这是描述信息

乐鑫matter通讯方案蓝牙wifi一体芯片esp-insights工程运行示例

乐鑫matter通讯方案蓝牙wifi一体芯片esp-insights工程运行示例

乐鑫matter通讯方案蓝牙wifi一体芯片esp-insights工程运行示例

乐鑫matter通讯方案蓝牙wifi一体芯片esp-insights工程运行示例

乐鑫matter通讯方案蓝牙wifi一体芯片esp-insights工程运行示例

乐鑫matter通讯方案蓝牙wifi一体芯片esp-insights工程运行示例

在esp-insights 工程中运行示例 diagnostics_smoke_test
1.下载 ESP Insights 组件
下载 ESPInsights 组件的工程代码,命令如下:
$git clone --recursive https://github.com/espressif/esp-insights.git
2.配置 ESP-IDF
ESP Insights 组件当前支持 master 分支和 v4.3.x、v4.2.x、v4.1x 的release 版本。对于版本 v4.3.2.需要按照如下命令打补丁 (Patch):
$ cd SIDF PATH
$ git apply -v <path/to/esp-insights>/idf-patches/Diagnostics-support-in-espidf- tag-v4.3.2.patch
对于版本 v4.2.2 和 v4.1.1,需要按照如下命令打补丁:
$cd $IDF_PATH
$git    apply    -v    <path/to/esp-insights>/idf-patches/Diagnostics-support-in-esp-idf-tag-v4.1.1-and-tag-v4.2.2.patch
用户可以根据自己需求,选择乐鑫matter通讯方案蓝牙wifi一体芯片HTTPS 协议或者 MQTT 协议传输诊断数据,具体配置选择可以参考如下命令:
$ idf.py menuconfig
对应的配置目录为Component config-ESP Insights-Insights default transports。如果选择 HTTPS 协议传输诊断数据,则需要用户登录 https://dashboard.insights.espressif.com/home/insights 界面查看设备的诊断日志。
3,编译烧录运行


上报 Coredump信息
在固件崩溃的情况下,Insights 代理将崩溃产生的核心信息存储到 Flash 中,并在后续启动时将其报告给乐鑫matter通讯方案蓝牙wifi一体芯片ESPInsights 云。这使得开发者可以查看设备生成的所有崩溃日志。


崩溃的整个堆栈 Backtrace 也将被捕获和报告。为了优化设备与 ESP Insights 云的通信,固件仅发送核心摘要信息。核心摘要信息包含程序计数器、异常原因、异常地址、通用寄存器和回溯。


该功能需要进行如下配置,开发者可以将如下配置添加至工程的默认配置文件(sdkconfig.defaults) 里。
1.CONFIG_ESP32_ENABLE_COREDUMP=Y
2.CONFIG_ESP32_ENABLE_COREDUMP_TO_FLASH=Y
3.CONFIG_ESP32_COREDUMP_DATA_FORMAT_ELF=Y
4.CONFIG ESP32_COREDUMP_CHECKSUM_CRC32-Y
5.CONFIG_ESP32_CORE_DUMP_MAX_TASKS_NUM=64


为了将崩溃产生的核心信息存储到乐鑫matter通讯方案蓝牙wifi一体芯片Flash 中,需要额外的分区用于存储。将下面一行信息添加到项目的分区表文件 (partitions.csv) 中。
1.coreddump,data,coredump,,64K


定制感兴趣的日志
Esp_log 组件是ESP-IDF 中的默认日志输出组件。通常 ESP_LOGE 和ESP_LOGW 用于记录固件中的错误和警告。使用esp_log组件记录的所有日志都由Insights代理跟踪并报告给ESPInsights 云。这允许开发者通过乐鑫matter通讯方案蓝牙wifi一体芯片ESPInsights_Dashboard 查看这些错误,为开发者提供有关可能发生的情况的详细信息。

开发者通过 esp diag log hook enable()函数和esp diag log_hook_disable()函数可以配置上报的日志等级。

1./*enable tracking error logsx/
2.esp_diag_log_hook enable(ESP_DIAG_LOG_TYPE_ERROR);
3.
4./*enable tracking all log levels*/
5.esp_diag_log_hook_enable(ESP_DIAG_LOG_TYPE_ERROR I ESP_DIAG_LOG_TYPE_WARNING|
6.ESP_DIAG_LOG_TYPE_EVENT):
7.
8./*disable tracking custom events*/
9.esp_diag_log_hook_disable(ESP_DIAG_LOG_TYPE_EVENT);


通常情况下,当设备发生崩溃之前都会打印一些错误或者警告等级的日志,这个时候往往可能无法将日志上报至云端,Insights 代理提供了一种方法来保持该日志,并且在上电重启时将日志上报给 ESP Insights 云。ESP32-C3 配备了RTC 内存,Insights 代理使用此内存来存储系统上发生的严重错误。在重新上电时,乐鑫matter通讯方案蓝牙wifi一体芯片Insights 代理都将检查 RTC 内存是否存在任何未报告的错误,并将其报告给 ESP Insights 云。


上报设备重启原因
Insights代理默认支持上报设备重启的原因,Insights代理会在每次启动后报告记录在 RTC内存的重启原因。这使得开发者可以识别设备是否因崩溃、看门狗触发、软件复位或终端用户的电源重置而引起重启。


