I am trying to understand the specification of subcommand ENUM in
https://networkupstools.org/docs/developer-guide.chunked/ar01s09.html
This says:
ENUM
Form:
LIST ENUM <upsname> <varname>
LIST ENUM su700 input.transfer.low
Response:
BEGIN LIST ENUM <upsname> <varname>
ENUM <upsname> <varname> "<value>"
...
END LIST ENUM <upsname> <varname>
BEGIN LIST ENUM su700 input.transfer.low
ENUM su700 input.transfer.low "103"
ENUM su700 input.transfer.low "100"
...
END LIST ENUM su700 input.transfer.low
What exactly does command LIST ENUM call for? Is it a list of those variables
for which there is a fixed set of possible values?
Roger
On Sun, Jan 10, 2021 at 10:37:13AM +0100, Roger Price wrote:> I am trying to understand the specification of subcommand ENUM in > https://networkupstools.org/docs/developer-guide.chunked/ar01s09.html > > This says: > > ENUM > Form: > LIST ENUM <upsname> <varname> > LIST ENUM su700 input.transfer.low > > Response: > BEGIN LIST ENUM <upsname> <varname> > ENUM <upsname> <varname> "<value>" > ... > END LIST ENUM <upsname> <varname> > > BEGIN LIST ENUM su700 input.transfer.low > ENUM su700 input.transfer.low "103" > ENUM su700 input.transfer.low "100" > ... > END LIST ENUM su700 input.transfer.low > > What exactly does command LIST ENUM call for? Is it a list of those > variables for which there is a fixed set of possible values? >I can't speak specifically about the NUT case, but if "ENUM" is short for "enumerate" or it's anything like the C 'enum' keyword, I think your assessment may be correct. Jonathan
On Jan 10, 2021, at 4:37 AM, Roger Price <roger at rogerprice.org> wrote:> > I am trying to understand the specification of subcommand ENUM in > https://networkupstools.org/docs/developer-guide.chunked/ar01s09.html...> What exactly does command LIST ENUM call for? Is it a list of those variables for which there is a fixed set of possible values?"Is it a list of those variables" -> I would say that for a given variable called <varname> (on <upsname>), it returns the set of possible values that can be read or written. I don't think there is a way to query upsd for just the list of ENUM variables, the way it is possible to query for RW variables. Several UPSes have settings which can be cycled via a front panel button (e.g. sensitivity or voltage thresholds), and if those are exposed in the protocols, then the drivers should use ENUMs to pass that along. This is not currently the case for usbhid-ups: https://github.com/networkupstools/nut/issues/134 -- Charles Lepple clepple at gmail