aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/wirish/pwmwrite.rst
blob: b1f0515121d9677ab2643cad8469543eaaab8b11 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
.. highlight:: cpp

.. _wirish-pwmwrite:

pwmWrite()
==========

Writes a :ref:`PWM wave <pwm>` to a pin.  You can use this to make an
LED get brighter or dimmer, control a servomotor, etc. After a call to
pwmWrite(), the pin will output a steady square wave with the given
duty cycle.  You can change the duty cycle later by calling pwmWrite()
again with the same pin and a different duty.

.. contents:: Contents
   :local:

Library Documentation
---------------------

.. doxygenfunction:: pwmWrite

Example
-------

Sets the output to the LED proportional to the value read from the
potentiometer (adapted for Maple from the Arduino `analogWrite()
reference <http://www.arduino.cc/en/Reference/AnalogWrite>`_\ )::

     
    int ledPin = 13;      // LED connected to pin 13 (Maple-specific)
    int analogPin = 3;    // potentiometer connected to analog pin 3
    int val = 0;          // variable to store the read value
    
    void setup() {
      pinMode(ledPin, OUTPUT);   // sets the LED pin as output

      pinMode(analogPin, PWM);   // sets the potentiometer pin as PWM
                                 // output (Maple-specific)
    }
    
    void loop() {
      val = analogRead(analogPin);   // read the input pin

      analogWrite(ledPin, val / 16);  // analogRead values go from 0 to 4095,
                                      // analogWrite values from 0 to 65535
                                      // (Maple-specific)
    }

See Also
--------

-  :ref:`Maple PWM tutorial <pwm>`