上报自定义的指标值
Insights代理支持向ESPInsights云上报指标,然后通过ESPInsights仪表板查看图表,这些图表绘制了所上报的指标在一段时间内的变化情况。
通过配置 CONFIG_DIAG_ENABLE_METRICS=y 选项来开启上述功能。Insights 代理支持原先定义好的指标,如内存和 Wi-Fi信号强度等,另外也支持用户自定义的指标。


1.内存指标
Insights 代理支持报告当前可用内存、大可用块和峰值内存。这些参数记录的是内部 RAM以及外部 RAM(如果设备具有 PSRAM)的内存情况。乐鑫matter通讯方案蓝牙wifi一体芯片Insights 代理还支持记录内存分配失败的情况,不过需要使用 ESP-IDF 版本v4.2及更高版本。

通过配置CONFIG_DIAG_ENABLE_HEAP_METRICS=y 选项可支持上述功能。


2.Wi-Fi指标

Insights代理还支持报告Wi-Fi指标,可记录Wi-Fi信号强度(RSSI)和低的RSSI信息。Insights代理每30s统计一次 RSSI如果之前统计的和当前统计的相差 5dB,就会上报至 ESP Insights云。从ESP-IDF v4.3 版本开始,当 RSSI值低于预先配置的闽值时,Insights 代理也会记录低的 RSSI。乐鑫matter通讯方案蓝牙wifi一体芯片使用esP_wifi_set_rssi_threshold()函数可以配置阈值。还有一个函数可以在任何给定时间点收集和报告 Wi-Fi信号的指标,即:

1./*Reports RSSI to cloud and also prints to console*/
2. esp_diag_wifi_metrics_dump();


3.自定义指标
开发者可以通过如下函数添加自定义指标。

1./*Register a metrics to track room temperature*/
2.esp diag metrics register("temp","templ","Room temperature","room",
3.ESP_DIAG_DATA TYPE_UINT);
4.
5./*Record a data point for room temperature*/Fuint32 t room temp = get_room_temperature();
6.uint32 t room temp = get_room_temperature();
7.esp diag_metrics_add_uint("templ", &room_temp);


esp_diag_metrics_register()函数的原型如下:
1.esp_err_t esp_diag_metrics_register(const char *tag const char *key;
2.const char *label,const char *path,
3.esp_diag_data_type_t type);
在函数 esp_diag_metrics_register()的原型中,参数 tag 表示该指标的标签,用户可以自行定义;参数 key表示该指标的唯一标识,用于查找、设置该指标值的标识;参数label是显示在 ESP Insights 仪表盘的标签:参数 path 表示对 key 的分层路径,必须用“.”分隔如 wifi、heap.internal、heap.external;参数 type 表示数据类型,类型支持如下枚举值:

1.typedef enum {
2.ESP_DIAG_DATA_TYPE_BOOL,/*!< Data type boolean*/
3.ESP_DIAG_DATA_TYPE_INT, /*!< Data type integer*/
4.ESP_DIAG_DATA_TYPE_UNIT, /*!< Data type unsigned integer*/
5.ESP_DIAG_DATA_TYPE_FLOAT,/*!< Data type float*/
6.ESP_DIAG_DATA_TYPE_STR,/*!< Data type string*/
7.ESP_DIAG_DATA_TYPE_IPV4,/*!< Data type IPv4 address*/
8.ESP_DIAG_DATA_TYPE_MAC,/*!< Data type MAC address*/
9.}esp_diag_data_type_t;


4.变量
变量与指标类似,一般都不需要统计一段时间内变量的变化,因为变量一般表示设备的信息如设备的IP 地址。乐鑫matter通讯方案蓝牙wifi一体芯片通过配置CONEIG_DIAG_ENABLE_VARIABLES=y 选项可以统计变量信息。和指标一样,除了支持原先定义好的变量,如 IP、Wi-Fi 等信息,也支持用户自定义变量。
(1)网络变量。目前支持 Wi-Fi和IP 中的变量,Wi-Fi中的变量包括BSSID、SSID、Wi-Fi 断开连接的原因、当前信道、Wi-Fi 连接认证模式和连接状态;IP 中的变量包括网关地址、IPv4 地址和子网掩码。
(2)自定义变量。开发者可以通过如下函数添加自定义变量:
1./*Register a variable to track stations associated with ESP32 AP*/
2.esp_diag_variable_register(“wifi”,”sta_cnt”,”STAs associated”,
3.”wifi.sta”,ESP_DIAG_DATA_TYPE_UINT);
4.
5./*Assuming WIFI_EVENT_AP_STACONNECTED and WIFI_EVEN_ AP_STADISCONNECTED
6.events track the number of associated stations*/
7.esp_diag_variable_add_uint("sta_cnt",&sta_cnt);
函数 esp_diag_variable_register ()的原型如下:
1.esp_err_t esp_diag_variable_register(const char *tag,const char *key,
2.const chat *label,const char *path,
3.esp_diag_data_type_t type);

函数 esp_diag_variable_register()的参数含义和函数 esp_diag_metrics_register()的参数相同。

地址:深圳市宝安区西乡街道麻布社区宝安互联网产业基地A区6栋7栋7706

邮箱:Sales@ferry-semi.com

版权所有©2020  深圳市飞睿科技有限公司  粤ICP备2020098907号    飞睿科技微波雷达wifi模块网站地图