​Zigbee快速入门第一节 – Zigbee预备课程
Zigbee快速入门第二节 – Zigbee基础介绍
Zigbee快速入门第三节 – EmberZnet和AppBuilder介绍
Zigbee快速入门第四节 – 由Light构建网络，并使用install code将Switch加入到这个网络
Zigbee快速入门第五节 – 在设备上使用API发送，接收和处理On-Off命令
Zigbee快速入门第六节 – 在Switch端用一个周期事件来执行自定义代码，在我们的实验中是控制LED闪烁。
Zigbee快速入门第七节 – 在Switch端使用非易失性存储器来存储自定义数据 

1. 简介

1.1. 实验内容

Zigbee快速入门——新兵训练营培训的实验环节将涵盖以下四个部分。我们通过这四个部分来向大家逐步展示，如何从零开始构建一个Zigbee应用。

本文档中的实验是“Zigbee快速入门——新兵训练营”系列中的第四部分。

• 第一部分，由Light构建网络，并使用install code将Switch加入到这个网络。
• 第二部分，在设备上使用API发送，接收和处理On-Off命令。
• 第三部分，在Switch端用一个周期事件来执行自定义代码，在我们的实验中是控制LED闪烁。
• 第四部分，在Switch端使用非易失性存储器来存储自定义数据。

1.2. 目的

本实验演示了EmberZNet Stack上非易失性数据存储的基本用法。此外，本文档中还包含了一些有关NVM, Token的基本知识，以帮助所有人更好地理解该实验。

你将学习

• 通过本实验课程，您将学习非易失性数据存储的基础知识，Silicon Labs提供的数据存储方案，以及如何使用Tokens来访问非易失性数据存储对象。

你需要做

• 在本实验中，我们需要解决的一个问题是，在没有EEPROM的EFR32MG12平台上，如何在系统掉电或复位时来保存当前灯的开/关状态。在本实验中，我们提供了使用Tokens来实现此目的的解决方案。
• 而且，您还需要检索制造商在生产过程中所烧录的制造字符串。

下图说明了该实验的基本流程。

2. 非易失性存储器的基础知识

2.1. 什么是非易失性存储？

非易失性存储器（NVM）是指当设备掉电后，所存储的数据不会消失的存储器。它通常是指半导体存储芯片中的存储器，包括NAND闪存和固态硬盘（SSD）之类的闪存存储，以及EPROM（可擦除可编程ROM）和EEPROM（电可擦除可编程ROM）之类的ROM芯片。
在Silicon Labs的微处理器和无线射频芯片上，其内部都没有包含EEPROM，NVM的功能是通过闪存来实现的。

2.2. 为什么在EmberZNet PRO中需要非易失性存储？

通常，EmberZNet协议栈和应用程序需要存储一些数据对象，这些对象在电源掉电之后仍需要保留。其中一部分数据是制造数据，只能写入一次，它由生产商在生产过程中写入。另一部分数据，在产品的整个生命周期内都会被频繁地写入和读取，这被称为动态数据。

2.3. Silicon Labs如何实现非易失性数据存储？

总体而言，Silicon Labs为闪存中的非易失性数据存储提供3种不同的实现方案。并且还提供Tokens机制，用于从非易失性数据存储中存储和检索数据。

Persistent Store (PS Store)
PS Store仅可用于除EFR32 2系列以外的所有的蓝牙设备。PS Store的大小为2048字节，并使用两个闪存页进行存储。蓝牙协议栈和应用程序都可以在该区域中存储数据。
由于本文档重点介绍EmberZNet PRO，因此在本文档中我们不会过多介绍PS Store。

SimEEv1和SimEEv2
SimEEv1（模拟EEPROM版本1）或SimEEv2（模拟EEPROM版本2）与EmberZNet PRO，Silicon Labs Thread，Silicon Labs Connect在EM35x和EFR32系列1平台上配合使用。SimEEv1使用两个虚拟页，每个虚拟页包含两个闪存页，而SimEEv2使用三个虚拟页，其中每个虚拟页包含6个闪存页。

