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
Operating Brushless Motors
Advanced Digital Motor Controller User Manual 129
After the setup is complete, the motor will stop, BECC and SVT values will be printed on
the console and saved in the controller’s configurations flash memory.
In case BECC is reported as a negative number, the calibration will be treated as a failure,
and the error message “BEMF Integration Limit Detection FAILED!” will be displayed in
the console
If the calibration was successful, message “BEMF integration limit detection OK” will
be printed in the console and the values of BECC and SVT will be displayed too, then the
motor is ready to use. Send motor commands in open loop and verify that it runs in both
direction with reliability startup.
Further verification is possible by using an oscilloscope connected to any of the motor
phases. Verify that the signal is symmetrical as shown in figure 8-5. If it is imbalanced,
this means that the Back EMF Integrator Limit (SVT) needs further adjustment. You can
change the value manually until the left and right ramps look symmetrical.
Important Warning
Beware that the motor will spin at maximum speed during calibration/auto-tuning.
Make sure it is safe to do so before initiating. Be ready to cut to power instantly at
any time during the tuning process.
Closed Loop Modes in Sensorless
Closed loop speed mode can be used with sensorless motors. The speed is determined
by measuring the time between commutations. Sensorless motors will work the same as
sensored motors and require similar PID tuning. The only limitation is at very slow speed
where the motor cannot be made to go slower than the RPM resulting from the Startup
Frequency parameter.
Position modes, and the Speed Position modes cannot be used reliably with sensorless
motors.
Operating Brushless Motors
This section covers operating features that are common to Brushless Motor control, re-
gardless of the commutation mode.
Once configured and tuned, a brushless motor can be operated exactly like a DC motor
and all other sections in this manual are applicable. In addition, the Hall sensors or encod-
ers, provide extra information about the motor’s state compared to DC motors. This infor-
mation enables the additional features discussed below.
Stall Detection
The rotor sensors and the encoders can be used to detect whether the motor is spinning
or not. The controller includes a safety feature that will stop the motor power if no rotation
is detected while a given amount of power is applied for a certain time. Three combina-
tions of power and time are available: