Skip to content
This repository has been archived by the owner on Sep 27, 2018. It is now read-only.

Wireless Communication Microcontroller API

Anthony Randell edited this page Feb 24, 2017 · 13 revisions

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 Home Page.


Command 0x00 – Reset Wireless Module

Request Message:

  • Payload size: 1 byte
Byte Description Valid Range
0 Null Byte 0x00

Response Message:

  • Payload size: 1 byte
Byte Description Valid Range
0 Null Byte 0x00

Command 0x01 – Set Wireless Module Configuration

Request Message:

  • Payload Size: 2 bytes
Byte Title Description Valid Range
0 Register Parameter being modified See RFM69HCW Manual
1 Value New configuration value Varies

Response Message:

  • Payload Size: 2 bytes
Byte Title Description Valid Range
0 Register Parameter that was modified See RFM69HCW Manual
1 Value New Configuration Value Varies

Command 0x02 – Get Wireless Module Configuration

Request Message:

  • Payload Size: 1 byte
Byte Title Description Valid Range
0 Register Parameter to read See RFM69HCW Manual

Response Message:

  • Payload Size: 2 bytes
Byte Title Description Valid Range
0 Register Parameter that was read See RFM69HCW Manual
1 Value Value in Register Varies

Command 0x03 – Wireless Receive

Request Message:

  • Payload Size: 1 byte
Byte Description Valid Range
0 Null Byte 0x00

Response Message:

  • Payload Size: 64 bytes
Byte Title Description Valid Range
0 Message Available True/False (1 or 0)
1 to 61 Message Payload of incoming wireless message Any
62 to 63 RSSI Signal strength 0 to -114 (dBm)

Command 0x04 – Wireless Transmit

Request Message:

  • Payload Size: 61 bytes (contents of message)
Byte Title Description Valid Range
0 to 60 Message Payload to send over wireless Any

Response Message:

  • Payload Size: 1 bytes
Byte Title Description Valid Range
0 TX Status Whether or not the message was sent successfully True or False

Command 0x0F – 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.

Bit Description Valid Range
7 (MSB) Timeout 0 or 1
6 Not Used 0 or 1
5 Not Used 0 or 1
4 Not Used 0 or 1
3 Not Used 0 or 1
2 Not Used 0 or 1
1 Not Used 0 or 1
0 (LSB) CRC Error 0 or 1