Serial Protocol

A custom serial communication protocol is used to send commands over USB and I2C to the ECU-P hardware and reading back a response.

General Format and Checksum

Every communications starts with a Command being sent to the ECU-P hardware. The ECU-P then will try to execute the received command and always send a single Respone message . The ECU-P hardware never initialize communication.

Message Structure

The structure of Command and Respone messages follow this general format:

General Message Structure

Byte Number

0

1

2

N - 2

N - 1

Value

N

D0

D1

CRC16 & 0xFF

CRC16 >> 8

Description

total length in

bytes. Max. 32

message data

CRC16 lower byte

CRC 16 upper byte

checksum

The length of the entire message (including the length byte and checksum) is transmitted first. The maximum allowed message length is 32. Given that, the maximum data length in a single message is 29.

Any 2-byte values encoded in the message data and the checksum follow little-endian byte order.

Checksum

A 2-byte checksum is transmitted. The lower byte is transmitted first, then the upper byte completes the message. The checksum is calculated over the whole previous data, including the first total length byte.

The 16 bit checksum used is CRC16 (CCITT-16), inital value 0 and polynomial 0x1021 (x16 + x12 + x5 + 1). This checksum is implemented in Python for example in binascii.crc_hqx(data, 0).

For example the byte sequence of 0x05, 0x01, 0x3F results in a checksum value of 0x1F7D, so the first byte to append to the message is 0x7D and the second byte is 0x1F.

Example Message with Checksum

Byte Number

0

1

2

3

4

Value

0x05

0x01

0x3F

0x7D

0x1F

Description

length

message data

checksum

USB Communication

Connecting to the ECU-P hardware uses a USB-to-Serial convert chip: CP2102N from Silicon Laboratories. This chip requires a USB driver being installed on the USB host side (Desktop PC, Laptop etc.). The driver is offered by SiLabs on their download page. Short instructions on how to install the driver can be found in the Getting Started guide.

The serial port needs to be opened with these parameters:

Baudrate:

1000000 (1 million symbols / second)

Data bits:

8

Parity:

None

Stop bits:

1

Flow Control:

None

or in short 1000000 baudrate 8N1.

A transaction start with the USB host sending the command message. As soon as the last byte is received, the ECU-P hardware processes the commands and tries to execute it. If a command message is not fully transmitted, the ECU-P hardware waits for completion for 50ms. Bytes received after this timeout are assumed to be a new command message.

The ECU-P hardware then transmits the response message. During transmission of the response no new commands are allowd to be send to the ECU-P hardware.

Once the response message has been fully transmitted, the ECU-P hardware is ready to receive the next command.

Command Structure

Commands sent to the ECU-P hardware extend the General Message format and define further bytes in the message. The structure follow the following format:

Command Structure

Byte Number

0

1

2

3

4

N - 2

N - 1

Value

N

ID

MODE

D0

D1

CRC16

Description

length

command

identifier

0x21 write mode,

0x3F read mode

command data

if any

checksum

The first byte transmitted is the total length of the message (including this byte and the checksum).

Which command is to be executed is transmitted as a unique command identifier (ID) in the second byte of the message. Not all commands are supported by each ECU-P hardware. Some commands are only available on some hardware.

A command can either be a write or a read command. This is specified by the third byte: 0x21 is transmitted for write mode, 0x3F for read mode. Some commands only support write mode, some only read mode and some commands support both.

Then follows data for the specific command. The length of this data depends on the command identifier and mode. Some commands do not allow any data at all, some only require data for read mode or vice versa. The data length in write mode is not the same when in read mode.

At the end the checksum is transmitted.

Response Structure

Responses from the ECU-P hardware (after receiving a Command message) extend the General Message format and define further bytes in the message. The structure follow the following format:

Response Structure

Byte Number

0

1

2

3

4

N - 2

N - 1

Value

N

ID

STATUS

D0

D1

CRC16

Description

length

command

identifier

0x2B success,

0x2D error

response data if

any or error code

checksum

The first byte transmitted is the total length of the message (including this byte and the checksum).

The second byte transmitted is the command identifier (ID) of the received command this response is for.

The third by returns the status (STATUS) of the received command: 0x2B is sent if the received command was executed successfully, 0x2D is transmitted if an error occured during command execution.

Then follows the response data if any in case the command was executed successfully (STATUS=0x2B). Some commands do not return any response data. The length of the response data depends on the command identifier and the mode. In case an error occured during command execution (STATUS=0x2D) the response data will contain exactly one byte, the Error Code.

At the end the checksum is transmitted.

Error Codes

In case the command could not be executed successfully by the ECU-P hardware an error response will be send by the harwdare. This error response extends the Response Structure and has the following format:

Error Response Structure

Byte Number

0

1

2

3

4

5

Value

0x06

ID

0x2D

ERROR CODE

CRC16

Description

length

command

identifier

error

status

error

identifier

checksum

The following error identifiers (ERROR CODE) values are defined:

0x01 CHECKSUM

The checksum in the transmitted command did not match the data in the command.

0x02 UNKNOWN_COMMAND

An unkown command identifier was transmitted. Be aware that support for some commands depend on the hardware.

0x03 WRONG_MODE

The mode selection byte in the command was not valid.

0x04 READ_ONLY

The transmitted command is read-only and cannot be in write-mode.

0x05 WRITE_ONLY

The transmitted command is write-ony and cannot be in read-mode.

0x06 WRONG_DATA_LENGTH

The command data did not match the expected length for this command and selected mode.

0x07 WRONG_CHANNEL

The specified channel in the command data is not valid.

0x08 CALIBRATION_LOCKED

Writing calibration failed because the the calibration is locked. Sending the unlock command first is required.

0x09 AUTOMATIC_MODE

The hardware is in automatic mode. Some commands changing the output are not allowed. They require switching to manual mode first.

