Firmware » History » Version 2
laforge, 02/19/2016 10:50 PM
| 1 | 1 | laforge | [[PageOutline]] |
|---|---|---|---|
| 2 | = OsmoSDR Firmware = |
||
| 3 | |||
| 4 | The OsmoSDR firmware is written in C language. It uses a modified version of the Atmel-provided sam3u drivers (at91lib). |
||
| 5 | |||
| 6 | There are multiple firmware images available, providing different interfaces towards the host PC. |
||
| 7 | |||
| 8 | == Firmware Variants == |
||
| 9 | |||
| 10 | There are multiple firmware images available, providing different interfaces towards the host PC. |
||
| 11 | |||
| 12 | === standard (usb-audio) firmware === |
||
| 13 | |||
| 14 | The standard firmware image exports a composite USB device with two interfaces: |
||
| 15 | * A USB standard audio class device (for actual received baseband samples) |
||
| 16 | * A USB CDC-ACM serial device (for hardware control like tuning) |
||
| 17 | |||
| 18 | The audio class device offers (at least) two sample rates: |
||
| 19 | * a high sample rate (1/2/4 MHz) for USB Audio drivers like the ALSA driver included in mainline Linux |
||
| 20 | * a low sample rate of 96 kHz (possibly 128 kHz) to work with the poor USB Audio driver of MS Windows OSs |
||
| 21 | |||
| 22 | == Firmware flashing == |
||
| 23 | |||
| 24 | There are two methods of flashing the firmware: |
||
| 25 | |||
| 26 | === DFU firmware flashing === |
||
| 27 | |||
| 28 | This is currently being worked on. FIXME. |
||
| 29 | |||
| 30 | === SAM-BA / rum-ba firmware flashing === |
||
| 31 | |||
| 32 | The sam3u contains a ROM based recovery boot loader called "SAM-BA". To activate this loader, |
||
| 33 | you have to |
||
| 34 | * power down the device |
||
| 35 | * close the ERASE jumper |
||
| 36 | * power up the device (1 second is sufficient) |
||
| 37 | * power down the device |
||
| 38 | * remove the ERASE jumper |
||
| 39 | * power up the device again |
||
| 40 | |||
| 41 | You will now the SAM-BA enumerate on USB using the following parameters: |
||
| 42 | * Vendor ID 0x03eb |
||
| 43 | * Product ID 0x6124 |
||
| 44 | * String: "Atmel Corp. at91sam SAMBA bootloader" |
||
| 45 | |||
| 46 | The SAM-BA loader exports a CDC-ACM (virtual serial port) interface. |
||
| 47 | |||
| 48 | You can now use either Atmel's original host PC software (large, complex) or the {{{rum-ba}}} program provided by OsmoSDR to flash the full firmware image: |
||
| 49 | {{{ |
||
| 50 | $ ./rumba /dev/ttyACM0 flash firmware_file_name.samba |
||
| 51 | }}} |
||
| 52 | 2 | laforge | |
| 53 | == Firmware building == |
||
| 54 | |||
| 55 | You first need to build and/or obtain a Cortex-M3 [wiki:Toolchain]. |
