Remote Information eXchange adds remote logging and debugging capabilities to your ESP based Arduino projects. This can be useful if your project is in an inaccessible location, and serial isn't available.
Clone this repo to your Arduino libraries directory. On Linux this is
~/Arduino/libraries/
Include the RIX library
#include <esp-rix.h>
Listen for RIX calls at the end of your loop()
function
void loop() {
// Other loop code here
// Rix supports 7 levels of debug messages
rix_1("This is a LEVEL 1 message");
rix_7("This is a LEVEL 7 message");
// Rix also supports printf style messages
rix_5("MCU Uptime: %d minutes", millis() / 1000 / 60);
handle_rix();
}
On a machine that shares the same WiFi as your ESP you can telnet
to your
ESP's IP address to view the messages.
Enable/disable color in output
rix_color(0); // Disable color
Set the initial output logging level
rix_log_level(4); // Default: 7
Change the TCP port that RIX listens on
rix_tcp_port(2300); // Default: 23
Using delay()
in your scripts may cause RIX to be less responsive. A
rix_delay()
method has been added as a drop-in replacement to keep your
project responsive.
rix_delay(500); // Wait 500 ms
RIX has a function to make connecting to your WiFi simple:
int ok = rix_init_wifi("MySSID", "SekritPassword");
When you're done debugging you can disable RIX entirely by adding:
# define RIX_DISABLE
before the include line. This will make all the rix_*
calls no-ops, and
disable logging. This means you can leave all your setup and logging calls in
your code and simply disable the library at compile time.
On non-ESP boards RIX is automatically disabled. This allows you to test and debug on an ESP board, and then compile on an Arduino Nano with no changes to your code.
RIX was inspired by Joao Lopes' RemoteDebug which appears to be abandonned.