addon

Connection to add-on device for Arduino hardware

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

Description

An object created by addon represents a connection to an add-on device on Arduino^® hardware. You can use the addon function to create add-on libraries such as L3G, LSM303, 1–Wire, Capacitive sensor, NeoPixel, and DHT22. 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 add-on libraries as mentioned in Create Custom Arduino Add-On Library.

This page is specifically about the 'Adafruit\MotorshieldV2' add-on 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. You can create connections to motors on the shield using object functions.

Creation

Syntax

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

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

Description

shield = addon(a,'Adafruit\MotorshieldV2') creates an add-on 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 pair 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 comma-separated pair consisting of '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 comma-separated pair consisting of 'PWMFrequency' and a number in hertz.

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

Properties

SCLPin — I2C pin

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

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

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

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

Use these object functions to create a connection to a motor on the Adafruit Motor Shield V2.

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 an 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.

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