Difference between revisions of "Firmware versioning for companion apps"

From PINE64
Jump to navigation Jump to search
(Created page with "= Firmware versioning for companion apps = BLE defines a standard service (Device Information Service, DIS) that allows BLE devices to expose informations about them : hardwa...")
 
(fix)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= Firmware versioning for companion apps =
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 informations 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.
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 21: Line 19:
|Model number
|Model number
|Name of the device
|Name of the device
|"Pinetime", "P8"
|"PineTime", "P8"
|-
|-
|Serial number
|Serial number
|Not needed by companion apps as they can use the BLE MAC adress
|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]]

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"