Hardware revisions

hw_rev distinguishes hardware variants on the same Version Line. It is not part of the version identity. Rank defines the compatible range.

When to use

Use when one firmware image has board revisions. Do not encode hw in SemVer. See MCU.

Configuration entry

Project → Hardware Revisions; bind on artifact upload. Steps: Hardware revisions.

Rules and error codes

Unregistered bind → HW_REV_UNKNOWNUnregistered hw_rev. Incompatible client rev → HW_REV_INCOMPATIBLEhw_rev out of range. Hash downloads ignore X-Hw-Rev.

Client duties

check may send hw_rev. Store feeds project the default hw variant only.

Related: Platform matrix.