IEEE 802.15.4 Examples and API Fixes

[tyler-potyondy]

IEEE 802.15.4 Examples and API Fixes

This PR updates the libtock-rs 15.4 API to account for the Phy/Standard 15.4 drivers in the kernel.

For context, the kernel has two 15.4 driver interfaces (that are mutually exclusive): a standard 15.4 driver and a Phy driver. The standard driver accepts payloads and forms the frame (adding headers, handling encryption, etc.). The Phy driver takes a buffer and transmits this buffer without modification.

The existing 15.4 API uses the standard driver. However, this driver does not expose functionality for things such as setting the channel or tx power (resulting in the errors in #586).

Changes

• Update 15.4 API to include transmit "raw" (using Phy driver).
• Remove set channel / tx power from standard examples.
• Add a "tx_raw" example.
• Adds some more debug prints to the examples.

TODO

• I only have one board with me currently so I need to test tx/rx functionality together with two boards. I'll ping once this is ready to merge on my end.
• We should integrate the libtock-rs 15.4 examples into the 15.4/OpenThread Nightly CI test.

[tyler-potyondy]

I realized that the existing libtock-rs implementation explicitly only uses the Phy kernel driver. I updated the PR to only mention/use the Phy interface and more explicitly call out this as the "raw" transmit. Does there exist a README with documentation on the examples?

[tyler-potyondy]

I've confirmed that the ieee802154_rx_raw, ieee802154_rx_raw, and ieee802154_rx_tx_raw tests are working.

When testing, I noticed some issues with the parsing logic (which have now been fixed). Should be good to merge on my end. I see some CI failures, but those look like they are not relevant to me?

[lschuermann]

Hm, it really looks like we ought to have a Cargo.lock in this repository as well, @jrvanwhy?

error: rustc 1.88.0 is not supported by the following packages:
  smol_str@0.3.4 requires rustc 1.89
  typed-index-collections@3.4.0 requires rustc 1.90.0

[jrvanwhy]

Hm, it really looks like we ought to have a Cargo.lock in this repository as well, @jrvanwhy?

error: rustc 1.88.0 is not supported by the following packages:
  smol_str@0.3.4 requires rustc 1.89
  typed-index-collections@3.4.0 requires rustc 1.90.0

Or upgrade to edition 2024.