electronics
/
osmo-asf4-dfu
9
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
USB DFU (Device Firmware Upgrade) firmware for Atmel SAM devices supported by ASF4
31 Commits 2 Branches 1 Tag 1.1 MiB
C 94.5%
C++ 5.3%
Go to file
Kevin Redon 5078232cce document flashing procedure for sysmoOCTSIM 
the sysmoOCTSIM board does not have an onboard EDBG adapter such as
the SAM E54 Xplained Pro board.
instead SWD is used directly.

Change-Id: I85aa4db62464d0a1b558968d0423e2adbe491a4f
 		2019-02-03 13:59:40 +01:00
CMSIS use USB CDC Echo example project 2019-01-09 15:33:36 +01:00
config use sysmoOCTSIM USB PID and strings 2019-02-03 13:55:24 +01:00
contrib add contrib/jenkins.sh for build verification 2019-01-13 13:40:56 +01:00
documentation removed unused USB CDC stack 2019-01-16 18:41:23 +01:00
gcc remove unused example code 2019-01-16 18:41:23 +01:00
hal add flash ASF4 driver 2019-01-16 18:40:31 +01:00
hpl add flash ASF4 driver 2019-01-16 18:40:31 +01:00
hri use USB CDC Echo example project 2019-01-09 15:33:36 +01:00
include use USB CDC Echo example project 2019-01-09 15:33:36 +01:00
usb remove OCTSIM in USB ID 2019-01-31 18:02:10 +01:00
.gitignore ignore gdb history file 2019-01-16 18:40:31 +01:00
.gitreview Add git-review config 2019-01-13 13:05:24 +00:00
AtmelStart.env_conf use USB CDC Echo example project 2019-01-09 15:33:36 +01:00
AtmelStart.gpdsc use USB CDC Echo example project 2019-01-09 15:33:36 +01:00
LICENSE add license file 2019-01-16 18:41:23 +01:00
README.md document flashing procedure for sysmoOCTSIM 2019-02-03 13:59:40 +01:00
atmel_start.c use USB CDC Echo example project 2019-01-09 15:33:36 +01:00
atmel_start.h use USB CDC Echo example project 2019-01-09 15:33:36 +01:00
atmel_start_config.atstart use USB CDC Echo example project 2019-01-09 15:33:36 +01:00
atmel_start_pins.h change LED and switch to sysmoOCTSIM board 2019-02-03 13:54:55 +01:00
driver_init.c change LED and switch to sysmoOCTSIM board 2019-02-03 13:54:55 +01:00
driver_init.h add code to initialize flash 2019-01-16 18:40:31 +01:00
usb_dfu_main.c change LED and switch to sysmoOCTSIM board 2019-02-03 13:54:55 +01:00
usb_start.c change LED and switch to sysmoOCTSIM board 2019-02-03 13:54:55 +01:00
usb_start.h add USB DFU description 2019-01-16 18:39:41 +01:00

README.md

This is an implementation of the DFU mode of the USB DFU Device Class Specification for the Microchip SAM D5x/E5x micro-controller. It is meant to be used as bootloader to allow flashing the main application over USB.

This branch is specific to the proprietary sysmocom sysmoOCTSIM hardware.

The code uses the Atmel START ASFv4 library.

USB DFU

This implementation support the following USB DFU capabilities:

  • can download: allowing to download the code over USB on the device (enabled per default)
  • manifestation tolerant: allowing to download after a previous download (disabled per default)
  • will detach: forcing the device the reset after a download, else it wit for a USB reset (enable per default)

Set the corresponding attributes in the 'DFUD_IFACE_DESCB' macro definition in the 'usb/class/dfu/device/dfudf_desc.h' file.

Compiling

Use the 'Makefile' script to compile the source code using the ARM none EABI GCC cross-cimpilig toolchain:

cd gcc
make

The resulting firmware binary is AtmelStart.bin.

Flashing

To flash the bootloader you can use OpenOCD with any SWJ adapter.

The USB DFU bootloader should be flashed in a protected area of the flash memory to prevent for erasing it, as specified in data sheet section 25.6.2 Memory Organization. The bootloader size is configured in the NVM user configuration BOOTPROT field, as specified in data sheet section 25.6.9 NVM User Configuration. The bit position of the BOOTPROT field is documented in data sheet section 9.4 NVM User Page Mapping. We need to reserve as least 2 pages of 8192 bytes for the bootloader since it is a bit larger than 10 KB (e.g. over 8 KB). This setting will also tell the bootloader where to flash the application firmware to (e.g. after the bootloader reserved space). The LED will blink once per second if this size is not set.

ST-LINK/V2

To flash the USB DFU bootloader, we will use OpenOCD (with the SAM E54 patch and a ST-LINK/V2 SWD adapter. The command will perform the following actions:

  • remove reserved bootloader space so we can erase it (and reset MCU for change to be effective)
  • erase the whole flash
  • program the bootloader
  • reserve bootloader space

openocd --file interface/stlink.cfg --command "transport select hla_swd" --command "set CHIPNAME same54" --command "set CPUTAPID 0x2ba01477" --file target/atsame5x.cfg --command "init" --command "reset halt" --command "atsame5 bootloader 0" --command "flash erase_sector 0 0 last" --command "reset halt" --command "program ./AtmelStart.bin" --command "atsame5 bootloader 16384" --command "reset run" --command "shutdown"