PWM

R2026b

Generate pulse width modulated signal on analog output pin

expand all in page
  • Arduino Common PWM Icon

Libraries:
Simulink Support Package for Arduino Hardware / Common

Description

Add-On Required: This feature requires the Simulink Support Package for Arduino Hardware add-on.

The PWM block generates square pulses of varying duty cycle depending on the input value sent to the block on the Arduino® hardware pin. This block enables a digital output to provide a range of different power levels, similar to that of an analog output.

For more information on how to select pins when you Simulink® model contains PWM, Standard Servo Read, Standard Servo Write, Continuous Servo Write, and Input Capture blocks, see Conflicting Pin Configurations on Arduino Timer.

Ports

Input

expand all

The value sent to the block input determines the width of the square wave, called duty-cycle, that the Arduino hardware outputs on the specified PWM pin.

For example:

  • Sending the maximum value, 255, to the block input produces 100% duty-cycle, which results in full power on the PWM pin.

  • Sending the minimum value, 0, to the block input produces 0% duty-cycle, which results in no power on the PWM pin.

  • Sending an intermediate value to the block input produces a proportional duty-cycle and power output on the PWM pin. For example, sending 204 to the block input produces 80% duty cycle and power (204/255 = 0.8).

  • Sending out-of-range values, such as 500 or -500, to the block input has the same effect as sending the maximum or minimum input values, respectively.

The block input port inherits the data type of the upstream block, and internally converts it to uint8.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean

Parameters

expand all

Specify the Arduino hardware board pin number to which the PWM input signal is connected. Click View pin map to open the Arduino pin mapping table. For more information on how to assign pins or view the pins for the PWM block, see Pin Mapping for Arduino Timer-Dependent Blocks.

Note

Do not assign the same pin number to multiple blocks within a model.

Configure the frequency of the PWM signal.

When you set the Frequency as:

  • Default –– The block generates PWM signal with default frequency. For more information on default PWM frequencies and pins that support PWM on different Arduino boards, see Supported Default PWM Frequencies and Pins on Arduino Compatible Teensy Boards.

  • Specify –– Using this parameter, you can specify the frequency of the PWM signal. Using this option enables the Desired(Hz) and Achievable(Hz) parameters. In the Desired(Hz) parameter, specify the desired frequency of the PWM signal. The block generates the PWM signals with achievable frequency that is closest to the frequency specified in the Desired(Hz) parameter.

Note

In the connected I/O mode, you cannot use the Specify option. The block generates the PWM signal only with default frequencies.

Specify the desired output frequency of the PWM signal.

Dependencies

To enable this parameter, set Frequency to Specify.

This read-only parameter indicates the block generated PWM signals with the frequency that is closest to the frequency specified in the Desired(Hz) parameter.

Dependencies

To enable this parameter, set Frequency to Specify.

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"arduinolib/PWM"

Example: add_block("arduinolib/PWM","myModel/myBlock",MakeNameUnique="on")

More About

expand all

Version History

Introduced in R2012b

See Also

| | | | | | |

Topics