器件 API 负责器件的功耗和一般配置。

Sl_Start – 该函数用于初始化通信接口、设置器件的使能引脚以及调用初始化完成回调。如果未提供回调函数，该函数处于阻塞状态，直至器件完成初始化过程。如果成功，器件会返回其职能角色：ROLE_STA、ROLE_AP、ROLE_P2P。否则，在失败时它会返回：ROLE_STA_ERR、ROLE_AP_ERR、ROLE_P2P_ERR

Sl_Stop – 该函数用于清除器件的使能引脚、关闭通信接口并调用停止完成回调（如果存在）。time-out 参数使用户能够控制休眠时序：

• 0 – 立即进入休眠模式
• 0xFFFF – 主机在休眠前等待器件响应，无超时保护。
• 0 < Timeout[msec] < 0xFFFF – 主机在休眠前等待器件响应，已定义超时保护。此超时定义了等待的最长时间。NWP 响应的发送时间可早于此超时。

sl_DevSet – 该函数用于配置不同的器件参数。使用的主参数是 DeviceSetID 和 Option。可能的 DeviceSetID 和 Option 组合为：

• SL_DEVICE_GENERAL_CONFIGURATION – 一般配置选项为：
  • SL_DEVICE_GENERAL_CONFIGURATION_DATE_TIME – 配置器件内部日期和时间。时间参数保留在休眠模式下，但在关机时会复位。

设置器件时间和日期示例：

SlDateTime_t dateTime= {0};
dateTime.sl_tm_day =   (unsigned long)23;          // Day of month (DD format) range 1-13
dateTime.sl_tm_mon =   (unsigned long)6;           // Month (MM format) in the range of 1-12 
dateTime.sl_tm_year =  (unsigned long)2014;        // Year (YYYY format) 
dateTime.sl_tm_hour =  (unsigned long)17;          // Hours in the range of 0-23
dateTime.sl_tm_min =   (unsigned long)55;          // Minutes in the range of 0-59
dateTime.sl_tm_sec =   (unsigned long)22;          // Seconds in the range of  0-59
sl_DevSet(SL_DEVICE_GENERAL_CONFIGURATION,SL_DEVICE_GENERAL_CONFIGURATION_DATE_TIME,sizeof(SlDateTime_t),(unsigned char *
) (&dateTime));

sl_DevGet – 该函数使用户能够读取不同的器件参数。使用的主参数是 DeviceSetID 和 Option 参数。可能的 DeviceSetID 和 Option 组合为：

• SL_DEVICE_GENERAL_CONFIGURATION
  • SL_DEVICE_GENERAL_CONFIGURATION_DATE_TIME
  • SL_DEVICE_GENERAL_VERSION – 返回器件固件版本
• SL_DEVICE_STATUS – 器件状态选项为：
  • SL_EVENT_CLASS_DEVICE – 可能的值为：
    • EVENT_DROPPED_DEVICE_ASYNC_GENERAL_ERROR – 一般系统错误，检查系统配置。
    • STATUS_DEVICE_SMART_CONFIG_ACTIVE – 器件处于 SmartConfig 模式。
  • SL_EVENT_CLASS_WLAN
    • EVENT_DROPPED_WLAN_WLANASYNCONNECTEDRESPONSE
    • EVENT_DROPPED_WLAN_WLANASYNCDISCONNECTEDRESPONSE
    • EVENT_DROPPED_WLAN_STA_CONNECTED
    • EVENT_DROPPED_WLAN_STA_DISCONNECTED
    • STATUS_WLAN_STA_CONNECTED
• SL_EVENT_CLASS_BSD – 可能的值为：
  • EVENT_DROPPED_SOCKET_TXFAILEDASYNCRESPONSE
• SL_EVENT_CLASS_NETAPP – 可能的值为：
  • EVENT_DROPPED_NETAPP_IPACQUIRED
  • EVENT_DROPPED_NETAPP_IPACQUIRED_V6
  • EVENT_DROPPED_NETAPP_IP_LEASED
  • EVENT_DROPPED_NETAPP_IP_RELEASED
• SL_EVENT_CLASS_NETCFG（当前未使用）
• SL_EVENT_CLASS_NVMEM（当前未使用）

获取版本的示例：