NVM3
第三代非易失性存储器（NVM3）数据存储是SimEEv1 / v2和PS Store的替代产品，旨在与EFR32上运行的EmberZNet，Silicon Labs Thread，Connect和Bluetooth应用程序，以及EFM32上运行的MCU应用程序一起使用。
由于NVM3具有更高的可配置性，可以更好地平衡Tokens容量与所需的闪存，并且与DMP（动态多协议）应用程序兼容，因此推荐在EFR32上进行开发时，使用该方案。
在本实验中，我们将使用NVM3进行数据存储。

Token
Token的机制使应用程序可以将定义的数据类型存储在非易失性存储中，并且SimEEv1 / v2和NVM3都可以在Token机制下运行。
Token有两个部分：Token标识和Token数据。Token标识是用于存储和检索Token数据的唯一标识符。通过使用Token标识，应用程序无需知道数据在非易失性存储中的确切位置即可进行检索。
下图说明了Token与非易失性数据存储机制之间的关系。Silicon Labs提供了三种不同的Dynamic Tokens实现：SimEEv1（模拟EEPROM版本1），SimEEv2（模拟EEPROM版本2）和NVM3（第三代非易失性存储）。

图2-1 非易失性存储和Token

3. 使用Token API访问NVM3对象

在EFR32上进行开发时，我们推荐使用NVM3进行数据存储，因此以下部分将介绍如何使用Token API访问NVM3对象。

3.1. Token类型：Dynamic Tokens和Manufacturing Tokens

根据Token的使用方式，可以将其区分为Dynamic Tokens或Manufacturing Tokens。

图3-1 Token类型

3.1.1. Dynamic Tokens

Dynamic Tokens系统的基本目的是允许它可以像普通RAM一样频繁地访问（读取和写入），而且Token数据在系统重新启动和断电期间得以保存。它们存储在闪存的专用区域中，在该区域中，我们使用memory-rotation algorithm来防止闪存过度使用。
有两种类型的Dynamic Tokens，它们的格式有所不同：Basic Tokens和Indexed Tokens。

3.1.1.1. Basic (Non-indexed) Tokens

Basic Tokens可以被视为简单的char变量类型，只能作为一个单元进行访问。例如，Basic Tokens可用于存储数组，并且如果该 数组的任何元素发生更改，则必须重写整个数组。
Counter Token是一种特殊类型的Non-indexed Dynamic Tokens，用于存储一次递增1的数字。
提示：本实验中将不涉及Counter Token，有关Counter Token的更多信息，请参考UG103.7的2.6计数器对象一节和AN703的4.2何时定义Counter Token。

3.1.1.2. Indexed Tokens

Indexed Dynamic Tokens可以看作是char变量的链接数组，其中每个元素都希望独立于其他元素进行更改，因此每个元素在内部被存储为独立的Token，并可以通过Token API进行访问。
提示: 在本实验中也将不包括Indexed Tokens，有关Indexed Tokens的更多信息，请参考UG103.7的 2.7 索引对象和AN703的4.3 Array Tokens 和Indexed Tokens。

3.1.2. Manufacturing Tokens

Manufacturing Tokens是制造商在产品制造时设置，并且存储在闪存的绝对地址中。在芯片的生命周期内，Manufacturing Tokens只被写入一次或很少被写入。

3.2. Token的用法：创建和访问

现在，我们将讨论如何使用Token。这包括了解如何创建新Token，如何读取和修改Token数据，以及在哪里可以找到系统的默认Token。

3.2.1. Dynamic Tokens

要创建自定义Dynamic Tokens，您需要新建一个Token头文件并包含Token的定义。在本实验中，我们将创建一个custom-token.h的头文件，并包含自定义Dynamic Tokens的定义。

3.2.1.1. 创建Dynamic Tokens

通常，创建Dynamic Tokens涉及以下三个步骤。本文的4.3.2 创建自定义Token中包含一个示例以详细演示如何创建自定义Dynamic Tokens。

• 定义Token名称。
• 如果需要使用自定义的Token，则使用typedef定义该Token类型
• 定义Token存储。

