User Manual
Table Of Contents
- Revision History
- Introduction
- Refer to the Datasheet for Hardware-Specific Issues
- User Manual Structure and Use
- SECTION 1 Connecting Power and Motors to the Controller
- SECTION 2 Safety Recommendations
- SECTION 3 Connecting Sensors and Actuators to Input/Outputs
- SECTION 4 I/O Configuration and Operation
- SECTION 5 Magnetic Sensor
- SECTION 6 Command Modes
- SECTION 7 Motor Operating Features and Options
- SECTION 8 Brushless Motor Connections and Operation
- SECTION 9 AC Induction MotorOperation
- SECTION 10 Closed Loop Speed and Speed Position Modes
- SECTION 11 Closed Loop Relative and Tracking Position Modes
- SECTION 12 Closed Loop Count Position Mode
- SECTION 13 Closed Loop Torque Mode
- SECTION 14 Serial (RS232/RS485/USB/TCP) Operation
- SECTION 15 Commands Reference
- SECTION 1: Connecting Power and Motors to the Controller
- Power Connections
- Controller Power
- Controller Powering Schemes
- Mandatory Connections
- Connection for Safe Operation with Discharged Batteries (note 1)
- Use precharge Resistor to prevent switch arcing (note 2)
- Protection against Damage due to Regeneration (notes 3)
- Connect Case to Earth if connecting AC equipment (note 4)
- Avoid Ground loops when connecting I/O devices (note 5)
- Connecting the Motors
- Single Channel Operation
- Power Fuses
- Wire Length Limits
- Electrical Noise Reduction Techniques
- Battery Current vs. Motor Current
- Measured and Calculated Currents
- Power Regeneration Considerations
- Using the Controller with a Power Supply
- SECTION 2: Safety Recommendations
- SECTION 3: Connecting Sensors and Actuators to Input/Outputs
- Controller Connections
- Controller’s Inputs and Outputs
- Connecting devices to Digital Outputs
- Connecting Switches or Devices to direct Digital Inputs
- Connecting a Voltage Source to Analog Inputs
- Connecting Tachometer to Analog Inputs
- Connecting External Thermistor to Analog Inputs
- Using the Analog Inputs to Monitor External Voltages
- Connecting Sensors to Pulse Inputs
- Connecting SSI Sensors
- Connecting Optical Encoders
- Connecting the Encoder
- SECTION 4: I/O Configuration and Operation
- Basic Operation
- Input Selection
- Digital Inputs Configurations and Uses
- Analog Inputs Configurations and Use
- Pulse Inputs Configurations and Uses
- Digital Outputs Configurations and Triggers
- Encoder Configurations and Use
- SSI Configuration and Use
- Hall and other Rotor Sensor Inputs
- Sensor Min Max values
- Relative Speed
- Brake Release
- Roboteq Products Connection and Operation
- SECTION 5: Roboteq Products Connection and Operation
- SECTION 6: Command Modes
- Input Command Modes and Priorities
- Operating the Controller in RC mode
- Using Sensors with PWM Outputs for Commands
- Operating the Controller In Analog Mode
- Monitoring and Telemetry in RC or Analog Modes
- Using the Controller with a Spektrum Satellite Receiver
- Using the Controller in Serial (USB/RS232/RS485/TCP) Mode
- SECTION 7: Motor Operating Features and Options
- SECTION 8: Brushless Motor Connections and Operation
- SECTION 9: AC Induction MotorOperation
- SECTION 10: Closed Loop Speed and Speed-Position Modes
- SECTION 11: Closed Loop Relative and Tracking Position Modes
- Modes Description
- Selecting the Position Modes
- Position Feedback Sensor Selection
- Sensor Mounting
- Feedback Sensor Range Setting
- Adding Safety Limit Switches
- Using Current Trigger as Protection
- Operating in Closed Loop Relative Position Mode
- Operating in Closed Loop Tracking Mode
- Position Mode Relative Control Loop Description
- PID tuning in Position Mode
- PID Tuning Differences between Position Relative and Position Tracking
- Loop Error Detection and Protection
- SECTION 12: Closed Loop Count Position Mode
- SECTION 13: Closed Loop Torque Mode
- SECTION 14: Serial (RS232/ RS485/USB/TCP) Operation
- SECTION 15: Commands Reference
- Commands Types
- Runtime Commands
- AC Set Acceleration
- AX Next Acceleration
- B Set User Boolean Variable
- BND Spectrum Bind
- C Set Encoder Counters
- CB Set Brushless Counter
- CG Set Motor Command via CAN
- CS CAN Send
- CSS Set SSI Sensor Counter
- CU Raw Redirect Send
- D0 Reset Individual Digital Out bits
- D1 Set Individual Digital Out bits
- DC Set Deceleration
- DS Set all Digital Out bits
- DX Next Deceleration
- EES Save Configuration in EEPROM
- EX Emergency Stop
- G Go to Speed or to Relative Position
- GIQ Go to Torque Amps
- GID Go to Torque Amps
- H Load Home counter
- MG Emergency Stop Release
- MS Stop in all modes
- P Go to Absolute Desired Position
- PR Go to Relative Desired Position
- PRX Next Go to Relative Desired Position
- PX Next Go to Absolute Desired Position
- R MicroBasic Run
- RC Set Pulse Out
- S Set Motor Speed
- SFT Safety Stop
- STT STO Self-Test
- SX Next Velocity
- VAR Set User Variable
- DS402 Runtime Commands
- CW – Control Word (DS402)
- Profile Position Mode
- Velocity Mode
- Other Modes
- FEW Following Error Window (DS402)
- FET Following Error Time Out (DS402)
- INT Interpolation Time Period (DS402)
- MSL Target Profile Velocity (DS402)
- PAC – Profile Acceleration (DS402)
- PDC – Profile Deceleration (DS402)
- PLT Software Position Limit (DS402)
- POS – Target Position (DS402)
- PSP – Profile Velocity (DS402)
- ROM – Modes of Operation (DS402)
- S16 – Target Velocity (DS402)
- SAC – Velocity Acceleration (DS402)
- SDC – Velocity Deceleration (DS402)
- SPC Target Profile Velocity (DS402)
- SPL – Velocity Min/Max Amount (DS402)
- TC – Target Torque (DS402)
- TSL – Torque Slope (DS402)
- Runtime Queries
- A Read Motor Amps
- AI Read Analog Inputs
- AIC Read Analog Input after Conversion
- ANG Read Rotor Angle
- ASI Read Raw Sin/Cos sensor
- B Read User Boolean Variable
- BA Read Battery Amps
- BCR Read Brushless Count Relative
- BMC Read BMS State Of Charge in AmpHours
- BMF Read BMS status flags
- BMS Read BMS switch states
- BS Read BL Motor Speed in RPM
- BSC Read BMS State of Charge in percentage
- BSR Read BL Motor Speed as 1/1000 of Max RPM
- C Read Encoder Counter Absolute
- CAN Read Raw CAN frame
- CB Read Absolute Brushless Counter
- CD Read Raw Redirect Received Frames Count
- CF Read Raw CAN Received Frames Count
- CHS CAN Consumer Heartbeat Status
- CIA Read Converted Analog Command
- CIP Read Internal Pulse Command
- CIS Read Internal Serial Command
- CL Read RoboCAN Alive Nodes Map
- CR Read Encoder Count Relative
- CSR Read Relative SSI Sensor Counter
- CSS Read Absolute SSI Sensor Counter
- D Read Digital Inputs
- DDT Read Raw Redirect Received Frame
- DI Read Individual Digital Inputs
- DO Read Digital Output Status
- DPA Read DC/Peak Amps
- DR Read Destination Reached
- E Read Closed Loop Error
- F Read Feedback
- FC Read FOC Angle Adjust
- FLW Read Flow Sensor Counter
- FF Read Fault Flags
- FID Read Firmware ID
- FIN Read Firmware ID (numerical)
- FM Read Runtime Status Flag
- FS Read Status Flags
- HS Read Hall Sensor States
- ICL Is RoboCAN Node Alive
- K Read Spektrum Receiver
- LK Read Lock status
- M Read Motor Command Applied
- MA Read Field Oriented Control Motor Amps
- MGD Read Magsensor Track Detect
- MGM Read Magsensor Markers
- MGS Read Magsensor Status
- MGT Read Magsensor Track Position
- MGY Read Magsensor Gyroscope
- MGX Read MagSensor Tape Cross Detection
- P Read Motor Power Output Applied
- PHA Read Phase Amps
- PI Read Pulse Inputs
- PIC Read Pulse Input after Conversion
- S Read Encoder Motor Speed in RPM
- SCC Read Script Checksum
- SDT Read Raw Redirect Received Frame as string
- SEC Read Sensor Errors
- SNA Read Sensor Angle
- SR Read Encoder Speed Relative
- SS Read SSI Sensor Motor Speed in RPM
- SSR Read SSI Sensor Speed Relative
- STT STO Self-Test Result
- T Read Temperature
- TM Read Time
- TR Read Position Relative Tracking
- TRN Read Control Unit type and Controller Model
- UID Read MCU Id
- V Read Volts
- VAR Read User Integer Variable
- SL Read Slip Frequency
- DS402 Runtime Queries
- AOM – Modes of Operation Display (DS402)
- CW – Control Word (DS402)
- SPE – Velocity Actual Value (DS402)
- FEW Following Error Window (DS402)
- FET Following Error Time Out (DS402)
- INT Interpolation Time Period (DS402)
- MSL Max Motor Speed (DS402)
- PAC – Profile Acceleration (DS402)
- PDC – Profile Deceleration (DS402)
- PLT Software Position Limit (DS402)
- PST Position Actual Value
- POS – Target Position (DS402)
- PSP – Profile Velocity (DS402)
- RMP – VL Velocity Demand (DS402)
- ROM – Modes of Operation (DS402)
- S16 – Target Velocity (DS402)
- SAC – Velocity Acceleration (DS402)
- SDC – Velocity Deceleration (DS402)
- SDM – Supported Drive Modes (DS402)
- SPL – Velocity Min/Max Amount (DS402)
- SW – Status Word (DS402)
- TC – Target Torque (DS402)
- TRQ – Target Torque (DS402)
- TSL – Profile Acceleration (DS402)
- VNM – Version Number (DS402)
- Query History Commands
- Maintenance Commands
- CLMOD – Motor/Sensor Setup
- CLRST Reset configuration to factory defaults
- CLSAV Save calibrations to Flash
- DFU Update Firmware via USB
- EELD Load Parameters from EEPROM
- EELOG Dump Flash Log Data
- EERST Reset Factory Defaults
- EESAV Save Configuration in EEPROM
- ERASE Erase Flash Log Data
- LK Lock Configuration Access
- RESET Reset Controller
- SLD Script Load
- STIME Set Time
- UK Unlock Configuration Access
- Set/Read Configuration Commands
- General Configuration and Safety
- ACS Analog Center Command to Start
- AMS Analog keep within Guard Bands
- BEE User Storage in Battery Backed RAM
- BRUN Script Auto-Start
- CLIN Command Linearity
- CPRI Command Priorities
- DFC Default Command value
- DMOD – Modbus Mode
- ECHOF Enable/Disable Serial Echo
- EE User-Defined Values
- ISM Raw Redirect Mode
- MDAL – Modbus Data Alignment
- MNOD – Modbus Slave ID
- PMS Pulse keep within Min & Max Safety
- RSBR Set RS232/RS485 baudrate
- RS485 Enable RS485
- RWD Serial Data Watchdog
- SCRO Select Print output port for scripting
- SKCTR Spektrum Center
- SKDB Spektrum Deadband
- SKLIN Spektrum Linearity
- SKMAX Spektrum Max
- SKMIN Spektrum Min
- SKUSE Assign Spektrum port to motor command
- STO – STO Enable
- TELS Telemetry String
- Analog, Digital, Pulse IO Configurations
- ACTR Analog Input Center (0)
- ADB Analog Input Deadband
- AINA Analog Input Use
- ALIN Analog Input Linearity
- AMAX Analog Input Max
- AMAXA Analog Input Action at Max
- AMIN Analog Input Min
- AMINA Analog Input Action at Min
- AMOD Analog Conversion Type
- APOL Analog Input Conversion Polarity
- DINA Digital Input Action
- DINL Digital Input Active Level
- DOA Digital Output Action
- DOL Digital Outputs Active Level
- PCTR Pulse Input Center
- PDB Pulse Input Deadband
- PINA Pulse Input Use
- PLIN Pulse Input Linearity
- PMAX Pulse Input Max
- PMAXA Pulse Input Action at Max
- PMIN Pulse Input Min
- PMINA Pulse Input Action at Min
- PMOD Pulse Input Capture Type
- PPOL Pulse Input Capture Polarity
- Motor Configurations
- ALIM Amps Limit
- ATGA Amps Trigger Action
- ATGD Amps Trigger Delay
- ATRIG Amps Trigger Level
- BKD Brake Delay
- BPR Bypass Trajectory/Ramp
- BRV Brake Release Voltage
- BHV Brake Hold Voltage
- BDT Brake Delay Time
- BLFB Closed loop Feedback Sensor
- BLSTD Stall Detection
- CLERD Close Loop Error Detection
- EDEC Motor Fault Deceleration Rate
- EHL Encoder Max Limit
- EHLA Encoder Action at Max
- EHOME Encoder Home Count
- ELL Encoder Min Limit
- ELLA Encoder Action at Min
- EMOD Encoder Usage
- EPPR Encoder Pulse/Rev Value
- ICAP PID Integrator Limit
- KDG PID Differential Gain
- KIG PID Integral Gain
- KPG PID Proportional Gain
- MAC Motor Acceleration Rate
- MDEC Motor Deceleration Rate
- MLX Molex Input
- MDIR Motor Direction
- MMOD Operating Mode
- MNRPM Min Speed RPM
- MVEL Position Mode Velocity
- MXMD Mixed Mode
- MXPF Motor Max Power Forward
- MXPR Motor Max Power Reverse
- MXRPM Max Speed RPM
- MXTRN Position Turns Min to Max
- OVH Overvoltage hysteresis
- OVL Overvoltage Limit
- OTL Over Temperature Limit
- SED Sensor Error Detection
- SCPR SSI Sensor Resolution
- SHL SSI Sensor Max Limit
- SHLA SSI Sensor Action at Max
- SHOME SSI Sensor Home Count
- SLL SSI Sensor Min Limit
- SLLA SSI Sensor Action at Min
- SMOD SSI Sensor Usage
- TNM Motor Torque Constant
- UVL Undervoltage Limit
- Brushless Specific Commands
- BADJ Brushless Angle Zero Adjust
- BADV Brushless timing angle adjust
- BECC – BEMF Coupling Constant
- BFBK Brushless Sinusoidal Angle Sensor
- BHL Brushless Internal Sensor Max Limit
- BHLA Brushless Internal Sensor Action at Max
- BHOME Brushless Internal Sensor Home Count
- BLL Brushless Internal Sensor Min Limit
- BLLA Brushless Internal Sensor Action at Min
- BMOD Brushless Switching Mode
- BPOL Number of Pole Pairs
- BZPW Brushless Reference Seek Power
- HPO Hall Sensor Position Type
- HSAT Hall Sensor Angle Table
- HSM Hall Sensor Map
- KIF Current PID Integral Gain
- KPF Current PID Proportional Gain
- LD Motor d-axis Inductance
- LQ Motor q-axis Inductance
- PSA Phase Shift Angle
- RS Motor Stator Resistance
- SPOL SinCos/SSI Sensor Poles
- SSF – Sensorless Start-Up Frequency
- SVT – BEMF Integrator Limit
- SWD Swap Windings
- TID FOC Target Id
- VK Motor Voltage constant
- ZSMA Cos Amplitude
- ZSMC SinCos Calibration
- AC Induction Specific Commands
- BFBK AC Induction Operating Mode
- ILM Mutual Inductance
- ILLR Rotor Leakage Inductance
- IRR Rotor Resistance
- MPW Minimum Power
- MXS Optimal Slip Frequency
- RFC Rotor Flux Current
- VPH AC Induction Volts per Hertz
- CAN Communication Commands
- CAS CANOpen Auto start
- CBR CAN Bit Rate
- CEN CAN Mode
- CHB CAN Heartbeat
- CHLA CAN Consumer Heartbeat Lost Action
- CLSN CAN Listen Node ID
- CNOD CAN Node ID
- CSRT MiniCAN SendRate
- CTPS CANOpen TPDO SendRate
- CTT – CANOpen Transmission Type
- FSA – DS402 PDS Finite State Automation Enable
- DHCP Enable DHCP
- GWA Gateway Address
- IPA IP Address
- IPP IP Port
- PDNS Primary DNS
- SBM Subnet Mask
- SDNS Primary DNS
- WMOD TCP Mode
Controller Powering Schemes
Advanced Digital Motor Controller User Manual 25
Connection for Safe Operation with Discharged Batteries (note 1)
The controller will stop functioning when the main battery voltage drops below 7V. To en-
sure motor operation with weak or discharged batteries, connect a second battery to the
Power Control wire/terminal via the SW1 switch. This battery will only power the control-
ler’s internal logic. The motors will continue to be powered by the main battery while the
main battery voltage is higher than the secondary battery voltage.
Use precharge Resistor to prevent switch arcing (note 2)
Insert a 100Ohm, 5W resistor across the SW2 Emergency Switch. This will cause the con-
troller’s internal capacitors to slowly charge and maintain the full battery voltage by the time
the SW2 switch is turned on and thus eliminate damaging arcing to take place inside the
switch. Make sure that the controller is turned Off with the Power Control wire grounded
while the SW2 switch is off. The controller’s capacitors will not charge if the Power Control
wire is left floating and arcing will then occur when the Emergency switch is turned on.
Protection against Damage due to Regeneration (notes 3)
The voltage generated by motors rotating while not powered by the controller can cause
serious damage even if the controller is Off or disconnected.
• Use the main SW1 switch on the Power Control wire/terminal to turn Off and keep
Off the controller. In this way the controller cannot be powered up under any un-
wanted circumstances.
• Countermeasures should be taken to deal with any regeneration power if the bat-
tery or BMS system does not support energy to return back to it.
• Disconnecting the controller from the battery while motors are rotating could lead
to a serious damage. In this case a regeneration brake system is needed.
Connect Case to Earth if connecting AC equipment (note 4)
If building a system which uses rechargeable batteries, it must be assumed that periodi-
cally a user will connect an AC battery charger to the system. Being connected to the AC
main, the charger may accidentally bring AC high voltage to the system’s chassis and to
the controller’s enclosure. A similar danger exists when the controller is powered via a
power supply connected to the mains.
Some controller models in metallic enclosures are supplied with an Earth tab, which per-
mits earthing the metal case. Connect this tab to a wire connected to the Earth while the
charger is plugged in the AC main, or if the controller is powered by an AC power supply
or is being repaired using any other AC equipment (PC, Voltmeter etc.)
Avoid Ground loops when connecting I/O devices (note 5)
When connecting a PC, encoder, switch or actuators on the I/O connector, be very careful
that you do not create a path from the ground pins on the I/O connector and the battery
minus terminal. Should the controller’s main Ground wires (thick black) or terminals
be disconnected while the VMot wires (thick red) or terminals are connected, the high
current would flow from the ground pins, potentially causing serious damage to the
controller and/or your external devices.
• Do not connect a wire between the I/O connector ground pins and the battery mi-
nus terminal. Look for hidden connection and eliminate them.
• Have a very firm and secure connection of the controller ground wire and the bat-
tery minus terminal.
• Do not use connectors or switches on the power ground cables.