jeez/qm-bootloader

Quark MCUs Bootloader and Firmware Manager

Intel® Quark™ Bootloader

Overview

The Intel® Quark™ bootloader supports the following SoCs:

• Intel® Quark™ D2000 Microcontroller (D2000)
• Intel® Quark™ SE Microcontroller C1000 (SE C1000)

Contents

• Overview
• Support
• Hardware Compatibility
• External Dependencies
• License
• Organization
• Documentation
• Building
  • Environment
  • Building options
    • Target SoC selection
    • Firmware Management
    • Return from sleep
  • Flashing

Support

Information and support regarding Intel® Quark™ MCUs can be found in the following website:

http://www.intel.com/quark/mcu

Hardware Compatibility

This release has been validated with the following hardware:

• Intel® Quark™ SE Microcontroller C1000.
• Intel® Quark™ SE Microcontroller C1000 Development Platform.
• Intel® Quark™ Microcontroller D2000.
• Intel® Quark™ Microcontroller D2000 Development Platform.

External Dependencies

• The ISSM toolchain is required to build the source code. It provides the IAMCU toolchain (i586-intel-elfiamcu). The currently supported version is "2016-05-12".
• OpenOCD is required to flash the bootloader onto the SoC.
• The toolchain is provided within the ISSM package or standalone tarballs.

More info about dependencies can be found in the bootloader resources file.

License

Please refer to COPYING.

Organization

.
├── bootstrap       : Bootstrap code
│   └── soc         : SoC-specific bootstrap code and headers
├── doc             : Bootloader documentation
├── fw-manager      : Firmware managment code
│   └── dfu         : DFU over UART code
│   └── qfm         : Quark Firmware Management (QFM) protocol code
│   └── qfu         : Quark Firmware Upgrade (QFU) image format code
└─  tools           : Firmware Management host-side tools

Documentation

All Documentation about the bootloader can be found in the doc folder:

• Bootloader resources
• Bootloader flow
• Firmware Manager User Guide
• Firmware Manager Overview

Building

The build system is based on the make tool. Make sure you have downloaded the toolchain as described in External Dependencies.

Environment

You must first set the IAMCU_TOOLCHAIN_DIR environment variable. Assuming the toolchain was unpacked into $HOME/issm_2016/ and that you would find i586-intel-elfiamcu-gcc at $HOME/issm_2016/tools/compiler/gcc-ia/5.2.1/bin, the variable can be set with:

export IAMCU_TOOLCHAIN_DIR=$HOME/issm_2016/tools/compiler/gcc-ia/5.2.1/bin

QMSI sources are needed to build bootloader code. The QMSI_SRC_DIR environment variable must point to the QMSI folder, for instance:

export QMSI_SRC_DIR=$HOME/qmsi

If such a variable is not defined, the bootloader expects QMSI folder to be named qmsi and be a sibling folder of the bootloader one.

To use the "make flash" command, the $QM_BOOTLOADER_DIR environment variable should be set.

export QM_BOOTLOADER_DIR=$HOME/bootloader

Building options

The bootloader makefile supports the following build parameters:

• SOC
• ENABLE_FIRMWARE_MANAGER
• ENABLE_RESTORE_CONTEXT

Target SoC selection

Both D2000 and SE C1000 are supported. You can select them by setting the SOC variable.

To build for D2000:

make SOC=quark_d2000

To build for SE C1000:

make SOC=quark_se

On SE C1000, the ARC is not started as part of the ROM flow. It is up to user application / RTOS to do such. In a bare metal environment, to start the ARC the function sensor_activation() must be called. The function is provided by QMSI in the ss_init.h header file.

Firmware Management

ENABLE_FIRMWARE_MANAGER is used to enable firmware management inside of the bootloader,

By default, firmware management mode is not enabled.

More info on building and flashing an application using the firmware management mode can be found in the Firmware Manager User Guide.

Return from sleep

The Quark SE has support for sleep states that power off the CPU. When a wake event happens, the CPU starts over from the reset vector as in a normal power on. To do so, build both the bootloader and libqmsi with 'ENABLE_RESTORE_CONTEXT=1'.

make SOC=quark_se ENABLE_RESTORE_CONTEXT=1

The context of the Quark D2000 is restored by the hw. For that reason, the ENABLE_RESTORE_CONTEXT option has no effect on Quark D2000 SoC.

By default, context save and restore management is enabled on Quark SE.

Flashing

The bootloader must be flashed on the OTP ROM flash region.

For flashing the board OpenOCD must be used. You can optionally use gdb as a front-end for OpenOCD as described below.

Assuming the toolchain was unpacked into $HOME/issm_2016/, this can be done with:

$ cd $HOME/issm_2016/tools/debugger/openocd

For D2000, start OpenOCD with the following command:

$ ./bin/openocd -f scripts/board/quark_d2000_onboard.cfg

For SE C1000, start OpenOCD with the following command:

$ ./bin/openocd -f scripts/board/quark_se_onboard.cfg

Create a new terminal session at this point and set environment variables accordingly. Then launch a GDB session using:

$ gdb

To connect to the remote port, enter the following GDB commands:

(gdb) target remote :3333

(gdb) monitor clk32M 5000

For D2000, the following command is used to flash the bootloader to the device:

(gdb) monitor load_image $PATH_TO_QM_BOOTLOADER/build/release/quark_d2000/rom/quark_d2000_rom.bin 0x0

For SE C1000, the following command is used to flash the bootloader to the device:

(gdb) monitor load_image $PATH_TO_QM_BOOTLOADER/build/release/quark_se/rom/quark_se_rom.bin 0xFFFFE000