3.2.1.1.1. 定义Token名称

在定义名称时，请不要在名称中加TOKEN前缀。对于NVM3 Dynamic Tokens，请使用单词NVM3KEY作为前缀。

1
/** * Custom Zigbee Application Tokens */ // Define token names here #define NVM3KEY_LED1_ON_OFF (NVM3KEY_DOMAIN_USER | 0x0001)

请注意，Token名称在此设备内必须唯一。
对于NVM3，自定义应用程序Token应使用NVM3KEY_DOMAIN_USER范围，以免与协议栈中的Token（例如NVM3KEY_DOMAIN_ZIGBEE）冲突。有关NVM3默认范围的信息，请参考下表。

图3-2 NVM3默认的范围

3.2.1.1.2. 定义Token类型

Token类型可以是内置的C数据类型，也可以使用typedef定义为自定义数据结构。

1
#if defined(DEFINETYPES) // Include or define any typedef for tokens here typedef struct { uint8_t ledIndex; // LED index bool ledOnOff; // LED ON OFF status } ledOnOffStatus_t; #endif //DEFINETYPES

3.2.1.1.3. 定义Token存储

定义任何自定义类型之后，您应该定义Token存储，以将所定义的Token通知给Token管理系统。
每个Token（无论是自定义Token还是默认Token）在此部分都有其自己的定义：

1
#ifdef DEFINETOKENS // Define the actual token storage information here DEFINE_BASIC_TOKEN(LED1_ON_OFF, ledOnOffStatus_t, {1, false}) #endif

DEFINE_BASIC_TOKEN带有三个参数：Token名称（LED1_ON_OFF，不带前缀“ NVM3KEY”），Token类型（ledOnOffStatus_t），如上所定义，以及Token的默认值。如果应用程序从未写入过该Token，则其值为默认值。
在上面的例子中，第一个值（ledIndex）被初始化为1表示LED1，而下一个值（ledOnOff）被设置false代表LED1的默认状态。

3.2.1.2. 访问Dynamic Tokens

协议栈提供了一组简单的API，用于访问Token数据。根据Token的类型，API略有不同。

3.2.1.2.1. 访问Basic (Non-indexed) Tokens

访问Basic (Non-indexed) Tokens API函数包括：

1
void halCommonGetToken(data, token) void halCommonSetToken(token, data)

在这种情况下，"token"参数是Token名称，"data"参数是Token数据。请注意，halCommonGetToken()和halCommonSetToken()是通用TokenAPI，可用于基本Dynamic Tokens和Manufacturing Tokens的访问。
现在，让我们使用一个示例来说明这些API的用法。
正如文章一开始的你需要做的章节所提及，我们需要频繁地存储LED1的开/关状态，并且在系统上电之后恢复LED1的状态。 在定义了Token之后，您可以使用如下代码片段访问它：

1
ledOnOffStatus_t led1OnOffStatus; // Retrieve the previous status of LED1 halCommonGetToken(&led1OnOffStatus, TOKEN_LED1_ON_OFF); led1OnOffStatus.ledOnOff = <current status>; // Store the current status of LED1 halCommonSetToken(TOKEN_LED1_ON_OFF, &led1OnOffStatus);

由于本实验是针对Silicon Labs EmberZNet协议栈入门介绍而设计的，因此我们将重点介绍Basic Tokens的用法，如果您对如何访问Counter Token感兴趣，请阅读AN11543.3.1.1 Accessing Counter Tokens。

3.2.1.2.2. 访问Indexed Tokens

要访问Indexed Tokens，请使用下面的API。如上所述，我们将不会在本文档中花费大量篇幅来介绍Indexed Tokens，更多信息请参考AN1154的3.3.2 Accessing Indexed Tokens。

1
void halCommonGetIndexedToken(data, token, index) void halCommonSetIndexedToken(token, index, data)

3.2.2. Manufacturing Tokens

Manufacturing Tokens的定义方式与Basic (Non-indexed)Dynamic Tokens的定义方式相同，因此，有关如何创建Token的信息，请参考创建Dynamic Tokens部分。它们之间的主要区别在于Token的存储位置和访问方式。
Manufacturing Tokens位于Manufacturing Tokens的专用闪存页面中（具有固定的绝对地址）。

