Rewrote in simple language. Added hint about average values.

This commit is contained in:
Ron Hale-Evans 2016-06-29 13:10:45 -07:00
parent 7a0a2fbd0a
commit deac587164

View File

@ -1,6 +1,7 @@
# Analog Write Pin
Write to the specified [pin](/device/pins) (P0, P1, P2) as analog.
Write an **analog** signal (`0` through `1023`) to the
[pin](/device/pins) you say.
```sig
pins.analogWritePin(AnalogPin.P0, 400)
@ -8,15 +9,25 @@ pins.analogWritePin(AnalogPin.P0, 400)
### Parameters
* `name` - [String](/reference/types/string); the pin name ("P0", "P1", or "P2")
* `value` - a [Number](/reference/types/number) between 0 and 1023 included
* a [string](/reference/types/string) that is the pin name you say (`P0` through `P4`, or `P10`)
* a [number](/reference/types/number) from `0` through `1023`
The following code writes `1023` to the `P0` pin:
### Example
This program writes `1023` to pin `P0`.
```blocks
pins.analogWritePin(AnalogPin.P0, 1023)
```
#### ~hint
When you tell it to write `256` (for example), this function does not
_really_ write `256`. Instead, it writes a lot of different numbers,
and their average is `256`.
#### ~
### See also
[micro:bit pins](/device/pins), [on pin pressed](/reference/input/on-pin-pressed), [analog read pin](/reference/pins/analog-read-pin), [digital read pin](/reference/pins/digital-read-pin), [digital write pin](/reference/pins/digital-write-pin)