Basic Micro Studio Syntax Manual

HPWM
Syntax
hpwm pin,period,duty{,wait}
• Pin - hardware capable PWM pin number. See the HPWM Capable Pins Table below.
• Period - the time in clock cycles for a single pulse (high and low part).
• Duty - the time in clock cycles for the high side of the pulse.
Commands
• Wait - an optional boolean (true or false) argument that will cause the command to wait until the
current pulse has fi nished before setting the new period and duty. This eliminates the possibility
of a glitch in the pulses.
Supported
• BA - Supported.
• BAN - Supported.
• BAP - Supported.
• BAP40 - Supported.
HPWM Capable Pins
Processor Pins
Nano 18 P3
Nano 28 P9 / P10
Nano 40 P9 / P10
Atom 24m P9 / P10
Atom 28m P9 / P10
Atom 40m P9 / P10
AtomPro One P4 / P5 / P6
AtomPro 24m P10 / P11 / P12
AtomPro 28m P10 / P11 / P12
AtomPro 40m P9 / P10 / P11 / P13 / P14 / P15
Description
The HPWM command generates a pulse width modulated signal. HPWM is based on internal
hardware and is processor independent. Meaning it will run in the background while your program
performs additional tasks. HPWM has several uses, some of which include generating an analog
voltage, DC motor control, servo control or generating a frequency.
To create an analog voltage the pin is transitioned from high to low quickly. During the transitions
leaving the pin high for a certain amount of time versus low and then averaging the output will cause
a voltage change. If the pin was high (5V) 50% of the time and then low (0V) the other 50% of the
time, the voltage output would be around 2.5V. By adjusting the ratio of how long the pin is high
versus low we can control the output voltage with a simple RC circuit.
116