silabs tokens

Silabs tokens
1.介绍
  标记是一个抽象数据常量，对应用程序具有特殊的持久含义。本文档描述了令牌并展示了如何在代码中使用它们。令牌可以是以下几种类型之一：

标准
索引
计数器
制造业

令牌可以分为以下一般组：

堆栈令牌 - 这些令牌是可读/写的，并在每个应用程序中定义以支持堆栈行为。这些令牌存在于模拟的EEPROM中。
应用程序令牌 - 这些令牌是读/写的，并由应用程序定义以支持应用程序行为。客户可以决定是否有应用程序令牌，它们是如何定义的以及它们的作用。这些令牌存在于模拟的EE-PROM中。
固定制造令牌 - 这些令牌是不可修改的只读令牌，特定于每个芯片并在芯片生产期间设置。它们支持关键的低级和高级功能。
客户制造令牌 - 这些令牌只能从片上代码读取，并可从外部编程工具读取/写入。这些令牌中的一些具有用于支持堆栈行为的定义目的。客户可以决定是否有任何额外的制造令牌，如何定义以及他们做了什么。

该文档还讨论了绑定，即EmberZNet PRO应用程序中使用的网络上两个设备之间的应用程序定义的关联。
2.关于tokens（译为令牌）
  令牌有两部分：令牌密钥和令牌数据。令牌密钥是用于存储和检索令牌数据的唯一标识符。在许多情况下，“令牌”一词的使用非常松散地表示令牌密钥，令牌数据或密钥和数据的组合。通常情况下，从上下文中可以清楚地知道使用何种含义。在此文档中，令牌始终引用键+数据对。

令牌通常存储在NVRAM中，NVRAM最常直接存储在闪存（制造令牌）中或存储在闪存之上的模拟EEPROM（堆栈和应用程序令牌）中。
1)目的
  与通用RAM使用相比，令牌系统的基本目的是允许令牌数据在重新启动和断电期间持续存在。通过使用令牌密钥来识别正确的数据，请求令牌数据的应用程序不需要知道数据的确切存储位置。这简化了应用程序设计和代码重用。当数据的底层存储可能随实施时间的变化而变化时，令牌也很有用。

由于EM3x工艺技术不提供内部EEPROM，因此实现了模拟EEPROM，以使用一段内部闪存进行堆栈和应用程序令牌存储。使用模拟EEPROM存储非易失性数据的器件在保证写周期方面具有不同的闪存性能水平，特别是2,000和20,000个写周期。最近，模拟EEPROM的版本2已经发布。对于版本1，EM3x使用4 kB或8 kB的高端闪存来存储模拟的EEPROM。对于版本2，模拟EEPROM需要36 kB的上闪存。请参见特定部件的数据表，以确定电压和温度保证写入周期的数量。由于写周期有限，

模拟EEPROM设计为尽可能透明地在令牌模块下方运行。模拟的EEPROM需要在数据移动时擦除闪存页面。该应用程序控制闪存页面的擦除，因为擦除页面将防止中断服务21毫秒。但是，应用程序只需要实现一个回调并定期调用一个实用程序函数。此外，还可以使用状态功能为应用程序提供有关模拟EE-PROM使用情况的两个基本统计信息。

Silicon Labs建议应用程序设计人员熟悉模拟EEPROM及其局限性，以便他们设计应用程序使用令牌以实现最佳闪存写入周期。有关更多信息，请参阅文档AN703，将模拟EEPROM用于Ember EM3x SoC平台。
2)用法
       网络堆栈提供了一组用于访问令牌数据的简单API。完整的文档可以在堆栈API参考中找到。

基本的API函数包括：

void halCommonGetToken（data，token）void halCommonSetToken（token，data）

图片