System Command Family - TapTrack/TappyBLE GitHub Wiki

The System command family specifies several commands for retrieving information about the Tappy device itself.

Commands

Get Hardware version

Requests that the Tappy reply with its hardware version.

Ping

Requests that the Tappy respond with a ping reply of its own.

Get Battery Level

Request the Tappy's current battery level

Get Firmware Version

Request the Tappy's firmware version

Get Hardware Version

Request the hardware revision of the Tappy

Set Config Item

Sets a configuration byte to change the TappyBLE operation. Currently, the only config setting that should be altered is 0x01h, where setting any value other than 0x00 will enable type 2 enumeration. When type 2 enumeration is enabled, the Tappy will attempt to determine what chip was used in NFC Forum Type 2 tags it encounters. This feature is disabled by default as it is a fairly lengthy process that unnecessarily hinders tag read performance in most applications.

Responses

Config Item Response

Informs the user that a configuration byte was successfully set

CRC Mismatch

CRC check failed on a command. TCMP packet was probably corrupted in transport.

Firmware Version Response

Response to a firmware version request. Contains a single-byte major version as well as a single-byte minor version.

Get Battery Level Response

Response to a battery level request. Contains a single byte equal to the battery percentage with 5% resolution.

Hardware Version Response

Response to a hardware version request. Contains a single-byte major version as well as a single-byte minor version.

Improper Message Format Response

TCMP message was received, but the format was

Lcs Mismatch Error Response

Length checksum on packet incorrect. Generally indicates a transport-level error.

Length Mismatch Error Response

Packet is the incorrect length. Generally indicates that a packet was dropped.

Ping response

Tappy reponse to a ping command