Emdrive User Manual - v2 - 2
Emdrive User Manual - v2 - 2
Emdrive User Manual - v2 - 2
User Manual
Rev. 2.2
Emsiso d.o.o.
+386 2 461 2 907
Pesnica pri Mariboru 20a
www.emsiso.com SI-2211 Pesnica pri Mariboru www.emdrive-mobility.com
Slovenia
Important Notice
This guide is delivered subject to the following conditions and restrictions:
• This guide contains proprietary information belonging to Emsiso d.o.o.
• The text and graphics included in this manual are for the purpose of illustration and
reference only. The specifications on which they are based are subject to change
without notice.
• Information in this document is subject to change without notice. Corporate and
individual names and data used in examples herein are fictitious unless otherwise
noted.
Copyright © 2020
Emsiso d.o.o.
All rights reserved.
Revision History:
Version Author Date Changes/Remarks
2.0 A. K., A. K., G. K. August 2020 Initial version
A.K. Added:
November
2.1 - CanOpen chapter
2020
- Application1 description
A.K.
2.2 February 2021 Modified specification for resolver with added waveforms.
emDrive Motor Controllers User Manual
Contents
1 Introduction ..................................................................................................................................... 1
1.1 About user manual .................................................................................................................. 1
1.2 Support .................................................................................................................................... 1
1.3 General emDrive information ................................................................................................. 1
Motor control features .................................................................................................................... 1
Position sensors ............................................................................................................................... 2
1.4 Protection functions ................................................................................................................ 2
1.5 Set-up ...................................................................................................................................... 2
2 Handling and safety instructions ..................................................................................................... 3
3 Technical specifications ................................................................................................................... 4
3.1 emDrive classification.............................................................................................................. 4
3.2 emDrive 150 ............................................................................................................................ 6
3.3 emDrive 500 ............................................................................................................................ 7
3.4 emDriveH300........................................................................................................................... 8
4 Mechanical specification ................................................................................................................. 9
4.1 Important instructions ............................................................................................................ 9
4.2 Dimension and mounting drawings ........................................................................................ 9
emDrive 150 .................................................................................................................................... 9
emDrive 500 .................................................................................................................................. 10
emDriveH300................................................................................................................................. 11
4.3 Mechanical installation instructions ..................................................................................... 12
4.4 Cooling ................................................................................................................................... 12
Air cooling ...................................................................................................................................... 12
Liquid cooling................................................................................................................................. 12
4.5 Sizing a conductor ................................................................................................................. 13
5 Electrical specification ................................................................................................................... 14
5.1 Important instructions .......................................................................................................... 14
5.2 Earthing of the system .......................................................................................................... 14
5.3 Insulation monitoring device ................................................................................................. 16
5.4 Power installation.................................................................................................................. 16
Basic power wiring ........................................................................................................................ 16
Power terminals identification ...................................................................................................... 16
emDrive 150 .................................................................................................................................. 17
emDrive 500 .................................................................................................................................. 17
emDriveH300................................................................................................................................. 18
5.5 DC-link discharge ................................................................................................................... 18
5.6 DC-link pre-charge ................................................................................................................. 18
5.7 Fuse rating ............................................................................................................................. 19
5.8 Minimum relay/contactor rating........................................................................................... 19
6 System integration guideline......................................................................................................... 20
6.1 emDrive architecture............................................................................................................. 21
emDrive 150 block diagram........................................................................................................... 21
emDrive 500 block diagram........................................................................................................... 21
emDriveH300 block diagram ......................................................................................................... 22
6.2 Requirements for building electric drivetrain system ........................................................... 22
6.3 emDrive system connector.................................................................................................... 23
Functional safety (STO) ................................................................................................................. 25
6.4 Equipment and Installation Check (commissioning) ............................................................. 26
6.5 Connection sequence ............................................................................................................ 26
6.6 Basic wiring example ............................................................................................................. 27
7 emDrive USB-CAN Interface .......................................................................................................... 30
7.1 Installation ............................................................................................................................. 31
8 emDrive Configurator tool (SW version 2.0 or higher) ................................................................. 32
8.1 Installation ............................................................................................................................. 32
8.2 emDrive Configurator user interface .................................................................................... 33
Menu bar ....................................................................................................................................... 33
Status panel ................................................................................................................................... 39
Main Window ................................................................................................................................ 40
Main window - Live Charts ............................................................................................................ 41
Main window - Oscilloscope.......................................................................................................... 42
Docked Window ............................................................................................................................ 44
Status bar....................................................................................................................................... 45
8.3 First time use of emDrive Configurator and SDO Browser.................................................... 46
9 Emsiso Connection Box ................................................................................................................. 48
10 Pairing emDrive and motor (controller configuration steps) .................................................... 51
10.1 Motor type ............................................................................................................................ 53
10.2 Controller/motor protections ............................................................................................... 53
Voltage protection (traction battery protection) .......................................................................... 53
Controller and motor current protections and settings................................................................ 54
Controller and motor temperature protections and settings ....................................................... 54
Copyright © Emsiso d.o.o. Rev. 2.2
www.emsiso.com
www.emdrive-mobility.com All rights reserved.
emDrive Motor Controllers User Manual
Figures
Tables
1 Introduction
1.2 Support
Please contact our web page www.emdrive-mobility.com for technical support.
Position sensors
• Standard three hall sensors with 60° or 120° configuration
• Absolute digital SSI encoder with RS422 interface (for example RLS RM44SC)
• Analog 5V sin/cos (for example RLS RM44AC)
• Resolver with TR = 0,5 ±10%; for example Tamagawa seiki TS2620N1095E161
o For resolver with TR out of specifications please contact support
Warning: If motor temperature sensor or position sensor feedback are not used or available then motor thermal
and motor velocity protection are not in function.
1.5 Set-up
• CANOpen connection for setting the parameters and data acquisition
• All settings are stored as parameters and can be changed – no “hard-wired” limits and
settings
• Parameter settings can be stored in file (.dcf)
• Easy set-up with emDrive configurator SW tool (emDrive USB to CAN interface card is
required)
• Internal FLASH memory for storing all selected data (battery voltage, motor current,
velocity, controller and motor temperature, …)
Before operating with emDrive motor controllers it is necessary that safety instruction provided
in this user manual are implement; that will keep personnel and work area safe. Please read
warning and important notes carefully. Following three signs are used during user manual.
Dangerous: Very important information. High risk of danger to life and/or damage to the product, process or
surroundings.
Warning: Is an instruction that draws attention to the risk of danger to life and/or damage to the product,
process or surroundings!
In this chapter only general handling and safety instructions are provided. Additional
instructions where needed are provided in other chapters.
Dangerous: Installation, adjust and maintain of emDrive must be done only by trained personnel under non-
energized conditions!
Dangerous: Before servicing or replacing any component, battery must be disconnected! After battery has been
disconnected wait for the internal capacitors to discharge to less than 60 V before handling the controller or
working near terminals!
Warning: Read and understand this manual carefully before starting operating with emDrive!
Warning: Installer of the emDrive motor controller takes over the responsibility for safety of the complete electric
drivetrain system!
Warning: Proper application circuitry shall include safety precautions such as protective fuse and an adequate
electrical insulation arrangement!
Warning: Use cables of the appropriate rating and fuse according to the applicable national vehicle and electrical
regulations!
Warning: While unpacking the emDrive special care have to be taken in to account that emDrive is heavy. Do not
drop emDrive itself or in the packaging since it can be damaged/destroyed or it can cause an injury!
Warning: Product must not be opened. Any attempt causes loss of warranty. There are no serviceable parts inside
of emDrive!
Warning: All user accessible metal parts and interface connectors meet basic isolation requirements. Basic
isolation test voltage is 2,5 kV for 1 min between metal parts and logic subsystem to high voltage power
subsystem.
NOTE: For recycling and disposal of emDrive consider regional requirements for recycling and disposal of
electronic equipment.
3 Technical specifications
emDrive 500_800/120
The emDrive motor controller serial number is 11 digits long and it is located on device
informational label. Serial number is composed of device family number (first 3 or 4 digits),
production week (next 2 digits), production year (next 2 digits) and serial number (last 3 or 4
digits). Serial number and identification label structure are shown on pictures below.
300A15170004
Serial number
Production year number
Production week number
Device family number
Fig. 3-2: Controller serial number structure (Example: emDriveH300A)
The emDrive motor controller serial number is 13 digits long and it is located on device
informational label. Serial number is composed of device family number (first 3 digits), device
type (1 digit), production week (next 2 digits), production year (next 4 digits) and serial number
(last 3 digits).
5000152017004
NOTE: emDrive motor controller serial number structure before end of year 2018 was slightly different and it
was 11 digits long. For further information about this change contact [email protected]
3.4 emDriveH300
Table 3-4: emDriveH300 technical specifications
emDriveH300 H300_450/450 unit
Electrical data
Output continuous current (peak one minute) 300 (450) ARMS
Input DC link voltage range 50 to 450 V
Input DC link current (maximum) 450 A
Input continuous power (peak one minute) 135 (200) kW
Output phase to phase voltage range 0 to 302 VRMS
Output continuous power (peak one minute) 135 (200) kVA
Input DC link capacitance 1000 µF
Switching frequency (number of output phases) 16 (3) kHz
Output frequency range 0 to 1,2 kHz
EMI Y capacitor, DC + and DC – to heat sink 220 nF
Discharge resistor: DC + to DC – typ. 200 k
Self-discharge time from 450 V to 60 V 5 min
Output short-circuits current 2 kA
Control unit electrical data
Supply voltage range (Ignition voltage) 12 to 30 V
Supply current maximum (Ignition current) 2,5 A
Protection functions
DC link under/over protection (adjustable) 0 to 450 V
Maximum controller current (adjustable) 0 to 450 ARMS
Secondary current (adjustable) 0 to 550 ARMS
DC link capacitors temperature (derating point) 75 °C
IGBT module temperature (derating point) 65 °C
Motor over temperature protection (derating point adjustable) 50 to 150 °C
Measurements
DC link voltage measurement range (resolution) 0 to 520 (0,125) V
Output current measurement range (resolution) 0 to 580 (0,353) ARMS
Motor temperature sensor input type KTY 84-130, KTY 84-210, NTC
Insulation
DC + to heat sink, DC – to heat sink 2,5 kV
DC + to logic level, DC – to logic level 2,5 kV
Logic level to heat sink 0,1 kV
Insolation resistance: DC + to heat sink, DC – to heat sink 500 M
Protective class (read section Earthing of the System) I
Mechanical data
Weight 7,5 kg
Height x Width x Length (chassis) 127 x 244 x 263 mm
Power contacts tightening torque (M6 nut) 4,5 to 5,5 Nm
Chassis screws tightening torque (M8 x 40 or longer) 15 to 25 Nm
Water fitting tightening torque 65 to 75 Nm
Cover screws tightening torque (2,5 x 10 mm) 0,6 to 0,8 Nm
Cable gland tightening torque (M25) 10 to 12 Nm
Cooling data
Power dissipation to coolant 4,5 kW
Required coolant flow 10 l/min
Coolant temperature (derating point) 60 °C
Operating pressure (pressure drop @ 10 l/min @ 25 °C) 1 (0,1) bar
Coolant volume 85 cm3
Coolant mixture (distilled water/glycol) 50/50 %
Environmental data
Operating ambient temperature -20 to 65 °C
Storage ambient temperature -40 to 85 °C
Enclosure protection level IP65
Operating altitude up to 2000 m
4 Mechanical specification
Warning: Failure to comply with specified flatness can cause deformation to emDrive base plate which can lead
to permanent damage!
emDrive 150
emDrive 500
emDriveH300
emDrive are not sensitive to mounting orientation. Controller can be mounted in any
orientation. Liquid cooling system in liquid cooled emDrive version has to be degassed.
4.4 Cooling
emDrive is equipped with temperature monitoring circuit to protect itself and motor from
overheating. If cooling is not sufficient emDrive/motor will overheat and reduced power will be
delivered from emDrive to motor.
Air cooling
emDrive 150 are versions with air cooling system. Mount emDrive 150 to sufficient large metal
sheet or install heat sink which is capable carrying enough heat. Heat losses are defined in
section 3.2.
Liquid cooling
emDrive with liquid cooling system have to use cooling liquid mixture as specified in sections
3.3 and/or 3.4. Before starting up the electric drive train with liquid cooling system has to be
degassed (no air pockets in the cooling loop).
Warning: Cooling system with air pockets can lead to overheating or thermal destruction of electric drive train
system components! Only degassed cooling system will operate properly!
Basic cooling circuit diagram is shown in figure below. Main cooling circuit components are:
water pump, emDrive, radiator and electric motor.
Left side of figure present’s simple circuit with only emDrive being liquid cooled. Direction of
cooling liquid is that emDrive hot liquid outlet is inlet to radiator. Between radiator through
pump toward emDrive only cooled liquid flows.
Right side of figure presents circuit where emDrive and motor are liquid cooled. When using
more components in cooling circuits that generates heat (e.g. charger, motor controller, motor,
etc.) components sequence is very important. First component in the loop is radiator which
cools down cooling liquid. Next is pump. All other components are ordered so that first
component is the one which generates the least heat losses and last in sequence is the one that
generates the most heat losses. This is because least heat losses add least temperature rise and
vice versa.
Warning: In cooling circuit use only approved components that meet thermal and pressure requirements!
Warning: Regarding to the standard ISO 6469, electrically propelled road vehicles Safety specifications – part 3,
protection of persons against electric shock defines that the outer covering of the cables and harness for
maximum working voltage class B (60 to 1500 V) electric circuits shall be orange color!
5 Electrical specification
Dangerous: Assembly and installation work must be taken only in non-energized conditions and by trained
personnel only!
Warning: None of emDrive has protection against reverse polarity on input DC link terminals! If installation
polarity is wrong the device will be destroyed!
Warning: Tie all cables into fixed position to prevent the cable from moving and thereby damaging the insulation!
Use shielded cable for all connections to the motor and the battery. Keep cables as short as
possible and close together to minimize emitting and receiving surfaces – loops. Keep battery
positive and negative cables as close as possible to minimize impedance. Keep motor power
cables as close as possible to minimize their impedance.
Keep all signal wiring harness as short as possible and route wiring close to metal framework.
Keep all signal wiring away from power cables as far as possible. Use only shielded cables.
Where using shielded cables beware of generating ground loops in which currents may be
induced or which may cause noise currents to flow via unintended paths.
Warning: Make sure that cable is not applying any torque or force to the phase or DC link terminal!
Warning: Cables carrying high AC current are subjected to alternating forces. Tie cables into fixed position to
prevent long-term fatigue!
Warning: When selecting cable cross section, consideration must be given to cable length, grouping of cables,
the maximum allowable temperature rise and the temperature rating of the chosen cable!
Dangerous: Do not operate emDrive motor controller without protective earthing conductor connected or without
equipotential bonding!
Dangerous: Protective class specified in section 3 specification is valid only if earthing is done correctly. If
earthing is not possible see section Insolation monitor device.
Every EDS or EDS element (motor, controller, battery) requiring connection to earth by
protective bonding have a means of connection for the protective earthing conductor, located
near the terminals for the respective live conductors. Earthing conductor of EDS has to be of a
minimal cross section specified in the section Sizing a conductor in green/yellow or green color.
Dangerous: A protective earthing conductor shall be connected at all times when high voltage power is connected
to the system!
Dangerous: It is forbidden and life-threatening to operate EDS which is not earth wired as specified!
Dangerous: In vehicle application where ground connection is not possible use of insolation monitor device is a
must!
emDrive 150
emDrive 150 has a M6 power terminals for connecting battery and motor cables. For
connecting cables use cable lug of proper size that suits selected cable cross section and for M6
tightening screw. Recommended cable lugs are from producer Cembre in sizes:
• 16 mm2: A3-M6
• 25 mm2: A5-M6
• 35 mm2: A7-M6 or A7 B-M6/11.5
• 50 mm2: A10-M6 or A10 B-M6/11.5
NOTE: emDrive 150 package includes controller with cable fixing screws.
emDrive 500
emDrive 500 has a M8 power terminals for connecting battery and motor cables. For
connecting cables use cable lug of proper size that suits selected cable cross section and for M8
tightening screw. Recommended cable lugs are from producer Cembre in sizes:
• 50 mm2: A10-M8
• 95 mm2: A19-M8 or A19 B-M8/15.5
emDriveH300
Only shielded high voltage cables are acceptable for emDriveH300 installation. Protective
shields of high voltage cables shall be installed correctly as shown at figures below. Use only
certified high voltage industrial or automotive cables. Supplied cable lugs are 50 mm2 from
producer Cembre, ordering code: A10-M6.
NOTE: emDriveH300 package includes controller with lugs and fixing nuts.
Dangerous: Before servicing or replacing any component, battery must be disconnected! After battery has been
disconnected wait for the internal capacitors to discharge to less than 60 V before handling the controller or
working near terminals.
Warning: Failure to use a pre-charging may lead to damage the line relay/contactor or the emDrive!
NOTE: Pre-charge resistor values have been calculated at maximum DC-link voltage and rounded to standard
E12 series values. High Pulse Capability wire wound resistors are recommended. For example, Arcol HS10-
HS300 or Tyco HSA & HSC Aluminium Housed Power Resistor series.
Warning: In table only, maximum current and minimum voltage fuse ratings for emDrive are shown. Actual fuse
rating must be selected according actual battery and motor specification used in drive train installation.
NOTE: In case of dual windings motor only torque mode should be used. Operation possible only with tandem
resolver position sensor.
emDrive 500 power stage architecture is very similar to emDrive 150. Main difference is that
DC link capacitors are on the separate PCB and it has liquid cooling instead of air cooling.
• Auxiliary components (CAN, Throttle, Brake, FWD, REV, ...) or Emsiso Connection Box
(contact Emsiso for offer)
emDrive control interface mating connector is 35 pin female AMPSEAL with ordering code:
• connector housing (Manufacturer Part No: 776164-1)
• female crimp pins (Manufacturer Part No: 770854-3 (gold) or 770854-1 (tin))
Warning: In standard (non-isolated) version controller has no galvanic insolation between power stage and
control section. Screw connection battery minus (–B) is internally connected with pins 1, 3 and 24.
System will not respond to 1 ms “disable” test pulses with frequency less than 100 Hz.
Dangerous: Installation, adjust and maintain the emDrive must be done only by trained personnel under non-
energized conditions!
Before starting up the electric drivetrain system with liquid cooling check if coolant mixture is
correct and system has been degassed. For air cooling system check if heat sink is capable
carrying enough heat and enough airflow is provided. More information about cooling
requirements are in cooling and technical specification chapter. Before connecting any external
power supply or battery to the electric drivetrain check if all electrical connections have been
done according to electrical installation, fuse rating and power installation chapters. Check also
that used cables are without isolation damage and correctly tightened. In case of system
earthing check if earthing is done correctly (more information in earthing of the system
chapter).
Battery
+ -
emDrive
Configurator 7
B+ B- 4
USB cable emDrive
USB/CAN W
1 System connector
V
MOTOR
U
CAN
2
bus
3 5
Sensor feedback
6
Auxiliary components and interconnections
Logic power +
(CAN, Sensor feedback, Throttle, Brake, FWD, REV, ...)
supply -
or Emsiso Connection Box
Fig. 6-7: Connection sequence
NOTE: Read and apply instructions found in other chapters since Pre-charge, Discharge, Fuses, Contactors,
Earthing, etc. are not shown in basic wiring example!
W
V
B+
+
U
Fig. 6-8: Basic wiring example
System connector
CAN High
30
CAN Low
19
CAN GND
5 4 3 2 1
CAN DB9 9 8 7 6
Female
Fig. 6-10: CAN bus cable wiring (for Emsiso USB/CAN interface)
General information
• CAN interface for the USB connection (USB 1.1, compatible with USB 2.0 and USB 3.0)
• Bit rates from 5 kbit/s up to 500 kbit/s
• CANOpen compatible
• CAN bus connection via D-sub Male, 9-pin
• USB connection via USB type B Female
• Galvanic insolation on the CAN up to 500 V
Housing
• Aluminum housing – Dimensions (Height x Width x Length) 30 x 70 x 60 mm
• Weight 93 g
• IP20 protection
1 5
6 9
7.1 Installation
Read system requirements chapter for emDrive USB-CAN Interface basic demands. Software
download is available from web page https://www.emdrive-mobility.com/. After download go
to download folder and extract files. Run file with filename corresponding to used operating
system (32/64bit). Follow installation wizard information until device driver installation is not
complete.
emDrive Configurator is CAN open tool developed by Emsiso. It was primarily designed for
usage with Emsiso products, but it can be used with any third-party device supporting CAN
open protocol. emDrive Configurator also has some additional features specific only for Emsiso
products (for example unique oscilloscope feature) that will not work on third-party devices. If
emDrive Configurator is used with third-party CAN interface specific features (outside CAN
open protocol) will also not work (for example oscilloscope feature will not work).
8.1 Installation
Download emDrive Configurator from web page and follow installation information (in case of
security warning message proceed by selecting Run/Install option). After application first run
unselect “Always ask before opening this file”. Licence Management window will appear if valid
licence was not found (follow application instructions for getting and applying licence). In case
of upgrade from version less than 2.0 to version 2.0 or higher notification window regarding
old licence type will appear. It is advised to contact us for new licence type. Without new licence
type emDrive Configurator will work as before, but some new features may not be available.
STATUS PANEL
STATUS BAR
Menu bar
Table 8-1: emDrive Configurator Menu bar options
Menu name Menu option Short description
Device Firmware update Firmware update. See pictures following this table
Set parameters to default (Ctrl + D) Set parameters to default (on emDrive device)
File menu
Save/Load project. emDrive Configurator allows user to save/load project file for later use on
PC drive. Project file includes Network description (EDS files), Watch, Shortcuts, Sliders and
other user settings.
Save EDS. Electronic Data Sheet (EDS) is standard CANopen file that contains list of all objects
supported by device with their parameters. With this command user can download EDS file
directly from emDrive device. Downloaded EDS file is standard text file with .eds extension.
Save/Load DCF. Device Configuration File (DCF) is standard CANopen file that contains list of
objects with values in moment that was saved. DCF can be saved and loaded with any CANopen
software that supports this functionality. To save or load DCF file make sure that connection to
the device is working and communication port is opened with right Node-ID selected. Select
Save DCF or Load DCF from menu and browse computer for file path.
View menu
Menu options in View are described in Main and Docked window chapter.
Network menu
Connection window. To obtain bitrate of the USB-CAN interface click Read CAN card bitrate. To
select different CAN bitrate, use Change CAN bitrate dropdown menu and click Apply to confirm
new setting. Click Read CAN card protocol to obtain information about selected protocol. To
select different CAN protocol, use Set CAN protocol dropdown menu and click Apply to confirm
new setting (if dropdown menu is disabled licence for this option is not installed). In Manual
connecting mode select from dropdown menu COM Port (use Refresh button to update list of
available communication ports). For opening/closing communication port use Open and Close
buttons. In Automatic connecting mode application will automatically select and open
connection based on device name (for Emsiso USB-CAN interface correct string is already set
by default). If Show connection menu checkbox is selected additional connection menu will be
shown under menu bar for quick access to communication setting control. If Check connection
is selected emDrive Configurator will send periodically CAN requests to device to verify if device
is still connected. If Read on click is selected, reading object values in SDO browser is done by
single click on SDO browser object structure (if read on click is not selected reading object value
is done by additional click on read button). Addition information about communication is visible
in Status of command queue. Waiting queue is cleared with click on Clear buffer button.
Fig. 8-4: emDrive Configurator Menu bar -> Network -> Connection
Fig. 8-5: emDrive Configurator Menu bar -> Network -> Connection (show connection menu)
Nodes window allows scan network and loading existing EDS file from computer or
downloading it from device. Start scan will start scan for available network nodes. This step can
be skipped if ID number of devices is already known (in this case Node-ID number is entered in
table). Scanning process can also be stopped when Node reaches the ID number of connected
devices. Normally default emDrive device node ID is 1. Refresh button will check only status of
Node-IDs that are already in table. Download button is used to get EDS information from device.
If EDS file of device is already available loading file is possible instead of downloading file again.
Select “…” and browse for EDS file. After loading EDS file SDO browser is automatically updated.
Fig. 8-6: emDrive Configurator Menu bar -> Network -> Nodes
Device menu
Firmware update of device is possible in this window. Check Node ID value of emDrive device
value before starting firmware update procedure (if needed change Node ID in Status panel
under General Node-ID). Browse for Firmware file and click Update button. Follow instruction
messages that appear during procedure.
Fig. 8-7: emDrive Configurator Menu bar -> Device -> Firmware update
Fig. 8-8: emDrive Configurator Menu bar -> Device -> Firmware update (Save DFC file)
Fig. 8-9: emDrive Configurator Menu bar -> Device -> Firmware update (Uploading progress)
Fig. 8-10: emDrive Configurator Menu bar -> Device -> Firmware update (Load DFC file)
Fig. 8-11: emDrive Configurator Menu bar -> Device -> Firmware update (end message)
Save parameters (Ctrl + S). Save parameter values to device internal memory (EEPROM).
Set parameters to default (Ctrl + D). Command will Reset all device parameters to default
values.
Script window allows Run or Edit created scripts. Script usage is only for advanced users (usually
Emsiso provides script file and customer uses only Browse and Run script).
Fig. 8-12: emDrive Configurator Menu bar -> Device -> Script
Status panel
Status panel is divided to General, NMT commands, Shortcuts, Sync and Status section.
General section. Node-ID of device that we want to control/monitor is selected. With Get
Device-ID button unique identification number of connected device is obtained.
NMT commands (Network Management) section allow user to set state of one or all nodes on
CAN network. Stopped disables transmit or receive any messages except node guarding or
heartbeat messages as well NMT messages. Comm Reset will reset CAN communication. Reset
will reset controller. Preoperational state is mainly used for making changes of CAN node
parameters (it disables DSP402 state machine so that parameters can be safely changed. In this
state power stage of the controller is disabled). Putting CAN node device into Operational will
start DSP402 state machine and enable PDO communication. Operational state is mandatory
condition to run motor.
Shortcuts section is part of status panel and is designed to allow user easy and fast access to
six predefined object writes. Shortcuts offers user six ready to be customized buttons. Shortcuts
are also triggered with keyboard hotkeys F1 to F6. To Add object to shortcut, browse for object
in SDO Browser, right click object, chose Add to shortcut menu and select shortcut number. To
edit shortcut right click on shortcut, click Edit, edit Value and Shortcut text, click Apply.
Fig. 8-16: emDrive Configurator Status panel (Shortcuts and edit shortcut)
Sync section. Sync is used to produce Sync messages with Emsiso USB-CAN interface.
NOTE: To use Sync feature it is necessary to use Emsiso USB-CAN interface! Sync time is not guaranteed!
Status shows status of connection between PC and USB-CAN interface and status of connection
between USB-CAN interface and emDrive device with green/red colored line.
Main Window
In Main Window Start page, SDO browser, Live Charts and Oscilloscope are visible if enabled in
View menu.
Start Page shows list of saved recent projects and Open Other Projects button.
SDO Browser. To open this window chose SDO Browser from View menu. SDO Browser is used
to Read or Write value to any object that is supported in device dictionary. SDO Browser is also
used to Add objects to Watch, Oscilloscope, Shortcuts and Slider (with right click on object).
Search and select wanted object in SDO browser by scrolling or use search dialog box to enter
object text string. Representation of object read and write value can be hexadecimal or decimal
(right mouse click inside object Value box).
In Live charts Main controls section Run/Pause, Clear history, Refresh rate, Export and Import
data are available. To show/pause drawing logged data of selected object click Run/Pause
button in Live Chart. Clear history button will clear currently logged object data (data collecting
will start from beginning). Refresh rate setting is used to optimize chart response and overall
application performance (for example if large number of data is expected in chart then value
for refresh rate can be adjusted to improve performance). Export data will save all data
monitored in watch window to .csv file. Import data will load all data stored in .csv file.
NOTE: Run/pause button is only for running/pausing Live Chart. Run/pause button will not stop collecting data.
To stop collecting data unselect Enable checkbox in watch window or remove object from watch window.
NOTE: Importing data from file will clear live charts and watch window. Watch Enable checkbox is unselected.
To compare live and imported values add SDO objects into watch window after importing data.
In Live charts Enable charts section Chart 1 to Chart 4 checkbox are available.
In Live charts Automatic scaling section Autoscale Y, Slide X and value for slide X are available.
With selected Autoscale Y checkbox Y-axis will automatically adjust to values in chart. For X-axis
scaling enable Slide X and set window period that is shown for X-axis. Live charts chart drawing
area. With left mouse and selection or mouse scroll inside graph window zooming is done (use
Pause button before using zoom). Other graph options are available with right mouse click
inside graph window.
SETTINGS
CHART AREA
TRIGGER
CHANNELS
Objects for oscilloscope are selected and added in SDO browser. After objects are added, the
oscilloscope needs to be configured. Available options for configuration for every oscilloscope
section are described below. In general, basic steps that are needed to use oscilloscope are:
add object/parameter to oscilloscope, select Chart no., add and set trigger settings, set settings
and at the end click WriteConf. After basic settings use Run/Stop button and Read Data button.
Chart area. Recording of objects is done with Run and Stop button. Continue button allows
continuing recording objects without clearing previous recorded data. Oscilloscope status
shows current status of oscilloscope. It is possible to select up to four charts (with checkbox)
and on every chart one or more objects can be shown. Read data reads and shows recorded
data in chart (reading progress is shown in Read progress). With left mouse and selection or
mouse scroll inside chart window zooming is done. Other chart options are available with right
mouse click inside chart window.
Settings section. Select recording target Memory (RAM, FLASH) from dropdown menu and set
Sample rate or Sample time (Sample rate and sample time values are connected. Changing one
will change other). Store results to flash will record data to controller flash memory. Recorded
information in controller flash memory is permanent and can be read if controller was turned
off in meantime. Once all Oscilloscope settings are done write setting configuration with Write
configuration (Settings, Trigger and Channels list are saved to controller). With Read
configuration existing oscilloscope configuration is loaded from device and shown. Export .csv
file will export data to CSV file that can be later loaded with Import .csv file. In Additional
settings window Oscilloscope frequency can be set Automatic or Manual. In manual mode value
can be manually entered. Default values are set with emDrive and BMS button. In section
Osciloscope unit select between Samples or Time setting. If parameters have been changed
save changes with Save settings button.
NOTE: Read configuration and Import .csv file will not load Chart no. numbers. After Read configuration or
Import .csv file select Chart no. numbers manually.
Trigger section. To set trigger Source right click on parameter in Channels section and chose
Set trigger. Different trigger options are selected with trigger Mode dropdown menu. Trigger
Level is decimal value used for trigger condition. Pretrigger % value represent percentage of
data that was measured and shown in oscilloscope chart before trigger condition was fulfilled.
For Pretrigger % decimal values from 0 to 99 are valid.
Channels section. Search in SDO browser for wanted objects and add them to Oscilloscope with
right mouse click in SDO browser (select Add to oscilloscope). After objects for oscilloscope
have been added to Oscilloscope select Chart no. in channel section. With right mouse click and
selecting Remove or Remove all objects are removed from channel list. With right mouse click
and selecting Set trigger object is added to trigger section where more options for trigger are
available.
Docked Window
In Docked Window are visible Watch, Sliders and EMCY messages (if enabled in View). In docked
window also Firmware update window will appear (if selected in Device menu). Firmware
update is described under Device menu.
Watch window is used to periodically read multiple objects values from device. If Enable
checkbox is selected watch window readings will periodically refresh. Period of reading values
is set in ms. With Read all button manual reading of all object/parameters in watch is done.
Direct value write for objects that are write type is done by entering new value to value column.
Watch window is also used to add/remove objects in Live Charts (in watch window set Chart
value from 1 to 4 to add object or empty for removing object). Use right mouse click to select
hexadecimal or decimal representation of object value. Other watch options are available with
right mouse click inside chart window.
NOTE: If Enable checkbox is checked object data will be logged until checkbox is unselect. To clear previous data
use right mouse and select Clear history (will clear only selected objects) or Clear history for all.
Sliders. To see Sliders select Sliders from View menu. Object/parameter is added to slider in
SDO browser (with right click on object). Sliders can be used only for objects that are write type.
If needed set maximum and minimum value (value must be inside object absolute limits). If
Sync (1s) is enabled reading of object value will be done every second. To change object value,
move Slider up/down with mouse or manually type value in Current value box.
EMCY messages window is used to periodically read EMCY messages from device. EMCY
messages are CANopen emergency messages. If Enable checkbox is selected EMCY window
readings will periodically refresh. Period of reading values is set in ms. Clear history button will
clear EMCY messages window. EMCY message information has Time, Node-ID, Error code and
Description. For detailed error description read device user manual and chapter with errors and
warnings.
NOTE: EMCY message time is application (computer) time of reading EMCY and not the time when error appeared
on device.
Status bar
Status bar shows basic information about connection status and errors related to
communication or device status (for example connection status and EMCY message reception).
NOTE: It is assumed that reader is familiar with CAN open protocol. For this reason, only basic information
needed for reading and using this user manual is provided.
NOTE: For future connections to same device this procedure/steps can be skipped if project was already saved
(menu File->Save project). In such cases only Load project is needed (menu File->Load project)
Step 1: Select menu Network -> Connection -> select Automatic connecting
NOTE: For manual connection read emDrive Configuration user manual chapter.
NOTE: If ID number of devices is known, ID can be entered manually and device status is just checked with
Refresh.
After these steps device dictionary structure is visible in SDO browser. Meaning and usage of
individual parameters is not described in this user manual.
For testing and demonstration purposes emDrive Auxiliary components (CAN, Sensor feedback,
Throttle, Brake, FWD, REV, ...) or Emsiso Connection Box can be used. Connection Box was
designed to simplify first usage of emDrive and to speed up emDrive integration into customer
application. In this chapter basic information about available controls and connectors for
Connection Box is provided.
LED 1 LED 2 LED 3
Table 9-5: Connection Box SSI MASTER DB9 Female connector pinout
Pin Name Description
1 / Not connected
2 SSI CLK+ SSI sensor clock
3 SSI CLK- SSI sensor clock
4 / Not connected
5 VCC (+5 V) Sensor power supply
6 SSI DATA+ SSI sensor data
7 SSI DATA- SSI sensor data
8 NTC Motor temperature
9 GND Ground
Table 9-6: Connection Box SSI SLAVE DB9 Female connector pinout
Pin Name Description
1 / Not connected
2 SSI CLK+ SSI sensor clock
3 SSI CLK- SSI sensor clock
4 / Not connected
5 / Not connected
6 SSI DATA+ SSI sensor data
7 SSI DATA- SSI sensor data
8 NTC Motor temperature
9 GND Ground
Table 9-7: Connection Box EXT HALL DB9 Female connector pinout
Pin Name Description
1 GND Ground
2 VCC (+5 V) Sensor power supply
3 / Not connected
4 HALL 1 HALL sensor feedback 1
5 HALL 2 HALL sensor feedback 2
6 HALL 3 HALL sensor feedback 3
7 / Not connected
8 / Not connected
9 / Not connected
Before using emDrive controller with motor it needs to be configured i.e. controller parameters
set to specific configuration and usage (motor type, temperature sensor type, position sensor
type, Auxiliary components, application type, …). Some configuration steps deepens on
emDrive controller interfacing option.
emDrive
Configurator Potentiometers, switches
External
Master
Device
CANOpen
For configuring the emDrive in different interfacing options follow the steps in table below. The
individual setting guidance can be found within chapter 13.1.
In case of interfacing emDrive with external master device with CANOpen connectivity, the
parameters can be set using NMT controls and SDO services. However we advise that due to
the simplicity and visualization features the initial setting are done with emDrive configurator
(emDrive USB to CAN interface card required).
NOTE: Traction battery protections are based on total battery voltage measurement. BMS still should be used to
monitor and protect individual cell.
Secondary current protection protects motor and controller power stage from overcurrent; the
protection is measured based.
Secondary current protection current in mARMS units is set at object 0x2051. If measured
current is above the secondary current protection parameter setting, the power stage is
disabled and error flag (0x2220) is set in error code object 0x603F. The red LED is turned on
indicating error state.
Secondary current protection is usually set to 10 % higher value than Maximum controller
current.
Motor rated current is parameter used for setting request motor torque current (iq) in regard
to torque command input Target Torque (0x6071) in torque mode operation.
Motor rated current in mARMS units is set at object 0x6075. The requested current in torque
mode is defined with following equation:
𝑇𝑎𝑟𝑔𝑒𝑡 𝑇𝑜𝑟𝑞𝑢𝑒
𝑖𝑞𝑟𝑒𝑞 = 𝑀𝑜𝑡𝑜𝑟 𝑟𝑎𝑡𝑒𝑑 𝑐𝑢𝑟𝑟𝑒𝑛𝑡
1000
Motor rated torque parameter at object 0x6076 is defined by device profile CiA DSP 402. For
emDrive devices this parameter is set to the same value as motor rated current.
Controller can protect motor from overheating if motor temperature sensor is connected. The
protection is set under Motor temperature config object 0x2057 and its sub-indexes. By default
controller support NTC10k, KTY84-130 and KTY81-210 sensor type (0x2057 0x01). The
NOTE: If motor temperature sensor is not used or it is disabled within parameter setting, then motor thermal
protection is not in function.
NTC 10k
140
Motor temperature object value (°C)
130
120
110
100
90
80
70
60
50
40
30
20
10
0
0 2000 4000 6000 8000 10000 12000 14000
Resistance ()
KTY 84-130
150
Motor temperature object value (°C)
140
130
120
110 y = -7E-05x2 + 0,3072x - 131,64
100
90
80
70
60
50
40
30
20
10
0
500 600 700 800 900 1000 1100 1200 1300 1400
Resistance ()
Fig. 10-3: R-T charachteristic for KTY 84-130 with 2nd order polyinomical function aproximation
KTY 81-210
150
Motor temperature object value (°C)
140
130
120
110
100 y = -2E-06x2 + 0,0658x - 99,03
90
80
70
60
50
40
30
20
10
0
1600 1800 2000 2200 2400 2600 2800 3000 3200 3400 3600 3800 4000 4200 4400
Resistance ()
Fig. 10-4: R-T charachteristic for KTY 81-210 with 2nd order polyinomical function aproximation
NOTE: Auto align procedure should be done at no – loaded motor (motor can spin freely).
NOTE: Auto align procedure should be done at PMSM motor type; 0x2034 = 0.
NOTE: If unsure about other emDrive parameters it is advised to clear/reset all parameters before starting.
Select menu Device -> Set parameters to default (Ctrl + D). If emDrive was already configured and only Auto
align procedure needs to be repeated then skip clear/reset step.
DANGEROUS: In case of wrong parameter settings software protection functions may not work. This may lead
to damage of EDS elements (motor, emDrive, battery, fuse, …)..
If there is no error than the auto align was successful and mode of operation (0x6060) is set
automatically to value 10 (torque mode). The measured offset is stored under parameter
Motor phase offset at 0x2040 0x02.
In case of any error in auto align procedure the error code is set to 0xFF0B (motor feedback);
for solving error refer to chapter warnings and errors. Repeat the auto align procedure unit
successfully finished.
For solving warning issue refer to chapter warnings and errors.
Fig. 10-7: Timing diagram for RM44AC sensor from RLS (picture source: www.rls.si)
Fig. 10-8: Sin/cos type positon sensor; raw data and electrical angle
Fig. 10-9: Hall type position sensor; raw data and electrical angle
In figure below motor velocity is shown. Due to low angle measurement resolution also velocity
resolution is low. Low velocity resolution can cause problems when emDrive is operating in
velocity mode. Therefore we advise to use Hall type positon sensor only in torque mode.
Angle = 0
Yellow – excitation
Measured between exc+ (pin 20) and exc- (pin 21)
0x60F6 0x01
0x60F6 0x02
isb -
0x201B 0x02 -
d, q 2
0x60F6 0x03
0x201C 0x01 + +
0 P 0x201C 0x03
- +
0x60F6 0x04
0x201C 0x02
In example below current control responses are shown at three different settings for P and I
gains.
Response at settings P = 2000 and I = 50; steady state error to large. Unsuitable response.
Response at settings P = 3000 and I = 4500; actual torque current overshoots, actual torque
current response is to stiff. Unsuitable response.
Response at settings P = 1800 and I = 1100; actual torque current does not over shoots, steady
state error is zero, response not to stiff. Suitable response.
Torque regulator response at P = 2000 and I = 50 Flux regulator response at P = 2000 and I = 50
Torque regulator response at P = 3200 and I = 4500 Torque regulator response at P = 3200 and I = 4500
Torque regulator response at P = 1800 and I = 1100 Flux regulator response at P = 1800 and I = 1100
Fig. 10-15: Current control responses at different P and I gain settings
Fig. 10-16: Slider configuration for setting Motor phase offset compensation
Copyright © Emsiso d.o.o. Rev. 2.2
www.emsiso.com
www.emdrive-mobility.com All rights reserved.
emDrive Motor Controllers User Manual
73I P a g e
In case that the motor is installed in test-bench setup with torque measurement equipment
the alternative procedure is to set id current to zero. At velocity 80 to 90% of base velocity the
nominal torque current iq is applied and Motor phase offset compensation parameter is set to
the value where maximal torque is produced.
In case that the motor is installed in test-bench setup with torque measurement equipment
the alternative procedure is to spin the motor at velocity 80 to 90% of base velocity with load
machine. Then flux current id is set to 50 % of nominal current while torque current is set to
zero; no torque should be produced. If torque is produced then adjust Motor phase offset
compensation parameter 0x2040 0x08.
Fig. 10-18: Slider and Watch window configuration for setting FOC calculation delay compensation
POWER
STAGE
0x60F9 0x01 PWM Ph1
0x60F9 0x02
Ph2 MOTOR
+ LIMITER Ph3
0x60FF 0x201A 0x201B 0x01 TORQUE
and x
- PI CONTROL
SCALING
Positon
Sensor
0x2050
0x6075 C2Q
1000
Positon
0x606C
to
Velocity
0x2050
0x6075
0x60F9 0x01
Reference velocity
Target velocity 0x60FF + +
- Slider input P 0x201A
- +
- Numeric input
- CAN message 0x60F9 0x02
0x606C
Fig. 10-22: Velocity control related object in Watch Window and Slider
Load applied
Setting P gain at: Setting I gain at: Setting P gain in order to improve
I gain = 0 P gain = 1000 response to applied load
unloaded motor unloaded motor
+
𝑖𝑑 = 𝑓 𝑖𝑞
+ 𝑖𝑑
+ + 3
0x201D 0x10
0x201D 0x0C
0x201D 0x0D
𝑖𝑞
d, q
0x201D 0x0B 0x201D 0x0E +
%2Q
- PI
0x201D 0x14
+ -
AWG
0x201D 0x0F
𝑥 2 + 𝑦2
Table 10-8: IPM MTPA and Field weakening (Output voltage control) related object
Object Object name Description Unit
0x2034 Motor type For enabling control set motor type to IPM motor type -
(set to value 2).
0x201D 0x01 PMSM flux mode Set to value 0. -
0x201D 0x0B Field weakening point Reference output voltage; usually set to 85%. %
0x201D 0x0C Field weakening regulator P gain Proportional gain for voltage control. -
0x201D 0x0D Field weakening regulator I gain Integral gain for voltage control. -
0x201D 0x0E Field weakening regulator requested Reference output voltage scaled to quants. quants
0x201D 0x0F Field weakening regulator actual Actual output voltage. quants
0x201D 0x10 Field weakening regulator out Field weakening reference current. Arms
0x201D 0x14 Field weakening regulator flux gain Antiwindup gain for voltage control. -
antiwindup int
0x201D 0x18 MTPA Polynom a2 Polynom coefficients for defining IPM MTPA
0x201D 0x19 MTPA Polynom a1 Coefficient internally divided by 1/10 000.
0x201D 0x1A MTPA Polynom a0 For surface mount magnet type motor all coefficients
are set to zero.
Remarks:
%2Q – constant for scaling reference voltage from % to quants
AWG – antiwindup gain for voltage control.
The IPM MTPA is realized with 2nd order polynomic function defined as:
𝑖𝑑 = 𝑓 𝑖𝑞 = 𝑎2 𝑖𝑞2 + 𝑎1 |𝑖𝑞 | + 𝑎0
where a2, a1 are polynomic function coefficient. Constant a0 is used for setting flux current
manually. The MTPA data is provided by motor producer.
Example:
From given MTPA current pairs (id and iq) table data provided by motor producer, the curve id
vs. iq is plotted (solid line); Fig. 10-25. The curve can be approximated using 2nd order polynomic
function (dotted line) with coefficients being a2 = - 0.0022, a1= 0.0023 and a0=0.
Because the coefficients are internally divided by 10000 the IPM MTPA settings are:
• 0x201D 0x18 = -22
• 0x201D 0x19 = 23
• 0x201D 0x1A = 0
For surface mount magnet motor the MTPA point is at id = 0; therefore all coefficient (a2, a1,
a0) are set to zero.
In order to operate in field weakening region the controller output voltage control is used; Fig.
10-24. The output voltage reference i.e. field weakening points is given % (0x201D 0x0B), where
100 % correspond to 0.95 of the controller output voltage. The output voltage (which is output
of FOC current regulators for id and iq i.e. ud, uq) is regulated by outer control loop using PI
controller. The anti-windup feedback gain is added to prevent integration wind-up when the PI
controller output (field weakening part of flux current id) is saturated. The field weakening part
of flux current is added to MTPA flux current. The total flux current is limited to 95 % of maximal
controller current defined at 0x2050. This limitation is hardcoded, therefore cannot be change
by the user. The torque current limitation deepened on total flux current and maximal
controller current. To disable field weakening operation set P, I and anti-windup gain to zero.
Setting field weakening controller gains (P, I, and anti-windup) are set manually with
experiment. For a start the field weakening can be set at 50 % of nominal velocity. The
controller is operating in velocity mode (because velocity effect the output voltage most), with
max reference velocity being set to 50 % of nominal velocity. Velocity ramp parameter (0x60F9
0x03) can be used to insure linear velocity increase. The reference for output voltage control
(Field Weakening point) is step changed for i.e. 45 % to 55 % and back. The output voltage
control response is evaluated. The guidance for evaluating the response are: overshoot should
be minimal, settling time must be shorter than mechanical dynamics, steady-state error is zero,
no oscillations. Firstly I gain and anti-windup gain are set, at P gain being set to zero. In the
example below I gain is changing at anti-windup gain set to 100; Fig. 10-27. The adequate
response is found at I gain being 2000.
Fig. 10-26: Field weakening related object in Watch Window and Slider
Fig. 10-27: Field weakening operation; setting I gain at anti-windup gain = 100, P gain = 0
Then anti-windup gain is increased. At zero velocity (output voltage near zero and below
reference value) field weakening current should be zero. This is true at anti-windup gain being
200; at higher gain values the field weakening “spikes” start to appear; Fig. 10-28.
Fig. 10-28: Field weakening operation; setting anti-windup gain at I gain = 2000, P gain = 0
The most important gains in output voltage control are I gain and anti-windup gain. The
Proportional part is used for improving response time. However the output voltage control is
sensitive to P gain because of “noisy” outputs of flux and torque current control. Therefore P
gain is set to the value where there is no oscillations in field weakening current; Fig. 10-29.
Fig. 10-29: Field weakening operation; setting P gain at I gain = 2000, anti-windup gain = 200
In end application the field weakening is used to increase the motor velocity above base velocity
() or to maintain the velocity at lowering DC link voltage because of battery discharge (). In
shown examples the field weakening point is set to 85 %.
Fig. 10-30: Field weakening operation for increasing velocity above base velocity and to compensate DC link voltage drop
Fig. 10-31: Field weakening operation for compensate DC link voltage drop from 32 V to 22 V
CAN Network
CAN node
Modes of operation
Motor
11.3 Object Dictionary, Electronic Data Sheet and Device Configuration File
One of the most important properties of CANopen is a standardized device description called object
dictionary (OD). It is a table which has the same structure for all types of devices. Thus, it is possible to
access all important data, parameters and functions of a device using a logical addressing system (index,
subindex) via the CAN bus. There are two important text files associated with the Object Dictionary.
These are:
Electronic Datasheet (EDS)
An EDS is a text file representation of the Object Dictionary structure only. It contains no data values.
The EDS is used by configuration software such as »EMSISO eDrive Configurator« to describe the
structure of a node’s Object Dictionary. An EDS for each emDrive controller model and software version,
is available on the device itself and can be also provided by EMSISO company. The EDS file format is
described in the DSP306 – Electronic Data Sheet Specification.
NOTE: Each Object Dictionary matches a particular device and software version. Also, its structure is hardcoded
into the device software.
The default CAN-ID mapping sorts frames by attributing a function code (NMT, SYNC, EMCY,
PDO, SDO...) to the first 4 bits, so that critical functions are given priority.
CAN-ID
Function Code Node ID
Length 4 bits 7 bits
Different types of communication models are used in the messaging between CANopen nodes:
Master/slave: one CANopen node is designated as the master, which sends/requests data
to/from the slaves. The NMT protocol is an example of a master/slave communication model.
Slave is emDrive motor controller.
Client/server: in this relationship the SDO protocol is implemented, where the SDO client sends
data (the object dictionary index and subindex) to an SDO server, which replies with one or
more SDO packages containing the requested data (the contents of the object dictionary at the
given index). SDO server is emDrive motor controller.
Producer/consumer: this model is used in the Heartbeat, Node Guarding and PDO protocols. In
the push-model of producer/consumer, the producer sends data to the consumer without a
specific request, whereas in the pull model, the consumer must request the data from the
producer. Normally, emDrive is in consumer mode.
Initialization
Pre-operational
Stopped
Operational
Upon power-up eDrive (CANopen slave node) comes out of »power-on reset« and goes into
initialization. It initializes the entire application, CAN/CANopen interfaces and communication.
At the end of the initialization the node tries to transmit boot-up message. As soon as it is
transmitted successfully, the node switches to Pre-operational state.
The NMT Protocol is used by the master node (NMT Master message) to individual nodes or all
nodes back and forth between the three major states: Pre-operation, Operational and Stopped.
The NMT protocols are used to issue state machine change commands (e.g. to start and stop
the devices), detect remote device bootups and error conditions.
The Module control protocol is used by the NMT master to change the state of the devices. The
CAN-frame COB-ID of this protocol is always 0, meaning that it has a function code 0 and node
ID is 0, which means that every node in the network will process this message. The actual node
ID, to which the command is meant to, is given in the data part of the message (at the second
byte). This can also be 0, meaning that all the devices on the bus should go to the indicated
state.
The message format is:
COB-ID (11 bits) RTR Data length Data Byte 0 Data Byte (1)
0x000 0 2 NMT Command (Request state) Addressed node
NMT Command Meaning
0x01 Enter Operational
0x02 Enter Stop
0x03 Enter Pre-operational
0x81 Reset node
0x82 Reset communication
The protocols/functions available in different states are listed in Table 11-1.
State
Function Stopped Pre-operational Operational
NMT Yes Yes Yes
GUARD Yes Yes Yes
EMCY No Yes Yes
SYNC No Yes Yes
TIMESTAMP No Yes Yes
SDO No Yes Yes
PDO No No Yes
SDO Server
SDO Client Object Dictionary
CAN
SDO protocol always confirms the read/write operation. If the data to be read/written is 4 bytes
or less than expedited packet can be used (one transmit and one confirm receive is necessary).
SDO Read
The message from SDO client for initiate SDO upload service (read data) is structured as:
COB-ID RTR Data Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7
length
0x600 + 0 8 Command OD Index OD Sub - Zeros
node ID Index
Command Meaning
0x40 Read Dictionary Object
Example:
Use SDO Read to get value for Current control torque regulator P gain (0x60F6 0x01). The data
type of this parameter is int16 (2 bytes). The controller Node ID is set to 1.
SDO Write
The message from SDO client for initiate SDO download service (write data) is structured as:
COB-ID RTR Data Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7
length
0x600 + 0 8 Command OD Index OD Sub - Data
node ID Index
Command Meaning
0x23 Write Dictionary Object reply,
expedited, 4 bytes sent
0x27 Write Dictionary Object reply,
expedited, 3 bytes sent
0x2B Write Dictionary Object reply,
expedited, 2 bytes sent
0x2F Write Dictionary Object reply,
expedited, 1 byte sent
Example:
Use SDO write to set value for Current control torque regulator P gain (0x606F 0x01) to 1500.
The data type of this parameter is int16. Use additional SDO write to save parameters using
Store Parameter Field Save all Parameters object (0x1010 0x01).
Step 3: Use NMT command to Reset or switch OFF/ON logic power supply
COB-ID Data Byte 0 Byte 1
length
0x000 2 81 01
Step 4: Use SDO Read message to verify the parameter gain value:
COB-ID Data Byte 0 Byte 1 Byte 2 Byte 3 Byte 4 Byte 5 Byte 6 Byte 7
length
0x601 8 40 F6 60 01 00 00 00 00
The TX PDO is set by two Object Dictionary entries 0x1Axx and 0x18xx. The RX PDO is set by two
Object Dictionary entries 0x16xx and 0x14xx. The formats of the 0x1Axx and 0x16xx entries are
identical and they need to be a matched pair between the transmitting and receiving nodes.
PDO mapping
The PDO mapping configuration registers 0x1Axx (for TX PDO) and 0x16xx (for RX PDO) specify
which object dictionary entries will be exchanged with the PDO message. Mapping is possible
only for those object dictionary entries whose mapping is enabled with EDS.
Up to 8 configuration bytes are available, but the total amount of data they specify must be 8
bytes or less.
An example for reading controller DC link voltage, controller temperature and DC capacitor
temperature. The OB entities with data types are:
• DC link voltage 0x6079 0x00, int16 (2 bytes data)
• Controller temperature 0x2026 0x01, unsigned 8 (1 byte data)
• Capacitor temperature 0x2026 0x02, unsigned 8 (1 byte data)
The length of all data is 4 bytes therefore using one Transmit PDO is sufficient. The content of
0x1A00 is:
• 0x1A00 0x00: 3 (because 3 process data are mapped)
• 0x1A00 0x01: 0x60790010 (mapping 0x6079 0x00, data length 16 bits 16dec = 10hex)
• 0x1A00 0x02: 0x20260108 (mapping 0x2026 0x01, data length 8 bits 8dec = 8hex)
• 0x1A00 0x03: 0x20260208 (mapping 0x2026 0x01, data length 8 bits 8dec = 8hex)
The object dictionary entries 0x18xx (TX) and 0x14xx (RX) specify the COB-ID of TX and RX
nodes, and different parameters on TX side defining when the PDO messages are transmitted
(COB-ID, Transmission type, Inhibit Time (ms), Compatibility Entry, Event Timer (ms), SYNC start
value).
At asynchronous transmission type 254 and 255 the PDO message is transmitted when mapped
data changes. With Inhibit time maximal update rate is set. The Event timer is used to make
asynchronous PDO transmit at given rate when timer expire, thus Event timer set minimum
update rate.
Cyclic Synchronous PDOs are transmitted with the SYNC message (periodical transmit). In fact,
the SYNC message causes all nodes with Synchronous PDOs configured to sample their inputs
and store the data, the actual data is transmitted on the next SYNC message.
With Acyclic Synchronous transmission type the PDOs are transmitted only when a Remote
request from another device ‘pre-triggers’ the PDO or a device (profile) specific event ‘pre-
triggers’ the PDO.
6. Save parameter
7. Reset device
8. Set device in operational mode and device is ready to send TPDO according to transmission
type settings
Example:
Controller is working in torque mode. Configure RX PDO to send torque command to the
controller. Configure TX PDO’s to receive the following data from the controller: controller
temperature, controller DC link capacitor temperature, DC link voltage, velocity, warning, and
error status. The controller node ID is set to 1.
Mapping RX PDO 1:
Before setting RX PDO make sure to disable communication and disable mapping.
Mapping Target Torque 0x6071 0x00 (2 bytes)
Object Object name Value Meaning
0x1600 0x00 Number of entries 1 Receiving one data package
0x1600 0x01 PDO Mapping Entry 0x60710010 Mapping Target Torque
Mapping TX PDO 1:
Before setting TX PDO make sure to disable communication and disable mapping.
Mapping Controller temperature 0x2026 0x01 (1 byte)
Mapping Capacitor temperature 0x2026 0x02 (1 byte)
Mapping DC link circuit voltage 0x6079 0x00 (2 bytes)
Mapping Velocity actual value 0x606C 0x00 (4 bytes)
Note that warning and error status is not possible to map within TX PDO 1, because data
length is full (8 bytes). Use TX PDO 2 to map warning and error status.
Object Object name Value Meaning
0x1A00 0x00 Number of entries 4 Transmitting four data packages
0x1A00 0x01 PDO Mapping Entry 0x20260108 Mapping Controller temperature
0x1A00 0x02 PDO Mapping Entry 0x20260208 Mapping Capacitor temperature
0x1A00 0x03 PDO Mapping Entry 0x60790010 Mapping DC link circuit voltage
0x1A00 0x04 PDO Mapping Entry 0x606C0020 Mapping Velocity actual value
Mapping TX PDO 2:
Mapping Warnings 0x2027 0x00 (2 bytes)
Mapping Error code 0x603F 0x00 (2 byte)
Object Object name Value Meaning
0x1A01 0x00 Number of entries 2 Transmitting two data packages
0x1A01 0x01 PDO Mapping Entry 0x20270010 Mapping Warnings
0x1A01 0x02 PDO Mapping Entry 0x603F0010 Mapping Error code
Disabling TX PDO 3:
Object Object name Value Meaning
0x1802 0x01 COB ID 0x800000000 Disabling TX
After Save and Reset the parameter value is read as 0x80000001.
Disabling TX PD0 4:
Object Object name Value Meaning
0x1803 0x01 COB ID 0x800000000 Disabling TX
After Save and Reset the parameter value is read as 0x80000001.
NMT: EnterPre-operational
NMT: Enter Operational
SDO Write: ControlWord = 6
Start
Not ready to
switch on
1
15
Switch on Fault
disabled
2 7 14
Ready to 13 Fault reaction
12 10
switch on active
3 6
Switched on
8 9
4 5 Power-off or reset
Quick stop Operation
active 11 enabled
Wiring example shown on figure below represents basic application for electric drivetrain.
Functionalities of electric drivetrain are:
• Switch for enable/disable controller (Ignition)
• Switch for direction (forward and reverse)
• Potentiometer for throttle setting
• Potentiometer for brake settings
• CAN for connection with emDrive Configurator (USB/CAN interface), used for setting
the parameters.
NOTE: Read and apply instructions found in other chapters since Pre-charge, Discharge, Fuses, Contactors,
Earthing, etc. are not shown in basic wiring example!
NOTE: Special attention must be paid to the information found in chapter’s safety and connection sequence
described in this manual!
W
V
B+
+
The APP1 is part of the software used for constructing simple powertrain, the simplified scheme
is shown in Fig. 12-2. The most basic configuration is one potentiometer (throttle voltage) to
set either requested torque (torque mode) or requested velocity (velocity mode) and two
switches to select desired direction. In addition, software support also braking options,
however braking functionalities are in phase of updating therefore they are not in scope of
following description. Once the APP1 is configured the drive operate without external CAN
communication.
The output of APP1 is always requested torque for lower level software where FOC Torque
Control is running. Therefore, the object Modes of operation must always be set to torque
control (0x6060 = 10). The data between software layers (APP1 layer and FOC Torque control
layer) are exchanged using PDO messages, therefore PDO messages in APP1 cannot be
modified.
For APP1 operating in torque mode object APP1 Control Mode 0x3001 0x01 is set to value 1. In
this case the Throttle voltage is directly scaled to Target torque command.
For APP1 operating in velocity mode object APP1 Control Mode 0x3001 0x01 is set to value 2.
In this case the Throttle voltage is scaled to velocity request command for APP1 velocity control
implemented with PI control. The parameters for APP1 PI velocity controller are set under the
object 0x3004. The output of velocity controller is Target torque command.
In following subchapters settings for torque and velocity mode at different throttle input types
are described. Before setting APP1 steps 1,2, 3, 4, 5 and 7 (optional) given in Table 10-1 must
be done.
0x3003
0x0A:0x10
SCALING
0x3004 Layer: Application1
+
0x3001
PI 0x01
-
DIRECTION
Velocity act. value avg.
and
DRIVE ENABLE
Throttle voltage
Target torque
0x2070 0x01
Controlword
0x2087
0x6071
0x6040
Positon
Sensor
0x3003: 0x0A
0x0B
0x0C
0x0F 0x3003: 0x01
0x10 0x02
+5V
Throttle voltage
Analog IN
Digital inputs
Digital IN
0x2076 Controlword
DRIVE ENABLE
0x6040
Fig. 12-3: Simplified torque request scheme of Application 1 – potentiometer unipolar throttle
Table 12-1: Settings for APP1; torque mode with potentiometer unipolar throttle
When parameters are set, application must be enabled by writing 1 to Select application object.
Put throttle command in zero request position and forward/reverse switch to off position.
After that Save the parameters and Reset the controller.
Right after reset controller will go into Operational state. For enabling drive mode turn on enable switch and
add throttle command to spin the motor.
0x3003: 0x0A
0x0B
0x0C
0x0D
0x0E
0x0F
0x10
+5V
Throttle voltage
Analog IN
Controlword
DRIVE ENABLE
0x6040
Fig. 12-5: Simplified torque request scheme of Application 1 – potentiometer bipolar throttle
Throttle voltage
Throttle voltage/Target torque function
Table 12-2: Settings for APP1; torque mode with potentiometer bipolar throttle
When parameters are set, application must be enabled by writing 1 to Select application object.
Put throttle command in zero request position and forward/reverse switch to off position.
After that Save the parameters and Reset the controller.
Right after reset controller will go into Operational state. For enabling drive mode turn on enable switch and add
throttle command to spin the motor.
0x3003: 0x0A
0x0B 0x3003: 0x01
0x0C 0x02
Digital inputs
Digital IN
0x2076 Controlword
DRIVE ENABLE
0x6040
Fig. 12-7: Simplified torque request scheme of Application 1 – Servo PWM throttle
Table 12-4: Settings for APP1; torque mode with Servo PWM throttle
When parameters are set, application must be enabled by writing 1 to Select application object.
Put throttle command in zero request position and forward/reverse switch to off position.
After that Save the parameters and Reset the controller.
Right after reset controller will go into Operational state. For enabling drive mode turn on enable switch and
add throttle command to spin the motor.
0x2076 Controlword
DRIVE ENABLE
0x6040
Fig. 12-9: Simplified velocity control scheme of Application 1 – potentiometer unipolar throttle
(0x2070 0x01)
Table 12-5: Settings for APP1; velocity mode with potentiometer unipolar throttle
When parameters are set, application must be enabled by writing 1 to Select application object.
Put throttle command in zero request position and forward/reverse switch to off position.
After that Save the parameters and Reset the controller.
Right after reset controller will go into Operational state. For enabling drive mode turn on enable switch and
add throttle command to spin the motor.
Throttle voltage
Analog IN
Controlword
DRIVE ENABLE
0x6040
Fig. 12-11: Simplified velocity control scheme of Application 1 – potentiometer bipolar throttle
(0x2070 0x01)
Throttle voltage
Throttle voltage/Reference velocity function
Table 12-6: Settings for APP1; velocity mode with potentiometer bipolar throttle
When parameters are set, application must be enabled by writing 1 to Select application object.
Put throttle command in zero request position and forward/reverse switch to off position.
After that Save the parameters and Reset the controller.
Right after reset controller will go into Operational state. For enabling drive mode turn on enable switch and
add throttle command to spin the motor.
0x3003: 0x0A
0x0B 0x3003: 0x01
0x0C 0x02 0x3004
PWM Pulse Width
Analog IN
0x2076 Controlword
DRIVE ENABLE
0x6040
Fig. 12-13: Simplified velocity control scheme of Application 1– Servo PWM throttle
Table 12-7: Settings for APP1; velocity mode with Servo PWM throttle
When parameters are set, application must be enabled by writing 1 to Select application object.
Put throttle command in zero request position and forward/reverse switch to off position.
After that Save the parameters and Reset the controller.
Right after reset controller will go into Operational state. For enabling drive mode turn on enable switch and
add throttle command to spin the motor.
For selecting the drive mode, external circuit as shown on picture below is required. Based on
switch SW position (1, 2, 3) the 0 V, 2.5 V or 5 V is applied to pin 22. Pin 22 is primarily used for
sin/cos type position sensor; therefore, driving modes functionality is not possible if sin/cos
type position sensor in used. The value on pin 22 in mV is shown in object Analog inputs Aux
voltage (0x2070, 0x02). To enable driving modes option set parameters according to Table
12-9.
If driving modes are not enabled (0x3006 0x01 = 0), then default mode is Sport mode.
+5V
4k7
3 (Sport) SW
2 (Eco) SIN/COS (SIN), pin22
1 (Normal)
4k7
Fig. 12-15: External circuit for selecting different driving modes (normal, eco, sport)
13.2 Warnings
To check emDrive controller warning status select SDO Browser and search for object 0x2027 -
Warnings and read object value. Warnings are organized in bit type form. This means that read
value must be decoded. For example, decimal value of object 0x2027 is 6. First convert object
value to binary value (6decimal = 0110binary) and then check in table below for active bits. Least
significant bit is right-most bit and represents bit 0 in table below. This means that for example
(value 6) bit 1 and bit 2 have active warning status (Motor temperature exceeded and DC link
under voltage). The warnings values are listed in Table 13-2.
When warning is active the controller output current is reduced.
13.3 Errors
To check emDrive controller error status select SDO Browser and search for object 0x603f -
Error_code and read object value. The error values are listed in Table 13-3 - Table 13-5.
When error is active the controller power stage is disabled. In case that error was active and
error cause was removed emDrive controller will stay in error state until controller reset is not
done
14 How to set
15 References
http://www.byteme.org.uk/canopenparent/canopen/sdo-service-data-objects-canopen/