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 # 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 ```sig
pins.analogWritePin(AnalogPin.P0, 400) pins.analogWritePin(AnalogPin.P0, 400)
@ -8,15 +9,25 @@ pins.analogWritePin(AnalogPin.P0, 400)
### Parameters ### Parameters
* `name` - [String](/reference/types/string); the pin name ("P0", "P1", or "P2") * a [string](/reference/types/string) that is the pin name you say (`P0` through `P4`, or `P10`)
* `value` - a [Number](/reference/types/number) between 0 and 1023 included * 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 ```blocks
pins.analogWritePin(AnalogPin.P0, 1023) 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 ### 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) [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)