−50% Launch offer: a Termethos license for $49 $24.50, one-time, until December 31, 2026

How To

Drive Termethos from your firmware

Everything below works with plain printf(). In the examples, DBG_Log() and DBG_LogLn() stand for your own print helpers. The same levels and dashboard fields are what AI agents read through the MCP server.

Quick reference

Print thisTermethos does
\x1b[2J Clear the trace area
!#text Draw a box around the text
!Itext Info-level line
!Wtext Warning-level line
!Etext Error-level line
@{index:value} Set dashboard field 0 to 23

01

Clear the trace area

Send the standard clear-screen sequence \x1b[2J. This is useful at the start of your firmware so every boot begins with an empty trace.

example.c
// DBG_Log() is just a printf()
DBG_Log("\x1b[2J");  // clear screen sequence
Termethos output for: Clear the trace area

02

Draw a box around text

Use this to highlight text, show branding or mark the start of your firmware. Prefix your text with !#.

example.c
// 'Ln' at the end means append a new line
DBG_Log("\x1b[2J");  // clear screen
DBG_LogLn("");       // some spacing
DBG_LogLn("!#Welcome To EGO Firmware!");
DBG_LogLn("");
Termethos output for: Draw a box around text

03

Use different trace levels

Termethos supports most standard bash color sequences, and it also adds shorter ones that are easier to remember. Start your text with ! followed by the level letter, I (info), W (warning) or E (error).

example.c
DBG_LogLn("I'm just regular text!");
DBG_LogLn("!II'm an important piece of information!");
DBG_LogLn("!WI'm warning you!");
DBG_LogLn("!EOops! Something really bad happened!");
Termethos output for: Use different trace levels

04

Dashboard: monitor a value

Use the dashboard to show real-time data, such as a sensor reading or any value that changes. Each dashboard slot is called a field, and up to 24 fields are supported. The value that changed last is highlighted. To set a field, print @{<field index>:<field value>}.

example.c
DBG_LogLn("Set field 11 to 123 and change field 23 from '---' to 'X'");
DBG_Log("@{11:123}@{23:---}");
DBG_Log("@{23:X}");
Termethos output for: Dashboard: monitor a value

Want more?

Custom baud rates, script commands and hotkeys are set up in the advanced settings. See the FAQ for examples.