0x0A STATEMACHINE_WRONG

The transmitted statemachine byte stream was not valid.

0x0B OUT_OF_RANGE

The range specified in the command data was not valid.

0x0C I2C_TRANSFER_FAILED

The I2C transaction failed.

Command Overview

Overview of all commands

ID

Name

Read

Write

0x01

DEVICEID

yes

no

0x02

FIRMWARENAME

yes

no

0x03

FIRMWAREVERSION

yes

no

0x04

DEVICEUUID

yes

no

0x05

ENTERBOOTLOADER

no

yes

0x06

RESET

no

yes

0x07

ENABLE

yes

yes

0x08

SETPOINT

yes

yes

0x09

PROCESSVALUE

yes

no

0x0A

VOLTAGE

yes

no

0x0B

RESISTANCE

yes

no

0x0C

INPUTCURRENT

yes

no

0x0D

INPUTCURRENTMAX

yes

no

0x0E

MODE

yes

yes

0x0F

MODECONFIGURATION

yes

yes

0x10

STATEMACHINECONFIGURATION

yes

yes

0x11

MONITORINGCONFIGURATION

yes

yes

0x12

CCSOURCECONFIGURATION

yes

yes

CCSOURCECONFIGURATION V2

0x13

DACCALIBRATION

yes

yes

0x14

ADCCONFIGURATION

yes

yes

0x15

ADCCURRENTCALIBRATION

yes

yes

0x16

ADCINPUTCURRENTCALIBRATION

yes

yes

0x17

ADCVOLTAGECALIBRATION

yes

yes

0x18

PUSHBUTTONCONFIGURATION

yes

yes

0x19

I2CCONFIGURATION

yes

yes

0x1A

UNLOCK

no

yes

0x1B

SAVETOEEPROM

no

yes

0x1C

MEASURERESISTANCE

yes

yes

0x1D

CHANNELINFO

yes

no

0x1E

DIGITALOUTPUT

yes

yes

0x1F

VOLTAGESOURCE

yes

yes

0x20

ANALOGINPUT

yes

no

0x21

I2CCONTROLLER

no

yes

0x22

I2CCONTROLLERSPEED

no

yes

Identify Commands

These commands can be used to identify specific products and their revision. Reading also the unique identifier to differentiate units of the same type.

DEVICEID

ID:

0x01

Read supported:

True

Write supported:

False

Get several identifiers of ECU-P hardware. The values returned depend on the specific memetis product and revision. There is a list of hardware and their supported commands.

  • Read Mode
    Command data length:

    0

    Command DEVICEID

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x01

    0x3F

    0x7D

    0x1F

    Response data length:

    4

    DEVICEID:

    identifier of mircocontroller family

    DERIVID:

    identifier for specific microcontroller within family

    REVID:

    identifier for microcontroller harwdare revision

    HARDWAREID:

    memetis product identifier

    Response DEVICEID

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    Value

    0x09

    0x01

    0x2B

    DEVICEID

    DERIVID

    REVID

    HARDWAREID

    CRC16

FIRMWARENAME

ID:

0x02

Read supported:

True

Write supported:

False

Get the name of the firmware running on this ECU-P. The respone has no fixed length because the firmware name has a variable length across differnt hardware.

  • Read Mode
    Command data length:

    0

    Command FIRMWARENAME

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x02

    0x3F

    0x2E

    0x4A

    Response data length:

    variable, depends on the firmware name to be transmitted

    FIRMWARENAME:

    name of the firmware running on this ECU-P, encoded in ASCII

    Response FIRMWARENAME

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    N - 2

    N - 1

    Value

    N

    0x02

    0x2B

    FIRMWARENAME

    CRC16

FIRMWAREVERSION

ID:

0x03

Read supported:

True

Write supported:

False

Get the version of the firmware running on this ECU-P. The respone has no fixed length because the firmware version can have a variable length across differnt hardware.

  • Read Mode
    Command data length:

    0

    Command FIRMWAREVERSION

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x03

    0x3F

    0x1F

    0x79

    Response data length:

    variable, depends on the firmware version to be transmitted

    FIRMWAREVERSION:

    version of the firmware running on this ECU-P, encoded in ASCII

    Response FIRMWAREVERSION

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    N - 2

    N - 1

    Value

    N

    0x03

    0x2B

    FIRMWAREVERSION

    CRC16

DEVICEUUID

ID:

0x04

Read supported:

True

Write supported:

False

Get the universally unique identifier (UUID) of this ECU-P unit. The UUID identifies specific units of the same memetis product.

  • Read Mode
    Command data length:

    0

    Command DEVICEUUID

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x04

    0x3F

    0x88

    0xE0

    Response data length:

    16

    UUID:

    128 bit universally unique identifier

    Response FIRMWAREVERSION

    Byte Number

    0

    1

    2

    3

    4

    5

    18

    19

    20

    Value

    0x15

    0x04

    0x2B

    UUID

    CRC16

General Commands

These commands affect all channels at the same time and are not related to changing factory settings.

RESET

ID:

0x06

Read supported:

False

Write supported:

True

Reset the unit to it’s power up state. This is equivalent to turning the power off and back on again.

  • Write Mode
    Command data length:

    0

    Command RESET

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x06

    0x21

    0x15

    0x75

    Response data length:

    0

    Response RESET

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x06

    0x2B

    0x5F

    0xD4

MODE

ID:

0x0E

Read supported:

True

Write supported:

True

Read the current mode or set a new mode. Currently only two modes are available:

automatic mode

Outputs can only be enabled/disabled, the output current profile etc. cannot be changed. The behaviour is defined by the statemachine configuration.

manual mode

