Power control devices

Power control devices share some common functionality through the MagAO-X outletController.

Common INDI properties

Read/write Properties

Channel states are reported by the property with the channel name, and state changes can be requested by the same property. The target element contains the last requested state until the state element, which is the current state, matches it. Changing either state or target will request a state change in that channel.

<name>.<channelName>.state = On | Int | Off
<name>.<channelName>.target = On | Off | [empty]

Read-only Properties

The status property gives the reported device status. This does not appear to be useful.

<name>.status.value = ?

The load property gives the line frequency, line voltage, and drawn current as reported by the device.

<name>.load.frequency = [Hz]
<name>.load.voltage = [V]
<name>.load.current = [A]

Each outlet has a property which indicates its current state.

<name>.outlet<N>.state = On | Int | Off

Channel Configuration

The outlets are controlled in channels, which consist of at least one outlet. Channels are configured as sections in the configuration file. Any section name, say [channel1], which has either a oulet= or outlets= keyword will be treated as a channel specification.

The oulet= or outlets= keyword=value pair specifies which outlet or outlets are controlled by this channel. Multiple outlets are specified in an comma separated list.

You can also specify the order in which the outlets are turnned on with the onOrder and offOrder keywords. The values contain indices in the vector specified by the outlet/outlets keyword, not the outlet numbers. So if you have outlets=7,8 you would then have onOrder=1,0 to turn on outlet 8 first, then outlet 7.

You can use onDelays and offDelays, to specify the delays between outlet operations in milliseconds. The first entry is always ignored, then the second entry specifies the delay between the first and second outlet operation, etc.

An example config file section is:

[sue]           #this channel will be named sue
outlets=4,5     #this channel uses outlets 4 and 5
onOrder=1,0     #outlet 5 will be turned on first
offOrder=0,1    #Outlet 4 will be turned off first
onDelays=0,150  #a 150 msec delay between outlet turn on
offDelays=0,345 #a 345 msec delay between outlet turn off

trippLitePDU

trippLitePDU provides an interface to a Tripp Lite power distribution unit. INDI properties provide the status of each outlet, as well as line power status.

Driver-specific options

Sh ort

Long

Config-File

Type

D e s c r i p t i o n

- a

--device.address

device.address

string

T h e d e v i c e a d d r e s s .

- p

--device.port

device.port

string

T h e d e v i c e p o r t .

- u

--device.username

device.username

string

T h e d e v i c e l o g i n u s e r n a m e .

--device.passfile

device.passfile

string

T h e d e v i c e l o g i n p a s s w o r d f i l e ( r e l a t i v e t o s e c r e t s d i r ) .

` –device.readTimeout`

device.readTimeout

int

t i m e o u t f o r r e a d i n g f r o m d e v i c e

`` –device.writeTimeout``

device.writeTimeout

int

t i m e o u t f o r w r i t i n g t o d e v i c e

--time outs.outletStateDelay

timeo uts.outletStateDelay

int

T h e m a x i m u m t i m e t o w a i t f o r a n o u t l e t t o c h a n g e s t a t e [ m s e c ] . D e f a u l t = 5 0 0 0

` –limits.freqLowWarn`

limits.freqLowWarn

int

T h e l o w - f r e q u e n c y w a r n i n g t h r e s h o l d

`` –limits.freqHighWarn``

limits.freqHighWarn

int

T h e h i g h - f r e q u e n c y w a r n i n g t h r e s h o l d

`` –limits.freqLowAlert``

limits.freqLowAlert

int

T h e l o w - f r e q u e n c y a l e r t t h r e s h o l d

- -limits.freqHighAlert

limits.freqHighAlert

int

T h e h i g h - f r e q u e n c y a l e r t t h r e s h o l d

`` –limits.freqLowEmerg``

limits.freqLowEmerg

int

T h e l o w - f r e q u e n c y e m e r g e n c y t h r e s h o l d

- -limits.freqHighEmerg

limits.freqHighEmerg

int

T h e h i g h - f r e q u e n c y e m e r g e n c y t h r e s h o l d

` –limits.voltLowWarn`

limits.voltLowWarn

int

T h e l o w - v o l t a g e w a r n i n g t h r e s h o l d

`` –limits.voltHighWarn``

limits.voltHighWarn

int

T h e h i g h - v o l t a g e w a r n i n g t h r e s h o l d

`` –limits.voltLowAlert``

limits.voltLowAlert

int

T h e l o w - v o l t a g e a l e r t t h r e s h o l d

- -limits.voltHighAlert

limits.voltHighAlert

int

T h e h i g h - v o l t a g e a l e r t t h r e s h o l d

`` –limits.voltLowEmerg``

limits.voltLowEmerg

int

T h e l o w - v o l t a g e e m e r g e n c y t h r e s h o l d

- -limits.voltHighEmerg

limits.voltHighEmerg

int

T h e h i g h - v o l t a g e e m e r g e n c y t h r e s h o l d

--limits.currWarn

limits.currWarn

int

T h e h i g h - c u r r e n t w a r n i n g t h r e s h o l d

--limits.currAlert

limits.currAlert

int

T h e h i g h - c u r r e n t a l e r t t h r e s h o l d

--limits.currEmerg

limits.currEmerg

int

T h e h i g h - c u r r e n t e m e r g e n c y t h r e s h o l d

Troubleshooting

Device not responding

If the device stops responding on the CLI port. A fix is to login via ssh, e.g.

$ ssh localadmin@x.x.x.x

You will need the current password for this device. Once logged in, navigate to the menu choice to Restart PowerAlert.

2- System Configuration

   7- Restart PowerAlert

      1- Restart PowerAlert Now

This can take a loooooong time to reboot.

If the software reboot doesn’t fix it, reset the device using the recessed reset button under the ethernet adapter.

If that doesn’t work, you need to completely unplug the device to force a full reset.

xt1121DCDU

xt1121DCDU provides an interface to a xt1121-based D.C. distribution unit. This is an Electronics-Salon D-228 relay module controlled by an Acromag xt1121 digital I/O module.

Driver-specific options

Sh ort

Long

Config-File *

Type

D e s c r i p t i o n

--power.device

power.device

string

D e v i c e c o n t r o l l i n g p o w e r f o r t h i s a p p ’ s d e v i c e ( I N D I n a m e ) .

--power.channel

power.channel

string

C h a n n e l o n d e v i c e f o r t h i s a p p ’ s d e v i c e ( I N D I n a m e ) .

--power.element

power.element

string

I N D I e l e m e n t n a m e . D e f a u l t i s “ s t a t e ” , o n l y n e e d t o s p e c i f y i f d i f f e r e n t .

--device.name

device.name

string

T h e d e v i c e I N D I n a m e .

--d evice.channelNumbers

de vice.channelNumbers

vector

T h e c h a n n e l n u m b e r s t o u s e f o r t h e o u t l e t s , i n o r d e r .