Hardware Firmware And Protobuf
- Confirm the requested firmware repository, branch or commit, protocol version, and generated outputs before changing anything.
- Read Protocol V1/V2 transport and the relevant SDK runtime or device-management document from the docs index.
- Treat
submodules/firmware-pro2/sys/protobuf/onekey_protocol/latest/as the Protocol V2 source of truth. - Preserve unrelated submodule modifications and never switch branches or move the pointer as a side effect.
- Modify the source or generator, then run
yarn update-protobuf; never hand-edit generated schema or types. - Verify transport schema, Core schema/mapping, generated types, message numbers, optional fields, tests, and documentation together.
- Build and test
hd-transportbefore downstream transports and Core.
Do not install firmware, reboot into a loader, wipe a device, or mutate a physical device without explicit authorization and a resolved target.