SlVersionFull ver;
pConfigOpt = SL_DEVICE_GENERAL_VERSION;
sl_DevGet(SL_DEVICE_GENERAL_CONFIGURATION, &pConfigOpt,&pConfigLen,
         (unsigned char*)(&ver));
         printf("CHIP %d\nMAC 31.%d.%d.%d.%d\nPHY %d.%d.%d.%d\nNWP 
         %d.%d.%d.%d\nROM%d\nHOST%d.%d.%d.%d\n",
         ver.ChipFwAndPhyVersion.ChipId,
         ver.ChipFwAndPhyVersion.FwVersion[0],ver.ChipFwAndPhyVersion.FwVersion[1],
         ver.ChipFwAndPhyVersion.FwVersion[2],ver.ChipFwAndPhyVersion.FwVersion[3],
         ver.ChipFwAndPhyVersion.PhyVersion[0],ver.ChipFwAndPhyVersion.PhyVersion[1],
         ver.ChipFwAndPhyVersion.PhyVersion[2],ver.ChipFwAndPhyVersion.PhyVersion[3],
         ver.NwpVersion[0],ver.NwpVersion[1],ver.NwpVersion[2],ver.NwpVersion[3],
         ver.RomVersion, SL_MAJOR_VERSION_NUM, SL_MINOR_VERSION_NUM, SL_VERSION_NUM, 
         SL_SUB_VERSION_NUM);

sl_EventMaskSet – 屏蔽来自器件的异步事件。屏蔽的事件不会从器件生成异步消息。该函数用于接收 EventClass 和位掩码。事件和掩码选项为：

• SL_EVENT_CLASS_WLAN 用户事件：
  • SL_WLAN_CONNECT_EVENT
  • SL_WLAN_DISCONNECT_EVENT
  • SL_WLAN_STA_CONNECTED_EVENT
  • SL_WLAN_STA_DISCONNECTED_EVENT
  • SL_WLAN_SMART_CONFIG_COMPLETE_EVENT
  • SL_WLAN_SMART_CONFIG_STOP_EVENT
  • SL_WLAN_P2P_DEV_FOUND_EVENT
  • SL_WLAN_P2P_NEG_REQ_RECEIVED_EVENT
  • SL_WLAN_CONNECTION_FAILED_EVENT
• SL_EVENT_CLASS_DEVICE 用户事件：
  • SL_DEVICE_FATAL_ERROR_EVENT
  • SL_DEVICE_ABORT_ERROR_EVENT
• SL_EVENT_CLASS_BSD 用户事件：
  • SL_SOCKET_TX_FAILED_EVENT
  • SL_SOCKET_ASYNC_EVENT
• SL_EVENT_CLASS_NETAPP 用户事件：
  • SL_NETAPP_IPV4_IPACQUIRED_EVENT
  • SL_NETAPP_IPACQUIRED_V6_EVENT
  • SL_NETAPP_IP_LEASED_EVENT
  • SL_NETAPP_IP_RELEASED_EVENT
  • SL_NETAPP_HTTPGETTOKENVALUE_EVENT
  • SL_NETAPP_HTTPPOSTTOKENVALUE_EVENT

从 WLAN 类屏蔽掉连接和断开连接的示例：

sl_EventMaskSet(SL_EVENT_CLASS_WLAN, (SL_WLAN_CONNECT_EVENT | SL_WLAN_DISCONNECT_EVENT) );

sl_EventMaskGet – 从器件返回事件位掩码。如果已屏蔽该事件，则器件不会将其发送。该函数类似于 sl_EventMaskSet。

为 WLAN 类获取事件掩码的示例：

sl_EventMaskSet(SL_EVENT_CLASS_WLAN,
(SL_WLAN_CONNECT_EVENT | SL_WLAN_DISCONNECT_EVENT) );

sl_EventMaskGet – 从器件返回事件位掩码。如果已屏蔽事件，则器件不会发送事件。该函数类似于 sl_EventMaskSet。

为 WLAN 类获取事件掩码的示例：

unsigned long maskWlan;
sl_StatusGet(SL_EVENT_CLASS_WLAN,&maskWlan);

sl_Task

• 非 OS 平台 – 应从主循环调用
• 多线程平台 – 当用户不采用外部派生函数时，应从分配给 SimpleLink 驱动程序的专用线程调用该函数。在此模式中，该函数从不返回。

sl_UartSetMode – 如果用户所选的主机接口为 UART，应使用此函数。该函数用于设置用户的 UART 配置：

• 波特率
• 流控制
• COM 端口