esp wifi logger Download - esp wifi logger Source code download

esp wifi logger

Other categories

1.0.0

Download

WiFi Logger component

ESP32 WiFi logger - Log messages over WiFi, using either TCP, UDP or Websockets

Generates log messages with same format as ESP-IDF Logging API.
Can route logs generated by ESP_LOGX(), provides a custom function to log messages over wifi.
Follows ESP-IDF log color pattern for different log levels.
Using UDP as network protocol provides lowest latency:
- Minimal test condition - minimum free heap = 220388 bytes.
TCP performance is mid-way:
- Minimal test condition - minimum free heap = 216537 bytes.
Using Websockets provides the worst latency:
- Minimal test condition - minimum free heap = 205416 bytes.

Example App:

Requirements

protocol_examples_common (esp-idf/examples/common_components/)

Installation

cd <your_esp_idf_project>
mkdir components
cd components
cp $IDF_PATH/examples/common_components/protocol_examples_common . -r
git clone https://github.com/VedantParanjape/esp-wifi-logger.git wifi_logger

Change CMakeList.txt to add the line given below:

set(EXTRA_COMPONENT_DIRS <relative_path_to_component_folder>)

component folder must contain protocol_examples_common and wifi_logger component

Usage

How to receive logs

sudo apt-get install netcat
Netcat is required to receive logs
nc -lu <PORT>
Receive logs when udp is used as network protocol
nc -l <PORT>
Receive logs when tcp is used as network protocol
websocat -s <IP_ADDRESS_OF_YOUR_MACHINE>:<PORT>
Receive logs when websocket is used as network protocol
websocat -s $(ip -o route get to 8.8.8.8 | sed -n 's/.*src ([0-9.]+).*/1/p'):1234
receive logs when websocket is used as network protocol, auto fills the ip address
Example: Assume, port is 1212 over TCP, command will be: nc -l 1212

How to use in ESP-IDF Projects

wifi_log_e() - Generate log with log level ERROR
wifi_log_w() - Generate log with log level WARN
wifi_log_i() - Generate log with log level INFO
wifi_log_d() - Generate log with log level DEBUG
wifi_log_v() - Generate log with log level VERBOSE

Can send logs generated by ESP_LOGE, ESP_LOGW, ESP_LOGI, ESP_LOGD, ESP_LOGV, if configured so through menuconfig
Usage pattern same as, ESP_LOGX()
Use wifi_log()_x function to print logs over wifi
Example: wifi_log(TAG, "%s", "logger test");
ESP_LOGE, ESP_LOGW, ESP_LOGI, ESP_LOGD, ESP_LOGV logs will also be sent over wifi, if configured in menuconfig.
Call start_wifi_logger() in void app_main() to start the logger. Logging function wifi_log_x() (x = e,w,i,d,v) can be called to log messages or normal ESP-IDF Logging API functions like ESP_LOGW can be used if configured through menuconfig.
Configure menuconfig
- Example Connection Configuration Set WiFi SSID and password
- Component config
- WiFi Logger configuration
  - Route logs generated by ESP_LOGX to the wifi logger - Select if the logs written by system API are routed to be sent to the remote logger
  - Network Protocol (TCP/UDP/WEBSOCKET) - Set network protocol to be used
  - UDP/TCP Network Protocol
    - Server IP Address - Set the IP Address of the server which will receive log messages sent by ESP32
    - Port - Set the Port of the server
  - WEBSOCKET Network Protocol
    - Websocket Server URI - Sets the URI of Websocket server, where logs are to be sent

IP Address of the server can be found out by running ifconfig on a linux machine

Configuration

idf.py menuconfig

Example Connection Configuration
- WiFi SSID - Set WiFi SSID to connect
- WiFi Password - Set WiFi Password
Component config
- WiFi Logger configuration
  - Network Protocol (TCP/UDP/WEBSOCKET) - Set network protocol to be used
  - Route logs generated by ESP_LOGX to the wifi logger - Select if the logs written by system API are routed to be sent to the remote logger
  - UDP/TCP Network Protocol
    - Server IP Address - Set the IP Address of the server which will receive log messages sent by ESP32
    - Port - Set the Port of the server
  - WEBSOCKET Network Protocol
    - Websocket Server URI - Sets the URI of Websocket server, where logs are to be sent
  - Queue Size - Advanced Config, change at your own risk Set the freeRTOS Queue size used to pass log messages to logger task.
  - logger buffer size - Advanced Config, change at your own risk Set the buffer size of char array used to generate log messages in ESP format

Example

Detailed Example App:

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "wifi_logger.h"


void app_main(void)
{
    start_wifi_logger(); // Start wifi logger

    while(1)
    {
        wifi_log_e("test", "%s %d %f", "hello world wifi logger", 43, 45.341223242); // write log over wifi with log level -> ERROR
        wifi_log_w("test", "%s %d %f", "hello world wifi logger", 43, 45.341223242); // write log over wifi with log level -> WARN
        wifi_log_i("test", "%s %d %f", "hello world wifi logger", 43, 45.341223242); // write log over wifi with log level -> INFO
        wifi_log_d("test", "%s %d %f", "hello world wifi logger", 43, 45.341223242); // write log over wifi with log level -> DEBUG
        wifi_log_v("test", "%s %d %f", "hello world wifi logger", 43, 45.341223242); // write log over wifi with log level -> VERBOSE

        vTaskDelay(100);  // Wait for 100ms, prevent watchdog from triggering a reset
    }
}