examples: ieee802154: update to correct interface

This adds an `ieee802154_tx_raw` example to use the kernel's Phy 15.4
driver. The standard 15.4 driver returns an error on setting channel,
setting on/off, and setting power as these are handled by a higher layer
in the kernel. This updates the non "raw" examples to no longer use this
commands as they will return a no-support error.

Author: tyler-potyondy

examples/ieee802154_rx.rs

@@ -16,20 +16,26 @@ fn main() {
     let pan: u16 = 0xcafe;
     let addr_short: u16 = 0xdead;
     let addr_long: u64 = 0xdead_dad;
-    let tx_power: i8 = 5;
-    let channel: u8 = 11;
+
+    writeln!(Console::writer(), "Configuring IEEE 802.15.4 radio...\n").unwrap();
 
     Ieee802154::set_pan(pan);
+    writeln!(Console::writer(), "Set PAN to {pan:#06x}\n").unwrap();
+
     Ieee802154::set_address_short(addr_short);
+    writeln!(
+        Console::writer(),
+        "Set short address to {addr_short:#06x}\n"
+    )
+    .unwrap();
+
     Ieee802154::set_address_long(addr_long);
-    Ieee802154::set_tx_power(tx_power).unwrap();
-    Ieee802154::set_channel(channel).unwrap();
+    writeln!(Console::writer(), "Set long address to {addr_long:#018x}\n").unwrap();
 
     // Don't forget to commit the config!
     Ieee802154::commit_config();
+    writeln!(Console::writer(), "Committed IEEE 802.15.4 config\n").unwrap();
 
-    // Turn the radio on
-    Ieee802154::radio_on().unwrap();
     assert!(Ieee802154::is_on());
 
     let mut buf = RxRingBuffer::<2>::new();

examples/ieee802154_rx_tx.rs

@@ -18,20 +18,26 @@ fn main() {
     let pan: u16 = 0xcafe;
     let addr_short: u16 = 0xdead;
     let addr_long: u64 = 0xdead_dad;
-    let tx_power: i8 = 5;
-    let channel: u8 = 11;
+
+    writeln!(Console::writer(), "Configuring IEEE 802.15.4 radio...\n").unwrap();
 
     Ieee802154::set_pan(pan);
+    writeln!(Console::writer(), "Set PAN to {pan:#06x}\n").unwrap();
+
     Ieee802154::set_address_short(addr_short);
+    writeln!(
+        Console::writer(),
+        "Set short address to {addr_short:#06x}\n"
+    )
+    .unwrap();
+
     Ieee802154::set_address_long(addr_long);
-    Ieee802154::set_tx_power(tx_power).unwrap();
-    Ieee802154::set_channel(channel).unwrap();
+    writeln!(Console::writer(), "Set long address to {addr_long:#018x}\n").unwrap();
 
     // Don't forget to commit the config!
     Ieee802154::commit_config();
+    writeln!(Console::writer(), "Committed IEEE 802.15.4 config\n").unwrap();
 
-    // Turn the radio on
-    Ieee802154::radio_on().unwrap();
     assert!(Ieee802154::is_on());
 
     let mut buf = RxRingBuffer::<2>::new();

examples/ieee802154_tx.rs

@@ -18,20 +18,26 @@ fn main() {
     let pan: u16 = 0xcafe;
     let addr_short: u16 = 0xdead;
     let addr_long: u64 = 0xdeaddad;
-    let tx_power: i8 = 5;
-    let channel: u8 = 11;
+
+    writeln!(Console::writer(), "Configuring IEEE 802.15.4 radio...\n").unwrap();
 
     Ieee802154::set_pan(pan);
+    writeln!(Console::writer(), "Set PAN to {pan:#06x}\n").unwrap();
+
     Ieee802154::set_address_short(addr_short);
+    writeln!(
+        Console::writer(),
+        "Set short address to {addr_short:#06x}\n"
+    )
+    .unwrap();
+
     Ieee802154::set_address_long(addr_long);
-    Ieee802154::set_tx_power(tx_power).unwrap();
-    Ieee802154::set_channel(channel).unwrap();
+    writeln!(Console::writer(), "Set long address to {addr_long:#018x}\n").unwrap();
 
     // Don't forget to commit the config!
     Ieee802154::commit_config();
+    writeln!(Console::writer(), "Committed IEEE 802.15.4 config\n").unwrap();
 
-    // Turn the radio on
-    Ieee802154::radio_on().unwrap();
     assert!(Ieee802154::is_on());
 
     let mut counter = 0_usize;

examples/ieee802154_tx_raw.rs

@@ -0,0 +1,81 @@
+//! An example showing use of IEEE 802.15.4 networking.
+//! It infinitely sends a frame with a constantly incremented counter.
+//!
+//! This uses the kernel IEEE 802.15.4 PHY driver to send "raw" frames,
+//! (i.e. the kernel does not add any headers). This requires your board
+//! file to use the IEEE 802.15.4 Phy capsule. Example board files can
+//! be found in `boards/tutorials/nrf52840dk-thread-tutorial/`.
+
+#![no_main]
+#![no_std]
+use core::fmt::Write as _;
+
+use libtock::alarm::{Alarm, Milliseconds};
+use libtock::console::Console;
+use libtock::ieee802154::Ieee802154;
+use libtock::runtime::{set_main, stack_size};
+
+set_main! {main}
+stack_size! {0x600}
+
+fn main() {
+    // Configure the radio
+    let pan: u16 = 0xcafe;
+    let addr_short: u16 = 0xdead;
+    let addr_long: u64 = 0xdeaddad;
+    let tx_power: i8 = 4;
+    let channel: u8 = 11;
+
+    writeln!(Console::writer(), "Configuring IEEE 802.15.4 radio...\n").unwrap();
+
+    Ieee802154::set_pan(pan);
+    writeln!(Console::writer(), "Set PAN to {pan:#06x}\n").unwrap();
+
+    Ieee802154::set_address_short(addr_short);
+    writeln!(
+        Console::writer(),
+        "Set short address to {addr_short:#06x}\n"
+    )
+    .unwrap();
+
+    Ieee802154::set_address_long(addr_long);
+    writeln!(Console::writer(), "Set long address to {addr_long:#018x}\n").unwrap();
+
+    Ieee802154::set_tx_power(tx_power).unwrap();
+    writeln!(Console::writer(), "Set TX power to {tx_power} dBm\n").unwrap();
+
+    Ieee802154::set_channel(channel).unwrap();
+    writeln!(Console::writer(), "Set channel to {channel}\n").unwrap();
+
+    // Don't forget to commit the config!
+    Ieee802154::commit_config();
+    writeln!(Console::writer(), "Committed IEEE 802.15.4 config\n").unwrap();
+
+    // Turn the radio on
+    Ieee802154::radio_on().unwrap();
+    assert!(Ieee802154::is_on());
+
+    let mut counter = 0_usize;
+    let mut buf = [
+        b'f', b'r', b'a', b'm', b'e', b' ', b'n', b'.', b'o', b'.', b' ', b'\0', b'\0', b'\0',
+        b'\0',
+    ];
+    fn set_buf_cnt(buf: &mut [u8], counter: &mut usize) {
+        let buf_len = buf.len();
+        let buf_cnt = &mut buf[buf_len - core::mem::size_of_val(&counter)..];
+        buf_cnt.copy_from_slice(&counter.to_be_bytes());
+    }
+
+    loop {
+        Alarm::sleep_for(Milliseconds(1000)).unwrap();
+
+        set_buf_cnt(&mut buf, &mut counter);
+
+        // Transmit a frame
+        Ieee802154::transmit_frame_raw(&buf).unwrap();
+
+        writeln!(Console::writer(), "Transmitted frame {counter}!\n").unwrap();
+
+        counter += 1;
+    }
+}