User Tools

Site Tools


pidflightlap:protocol

PIDflight Lap Protocol

The PIDflight Lap protocol uses a slightly modified version of the Multiwii Serial Protocol.

Notes

  • By default all lap timers are activated on power up. (i.e. do not require MSP_ACTIVATE to be sent)

Getting started

  • Open serial connection to lap timing device(s).
    • Baud rate: 115200
  • Application issues MSP_SET_DEVICE_ID to all devices.
    // Initialise all connected devices identifiers starting with 1
    MSP.sendMessage(MSP.WILDCARD_DEVICE_ID, MSP.MSP_SET_DEVICE_ID, 1);
  • Each device found and initialised will return a response to MSP_SET_DEVICE_ID with the ID it has been initialised with.
  • Poll MSP_CURRENT_LAP to detect when a new lap has been recorded on the lap timer.
  • Poll MSP_STATUS to retrieve current status of the lap timer.

MSP message format

MSP codes

NameCodeDescription
MSP_API_VERSION1Firmware API version
MSP_STATUS4Device and lap timing status
MSP_RESET5Resets device and lap timing state
MSP_RSSI_CALIBRATE6Triggers RSSI calibration routine
MSP_START7Starts lap timing
MSP_ACTIVATE8Activates a lap timer device
MSP_DEACTIVATE9Deactivates a lap timer device
MSP_DEVICE_ID10Not used
MSP_SET_DEVICE_ID11Triggers lap timing devices to assign an ID
MSP_CHANNEL20Gets the channel frequency set on the lap timing device
MSP_SET_CHANNEL21Sets the channel frequency on the lap timing device
MSP_CURRENT_LAP30
MSP_LAP_MIN_TIME34
MSP_SET_LAP_MIN_TIME35
MSP_LAP_MAX37
MSP_SET_LAP_MAX38
MSP_RSSI40
MSP_RSSI_THRESHOLD42
MSP_SET_RSSI_THRESHOLD43
MSP_RSSI_FILTER44TBD
MSP_SET_RSSI_FILTER45TBD
MSP_EEPROM_WRITE250Persists settings to EEPROM for settings to survive a power cycle (if desired)

MSP_API_VERSION

PartTypeDescription
1UINT 8Major version
2UINT 8Minor version

Version is constructed as [PART 1][DECIMAL][PART2][DECIMAL][ZERO] (e.g. 2.6.0)

MSP_STATUS

PartTypeDescription
1UINT 8Device state
2UINT 8Timer state

Device states

ValueState
0Idle
1Timing
2Calibrating
3Inactive

Timer states

ValueState
0Waiting
1Start
2Stop
pidflightlap/protocol.txt · Last modified: 2019/02/08 20:15 by cmengler