This project aims to create a tool to debug sparkplug communication with Edge Of Network Devices (EoN).
Enki is the Sumerian god of water, knowledge, mischiefs, crafts and creations.
export PYTHONPATH=${PYTHONPATH}:$(pwd)/tahu/python/core/
./enki.py
When launched, the enki.py script gives access to a shell with commands to manage topics subscriptions, list EoN and devices, craft metrics into payload. Type help to see the list of commands available.
Additional usage information can be found here.
docker run -it --rm ghcr.io/siemaapplications/enki:v0.3.1 --host <mqtt broker hostname>
docker build -t enki .
docker run -it --rm enki --host <mqtt broker hostname>
enki must connect to a broker which is specified on the command line with the --host argument (eg test.mosquitto.org).
If a broker is running on the host computer, the ip of the docker network interface can be supplied to --host:
docker run -it --rm ghcr.io/siemaapplications/enki:v0.3.1 --host $(ip -4 -br a s docker0 | awk '{print $3}' | cut -d/ -f1)
However, if the broker is hosted in a container, the enki instance must be connected to the network hosting the broker:
docker run -it --rm --network <docker network name> ghcr.io/siemaapplications/enki:v0.3.1 --host <container instance name>
Where <docker network name> can be seen in the output of docker network ls command and <container instance name> in the output of docker ps.