3.2.2.1. 访问Manufacturing Tokens

顾名思义，Manufacturing Tokens通常在制造时一次写入专用闪存页面中的固定位置。由于它们的地址是固定的，因此如果禁用了此闪存区域的读保护，则可以轻松地从外部编程工具读取它们。
并且由于同一闪存单元，如果没有作擦除操作就无法重复写入。仅当Token当前处于已擦除状态时，才能通过代码来写入Manufacturing Tokens。覆盖之前已经写入的Manufacturing Tokens，总是需要先使用外部编程工具擦除Manufacturing Tokens所在的闪存页面。

Manufacturing Tokens应通过下面的专用API来访问。

1
halCommonGetMfgToken(data, token); halCommonSetMfgToken(token, data);

它们具有与Basic Tokens API相同的参数。使用专用Manufacturing Tokens访问API的两个主要目的是：

• 为了更快地访问；
• 为了在系统启动过程中，调用emberInit()初始化协议栈之前进行访问。

而且Manufacturing Tokens也可以通过Basic Tokens API halCommonGetToken()和halCommonSetToken()进行访问。

还让我们使用一个示例来说明这些专用API如何访问Manufacturing Tokens。
正如文章前面的章节你需要做中所提及，制造商将在生产过程中通过编程工具对“制造字符串”Token进行编程，我们可以运行如下代码段来从Manufacturing Tokens中检索该字符串。

1
tokTypeMfgString mfgString; // Retrieve the manufacturing string from the manufacturing token halCommonGetMfgToken(mfgString, TOKEN_MFG_STRING);

3.2.3. 在哪里可以找到默认Token定义

EmberZNet PRO协议栈已经为协议栈本身，应用程序框架，制造数据等定义了许多Token。
要查看协议栈所定义的Token，请参考文件：
<install-dir>/stack/config/token-stack.h

要查看Token应用程序框架，请在AppBuilder中生成项目后，导航至该项目的目录。文件<project_name>_tokens.h含有ZCL属性的Token，协议栈专用的Token文件znet-token.h中包括有Token插件头文件和Token自定义应用程序头文件。

要查看EFR32系列芯片的Manufacturing Tokens，请参阅以下文件：
<install-dir>/hal/micro/cortexm3/efm32/token-manufacturing.h

4. 实验

本节提供分步说明，以演示如何使用Basic Tokens向非易失性数据存储（在本实验中为NVM3）对象存储和从其检索LED1的状态。并演示如何使用专用API访问Manufacturing Tokens。
这也正是我们在本文章开始时你需要做的部分中提出的问题。

前提条件
请确保您已完成Zigbee预备课程，并确保所有SDK软件和开发套件都已准备就绪。

4.1. 硬体需求

该实验需要EFR32MG21 / EFR32MG13 / EFR32MG12开发板中的任何一款，我们推荐使用EFR32MG12无线开发板BRD4162A，我们的示例项目也是基于该套件创建的。以下是该开发板的布局。

图 4-1 无线入门套件

使用“ J-Link USB”连接器和开发套件中随附的USB电缆将开发板连接到PC。并将电源开关切换到“ AEM”位置。启动Simplicity Studio V4，它能识别所连接的设备，并将其列出在如下所示区域中。

图 4-2 Simplicity Studio检测到无线入门套件

4.2. 软件需求

该实验是在之前的三个实验“ 构建和连接”，“ 发送/关闭命令”和“ 使用事件”的基础上进行的，并且假设您已经按照我们的Zigbee预备课程中的说明安装了Simplicity Studio和必需的SDK 。

4.3. 实践

4.3.1. 打开Switch项目

该实验是在前三个实验基础之上。由于非易失性数据存储机制不依赖于网络节点类型，因此我们仅仅演示如何在Switch（路由节点）设备端通过TokenAPI访问NVM3对象，即Zigbee_Switch_ZR项目。

4.3.2. 创建自定义Token

