Legacy HAL#

The Legacy HAL is an implementation of the Hardware Abstraction Layer (HAL) that was used by the Zigbee EmberZNet and Flex Connect stacks before their transition to the new component-based architecture (Zigbee version 7.0 and Connect version 3.0).

This component is not a complete duplicate of the old HAL. It only contains the most commonly used pieces to enable our networking stacks and sample applications and to support porting customer applications to the new component-based implementation. Currently, Zigbee and Connect sample applications are dependent on this component. Eventually, they will be ported to use new HAL components directly so that this component can become optional or be deprecated. Note

This component is only designed to be used with Zigbee and Connect stack applications. Do not use with any other stacks as it will likely introduce problems.

Modules#

HalEepromInformationType

EepromStateType

Application Bootloader Interface

Button

Common Bootloader

Cyclic Redundancy Check

Diagnostics

LED

Microcontroller functions

Random Numbers

Reset Cause Definitions

SimEE2 to NVM3 Upgrade

Simulated EEPROM 1 and 2

Standalone Bootloader

Functions#

uint16_t

halCommonGetInt16uMillisecondTick(void)

This function will get 16u ms tick data.

uint32_t

halCommonGetInt32uMillisecondTick(void)

This function will get 32u ms tick data.

uint64_t

halCommonGetInt64uMillisecondTick(void)

This function will get 64u ms tick data.

uint16_t

halCommonGetInt16uQuarterSecondTick(void)

This function will get 16u quater second tick data.

uint16_t

halInternalStartSystemTimer(void)

This function will start system timer.

void

halCommonDelayMicroseconds(uint16_t us)

This function will delay an amount of time in us.

void

halCommonDelayMilliseconds(uint16_t ms)

This function will delay an amount of time in ms.

EmberStatus

halCommonIdleForMilliseconds(uint32_t *duration)

This function will set state to idle for an amount of time in ms.

void

halStackSymbolDelayAIsr(void)

This function is halStackSymbolDelayAIsr.

void

halStackRadioPowerUpBoard(void)

This function is halStackRadioPowerUpBoard.

void

halStackRadioPowerDownBoard(void)

This function is halStackRadioPowerUpBoard.

void

halStackProcessBootCount(void)

This function is halStackProcessBootCount.

const HalEepromInformationType *

halEepromInfo(void)

Call this function to get information about the external EEPROM and its capabilities.

Macros#

#define

simulatedTimePasses ()

#define

EEPROM_PAGE_SIZE (128ul)

Definition of an EEPROM page size, in bytes.

#define

EEPROM_FIRST_PAGE (0)

Define the location of the first page in EEPROM.

#define

EEPROM_IMAGE_START (EEPROM_FIRST_PAGE * EEPROM_PAGE_SIZE)

Define the location of the image start in EEPROM as a function of the EEPROM_FIRST_PAGE and EEPROM_PAGE_SIZE.

#define

EEPROM_SUCCESS 0U

Define EEPROM success status.

#define

EEPROM_ERR 1U

Define EEPROM error status.

#define

EEPROM_ERR_MASK 0x80U

Define EEPROM error mask.

#define

EEPROM_ERR_PG_BOUNDARY 0x81U

Define EEPROM page boundary error.

#define

EEPROM_ERR_PG_SZ 0x82U

Define EEPROM page size error.

#define

EEPROM_ERR_WRT_DATA 0x83U

Define EEPROM write data error.

#define

EEPROM_ERR_IMG_SZ 0x84U

Define EEPROM image too large error.

#define

EEPROM_ERR_ADDR 0x85U

Define EEPROM invalid address error.

#define

EEPROM_ERR_INVALID_CHIP 0x86U

Define EEPROM chip initialization error.

#define

EEPROM_ERR_ERASE_REQUIRED 0x87U

Define EEPROM erase required error.

#define

EEPROM_ERR_NO_ERASE_SUPPORT 0x88U

Define EEPROM error for no erase support.

#define

EEPROM_INFO_VERSION (0x0202)

The current version of the HalEepromInformationType data structure.

#define

EEPROM_INFO_MAJOR_VERSION (0x0200)

eeprom info major version

#define

EEPROM_INFO_MAJOR_VERSION_MASK (0xFF00)

eeprom info major version mask

#define

