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 Jan 14, 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 (null)

Response Message:

  • Payload Size: 1 byte

Command 0x01 – Set Wireless Module Configuration

Request Message:

  • Payload Size: 2 bytes
Byte Description Valid Range
0 Register to Modify See RFM69HCW Manual
1 New Configuration Varies

Response Message:

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

Command 0x02 – Get Wireless Module Configuration

Request Message:

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

Response Message:

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

Command 0x03 – Wireless Receive

Request Message:

  • Payload Size: 1 byte (null; 0x00)

Response Message:

  • Payload Size: 64 bytes
Byte Description Valid Range
0 Message Available True/False (1 or 0)
1 to 61 Message Received Any
62 to 63 RSSI 0 to -114 (dBm)

Command 0x04 – Wireless Transmit

Request Message:

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

Response Message:

  • Payload Size: 1 bytes
Byte Description Valid Range
0 TX Successful 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