我们将创建一个头文件custom-token.h，并在此头文件中定义Token名称，Token类型和Token存储。

• 在Simplicity studio中，单击[File]> [New]> [Project]
• 选择父文件夹作为项目的根路径，并将文件名设置为custom-token.h，然后单击[Finish]。
• 编辑头文件以定义Token。

首先,我们将Token名称定义为NVM3KEY_LED1_ON_OFF。有关Token名称定义规则的更多信息，请参考3.2.1.1.1. 定义Token名称。

• 问题:为什么需要用前置词NVM3KEY来定义Token名称？可以定义为TOKEN_LED1_ON_OFF吗？
• 提示: 请返回3.2.1.1.1. 定义Token名称部分以获取答案。

然后 定义用于记录LED开/关状态的Token类型，定义一个结构类型ledOnOffStatus_t，该结构类型包括两种不同的数据类型来表示LED索引和LED状态。有关更多信息，请参阅3.2.1.1.2. 定义Token类型。

最后, 使用宏定义DEFINE_BASIC_TOKEN来定义Token存储。有关更多信息，请参阅3.2.1.1.3. 定义Token存储。

以下是本实验环节中使用的头文件的内容，供您参考。

1
// File: custom-token.h // // Description: Custom token definitions used by the application. // // Copyright 2019 by Silicon Labs Corporation. All rights reserved. /** * Custom Zigbee Application Tokens */ // Define token names here #define NVM3KEY_LED1_ON_OFF (NVM3KEY_DOMAIN_USER | 0x0001) #if defined(DEFINETYPES) // Include or define any typedef for tokens here typedef struct { uint8_t ledIndex; // LED index bool ledOnOff; // LED ON OFF status } ledOnOffStatus_t; #endif //DEFINETYPES #ifdef DEFINETOKENS // Define the actual token storage information here DEFINE_BASIC_TOKEN(LED1_ON_OFF, ledOnOffStatus_t, {1, false}) #endif

创建自定义Token头文件后，您还需要执行一个步骤：通过Simplicity Studio中“ .isc”文件中“Token Configuration”部分下的[Includes]选项卡，将头文件添加到应用程序中。
注意：在.isc文件中添加头文件后，您需要再次点击“Generate”生成项目。

图4-3 添加自定义Token头文件

4.3.3. 访问Basic Tokens LED1_ON_OFF

让我们继续介绍如何访问已定义的Token。以下分步说明如何存储LED的状态，以及如何检索并恢复LED的状态值。
该实验的每个步骤在参考示例项目中都会有一个相应的注释Non-volatile Data Storage: Step x，以方便用户定位到正确的位置来编写代码。

4.3.3.1. 步骤1：检索Basic Tokens数据

打开Zigbee_Switch_ZR_callback.c，然后定义“ ledOnOffStatus_t”类型变量。

1
// Non-volatile Data Storage: Step 1 ledOnOffStatus_t led1OnOffStatus;

导航找到Zigbee_Switch_ZR_callback.c中的函数void emberAfMainInitCallback(void)，这将在初始化过程中被应用程序的主函数调用，用API halCommonGetToken()读取Basic Tokens “LED1_ON_OFF”。

1
// Non-volatile Data Storage: Step 1 // Retrieve the LED1 status before reset/power-off from the token halCommonGetToken(&led1OnOffStatus, TOKEN_LED1_ON_OFF);

然后根据所读取到的状态值，使用API halSetLed()或 halClearLed()对LED1进行相应的设置。

1
// Restore the LED1 status during initialization if(led1OnOffStatus.ledOnOff){ halSetLed(led1OnOffStatus.ledIndex); } else{ halClearLed(led1OnOffStatus.ledIndex); }

4.3.3.2. 步骤2：写入基本的Tokens数据

在上一个实验中，我们定义了一个事件处理函数ledBlinkingHandler()来定期切换LED1状态，本实验中，我们需要在每次切换完成之后将LED1的状态保存。
导航到Zigbee_Switch_ZR_callback.c的函数void ledBlinkingHandler(void)中。您也可以使用注释Non-volatile Data Storage: Step 2来定位所需要修改的代码的位置。
使用API halCommonSetToken()来写Token LED1_ON_OFF。