EEPROM_INFO_MIN_VERSION_WITH_WORD_SIZE_SUPPORT 0x0102U

eeprom info min version with word size support

#define

EEPROM_CAPABILITIES_ERASE_SUPPORTED (0x0001U)

Eeprom capabilites mask that indicates the erase API is supported.

#define

EEPROM_CAPABILITIES_PAGE_ERASE_REQD (0x0002U)

Eeprom capabilites mask that indicates page erasing is required before new data can be written to a device.

#define

EEPROM_CAPABILITIES_BLOCKING_WRITE (0x0004U)

Eeprom capabilites mask that indicates that the write routine is blocking on this device.

#define

EEPROM_CAPABILITIES_BLOCKING_ERASE (0x0008U)

Eeprom capabilites mask that indicates that the erase routine is blocking on this device.

#define

EEPROM_CAPABILITIES_PART_ERASE_SECONDS (0x0010U)

Eeprom capabilities mask that indicateds that the partEraseTime field of HalEepromInformationType is in seconds instead of the usual millisecondss.

Function Documentation#

halCommonGetInt16uMillisecondTick#

uint16_t halCommonGetInt16uMillisecondTick (void )

This function will get 16u ms tick data.

Parameters

Type	Direction	Argument Name	Description
void	N/A

Returns

halCommonGetInt32uMillisecondTick#

uint32_t halCommonGetInt32uMillisecondTick (void )

This function will get 32u ms tick data.

Parameters

Type	Direction	Argument Name	Description
void	N/A

Returns

halCommonGetInt64uMillisecondTick#

uint64_t halCommonGetInt64uMillisecondTick (void )

This function will get 64u ms tick data.

Parameters

Type	Direction	Argument Name	Description
void	N/A

Returns

halCommonGetInt16uQuarterSecondTick#

uint16_t halCommonGetInt16uQuarterSecondTick (void )

This function will get 16u quater second tick data.

Parameters

Type	Direction	Argument Name	Description
void	N/A

Returns

halInternalStartSystemTimer#

uint16_t halInternalStartSystemTimer (void )

This function will start system timer.

Parameters

Type	Direction	Argument Name	Description
void	N/A

Returns

halCommonDelayMicroseconds#

void halCommonDelayMicroseconds (uint16_t us)

This function will delay an amount of time in us.

Parameters

Type	Direction	Argument Name	Description
uint16_t	N/A	us	second in us

halCommonDelayMilliseconds#

void halCommonDelayMilliseconds (uint16_t ms)

This function will delay an amount of time in ms.

Parameters

Type	Direction	Argument Name	Description
uint16_t	N/A	ms	second in ms

halCommonIdleForMilliseconds#

EmberStatus halCommonIdleForMilliseconds (uint32_t * duration)

This function will set state to idle for an amount of time in ms.

Parameters

Type	Direction	Argument Name	Description
uint32_t *	N/A	duration	second in us

Returns

EmberStatus

halStackSymbolDelayAIsr#

void halStackSymbolDelayAIsr (void )

This function is halStackSymbolDelayAIsr.

Parameters

Type	Direction	Argument Name	Description
void	N/A

halStackRadioPowerUpBoard#

void halStackRadioPowerUpBoard (void )

This function is halStackRadioPowerUpBoard.

Parameters

Type	Direction	Argument Name	Description
void	N/A

halStackRadioPowerDownBoard#

void halStackRadioPowerDownBoard (void )

This function is halStackRadioPowerUpBoard.

Parameters

Type	Direction	Argument Name	Description
void	N/A

halStackProcessBootCount#

void halStackProcessBootCount (void )

This function is halStackProcessBootCount.

Parameters

Type	Direction	Argument Name	Description
void	N/A

halEepromInfo#

const HalEepromInformationType * halEepromInfo (void )

Call this function to get information about the external EEPROM and its capabilities.

Parameters

Type	Direction	Argument Name	Description
void	N/A

The format of this call must not be altered. However, the content can be changed to work with a different device.

Returns

A pointer to a HalEepromInformationType data structure, or NULL if the driver does not support this API

Macro Definition Documentation#

simulatedTimePasses#

#define simulatedTimePasses

EEPROM_PAGE_SIZE#

#define EEPROM_PAGE_SIZE

Value:

(128ul)

Definition of an EEPROM page size, in bytes.

