feat(boards): Support board revisions

[zhiayang]

Split off from #1946; this is just the zmk infrastructure part to support board revisions.

Changes:

1. Updated schema to support a list of revisions, as well as a default revision
2. Updated setup.sh to prompt the user for revisions if the board yml defines revisions (and will also say which one is the default — if any)
3. setup.sh will append @revision to the board name.

The script doesn't support revisions for shields yet, but if the approach is sound I'll add that as well as fix up the powershell script.

I've set up a repo to test: https://github.com/zhiayang/zmk-test, but this depends on #1946.

[petejohanson]

@zhiayang Thoughts on allowing fuzzy revisions in the YAML metadata so you can drop unneeded portions? Would allow you to add [email protected] as a revision target and not force specifying unneeded trailing version details.

Found this when working on #2195

[petejohanson]

It would be good to update the powershell script for this support as well. See my other comment about fuzzy version matching, and maybe allowing specifying a partial revision in the metadata.

[petejohanson]

How do interconnect versions work? Not sure why this piece got added?

[zhiayang]

i think i was just autopiloting through this; don't think interconnects need revisions.

[petejohanson]

Shield variants are sadly not nearly as structured as board revisions. See https://docs.zephyrproject.org/3.5.0/hardware/porting/shields.html#shield-variants

This probably needs to be handled differently, or just not handled at all in this PR, so we can focus on getting board revisions in first.

[zhiayang]

thanks pete, i'll look at this over the weekend hopefully

[zhiayang]

re: partial revisions, the schema already supports it, and I've tested it works with the rest of the infrastructure -- the zephyr cmake stuff already handles partial revisions.

In #1946 I updated the mikoto.zmk.yml to include revision info (and I tried with the partial one, 7.1), and in the test repo (https://github.com/zhiayang/zmk-test/) i'm pulling from that PR branch.

It seems to work: https://github.com/zhiayang/zmk-test/actions/runs/8226802642/job/22493758007

(just ignore the mikoto_520 one, that one is broken for an unrelated reason)

edit: will edit the powershell script

[zhiayang]

powershell script updated, is there anything else?

[petejohanson]

Looks reasonable, thanks!