Add feature to include FlashDevice device description

Author: mbrossard

Cargo.toml

@@ -17,6 +17,9 @@ name = "flash-algo"
 test = false
 bench = false
 
+[features]
+device_description = []
+
 [profile.dev]
 codegen-units = 1
 debug = 2

link.x

@@ -25,7 +25,7 @@ SECTIONS {
 
         *(.sdata)
         *(.sdata.*)
-        
+
         *(.bss)
         *(.bss.*)
 
@@ -35,6 +35,17 @@ SECTIONS {
         . = ALIGN(4);
     }
 
+    /*
+     * The device description is usually in DevDscr section, but adding it to
+     * PrgData in order to satisfy tools that need this section.
+     */
+    PrgData : {
+        KEEP(*(.DevDscr))
+        KEEP(*(.DevDscr.*))
+
+        . = ALIGN(4);
+    }
+
     /DISCARD/ : {
         /* Unused exception related info that only wastes space */
         *(.ARM.exidx);

src/main.rs

@@ -152,6 +152,49 @@ algorithm!(RP2Algo, {
 const BLOCK_SIZE: u32 = 65536;
 const SECTOR_SIZE: u32 = 4096;
 const BLOCK_ERASE_CMD: u8 = 0xd8;
+const FLASH_BASE: u32 = 0x1000_0000;
+
+#[repr(C)]
+pub struct FlashDevice {
+    pub version: u16,
+    pub device_name: [u8; 128],
+    pub device_type: u16,
+    pub device_address: u32,
+    pub size_device: u32,
+    pub size_page: u32,
+    pub reserved: u32,
+    pub val_empty: u8,
+    pub timeout_program: u32,
+    pub timeout_erase: u32,
+    pub sectors: [u32; 4],
+}
+
+#[cfg(feature = "device_description")]
+#[no_mangle]
+#[link_section = ".DevDscr"]
+pub static FlashDevice: FlashDevice = FlashDevice {
+    version: 1, // Version 1.01
+    device_name: [
+        0x52, 0x61, 0x73, 0x70, 0x65, 0x72, 0x72, 0x79, 0x20, 0x50, 0x69, 0x20, 0x52, 0x50, 0x32,
+        0x30, 0x34, 0x30, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    ], // "Rasperry Pi RP2040"
+    device_type: 5, // External SPI
+    device_address: FLASH_BASE, // Default device start address
+    size_device: 16 * 1024 * 1024, // Total Size of device (16 MiB)
+    size_page: PAGE_SIZE, // Programming page size
+    reserved: 0, // Must be zero
+    val_empty: 0xFF, // Content of erase memory
+    timeout_program: 500, // 500 ms
+    timeout_erase: 5000, // 5 s
+    sectors: [SECTOR_SIZE, FLASH_BASE, 0xFFFFFFFF, 0xFFFFFFFF],
+};
 
 impl FlashAlgorithm for RP2Algo {
     fn new(_address: u32, _clock: u32, _function: Function) -> Result<Self, ErrorCode> {