Debugging aids – Thinklogical Configuring the TLX ASCII Interface User Manual

Page 9

Advertising
background image

®

Configuring the TLX ASCII Interface

6

Rev. A - July, 2015

Debugging Aids

The API program has several options to aid in setup and debugging. These include logging the
incoming ASCII commands, logging the communications to the internal control process (aka
AVR or Control) and appending a comment to the response message that is returned after each
command. This comment will contain details about any errors.

These messages are written to the system log file:

/var/log/api

located on the Switch's

internal SD card.

Command line options to enable the API debug aids:

--debug

log extensive detailed data

--api

log the API commands received

--avr

log the commands to the internal control process

--clog

log connection make/break status

--verbose

append a comment to each command response

The '--api' and '--avr' settings may be toggled by sending a system signal to the running API
program. As shown in the help text on page 1, SIGUSR1 will toggle the 'api' setting and
SIGUSR2 will toggle the 'avr' setting. (See the example below for the syntax of the 'killall'
command.)

You may use the 'killall'

command to send a signal to a running program. The syntax is:

killall -USR1 tlxapi

or

killall -USR2 tlxapi

Advertising