use enhanced prefix in docs

This commit is contained in:
John
2024-01-20 17:40:40 +01:00
parent fe80841e78
commit 5c9153f3b7
2 changed files with 7 additions and 7 deletions
+6 -6
View File
@@ -29,16 +29,16 @@ automatically from the latest source on the git repository. Run the following co
Running interactively Running interactively
--------------------- ---------------------
To run an ebusd container interactively, e.g. on serial device /dev/ttyUSB1, use the following command: To run an ebusd container interactively, e.g. on enhanced serial device /dev/ttyUSB1, use the following command:
> docker run --rm -it --device=/dev/ttyUSB1:/dev/ttyUSB0 -p 8888 john30/ebusd > docker run --rm -it --device=/dev/ttyUSB1:/dev/ttyUSB0 -p 8888 john30/ebusd -d ens:/dev/ttyUSB0
This will show the ebusd output directly in the terminal. This will show the ebusd output directly in the terminal.
Running in background Running in background
--------------------- ---------------------
To start an ebusd container and have it run in the background, e.g. on serial device /dev/ttyUSB1, use the following command: To start an ebusd container and have it run in the background, e.g. on enhanced serial device /dev/ttyUSB1, use the following command:
> docker run -d --name=ebusd --device=/dev/ttyUSB1:/dev/ttyUSB0 -p 8888 john30/ebusd > docker run -d --name=ebusd --device=/dev/ttyUSB1:/dev/ttyUSB0 -p 8888 john30/ebusd -d ens:/dev/ttyUSB0
The container has the name "ebusd", so you can use that when querying docker about the container. The container has the name "ebusd", so you can use that when querying docker about the container.
@@ -62,14 +62,14 @@ Running with MQTT broker
------------------------ ------------------------
To start an ebusd container in the background and have it connect to your MQTT broker, use the following command while To start an ebusd container in the background and have it connect to your MQTT broker, use the following command while
replacing "BROKERHOST" with your MQTT broker host name or IP address: replacing "BROKERHOST" with your MQTT broker host name or IP address:
> docker run -d --name=ebusd --device=/dev/ttyUSB0 -p 8888 john30/ebusd --scanconfig -d /dev/ttyUSB0 --mqttport=1883 --mqtthost=BROKERHOST > docker run -d --name=ebusd --device=/dev/ttyUSB0 -p 8888 john30/ebusd --scanconfig -d ens:/dev/ttyUSB0 --mqttport=1883 --mqtthost=BROKERHOST
Use of environment variables Use of environment variables
---------------------------- ----------------------------
Instead of passing arguments (at the end of docker run) to ebusd, almost all (long) arguments can also be passed as Instead of passing arguments (at the end of docker run) to ebusd, almost all (long) arguments can also be passed as
environment variables with the prefix `EBUSD_`, e.g. the following line can be used instead of the last example above: environment variables with the prefix `EBUSD_`, e.g. the following line can be used instead of the last example above:
> docker run -d --name=ebusd --device=/dev/ttyUSB0 -p 8888 -e EBUSD_SCANCONFIG= -e EBUSD_DEVICE=/dev/ttyUSB0 -e EBUSD_MQTTPORT=1883 -e EBUSD_MQTTHOST=BROKERHOST john30/ebusd > docker run -d --name=ebusd --device=/dev/ttyUSB0 -p 8888 -e EBUSD_SCANCONFIG= -e EBUSD_DEVICE=ens:/dev/ttyUSB0 -e EBUSD_MQTTPORT=1883 -e EBUSD_MQTTHOST=BROKERHOST john30/ebusd
This eases use of e.g. "docker-compose.yaml" files like [the example docker-compose file](https://github.com/john30/ebusd/blob/master/contrib/docker/docker-compose.example.yaml) also describing each available environment variable in it. This eases use of e.g. "docker-compose.yaml" files like [the example docker-compose file](https://github.com/john30/ebusd/blob/master/contrib/docker/docker-compose.example.yaml) also describing each available environment variable in it.
+1 -1
View File
@@ -16,7 +16,7 @@ services:
# Use DEV as eBUS device ("enh:DEVICE" or "enh:IP:PORT" for enhanced device, "ens:DEVICE" for enhanced high speed # Use DEV as eBUS device ("enh:DEVICE" or "enh:IP:PORT" for enhanced device, "ens:DEVICE" for enhanced high speed
# serial device, "DEVICE" for serial device, or "[udp:]IP:PORT" for network device) # serial device, "DEVICE" for serial device, or "[udp:]IP:PORT" for network device)
EBUSD_DEVICE: "/dev/ttyUSB0" EBUSD_DEVICE: "ens:/dev/ttyUSB0"
# Skip serial eBUS device test # Skip serial eBUS device test
#EBUSD_NODEVICECHECK: "" #EBUSD_NODEVICECHECK: ""
# Only read from device, never write to it # Only read from device, never write to it