Full control over outputs, like changing output current etc. The statemachine configuration is not used.

  • Read Mode
    Command data length:

    0

    Command MODE (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x0E

    0x3F

    0x43

    0x0F

    Response data length:

    1

    MODE:

    0x00 if in automatic mode, 0x01 if in manual mode

    Response MODE (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x0E

    0x2B

    MODE

    CRC16

  • Write Mode
    Command data length:

    1

    MODE:

    0x00 to set automatic mode, 0x01 to set manual mode

    Command MODE (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x0E

    0x21

    MODE

    CRC16

    Response data length:

    0

    Response MODE (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x0E

    0x2B

    0xF6

    0x5D

INPUTCURRENT

ID:

0x0C

Read supported:

True

Write supported:

False

Get the input current of the ECU-P. The hardware measures it’s own power consumption and can limit it by automaticall turning off the outputs.

  • Read Mode
    Command data length:

    0

    Command INPUTCURRENT

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x0C

    0x3F

    0x21

    0x69

    Response data length:

    2

    CURRENT:

    in 0.1mA, so 1000 equals 100mA, lower byte transmitted first

    Response INPUTCURRENT

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x0C

    0x2B

    CURRENT

    CRC16

INPUTCURRENTMAX

ID:

0x0D

Read supported:

True

Write supported:

False

Get the maximum allowed input current. On some hardware this depends on the USB power supply used.

  • Read Mode
    Command data length:

    0

    Command INPUTCURRENTMAX

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x0D

    0x3F

    0x10

    0x5A

    Response data length:

    2

    CURRENT:

    in 0.1mA, so 1000 equals 100mA, lower byte transmitted first

    Response INPUTCURRENTMAX

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x0D

    0x2B

    CURRENT

    CRC16

MEASURERESISTANCE

ID:

0x1C

Read supported:

True

Write supported:

True

Get or set resistance measurement mode. If set to 0x00, the resistance will only be measured when the output is enabled. When set to 0x01, the resistance will always be measured. For this the output will be turned on shortly for the measurement. This results in a small output current that is always present.

  • Read Mode
    Command data length:

    0

    Command MEASURERESISTANCE (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x1C

    0x3F

    0x52

    0x6A

    Response data length:

    1

    MEAS:

    0x00 if resistance is only measured when output is enabled, 0x01 if resistance is always measured

    Response MEASURERESISTANCE (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x1C

    0x2B

    MEAS

    CRC16

  • Write Mode
    Command data length:

    1

    MEAS:

    0x00 to only measure resistance when output is enabled, 0x01 to always measure resistance

    Command MEASURERESISTANCE (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x1C

    0x21

    MEAS

    CRC16

    Response data length:

    0

    Response MEASURERESISTANCE (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x1C

    0x2B

    0xE7

    0x38

VOLTAGESOURCE

ID:

0x1F

Read supported:

True

Write supported:

True

Get or set the output voltage of the voltage source. If the value is 0, the voltage source is disabled. The values are in 1mV, so 1000 equals 1V.

  • Read Mode
    Command data length:

    0

    Command VOLTAGESOURCE (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x1F

    0x3F

    0x01

    0x3F

    Response data length:

    2

    VOLTAGE:

    0 means the voltage source is diabled, in 1mV, so 1000 equals 1V, lower byte transmitted first

    Response VOLTAGESOURCE (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x1F

    0x2B

    VOLTAGE

    CRC16

  • Write Mode
    Command data length:

    2

    VOLTAGE:

    0 to disable voltage source, in 1mV, so 1000 equals 1V, lower byte transmitted first

    Command VOLTAGESOURCE (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x1F

    0x21

    VOLTAGE

    CRC16

    Response data length:

    0

    Response VOLTAGESOURCE (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x1F

    0x2B

    0xB4

    0x6D

I2CCONTROLLER

ID:

0x21

Read supported:

False

Write supported:

True

Write and read bytes on the I2C bus as controller.

This is a combined command to first write bytes (if any) to a peripheral, then generating a repeated start condition and then reading back bytes (if any) from the peripheral. If no bytes are to be written the peripheral is only addressed once to read data and vice versa.

  • Write Mode
    Command data length:

    variable, depends on the number of bytes to be transmitted on the I2C bus

    ADDRESS:

    I2C 7-bit address of the peripheral on the I2C bus

    WRITE_LENGTH:

    number of bytes to be written to the peripheral, 0 if data should only be read from the peripheral

    READ_LENGTH:

    number of bytes to be read from the peripheral, 0 if data should only be written to the peripheral

    WRITE_DATA:

    data bytes to be written to the peripheral

    Command I2CCONTROLLER

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    N - 2

    N - 1

    Value

    N

    0x21

    0x21

    ADDRESS

    WRITE_LENGTH

    READ_LENGTH

    WRITE_DATA

    CRC16

    Response data length:

    variable, depends on the number of bytes to be read from the I2C bus

    ADDRESS:

    same as command

    WRITE_LENGTH:

    same as command

    READ_LENGTH:

    same as command

    READ_DATA:

    data bytes read from the peripheral

    Response I2CCONTROLLER

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    N - 2

    N - 1

    Value

    N

    0x21

    0x2B

    ADDRESS

    WRITE_LENGTH

    READ_LENGTH

    READ_DATA

    CRC16

I2CCONTROLLERSPEED

ID:

0x22

Read supported:

True

Write supported:

True

Get or set the I2C controller clock speed.

  • Read Mode
    Command data length:

    0

    Command I2CCONTROLLERSPEED (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x22

    0x3F

    0xC8

    0x4C

    Response data length:

    2

    SPEED:

    clock speed in kbit/s, lower byte transmitted first

    Response I2CCONTROLLERSPEED (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x22

    0x2B

    SPEED

    CRC16

  • Write Mode
    Command data length:

    2

    SPEED:

    clock speed in kbit/s, lower byte transmitted first

    Command I2CCONTROLLERSPEED (write)

    Byte Number

    0

    1

    2

    3

    5

    6

    Value

    0x07

    0x22

    0x21

    SPEED

    CRC16

    Response data length:

    0

    Response I2CCONTROLLERSPEED (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x22

    0x2B

    0x7D

    0x1E

Channel-specific Commands

ENABLE

ID:

0x07

Read supported:

True

Write supported:

True

Read if a channel is currently enabled or enable/disable a channel.

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command ENABLE (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x07

    0x3F

    CH

    CRC16

    Response data length:

    1

    STATUS:

    0x00 if this channel is disabled, 0x01 if it’s enabled

    Response ENABLE (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x07

    0x2B

    STATUS

    CRC16

  • Write Mode
    Command data length:

    2

    CH:

    channel number to set, starting with 1

    STATUS:

    0x00 to disable, 0x01 to enable this channel

    Command ENABLE (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x07

    0x21

    CH

    STATUS

    CRC16

    Response data length:

    0

    Command ENABLE (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x07

    0x2B

    0x6E

    0xE7

SETPOINT

ID:

0x08

Read supported:

True

Write supported:

True

Read the current setpoint of a channel or set a new one. All current values are in 0.1mA so 1000 equals 100mA.

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command SETPOINT (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x08

    0x3F

    CH

    CRC16

    Response data length:

    2

    CURRENT:

    setpoint of channel in 0.1mA, so 1000 equals 100mA, lower byte transmitted first

    Response SETPOINT (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x08

    0x2B

    CURRENT

    CRC16

  • Write Mode
    Command data length:

    3

    CH:

    channel number to read, starting with 1

    CURRENT:

    new setpoint of channel in 0.1mA, so 1000 equals 100mA, lower byte transmitted first

    Command SETPOINT (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    Value

    0x08

    0x08

    0x21

    CH

    CURRENT

    CRC16

    Response data length:

    0

    Command SETPOINT (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x08

    0x2B

    0x50

    0xF7

PROCESSVALUE

ID:

0x09

Read supported:

True

Write supported:

False

Read the current process value of a channel (actual output current). All current values are in 0.1mA so 1000 equals 100mA.

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command PROCESSVALUE

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x09

    0x3F

    CH

    CRC16

    Response data length:

    2

    CURRENT:

    process value of channel in 0.1mA, so 1000 equals 100mA, lower byte transmitted first

    Response PROCESSVALUE

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x09

    0x2B

    CURRENT

    CRC16

VOLTAGE

ID:

0x0A

Read supported:

True

Write supported:

False

Read the voltages at both output pins of a channel towards circuit ground. All voltages are in 1mV so 1000 equals 1V. The actual voltage across the output is the difference of the two voltages.

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command VOLTAGE

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x0A

    0x3F

    CH

    CRC16

    Response data length:

    4

    VOLTAGE_P:

    high side voltage in 1mv, so 1000 equals 1V, lower byte transmitted first

    VOLTAGE_N:

    low side voltage in 1mv, so 1000 equals 1V, lower byte transmitted first

    Response VOLTAGE

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    Value

    0x09

    0x0A

    0x2B

    VOLTAGE_P

    VOLTAGE_N

    CRC16

RESISTANCE

ID:

0x0B

Read supported:

True

Write supported:

False

Read the resistance connected to this channel. The value is in 1mΩ, so 1000 equals 1Ω. MEASURERESISTANCE configures if the resistance is also measured when the output is disabled.

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command RESISTANCE

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x0B

    0x3F

    CH

    CRC16

    Response data length:

    2

    RESISTANCE:

    resistance connected to this channel, in 1mΩ, so 1000 equals 1Ω, 0 if the resistance is currently not being measured

    Response RESISTANCE

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x0B

    0x2B

    RESISTANCE

    CRC16

CHANNELINFO

ID:

0x1D

Read supported:

True

Write supported:

False

Read basic values of a specific channels. This combines these commands: ENABLE, SETPOINT, PROCESSVALUE, VOLTAGE and RESISTANCE.

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command CHANNELINFO

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x1D

    0x3F

    CH

    CRC16

    Response data length:

    11

    STATUS:

    0x00 if this channel is disabled, 0x01 if it’s enabled

    SETPOINT:

    setpoint of channel in 0.1mA, so 1000 equals 100mA, lower byte transmitted first

    PROCESS:

    process value of channel in 0.1mA, so 1000 equals 100mA, lower byte transmitted first

    VOLTAGE_P:

    high side voltage in 1mv, so 1000 equals 1V, lower byte transmitted first

    VOLTAGE_N:

    low side voltage in 1mv, so 1000 equals 1V, lower byte transmitted first

    RESISTANCE:

    resistance connected to this channel, in 1mΩ, so 1000 equals 1Ω, 0 if the resistance is currently not being measured

    Response CHANNELINFO

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    9

    10

    11

    12

    13

    14

    15

    Value

    0x10

    0x1D

    0x2B

    STATUS

    SETPOINT

    PROCESS

    VOLTAGE_P

    VOLTAGE_N

    RESISTANCE

    CRC16

DIGITALOUTPUT

ID:

0x1E

Read supported:

True

Write supported:

True

Read the current digital output value of a channel or set a new one.

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command DIGITALOUTPUT (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x1E

    0x3F

    CH

    CRC16

    Response data length:

    2

    VALUE:

    current digital output value, lower byte transmitted first

    Response DIGITALOUTPUT (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x1E

    0x2B

    VALUE

    CRC16

  • Write Mode
    Command data length:

    3

    CH:

    channel number to read, starting with 1

    VALUE:

    new digital output value, lower byte transmitted first

    Command DIGITALOUTPUT (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    Value

    0x08

    0x1E

    0x21

    CH

    VALUE

    CRC16

    Response data length:

    0

    Command DIGITALOUTPUT (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x1E

    0x2B

    0x85

    0x5E

ANALOGINPUT

ID:

0x20

Read supported:

True

Write supported:

False

Read the analog input value of this channel. The value is in 1mΩ, so 1000 equals 1V.

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command ANALOGINPUT

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x20

    0x3F

    CH

    CRC16

    Response data length:

    2

    VOLTAGE:

    voltage on analog input of this channel, in 1mV, so 1000 equals 1V

    Response ANALOGINPUT

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x20

    0x2B

    VOLTAGE

    CRC16

Configuration Commands

These commands allow changing the behaviour of the ECU-P hardware. The changes will be lost after resetting or unpowering the ECU-P. To make them permanent save them to the internal memeory with SAVETOEEPROM.

ENTERBOOTLOADER

ID:

0x05

Read supported:

False

Write supported:

True

Enter bootloader mode. This allows firmware updates to take place.

  • Write Mode
    Command data length:

    0

    Command ENTERBOOTLOADER

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x05

    0x21

    0x46

    0x20

    Response data length:

    0

    Response ENTERBOOTLOADER

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x05

    0x2B

    0x0C

    0x81

SAVETOEEPROM

ID:

0x1B

Read supported:

False

Write supported:

True

Save any configuration and calibration changes to the internal memory. Without this, all changes will be lost after the next reset/power cycle.

  • Write Mode
    Command data length:

    0

    Command SAVETOEEPROM

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x1B

    0x21

    0x3A

    0x00

    Response data length:

    0

    Response SAVETOEEPROM

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x1B

    0x2B

    0x70

    0xA1

MODECONFIGURATION

ID:

0x0F

Read supported:

True

Write supported:

True

Read or set the configuration for default mode after reset and the default current when switching to manual mode.

  • Read Mode
    Command data length:

    0

    Command MODECONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x0F

    0x3F

    0x72

    0x3C

    Response data length:

    3

    MODE:

    0x00 if in automatic mode, 0x01 if in manual mode after reset

    CURRENT:

    default output current of all channels in manual mode after reset, in 0.1mA, so 1000 equals 100mA, lower byte transmitted first

    Response MODECONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    Value

    0x08

    0x0F

    0x2B

    MODE

    CURRENT

    CRC16

  • Write Mode
    Command data length:

    3

    MODE:

    0x00 if in automatic mode, 0x01 if in manual mode after reset

    CURRENT:

    default output current of all channels in manual mode after reset, in 0.1mA, so 1000 equals 100mA, lower byte transmitted first

    Command MODECONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    Value

    0x08

    0x0F

    0x21

    MODE

    CURRENT

    CRC16

    Response data length:

    0

    Response MODECONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x0F

    0x2B

    0xC7

    0x6E

STATEMACHINECONFIGURATION

ID:

0x10

Read supported:

True

Write supported:

True

Get or set the configuration of the state machine.

Multiple state machines are supported and each state can have many actions (enabling/disabling channels, etc.) when entered. The transition to a configurable next state occures if a configurable trigger event occurs (time out, push button press, serial command, etc.). This allows for automated sequeneces of output current. The state machine functionality is disabled when the ECU is in manual mode.

While writing a new configuration, no actions will be executed by the state machines. Only after writing the complete configuration the state machines are reinizialized.

Multiple reads or writes with increasing start address might be required to transmit the full binary byte stream.

  • Read Mode
    Command data length:

    2

    START_ADDRESS:

    address of first byte to read

    Command STATEMACHINECONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x10

    0x3F

    START_ADDRESS

    CRC16

    Response data length:

    variable, depends on the byte stream to be transmitted

    BYTE_STREAM:

    binary state machine configuration, max. 27 bytes (or less if remaing byte stream at the start address is shorter) will be returned

    Response STATEMACHINECONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    N - 2

    N - 1

    Value

    N

    0x10

    0x2B

    BYTE_STREAM

    CRC16

  • Write Mode
    Command data length:

    variable, depends on the byte stream to be transmitted

    START_ADDRESS:

    address of first byte to write

    BYTE_STREAM:

    binary state machine configuration, max. 27 bytes (or less if remaing byte stream at the start address is shorter) will be returned

    Command STATEMACHINECONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    N - 2

    N - 1

    Value

    N

    0x10

    0x21

    START_ADDRESS

    BYTE_STREAM

    CRC16

    Response data length:

    0

    Response STATEMACHINECONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x10

    0x2B

    0x8A

    0x7D

MONITORINGCONFIGURATION

ID:

0x11

Read supported:

True

Write supported:

True

Get or set the configuration for input and output current monitoring.

  • Read Mode
    Command data length:

    0

    Command MONITORINGCONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x11

    0x3F

    0x0E

    0x1C

    Response data length:

    6

    INPUT:

    0x01 to enable input current monitoring, 0x00 to disable it.

    INPUT_TIMEOUT:

    timout after input current was too high during which the outputs can’t be enabled again, in miliseconds, lower byte transmitted first

    OUTPUT:

    0x01 to enable monitoring of output current, 0x00 to disable it

    OUTPUT_ERROR:

    relative error threshold in 0.01%, so 1000 equals 10%, lower byte transmitted first

    Response MONITORINGCONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    9

    10

    Value

    0x0B

    0x11

    0x2B

    INPUT

    INPUT_TIMEOUT

    OUTPUT

    OUTPUT_ERROR

    CRC16

  • Write Mode
    Command data length:

    6

    INPUT:

    0x01 to enable input current monitoring, 0x00 to disable it.

    INPUT_TIMEOUT:

    timout after input current was too high during which the outputs can’t be enabled again, in miliseconds, lower byte transmitted first

    OUTPUT:

    0x01 to enable monitoring of output current, 0x00 to disable it

    OUTPUT_ERROR:

    relative error threshold in 0.01%, so 1000 equals 10%, lower byte transmitted first

    Command MONITORINGCONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    9

    10

    Value

    0x0B

    0x11

    0x21

    INPUT

    INPUT_TIMEOUT

    OUTPUT

    OUTPUT_ERROR

    CRC16

    Response data length:

    0

    Response MONITORINGCONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x11

    0x2B

    0xBB

    0x4E

CCSOURCECONFIGURATION

ID:

0x12

Read supported:

True

Write supported:

True

Get or set the configuration for constant current sources.

  • Read Mode
    Command data length:

    0

    Command CCSOURCECONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x12

    0x3F

    0x5D

    0x49

    Response data length:

    3

    CLOSED_LOOP:

    0x01 to enable close loop control of output current on all channels. This compares the measured output current with the setpoint and adjusts the DAC value accordingly. 0x00 to disable closed loop control

    MULITPLIER:

    mutlitplier for output current error, result is added to DAC value, lower byte transmitted first

    Response CCSOURCECONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    Value

    0x08

    0x12

    0x2B

    CLOSED_LOOP

    MULITPLIER

    CRC16

  • Write Mode
    Command data length:

    3

    CLOSED_LOOP:

    0x01 to enable close loop control of output current on all channels. This compares the measured output current with the setpoint and adjusts the DAC value accordingly. 0x00 to disable closed loop control

    MULITPLIER:

    mutlitplier for output current error, result is added to DAC value, lower byte transmitted first

    Command CCSOURCECONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    Value

    0x08

    0x12

    0x21

    CLOSED_LOOP

    MULITPLIER

    CRC16

    Response data length:

    0

    Response CCSOURCECONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x12

    0x2B

    0x23

    0xF4

CCSOURCECONFIGURATION V2

ID:

0x12

Read supported:

True

Write supported:

True

Get or set the configuration for constant current sources.

  • Read Mode
    Command data length:

    0

    Command CCSOURCECONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x12

    0x3F

    0x5D

    0x49

    Response data length:

    11

    CLOSED_LOOP:

    0x01 to enable close loop control of output current on all channels. This compares the measured output current with the setpoint and adjusts the DAC value accordingly. 0x00 to disable closed loop control

    MULITPLIER:

    mutlitplier for output current error, result is added to DAC value, lower byte transmitted first

    DELAY:

    clock cycles between starts of ADC conversions. This clock is running at 6 MHz, so a value of 12000 results in a sampling rate of 500 Hz. Lower byte transmitted first

    DEALY_ADC:

    Clock cycles between turning on output channels and starting the ADC conversion. This gives the analog voltages time to settle. This clock is running at 6 MHz, so a value of 850 results in a delay of 142 us, lower byte transmitted first

    PWM:

    0x01 to nable switching to PWM mode for output current if setpoint is lower than threshold. The PWM frequency is determind by the DELAY and the minimal achievable on time is determind by DEALY_ADC and the conversion time of the ADC. 0x00 to disable PWM switch over

    PWM_CURRENT:

    threshold current in 0.1mA below which the output switches to PWM mode, so 1000 equals 100mA, lower byte transmitted first

    MEAS_RES:

    0x01 to enable always measuring resistance of disabled channels by default after reset, 0x00 to disable default measurement after reset.

    Response CCSOURCECONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    9

    10

    11

    12

    13

    14

    15

    Value

    0x10

    0x12

    0x2B

    CLOSED_LOOP

    MULITPLIER

    DELAY

    DEALY_ADC

    PWM

    PWM_CURRENT

    MEAS_RES

    CRC16

  • Write Mode
    Command data length:

    11

    CLOSED_LOOP:

    0x01 to enable close loop control of output current on all channels. This compares the measured output current with the setpoint and adjusts the DAC value accordingly. 0x00 to disable closed loop control

    MULITPLIER:

    mutlitplier for output current error, result is added to DAC value, lower byte transmitted first

    DELAY:

    clock cycles between starts of ADC conversions. This clock is running at 6 MHz, so a value of 12000 results in a sampling rate of 500 Hz. Lower byte transmitted first

    DEALY_ADC:

    Clock cycles between turning on output channels and starting the ADC conversion. This gives the analog voltages time to settle. This clock is running at 6 MHz, so a value of 850 results in a delay of 142 us, lower byte transmitted first

    PWM:

    0x01 to nable switching to PWM mode for output current if setpoint is lower than threshold. The PWM frequency is determind by the DELAY and the minimal achievable on time is determind by DEALY_ADC and the conversion time of the ADC. 0x00 to disable PWM switch over

    PWM_CURRENT:

    threshold current in 0.1mA below which the output switches to PWM mode, so 1000 equals 100mA, lower byte transmitted first

    MEAS_RES:

    0x01 to enable always measuring resistance of disabled channels by default after reset, 0x00 to disable default measurement after reset.

    Command CCSOURCECONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    9

    10

    11

    12

    13

    14

    15

    Value

    0x10

    0x12

    0x21

    CLOSED_LOOP

    MULITPLIER

    DELAY

    DEALY_ADC

    PWM

    PWM_CURRENT

    MEAS_RES

    CRC16

    Response data length:

    0

    Response CCSOURCECONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x12

    0x2B

    0x23

    0xF4

ADCCONFIGURATION

ID:

0x14

Read supported:

True

Write supported:

True

Get or set the configuration for the analog-to-digital converter.

  • Read Mode
    Command data length:

    0

    Command ADCCONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x14

    0x3F

    0xFB

    0xE3

    Response data length:

    4

    CURRENT_TRACK:

    time in ADC clock cycles for sampling the current channel inputs. This time is needed for the input capacitor to reach the input voltage. Maximum value is 63 clock cycles

    CUR_ACCU:

    number of samples to average current channel inputs. Possible values are 1, 4, 8, 16, 32

    VOL_TRACK:

    time in ADC clock cycles for sampling the voltage channel inputs. This time is needed for the input capacitor to reach the input voltage. Maximum value is 63 clock cycles

    VOL_ACCU:

    number of samples to average voltage channel inputs. Possible values are 1, 4, 8, 16, 36

    Response ADCCONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    Value

    0x09

    0x14

    0x2B

    CURRENT_TRACK

    CUR_ACCU

    VOL_TRACK

    VOL_ACCU

    CRC16

  • Write Mode
    Command data length:

    4

    CURRENT_TRACK:

    time in ADC clock cycles for sampling the current channel inputs. This time is needed for the input capacitor to reach the input voltage. Maximum value is 63 clock cycles

    CUR_ACCU:

    number of samples to average current channel inputs. Possible values are 1, 4, 8, 16, 32

    VOL_TRACK:

    time in ADC clock cycles for sampling the voltage channel inputs. This time is needed for the input capacitor to reach the input voltage. Maximum value is 63 clock cycles

    VOL_ACCU:

    number of samples to average voltage channel inputs. Possible values are 1, 4, 8, 16, 36

    Command ADCCONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    Value

    0x09

    0x14

    0x21

    CURRENT_TRACK

    CUR_ACCU

    VOL_TRACK

    VOL_ACCU

    CRC16

    Response data length:

    0

    Response ADCCONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x14

    0x2B

    0x4E

    0xB1

PUSHBUTTONCONFIGURATION

ID:

0x18

Read supported:

True

Write supported:

True

Get or set the configuration for the push button mode.

  • Read Mode
    Command data length:

    0

    Command PUSHBUTTONCONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x18

    0x3F

    0x96

    0xA6

    Response data length:

    1

    TOGGLE:

    0x01 for push buttons to act in toggle mode, 0x00 for non-toggle mode

    Response PUSHBUTTONCONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x18

    0x2B

    TOGGLE

    CRC16

  • Write Mode
    Command data length:

    1

    Command PUSHBUTTONCONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x18

    0x21

    TOGGLE

    CRC16

    Response data length:

    0

    Response PUSHBUTTONCONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x18

    0x2B

    0x23

    0xF4

I2CCONFIGURATION

ID:

0x19

Read supported:

True

Write supported:

True

Read current I2C address or set a new one. The address is the 7 bit I2C address right-shifted (without the R/W bit).

  • Read Mode
    Command data length:

    0

    Command I2CCONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x19

    0x3F

    0xA7

    0x95

    Response data length:

    1

    ADDR:

    current 7 bit I2C address

    Response I2CCONFIGURATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x19

    0x2B

    ADDR

    CRC16

  • Write Mode
    Command data length:

    1

    ADDR:

    new 7 bit I2C address

    Command I2CCONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x19

    0x21

    ADDR

    CRC16

    Response data length:

    0

    Response I2CCONFIGURATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x19

    0x2B

    0x12

    0xC7

Calibration Commands

These commands allow changing the calibration values of the ECU-P hardware. The changes will be lost after resetting or unpowering the ECU-P. To make them permanent save them to the internal memeory with SAVETOEEPROM.

Before changing any values the ECU-P needs to be unlocked to prevent changing the calibration by accident. Use the UNLOCK command with the unlock keys for the specific hardware.

UNLOCK

ID:

0x1A

Read supported:

False

Write supported:

True

Unlock the calibration values. This needs to be sent before any values can be changed. The unlock keys that are required depend on the hardware.

  • Write Mode
    Command data length:

    2

    KEY1:

    unlock key first byte, specific to the ECU-P hardware

    KEY2:

    unlock key second byte, specific to the ECU-P hardware

    Command UNLOCK

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    Value

    0x07

    0x1A

    0x21

    KEY1

    KEY2

    CRC16

    Response data length:

    0

    Response UNLOCK

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x1A

    0x2B

    0x41

    0x92

DACCALIBRATION

ID:

0x13

Read supported:

True

Write supported:

True

Read the current DAC calibration values or set new ones for this channel. The calibration needs to be unlocked first.

This is used to calculate the DAC output voltage from the set output current. The following formula is used (output_current in 0.1mA, so 1000 equals 100mA):

DAC_VALUE = (output_current * MULTIPLIER / 2^10 + OFFSET) / 2^6

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command DACCALIBRATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x13

    0x3F

    CH

    CRC16

    Response data length:

    4

    MULTIPLIER:

    lower byte transmitted first

    OFFSET:

    lower byte transmitted first

    Response DACCALIBRATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    Value

    0x09

    0x13

    0x2B

    MULTIPLIER

    OFFSET

    CRC16

  • Write Mode
    Command data length:

    5

    CH:

    channel number to read, starting with 1

    MULTIPLIER:

    lower byte transmitted first

    OFFSET:

    lower byte transmitted first

    Command DACCALIBRATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    9

    Value

    0x0A

    0x13

    0x21

    CH

    MULTIPLIER

    OFFSET

    CRC16

    Response data length:

    0

    Response DACCALIBRATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x13

    0x2B

    0xD9

    0x28

ADCCURRENTCALIBRATION

ID:

0x15

Read supported:

True

Write supported:

True

Read the current ADC current calibration values or set new ones for this channel. The calibration needs to be unlocked first.

This is used to calculate the output current from the measured ADC value. The following formula is used (output_current in 0.1mA, so 1000 equals 100mA):

output_current = (ADC_VALUE * MULTIPLIER / 2^9 + OFFSET - 32768) / 2^5

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command ADCCURRENTCALIBRATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x15

    0x3F

    CH

    CRC16

    Response data length:

    4

    MULTIPLIER:

    lower byte transmitted first

    OFFSET:

    lower byte transmitted first

    Response ADCCURRENTCALIBRATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    Value

    0x09

    0x15

    0x2B

    MULTIPLIER

    OFFSET

    CRC16

  • Write Mode
    Command data length:

    5

    CH:

    channel number to read, starting with 1

    MULTIPLIER:

    lower byte transmitted first

    OFFSET:

    lower byte transmitted first

    Command ADCCURRENTCALIBRATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    9

    Value

    0x0A

    0x15

    0x21

    CH

    MULTIPLIER

    OFFSET

    CRC16

    Response data length:

    0

    Response ADCCURRENTCALIBRATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x15

    0x2B

    0x7F

    0x82

ADCINPUTCURRENTCALIBRATION

ID:

0x16

Read supported:

True

Write supported:

True

Read the current ADC current calibration values or set new ones for this channel. The calibration needs to be unlocked first.

This is used to calculate the USB current from the measured ADC value. The following formula is used (input_current in 0.1mA, so 1000 equals 100mA):

input_current = (ADC_VALUE * MULTIPLIER / 2^9 + OFFSET - 32768) / 2^5

  • Read Mode
    Command data length:

    0

    CH:

    channel number to read, starting with 1

    Command ADCINPUTCURRENTCALIBRATION (read)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x16

    0x3F

    0x99

    0x85

    Response data length:

    4

    MULTIPLIER:

    lower byte transmitted first

    OFFSET:

    lower byte transmitted first

    Response ADCINPUTCURRENTCALIBRATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    Value

    0x09

    0x16

    0x2B

    MULTIPLIER

    OFFSET

    CRC16

  • Write Mode
    Command data length:

    4

    CH:

    channel number to read, starting with 1

    MULTIPLIER:

    lower byte transmitted first

    OFFSET:

    lower byte transmitted first

    Command ADCINPUTCURRENTCALIBRATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    Value

    0x09

    0x16

    0x21

    MULTIPLIER

    OFFSET

    CRC16

    Response data length:

    0

    Response ADCINPUTCURRENTCALIBRATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x16

    0x2B

    0x2C

    0xD7

ADCVOLTAGECALIBRATION

ID:

0x17

Read supported:

True

Write supported:

True

Read the current ADC voltage calibration values or set new ones for this channel. The calibration needs to be unlocked first.

This is used to calculate the output voltage from the measured ADC value. Both, the high and the low side of the output channel are measured. The voltage across the output is the difference of the high side and the low side voltage. The following formulas are used (output_voltage in 1mV, so 1000 equals 1V):

output_voltage_high_side = (ADC_VALUE * MULTIPLIER_P / 2^9 + OFFSET_P - 32768) / 2^5

output_voltage_low_side = (ADC_VALUE * MULTIPLIER_N / 2^9 + OFFSET_N - 32768) / 2^5

  • Read Mode
    Command data length:

    1

    CH:

    channel number to read, starting with 1

    Command ADCVOLTAGECALIBRATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    Value

    0x06

    0x17

    0x3F

    CH

    CRC16

    Response data length:

    8

    MULTIPLIER_P:

    lower byte transmitted first

    OFFSET_P:

    lower byte transmitted first

    MULTIPLIER_N:

    lower byte transmitted first

    OFFSET_N:

    lower byte transmitted first

    Response ADCVOLTAGECALIBRATION (read)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    9

    10

    11

    12

    Value

    0x0D

    0x17

    0x2B

    MULTIPLIER_P

    OFFSET_P

    MULTIPLIER_N

    OFFSET_N

    CRC16

  • Write Mode
    Command data length:

    9

    CH:

    channel number to read, starting with 1

    MULTIPLIER_P:

    lower byte transmitted first

    OFFSET_P:

    lower byte transmitted first

    MULTIPLIER_N:

    lower byte transmitted first

    OFFSET_N:

    lower byte transmitted first

    Command ADCVOLTAGECALIBRATION (write)

    Byte Number

    0

    1

    2

    3

    4

    5

    6

    7

    8

    9

    10

    11

    12

    13

    Value

    0x0E

    0x17

    0x21

    CH

    MULTIPLIER_P

    OFFSET_P

    MULTIPLIER_N

    OFFSET_N

    CRC16

    Response data length:

    0

    Response ADCVOLTAGECALIBRATION (write)

    Byte Number

    0

    1

    2

    3

    4

    Value

    0x05

    0x17

    0x2B

    0x1D

    0xE4

Supported Commands per Hardware

ECU-2I15-10

DEVICEID:

0x34

DERIVID:

0x45

HARDWAREID:

0xE7

Firmware Version:

<= 1.2

UNLOCK KEY1:

0x34

UNLOCK KEY2:

0xBE

ECU-2I15-11

DEVICEID:

0x34

DERIVID:

0x42 or 0x45

HARDWAREID:

0xE7

Firmware Version:

>= 1.3

UNLOCK KEY1:

0x34

UNLOCK KEY2:

0xBE

ECU-P2

DEVICEID:

0x34

DERIVID:

0x42 or 0x45

HARDWAREID:

0xE8

UNLOCK KEY1:

0x34

UNLOCK KEY2:

0xBE

ECU-PCON-mp6quad

DEVICEID:

0x30

DERIVID:

0x02 or 0x18

HARDWAREID:

0xA1

ECU-PCON-mp6single

DEVICEID:

0x30

DERIVID:

0x02 or 0x18

HARDWAREID:

0xA9

ECU-PCON-ABP2LAN

DEVICEID:

0x30

DERIVID:

0x02 or 0x18

HARDWAREID:

0xB1

ECU-PCON-SLF3

DEVICEID:

0x30

DERIVID:

0x02 or 0x18

HARDWAREID:

0xB9