EMS-ESP has a telnet server that enables clients to connect using a telnet client such as PuTTY or natively via the OS like this example with Windows. The port is 23.
You can also access the console via a USB Serial port, using baud 115200.
The console will give you more insight into the EMS bus traffic, MQTT queues and the full device information its capturing. It behaves similar to a Unix/Linux shell. Some of the most common commands are:
F1lists the commands and keywords. This works in each context.
exitwill exit the console or exit the current context.
CTRL-Ddoes the same.
systemto enter the system menu. Use
exitor CTRL-D to return.
suwill switch to the "super user" or admin mode. The default password is
ems-esp-neoand can be changed with
passwdfrom the system menu or via the Web interface (called secret password). When in su mode the command prompt switches from
- Some settings can be changed in the console. The
setcommand will list them.
- The default timeout for telnet is 10 minutes, if you want to change it use
set timeout <min>,
F2shows the data specific to the which context you're in. From the root it will show you all the EMS device information and any external Dallas temperature sensors.
callwill list all the commands which can called with the
callcommand. See Commands.
logsets the logging level.
log offdisables logging. Use
log debugfor debugging commands and actions,
log allincludes the telegrams like
watch on. This will be reset next time the console is opened.
watchwill output the incoming Rx telegrams directly to the console. You can also put on a watch on a specific EMS device ID or telegram ID or unknown (new) telegrams. Also choose to output as verbose text as raw data bytes.
The full list of console commands are shown below:
exit help log [level] read <device ID> <type ID> [offset] [length] set set timeout <n> show show commands show devices show ems show mqtt show system show values su watch [off | on | raw | unknown] [ID]
and these extra commands as admin (after a
call [device] [cmd] [data] [id|hc] exit format help log [level] mqtt subscribe <topic> passwd read <device ID> <type ID> [offset] [length] restart scan devices [deep] set set board_profile <name> set bus_id <device ID> set hostname <name> set timeout <n> set tx_mode <n> set wifi password set wifi ssid <name> show show commands show devices show ems show mqtt show system show users show values su watch [off | on | raw | unknown] [ID] wifi reconnect
Calling a command to change values~
Note you have
su first to get access to all the
Showing device values~
Monitoring the EMS traffic~
watch command you can monitor the incoming EMS telegrams.
watch on <ID> where ID is either a Telegram ID and also a Device ID.
Note the CRC byte is excluded from the data package.
If you want to see only telegrams that are not registered yet, use
If you want to see the raw bytes including CRC as transmitted on the EMS line use
watch raw <ID>.