Running the utility

There are 2 executables in this project:

• f007th-rpi_send This executable requires pigpio library to be installed and must be run as root (via sudo).
• f007th-send is the same as above but uses gpio-ts driver. This executable does not require root privileges but gpio-ts module must be already loaded (it can be loaded during system boot). See chapter Choose running mode for more information.

The utility has multiple command line parameters. But any of them can specified in a configuration file.
Note that many features can be set in configuration file only because the corresponded command line options do not exist.

Running in background from console

If you start the utility from shell to run in background (with ampersand at the end of command) and close your shell or just logoff then system may close the utility. To avoid this problem use command disown to detach the process from the current shell. For example:

~/f007th-rpi/bin/f007th-send --config ~/f007th-rpi/bin/f007th-send.cfg &
disown

Stopping the utility

• If you started the utility from the current console and did not executed the command disown then you can simply press Ctrl-C to terminate the utility.
• You can use command pkill f007th-send (or pkill f007th-rpi_send if you run this executable) to stop the utility.

You can check that the utility is running by command pgrep f007th-send (or pkill f007th-rpi_send if you use this executable).

Examples:

Print received data on console:

sudo f007th-rpi_send -A

Print received data on console with temperature in degrees Celsius:

sudo f007th-rpi_send -C -A

Run the command in background with configuration file:

f007th-send --config /home/pi/f007th-rpi/bin/f007th-send.cfg &
disown

Run the command in background and send data to InfluxDB database smarthome on server server.dom:

f007th-send -t InfluxDB http://server.dom:8086/write?db=smarthome &
disown

or

f007th-send --type=InfluxDB -s http://server.dom:8086/write?db=smarthome &
disown

or

f007th-send --type=InfluxDB --send-to http://server.dom:8086/write?db=smarthome &
disown

Send data to Loopback (REST server) on server qnap.dom:

f007th-send http://qnap.dom:3000/api/roomtemps

or

f007th-send -t REST -s http://qnap.dom:3000/api/roomtemps