See Standalone for documentation.

License#

Copyright 2018 Silicon Laboratories Inc. www.silabs.com

The licensor of this software is Silicon Laboratories Inc. Your use of this software is governed by the terms of Silicon Labs Master Software License Agreement (MSLA) available at www.silabs.com/about-us/legal/master-software-license-agreement. This software is distributed to you in Source Code format and is governed by the sections of the MSLA applicable to Source Code.

/***************************************************************************/
#ifndef __BOOTLOADER_STANDALONE_H__
#define __BOOTLOADER_STANDALONE_H__

uint16_t halGetStandaloneBootloaderVersion(void);

#define NO_BOOTLOADER_MODE                 0xFF

#define STANDALONE_BOOTLOADER_NORMAL_MODE   1

#define STANDALONE_BOOTLOADER_RECOVERY_MODE 0

EmberStatus halLaunchStandaloneBootloader(uint8_t mode);

#endif //__BOOTLOADER_STANDALONE_H__

Macros#

#define

Define a numerical value for NO BOOTLOADER mode. In other words, the bootloader should not be run.

#define

Define a numerical value for the normal bootloader mode.

#define

Define a numerical value for the recovery bootloader mode.

Functions#

uint16_t

Detects if the standalone bootloader is installed, and if so returns the installed version.

Quits the current application and launches the standalone bootloader (if installed). The function returns an error if the standalone bootloader is not present.

Macro Definition Documentation#

NO_BOOTLOADER_MODE#

#define NO_BOOTLOADER_MODE
Value:
0xFF

Define a numerical value for NO BOOTLOADER mode. In other words, the bootloader should not be run.


Definition at line 43 of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/bootloader-interface-standalone.h

STANDALONE_BOOTLOADER_NORMAL_MODE#

#define STANDALONE_BOOTLOADER_NORMAL_MODE
Value:
1

Define a numerical value for the normal bootloader mode.


Definition at line 47 of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/bootloader-interface-standalone.h

STANDALONE_BOOTLOADER_RECOVERY_MODE#

#define STANDALONE_BOOTLOADER_RECOVERY_MODE
Value:
0

Define a numerical value for the recovery bootloader mode.


Definition at line 51 of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/bootloader-interface-standalone.h

Function Documentation#

halGetStandaloneBootloaderVersion#

uint16_t halGetStandaloneBootloaderVersion (void )

Detects if the standalone bootloader is installed, and if so returns the installed version.

Parameters
N/A

A returned version of 0x1234 would indicate version 1.2 build 34

Returns


Definition at line 38 of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/bootloader-interface-standalone.h

halLaunchStandaloneBootloader#

EmberStatus halLaunchStandaloneBootloader (uint8_t mode)

Quits the current application and launches the standalone bootloader (if installed). The function returns an error if the standalone bootloader is not present.

Parameters
N/Amode

Controls the mode in which the standalone bootloader will run. See the bootloader Application Note for full details. Options are:

Both modes also allow an image transfer to begin via serial xmodem.

Returns


Definition at line 71 of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/bootloader-interface-standalone.h