Tripp Lite B092-016 - Page 231

231
Chapter 15: Advanced Configuration
Here is a brief description of the elements of the XML entries in /etc/config/powerstrips.xml.
<powerstrip>
<id>Name or ID of the device support</id>
<outlet port="port-id-1">Display Port 1 in menu</outlet>
<outlet port="port-id-2">Display Port 2 in menu</outlet>
...
<on>script to turn power on</on>
<off>script to power off</off>
<cycle>script to cycle power</cycle>
<status>script to write power status to /var/run/power-status</status>
<speed>baud rate</speed>
<charsize>character size</charsize>
<stop>stop bits</stop>
<parity>parity setting</parity>
</powerstrip>
The id appears on the web page in the list of available devices types to configure.
Theoutletsdescribetargetsthatthescriptscancontrol.Forexample,apowercontrolboardmaycontrolseveraldifferent
outlets.Theport-idisthenativenameforidentifyingtheoutlet.Thisvaluewillbepassedtothescriptsintheenvironment
variable outlet,allowingthescripttoaddressthecorrectoutlet.
There are four possible scripts: on, off, cycle and status
Whenascriptisrun,itsstandardinputandoutputisredirectedtotheappropriateserialport.Thescriptreceivestheoutlet
and port in the outlet and port environment variables respectively.
The script can be anything that can be executed within the shell.
All of the existing scripts in /etc/powerstrips.xml use the pmchat utility.
pmchatworksjustlikethestandardunix"chat"program,onlyitensuresinteroperationwiththeportmanager.
Thenaloptions,speed, charsize, stop and parity define the recommended or default settings for the attached device.