addon

R2026b

Connection to add-on device for Arduino hardware

Description

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

An object created by addon represents a connection to an add-on device on Arduino^® hardware. To create libraries such as L3G, LSM303, 1–Wire, Capacitive sensor, NeoPixel, and DHT22, use the addon function. These libraries are not part of the MATLAB^® Support Package for Arduino Hardware and must be downloaded separately. You can also create your own custom Arduino libraries as mentioned in Create Custom Arduino Library.

This page is specifically about the 'Adafruit\MotorshieldV2' library for the motorshieldv2 object, included in the MATLAB Support Package for Arduino Hardware. Attach an Adafruit^® Motor Shield V2 to Arduino hardware, and use 'Adafruit\MotorshieldV2' as an input argument to create a motorshieldv2 object. To create connections to motors on the shield, use the object functions.

Creation

Syntax

shield = addon(a,'Adafruit\MotorshieldV2')

shield = addon(a,'Adafruit\MotorshieldV2',Name=Value)

Description

shield = addon(a,'Adafruit\MotorshieldV2') creates a connection to Adafruit Motor Shield V2 connected to the Arduino hardware a.

shield = addon(a,'Adafruit\MotorshieldV2',Name=Value) adds additional options specified by one or more name-value arguments.

Input Arguments

a — Arduino hardware connection

arduino object

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

Example: shield = addon(a,'Adafruit\MotorshieldV2') creates a connection to motor shield on the specified arduino object a.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: motor = addon(a,'Adafruit\MotorshieldV2',I2CAddress='0x07',PWMFrequency=3200);

I2CAddress — I2C device address

96 ('0x60') (default) | numeric | character vector | hexadecimal | binary

I2C address, specified as the name-value argument 'I2CAddress' and either a hexadecimal value specified as a character vector or a scalar integer.

Example: shield = addon(a,'Adafruit\MotorshieldV2',I2CAddress=0x61); sets the I2C address to 97 or 0x61.

PWMFrequency — PWM frequency of Adafruit Motor Shield V2

1600 (default) | numeric

PWM frequency of Adafruit Motor Shield V2, specified as the name-value argument 'PWMFrequency' and a number in hertz.

Example: shield = addon(a,'Adafruit\MotorshieldV2',PWMFrequency=3200); sets the PWM frequency to 3200Hz.

Properties

SCLPin — I2C pin

Read-only: character vector

This property is read-only.

Arduino pins used by AdafruitMotor Shield V2. This is a read-only property.

Example:

>> shield.SCLPin

ans =

    'A5'

Data Types: char

SDAPin — I2C pin

Read-only: character vector

This property is read-only.

Arduino pins used by AdafruitMotor Shield V2. This is a read-only property.

Example:

>> shield.SDAPin

ans =

    'A4'

Data Types: char

I2CAddress — I2C device address

Read-only: 96 ('0x60') (default) | numeric | character vector | hexadecimal | binary

This property is read-only.

I2C device address, specified as a character vector that represents a hexadecimal value or a scalar integer.

Example:

>> shield.I2CAddress

ans =

    96

Data Types: double | char

PWMFrequency — PWM frequency of Adafruit Motor Shield V2

Read-only: 1600 (default) | numeric

This property is read-only.

PWM frequency of Adafruit Motor Shield V2, specified as a number in hertz.

Example:

>> shield.PWMFrequency

ans =

        1600

Data Types: double

Object Functions

To create a connection to a motor on the Adafruit Motor Shield V2, use these object functions.

dcmotor	Connection to DC motor on Adafruit Motor Shield V2 for Arduino
servo	Connection to servo motor on Adafruit Motor Shield V2 for Arduino
stepper	Connection to stepper motor on Adafruit Motor Shield V2 for Arduino

Examples

Create a Motorshieldv2 Object

Connect to Arduino hardware, and create an add-on connection to the Adafruit Motor Shield.

a = arduino('COM4','Uno',Libraries='Adafruit/MotorShieldV2');
motor = addon(a,'Adafruit\MotorshieldV2')

motor = 
  motorshieldv2 with properties:

          SCLPin: 'A5'
          SDAPin: 'A4'
      I2CAddress: 96 ('0x60')
    PWMFrequency: 1600 (Hz)

Specify I2C Address and PWM Frequency

Connect to Arduino hardware, and create an add-on connection to an Adafruit Motor Shield with an I2C address of 0x61 and PWM frequency of 1200 Hz.

a = arduino('COM4','Uno',Libraries='Adafruit/MotorShieldV2');

Updating server code on board Uno (COM4). This may take a few minutes.

motor = addon(a,'Adafruit/MotorShieldV2',I2CAddress=0x61,PWMFrequency=1200)

motor = 
  motorshieldv2 with properties:

          SCLPin: 'A5'
          SDAPin: 'A4'
      I2CAddress: 97 ('0x61')
    PWMFrequency: 1200 (Hz)

Version History

Introduced in R2014b