Propulsion Microcontroller API

This page contains the commands used when communicating to and from the Wireless Communication Modules.

More details about the communication protocol can be found via the API Documentation Homepage.

---

Command 0x10 – Reset Motor Controller

Request Message:

• Payload Size: 1 byte (null)

Response Message:

• Payload Size: 1 byte

---

Command 0x11 – Set Motor Controller Configuration

Request Message:

• Payload Size: 2 bytes

Byte	Description	Valid Range
0	Register to Modify	See Qik 2s12v10 User Guide parameter numbers
1	New Configuration	See Qik 2s12v10 User Guide parameter allowed values

Response Message:

• Payload Size: 2 bytes

Byte	Description	Valid Range
0	Register that was Set	See Qik 2s12v10 User Guide
1	New Configuration Value	Varies

---

Command 0x12 – Get Motor Controller Configuration

Request Message:

• Payload Size: 1 byte

Byte	Description	Valid Range
0	Register to Read	See Qik 2s12v10 User Guide

Response Message:

• Payload Size: 2 bytes

Byte	Description	Valid Range
0	Register that was Read	See Qik 2s12v10 User Guide
1	Value in Register	Varies

---

Command 0x13 – Set Motor Speeds

Request Message:

• Payload Size: 4 bytes
• Used to set the speed of both motors simultaneously

Response Message:

• Payload Size: 4 bytes
• The response from the microcontroller to a set motor speed is to reply with the new motor speed to confirm the set was successful

Byte	Description	Valid Range
0 to 1	M0 Speed (MSB)	signed 16 bit, -255 to 255
2 to 3	M1 Speed (MSB)	signed 16 bit, -255 to 255

---

Command 0x14 - Get Motor Currents

Request Message:

• Payload Size: 1 byte (null)
• Used to request the current being consumed by both motors.

Response Message:

• Payload size: 4 bytes
• Reply from the microcontroller contains the current of both motors in milliamps.

Byte	Description	Valid Range
0 to 1	M0 Current	signed 16 bit, > 0
2 to 3	M1 Current	signed 16 bit, > 0

---

Command 0x15 – Get Errors

Request Message:

• Payload Size: 1 byte (null)
• Requests the errors currently active on the device.
• Note: The act of reading the errors will clear them from the device.

Response Message:

• Payload Size: 1 byte
• See Qik 2s12v10 User Guide -> Get Error Byte for details

The table below explains the individual bit meanings of the single byte of the payload.

Bit	Description	Valid Range
7 (MSB)	Timeout	0 or 1
6	Format Error	0 or 1
5	CRC Error	0 or 1
4	Serial Hardware Error	0 or 1
3	Motor 1 Over Current	0 or 1
2	Motor 0 Over Current	0 or 1
1	Motor 1 Fault	0 or 1
0 (LSB)	Motor 0 Fault	0 or 1

Command 0x1F – General Error Message

Request Message:

• Not applicable. A general error message is sent when a request has not been understood by the module (such as a CRC16 failure) or some other error occurred preventing a normal reply to a message.

Response Message:

• Payload Size: 1 byte

The table below explains the individual bit meanings of the single byte of the payload.

Value	Description
0x01	CRC Error
0x02	Speed Command out of Range