Skip to content

Commit a24da89

Browse files
committed
dasharo-binaries-paths-convention.md: Add more path examples
Signed-off-by: Filip Gołaś <[email protected]>
1 parent fe038b5 commit a24da89

File tree

1 file changed

+22
-6
lines changed

1 file changed

+22
-6
lines changed

docs/kb/dasharo-binaries-paths-convention.md

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -23,10 +23,26 @@ where:
2323
`apu4`
2424
- `<framework>` - firmware framework, like `coreboot`, `slimbootloader`, `heads`
2525
- `[_payload]` - optional, firmware payload, like `_uefi`, `_heads`, `_seabios`
26-
- `<version>` - Dasharo version, like `v0.9.0`, `v1.7.2-rc1`
27-
28-
Example, path to the v1.0.0 release binaries for Novacustom V540TU laptop:
29-
- `/novacustom/v540tu/coreboot_uefi/1.0.0/`
26+
- `<version>` - Dasharo version, like `v0.9.0`, `v1.7.2-rc1`, compliant with
27+
the [versioning scheme](https://docs.dasharo.com/dev-proc/versioning/).
28+
29+
Examples:
30+
- Dasharo (coreboot+Heads) Community Package for Novacustom V540TNx 14th
31+
Gen laptops v1.0.0
32+
+ (historically kept in one path due to compatibility):
33+
+ `/novacustom/v540tnd/coreboot_heads/1.0.0/`
34+
+ `/novacustom/v540tne/coreboot_heads/1.0.0/`
35+
- Dasharo (coreboot+UEFI) Pro Package for Protectli V1000-series v0.9.3
36+
+ (historically kept in two directories, a common `protectli_vault_jsl`
37+
path,
38+
and in more specific variants like `protectli_vault_jsl_v1210` due to
39+
temporal compatibility):
40+
+ `/protectli/v1210/coreboot_uefi/v0.9.3/`
41+
+ `/protectli/v1410/coreboot_uefi/v0.9.3/`
42+
+ `/protectli/v1610/coreboot_uefi/v0.9.3/`
43+
- Dasharo (coreboot+SeaBIOS) Community Package for PC Engines APU4 v24.08.00.01
44+
+ (unique versioning scheme)
45+
+ `/pcengines/apu4/coreboot_seabios/v24.08.00.01/`
3046

3147
### Motivation
3248

@@ -46,8 +62,8 @@ framework/payload combination to reduce the ambiguity.
4662
It's argueable that a firmware framework without a payload makes little sense
4763
as it won't allow the device to boot. Dasharo Naming Convention allows for
4864
such cases though, so to reduce the risk of needing to come up with hacks like
49-
`none` payload and inconsistent lengths of th path to a binary, the `[_payload]`
50-
field is a part of the same directory name as the `<framework>`.
65+
`none` payload and inconsistent lengths of the path to a binary, the
66+
`[_payload]` field is a part of the same directory name as the `<framework>`.
5167

5268
#### <vendor>/<model>
5369

0 commit comments

Comments
 (0)