Tldr: For historical reasons, OneKey devices firmware updates are not always straightforward.
Incremental update: not every firmware update can be applied on any installed firmware. This currently applies only for T1 devices. Releases definitions (see below), contain min_bootloader_version
and min_firmware_version
. Depending on whether the device is in bootloader mode or not, respective field (min_bootloader_version
or min_firmware_version
) should be observed and next firmware to apply should be evaulated againts them.
Incremental downgrade: it is not possible to downgrade to lower version of bootloader. Rollout module does not solve this. Problem is, device will not tell you bootloader version if it is not in bootloader mode.
Rollout update: sometimes we might want to offer firmware only to small portion of users. This behaviour is defined by rollout
field and handled by this lib.
Firmware headers: any firmware that is applied on firmware with bootloader >= 1.8.0 has old firmware header of 256 bytes, that should be removed before installing. This should be only temporary state and will be solved in future by introducing special intermediate firmwares for updating.
to build a bundle run yarn build
run tests using yarn test
or yarn run test:watch
for watch mode
yarn run lint
npm install @onekeyhq/rollout --save
or
yarn add @onekeyhq/rollout
import Rollout from '@onekeyhq/rollout';
- options
{
baseUrl: 'https://connect.onekey.so',
releasesListsPaths: {
1: 'data/firmware/1/releases.json',
2: 'data/firmware/2/releases.json',
}
}
- stm firmware list,
- nrf firmware list
- returns rollout object that exposes following functions:
- returns random number from 0 to 1 (0.21, 0.89, 0,45)
- You may use this method to implement "rolling update". You probably want to save result of this function client side (local storage) under a key defined by concrete firmware. Items in releases list might have rollout field (number 0-1) that should be evaluated against getScore() result.
- features: Features object provided by Connect
{
major_version: 1,
minor_version: 8,
patch_version: 0,
bootloader_mode: false,
firmware_present: true,
...
}
-
score: Number (result of getScore()). This is to used to decide whether items with
rollout
defined are to be offered. Update is offered in casescore
provided is lower thanrollout
. -
returns UpdateInfo item
{
firmware: Object, // single object from releaseList,
isLatest: boolean || null, // is returned firwmare the latest one? null means we cant tell
isRequired: boolean, // true if any of unistalled firmwares are required
isNewer: boolean || null, // is returned firmware newer then actual? null means we cant tell
}
- returns array buffer with firmware that is safe to upload to device.