This definition is deprecated, and should no longer be used.

EEPROM_FIRST_PAGE#

#define EEPROM_FIRST_PAGE

Value:

(0)

Define the location of the first page in EEPROM.

This definition is deprecated, and should no longer be used.

EEPROM_IMAGE_START#

#define EEPROM_IMAGE_START

Value:

(EEPROM_FIRST_PAGE * EEPROM_PAGE_SIZE)

Define the location of the image start in EEPROM as a function of the EEPROM_FIRST_PAGE and EEPROM_PAGE_SIZE.

This definition is deprecated, and should no longer be used.

EEPROM_SUCCESS#

#define EEPROM_SUCCESS

Value:

0U

Define EEPROM success status.

EEPROM_ERR#

#define EEPROM_ERR

Value:

1U

Define EEPROM error status.

EEPROM_ERR_MASK#

#define EEPROM_ERR_MASK

Value:

0x80U

Define EEPROM error mask.

EEPROM_ERR_PG_BOUNDARY#

#define EEPROM_ERR_PG_BOUNDARY

Value:

0x81U

Define EEPROM page boundary error.

EEPROM_ERR_PG_SZ#

#define EEPROM_ERR_PG_SZ

Value:

0x82U

Define EEPROM page size error.

EEPROM_ERR_WRT_DATA#

#define EEPROM_ERR_WRT_DATA

Value:

0x83U

Define EEPROM write data error.

EEPROM_ERR_IMG_SZ#

#define EEPROM_ERR_IMG_SZ

Value:

0x84U

Define EEPROM image too large error.

EEPROM_ERR_ADDR#

#define EEPROM_ERR_ADDR

Value:

0x85U

Define EEPROM invalid address error.

EEPROM_ERR_INVALID_CHIP#

#define EEPROM_ERR_INVALID_CHIP

Value:

0x86U

Define EEPROM chip initialization error.

EEPROM_ERR_ERASE_REQUIRED#

#define EEPROM_ERR_ERASE_REQUIRED

Value:

0x87U

Define EEPROM erase required error.

EEPROM_ERR_NO_ERASE_SUPPORT#

#define EEPROM_ERR_NO_ERASE_SUPPORT

Value:

0x88U

Define EEPROM error for no erase support.

EEPROM_INFO_VERSION#

#define EEPROM_INFO_VERSION

Value:

(0x0202)

The current version of the HalEepromInformationType data structure.

EEPROM_INFO_MAJOR_VERSION#

#define EEPROM_INFO_MAJOR_VERSION

Value:

(0x0200)

eeprom info major version

EEPROM_INFO_MAJOR_VERSION_MASK#

#define EEPROM_INFO_MAJOR_VERSION_MASK

Value:

(0xFF00)

eeprom info major version mask

EEPROM_INFO_MIN_VERSION_WITH_WORD_SIZE_SUPPORT#

#define EEPROM_INFO_MIN_VERSION_WITH_WORD_SIZE_SUPPORT

Value:

0x0102U

eeprom info min version with word size support

EEPROM_CAPABILITIES_ERASE_SUPPORTED#

#define EEPROM_CAPABILITIES_ERASE_SUPPORTED

Value:

(0x0001U)

Eeprom capabilites mask that indicates the erase API is supported.

EEPROM_CAPABILITIES_PAGE_ERASE_REQD#

#define EEPROM_CAPABILITIES_PAGE_ERASE_REQD

Value:

(0x0002U)

Eeprom capabilites mask that indicates page erasing is required before new data can be written to a device.

EEPROM_CAPABILITIES_BLOCKING_WRITE#

#define EEPROM_CAPABILITIES_BLOCKING_WRITE

Value:

(0x0004U)

Eeprom capabilites mask that indicates that the write routine is blocking on this device.

EEPROM_CAPABILITIES_BLOCKING_ERASE#

#define EEPROM_CAPABILITIES_BLOCKING_ERASE

Value:

(0x0008U)

Eeprom capabilites mask that indicates that the erase routine is blocking on this device.

EEPROM_CAPABILITIES_PART_ERASE_SECONDS#

#define EEPROM_CAPABILITIES_PART_ERASE_SECONDS

Value:

(0x0010U)

Eeprom capabilities mask that indicateds that the partEraseTime field of HalEepromInformationType is in seconds instead of the usual millisecondss.