Difference between revisions of "Firmware versioning for companion apps"
Jump to navigation
Jump to search
(added category) |
(fix) |
||
| Line 1: | Line 1: | ||
BLE defines a standard service (Device Information Service, DIS) that allows BLE devices to expose information about them : hardware version, software version,... | |||
BLE defines a standard service (Device Information Service, DIS) that allows BLE devices to expose | |||
Companion apps will use these information to detect which firmware (or fork of a firmware) is running on the Pinetime they are connected to. | Companion apps will use these information to detect which firmware (or fork of a firmware) is running on the Pinetime they are connected to. | ||
| Line 24: | Line 22: | ||
|- | |- | ||
|Serial number | |Serial number | ||
|Not needed by companion apps as they can use the BLE MAC | |Not needed by companion apps as they can use the BLE MAC address | ||
| ? | | ? | ||
|- | |- | ||
| Line 39: | Line 37: | ||
|"0.7.1" | |"0.7.1" | ||
|} | |} | ||
[[Category:PineTime]] | [[Category:PineTime]] | ||
Latest revision as of 00:55, 16 March 2023
BLE defines a standard service (Device Information Service, DIS) that allows BLE devices to expose information about them : hardware version, software version,...
Companion apps will use these information to detect which firmware (or fork of a firmware) is running on the Pinetime they are connected to.
How to use the Device Information Service to differentiate firmwares?
We've briefly talked about this on the community chat and this proposal is the result of this discussion. This is a request for comments.
Fields from the Device Information Service:
| Field | Description | Example value |
|---|---|---|
| Manufacturer name | Manufacturer | PINE64 |
| Model number | Name of the device | "PineTime", "P8" |
| Serial number | Not needed by companion apps as they can use the BLE MAC address | ? |
| Hardware revision | Version of the hardware | 1.0a |
| Software revision | Project name or fork name | "InfiniTime", "InfiniTime-forkname", "Hypnos" |
| Firmware revision | Version of the firmware | "0.7.1" |