writeDigitalPin

R2026b

Write data to a specified pin on Arduino hardware

Syntax

writeDigitalPin(a,pin,value)

Description

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

writeDigitalPin(a,pin,value) writes the specified value to the specified pin on the Arduino^® hardware in the connection a.

Examples

Write to Digital Pin

Write a value to digital pin 5 with an LED to turn it on.

a = arduino();
writeDigitalPin(a,'D5',1);

Input Arguments

a — Arduino hardware connection

object

Arduino hardware connection created using arduino, specified as an object.

pin — Pin number

character vector

Pin number on the hardware, specified as a character vector.

Note

If you are using an analog pin to write a digital value, the function configures the pin in DigitalOutput mode.

value — Value of the digital data

logical

Value of digital data to write to the specified pin on hardware, specified as a logical value of 0 and 1 or true and false.

More About

Code Generation Using MATLAB Function Block

• Use writeDigitalPin in a MATLAB^® Function block with the Simulink^® Support Package for Arduino Hardware to generate code that can be deployed on Arduino Hardware.

• Configure the Arduino peripherals to the appropriate mode using configurePin before using writeDigitalPin in the MATLAB Function block.

Alternative Functionality

App

Use the Pin Explorer pane and Pin Configuration panel in the Arduino Explorer to write data to a specified pin on Arduino or any other supported hardware in MATLAB and MATLAB Online™. In the Pin Explorer pane, click the row corresponding to the pin that you want to configure. The Pin Configuration panel displays the options you can use to configure the selected pin. In the Pin Configuration panel, set the Mode as Digital Output (Write) and if required specify a Label to uniquely identify the pin. For more information, see Configure Read and Write for GPIO Pins Using Arduino Explorer App.

Version History

Introduced in R2014b

R2026a: Improved performance when writing digital data

The writeDigitalPin function shows improved performance when writing digital data to Arduino hardware. For example, this code is about 1.7x faster than in the previous release:

arduinoObj = arduino('COM6','Uno');

function testFun(arduinoObj)
   % LED Blinking for 100 times
   for i=1:100
       writeDigitalPin(arduinoObj,'D13',0);
       writeDigitalPin(arduinoObj,'D13',1);
   end
end

The approximate execution times are:

R2025b: 6.61 s

R2026a: 3.91 s

The code was timed on a Windows^® 11, Intel^® Xeon^® W-2133 CPU @ 3.60-GHz test system using the timeit function.

f = @() testFun(arduinoObj);
timeit(f)