Update [[example]] targets

Reorder [[example]] targets alphabetically
Remove some unnessesary required features
Tidy documentation in sai_dma_passthru example

Cargo.toml

@@ -148,17 +148,41 @@ debug = true # symbols are nice and they don't increase the size in flash
 lto = true # better optimizations
 opt-level = "s" # optimize for binary size
 
+# The following examples do not build for all feature flag combinations. The
+# `required-features` field specifies the hal features and/or the hardware
+# configuration required by the example.
+
 [[example]]
-name = "rtic"
-required-features = ["rt"]
+name = "can-echo"
+required-features = ["can"]
 
 [[example]]
-name = "rtic_timers"
-required-features = ["rt", "rm0433"]
+name = "can-fd"
+required-features = ["can"]
 
 [[example]]
-name = "vos0"
-required-features = ["revision_v"]
+name = "crc"
+required-features = ["crc"]
+
+[[example]]
+name = "embedded-graphics"
+required-features = ["ltdc", "xspi", "rm0468"]
+
+[[example]]
+name = "ethernet-stm32h747i-disco"
+required-features = ["rt", "stm32h747cm7", "ethernet"]
+
+[[example]]
+name = "ethernet-rtic-stm32h747i-disco"
+required-features = ["rt", "stm32h747cm7", "ethernet"]
+
+[[example]]
+name = "ethernet-rtic-stm32h735g-dk"
+required-features = ["rt", "stm32h735", "ethernet"]
+
+[[example]]
+name = "ethernet-nucleo-h743zi2"
+required-features = ["rt", "revision_v", "stm32h743v", "ethernet"]
 
 [[example]]
 name = "fmc"
@@ -169,12 +193,12 @@ name = "fmc_nand_flash"
 required-features = ["fmc"]
 
 [[example]]
-name = "can-echo"
-required-features = ["can"]
+name = "octospi"
+required-features = ["xspi", "rm0468"]
 
 [[example]]
-name = "can-fd"
-required-features = ["can"]
+name = "octospi_hyperram"
+required-features = ["xspi", "rm0468"]
 
 [[example]]
 name = "qspi"
@@ -189,12 +213,16 @@ name = "qspi_flash_memory"
 required-features = ["xspi", "rm0433"]
 
 [[example]]
-name = "octospi"
-required-features = ["xspi", "rm0468"]
+name = "rtc"
+required-features = ["rt", "rtc"]
 
 [[example]]
-name = "octospi_hyperram"
-required-features = ["xspi", "rm0468"]
+name = "rtic"
+required-features = ["rt"]
+
+[[example]]
+name = "rtic_timers"
+required-features = ["rt", "rm0433"]
 
 [[example]]
 name = "sdmmc"
@@ -205,24 +233,8 @@ name = "sdmmc_fat"
 required-features = ["sdmmc", "sdmmc-fatfs"]
 
 [[example]]
-name = "embedded-graphics"
-required-features = ["ltdc", "xspi", "rm0468"]
-
-[[example]]
-name = "ethernet-stm32h747i-disco"
-required-features = ["rt", "stm32h747cm7", "ethernet"]
-
-[[example]]
-name = "ethernet-rtic-stm32h747i-disco"
-required-features = ["rt", "stm32h747cm7", "ethernet"]
-
-[[example]]
-name = "ethernet-rtic-stm32h735g-dk"
-required-features = ["rt", "stm32h735", "ethernet"]
-
-[[example]]
-name = "ethernet-nucleo-h743zi2"
-required-features = ["rt", "revision_v", "stm32h743v", "ethernet"]
+name = "spi-dma-rtic"
+required-features = ["rt"]
 
 [[example]]
 name = "tick_timer"
@@ -245,17 +257,5 @@ name = "usb_phy_serial_interrupt"
 required-features = ["rt", "usb_hs", "rm0433"]
 
 [[example]]
-name = "rtc"
-required-features = ["rt", "rtc"]
-
-[[example]]
-name = "sai_dma_passthru"
-required-features = ["rm0433"]
-
-[[example]]
-name = "spi-dma-rtic"
-required-features = ["rm0433","rt"]
-
-[[example]]
-name = "crc"
-required-features = ["crc", "rt"]
+name = "vos0"
+required-features = ["revision_v"]

examples/sai_dma_passthru.rs

@@ -1,9 +1,8 @@
-//! This example was tested on the original Electro Smith Daisy Seed board with
+//! This example was tested on the original Electro Smith Daisy Seed board (STM32H750) with
 //! AK4556 codec https://www.electro-smith.com/daisy
 
 #![allow(unused_macros)]
 #![deny(warnings)]
-// #![deny(unsafe_code)]
 #![no_main]
 #![no_std]