dcmotor

Connection to DC Motor on Arduino MKR Motor Carrier or Nano Motor Carrier

Description

This object represents a connection to a DC Motor with the specified motor number on an MKR Motor Carrier or Nano Motor Carrier. You can control the DC motor using Object Functions.

Creation

Syntax

dcmObj = dcmotor(mcObj,motornumber)

dcmObj = dcmotor(mcObj,motornumber,Speed)

Description

dcmObj = dcmotor(mcObj,motornumber) creates a connection to the DC motor at the specified motor number on the MKR Motor Carrier or Nano Motor Carrier.

dcmObj = dcmotor(mcObj,motornumber,Speed) creates a connection to the DC motor at the specified motor number and specified additional options on the MKR Motor Carrier or Nano Motor Carrier.

Input Arguments

mcObj — MKR Motor Carrier or Nano Motor Carrier connection

object

Connection to the MKR Motor Carrier or Nano Motor Carrier, specified as an object.

Example: dcmObj = dcmotor(mcObj,M1) creates a DC motor connection at motor number 1 connected to M1.

motornumber — DC motor number

M1 | M2 | M3 | M4

DC motor number where the motor is connected on an MKR Motor Carrier or Nano Motor Carrier, specified as a character vector.

Speed — Normalized duty cycle

0 (default)

Normalized DC motor duty cycle specified as a number between-1 and 1. A positive number indicates a forward rotation and a negative number indicates a reverse rotation of the motor shaft.

Example: dcmObj = dcmotor(mcObj,'M1','Speed',0.2); sets the duty cycle to 20% in forward direction of rotation of the motor shaft.

Properties

MotorNumber — DC motor number

M1 | M2 | M3 | M4

This property is read-only.

Motor number on the MKR Motor Carrier or Nano Motor Carrier where the DC motor is connected.

Example:

>> dcmObj.MotorNumber
ans = 
      'M1' 

Data Types: char

Speed — Normalized duty cycle of DC motor

[-1 1]

DC motor duty cycle specified as a number between-1 and 1. A positive number indicates a forward rotation of the motor shaft and a negative number indicates a reverse rotation of the motor shaft.

Example:

>> dcmObj.Speed
ans = 
      0.2 

Data Types: double

Running — DC Motor State

0 (default) | 1

This property is read-only.

DC motor state specified as 0 or 1. Running is 0 if the motor has not started and 1 otherwise. Running is a read-only property.

Example:

>> dcmObj.Running
ans = 
      0 

Data Types: double

Object Functions

Use these object functions to create a connection to the DC Motor.

start	Start DC motor connected to MKR Motor Carrier or Nano Motor Carrier
stop	Stop DC motor connected to MKR Motor Carrier or Nano Motor Carrier

Examples

Create Connection to DC Motor on Nano Motor Carrier

Create an arduino object with the 'MotorCarrier' library.

arduinoObj = arduino('/dev/ttyACM0','Nano33IoT','Libraries','MotorCarrier')

arduinoObj = 
  arduino with properties:

                  Port: '/dev/ttyACM0'
                 Board: 'Nano33IoT'
         AvailablePins: {'D0-D13', 'A0-A7'}
  AvailableDigitalPins: {'D0-D13', 'A0-A7'}
      AvailablePWMPins: {'D2-D6', 'D9-D10'}
   AvailableAnalogPins: {'A0-A3', 'A6-A7'}
    AvailableI2CBusIDs: [0]
AvailableSerialPortIDs: [1]
             Libraries: {'MotorCarrier'}
Show all properties

Create a connection to the Nano Motor Carrier

mcObj = motorCarrier(arduinoObj)

mcObj = 
  MotorCarrier with properties:

          SCLPin: 'A5'
          SDAPin: 'A4'
      I2CAddress: 102 ('0x66')

Create a connection to the DC Motor M3.

dcmObj = dcmotor(mcObj,'M3')

dcmObj = 
  DCMotor with properties:

    MotorNumber: 'M3'
        Running: 0              
          Speed: 0              

Specify Speed of DC Motor on Nano Motor Carrier

Create an arduino object with the 'MotorCarrier' library.

arduinoObj = arduino('/dev/ttyACM0','Nano33IoT','Libraries','MotorCarrier')

arduinoObj = 
  arduino with properties:

                  Port: '/dev/ttyACM0'
                 Board: 'Nano33IoT'
         AvailablePins: {'D0-D13', 'A0-A7'}
  AvailableDigitalPins: {'D0-D13', 'A0-A7'}
      AvailablePWMPins: {'D2-D6', 'D9-D10'}
   AvailableAnalogPins: {'A0-A3', 'A6-A7'}
    AvailableI2CBusIDs: [0]
AvailableSerialPortIDs: [1]
             Libraries: {'MotorCarrier'}
Show all properties

Create a connection to the Nano Motor Carrier.

mcObj = motorCarrier(arduinoObj)

mcObj = 
  MotorCarrier with properties:

          SCLPin: 'A5'
          SDAPin: 'A4'
      I2CAddress: 102 ('0x66')

Create a connection to the DC Motor M3 setting the speed to 0.2

dcmObj = dcmotor(mcObj,'M3','Speed',0.2)

dcmObj = 
  DCMotor with properties:

    MotorNumber: 'M3'
        Running: 0              
          Speed: 2.000000e-01