1
// Non-volatile Data Storage: Step 2 // Retrieve the previous status of LED1 halCommonGetToken(&led1OnOffStatus, TOKEN_LED1_ON_OFF); halToggleLed(led1OnOffStatus.ledIndex); led1OnOffStatus.ledOnOff = !led1OnOffStatus.ledOnOff; // Store the current status of LED1 halCommonSetToken(TOKEN_LED1_ON_OFF, &led1OnOffStatus);

4.3.3.3. 步骤3：测试

将必要的代码添加到项目后，请编译Zigbee_Switch_ZR项目，并将其烧录到BRD4162A开发板上。

• 点击[Build] 按钮开始编译项目。
• 编译完成后，展开“ Binaries”文件夹，然后右键单击* .hex文件并选择[Flash to Device ...]
• 在弹出窗口中选择所连接的开发板。现在，“Flash Programmer”已预先填充了所有需要的数据，您可以单击“program”。
• 单击“program”，然后等待一会儿以完成烧录。

图4-4 编译项目并烧录

在上电延迟几秒钟后，开发板上的LED1将定期闪烁，按复位键复位该设备，复位完成后，应用程序会将LED1恢复到复位/关闭电源之前的状态。
提示：您可以修改系统上电后LED1延迟闪烁的时间，以及在Zigbee_Switch_ZR_callback.c中使用API emberEventControlSetDelayMS(ledBlinking, 2000); 来更改LED1的闪烁间隔。

4.3.4. 访问Manufacturing Tokens

4.3.4.1. 步骤4：读取Manufacturing Tokens MFG_STRING

仅当Token当前处于已擦除状态时，才能通过代码写入Manufacturing Tokens。通常，制造商将使用外部编程工具（例如Simplicity Commander）烧录Manufacturing Tokens。 这部分将涉及读取Manufacturing TokensMFG_STRING，该Token保存了制造商在生产过程中所烧录的制造字符串。
导航到Zigbee_Switch_ZR_callback.c的函数void emberAfMainInitCallback(void)，然后通过API halCommonGetMfgToken读取Manufacturing TokensMFG_STRING。

1
// Non-volatile Data Storage: Step 4 tokTypeMfgString mfgString; halCommonGetMfgToken(mfgString, TOKEN_MFG_STRING); emberAfAppPrintln("MFG String: %s", mfgString);

请注意，如果之前未通过外部编程工具对制造字符串Token进行编程，则调试输出将为NULL，这表示制造字符串为NULL。

同样，您也可以使用Simplicity Commander来查看Manufacturing Tokens，如下所示。
$ commander tokendump --tokengroup znet

图4-5 查看Manufacturing Tokens

Question: Manufacturing Tokens可以通过Basic Tokens APIs来访问吗？
Hint: 请返回到3.2.2.1. 访问Manufacturing Tokens以获取答案。

5. 结论

我们希望您通过非易失性数据存储的实验，理解Silicon Labs所提供的实现方案，它们是NVM3，SimEEv1 / SimEEv2和PS Store。 另外，通过本实验，您也学习了如何创建和访问Basic Tokens以及如何访问Manufacturing Tokens。

有关非易失性数据存储和Token的更多信息，请参考以下文档。
UG103.7: Non-Volatile Data Storage Fundamentals
AN1154: Using Tokens for Non-Volatile Data Storage
AN1135: Using Third Generation NonVolatile Memory (NVM3) Data Storage
AN703: Simulated EEPROM

原文地址：zigbee快速入门第七章 – 在Switch端使用非易失性存储器来存储自定义数据 - 专注于智能家居产品的创新及应用

最后

以上就是轻松水杯最近收集整理的关于zigbee快速入门第七节 – 在Switch端使用非易失性存储器来存储自定义数据1. 简介2. 非易失性存储器的基础知识3. 使用Token API访问NVM3对象4. 实验5. 结论的全部内容，更多相关zigbee快速入门第七节内容请搜索靠谱客的其他文章。