TADPOLECTL(8)        NetBSD/sparc System Manager's Manual        TADPOLECTL(8)

NAME
     tadpolectl -- get or set tadpole microcontroller state

SYNOPSIS
     tadpolectl [-n] name ...
     tadpolectl [-n] -w name=value ...
     tadpolectl [-n] -a

DESCRIPTION
     The tadpolectl utility retrieves values from the ts102 microcontroller
     and allows processes with appropriate privilege to set some values.  The
     state to be retrieved or set is described using a ``Management Informa-
     tion Base'' (``MIB'') style name, described as a dotted set of compo-
     nents.  The -a flag can be used to list all the currently available
     string or integer values.

     The -n flag specifies that the printing of the field name should be sup-
     pressed and that only its value should be output.  This flag is useful
     for setting shell variables.  For example, to save the mains power status
     in variable mains, use:
           set mains=`tadpolectl -n hw.power.mains`

     If just a MIB style name is given, the corresponding value is retrieved.
     If a value is to be set, the -w flag must be specified and the MIB name
     followed by an equal sign and the new value to be used.

     The information available from tadpolectl consists of only integers.
     Some registers can be modified, but have no way of reading what the cur-
     rent value is.  Those registers will always display ``0''.

     The changeable column indicates whether a process with appropriate privi-
     lege can change the value, and if a displayed value is valid.

     Name                                Changeable    Valid
     hw.microcontroller.version          no            yes
     hw.version                          no            yes
     hw.poweroncycles                    no            yes
     hw.poweronseconds                   no            yes
     hw.power.mains                      no            yes
     hw.power.battery.int                no            yes
     hw.power.battery.ext                no            yes
     hw.power.battery.chargedisabled     yes           yes
     hw.power.battery.int.chargerate     yes           yes
     hw.power.battery.ext.chargerate     yes           yes
     hw.power.battery.int.chargelevel    no            yes
     hw.power.battery.ext.chargelevel    no            yes
     hw.video.external                   no            yes
     hw.video.lid                        no            yes
     hw.video.syncinva                   yes           yes
     hw.video.syncinvb                   yes           yes
     hw.video.compsync                   yes           yes
     hw.video.tft.brightness             yes           yes
     hw.speaker.freq                     yes           no
     hw.speaker.volume                   yes           yes
     hw.kbd.repeat.delay                 yes           yes
     hw.kbd.repeat.speed                 yes           yes
     hw.kbd.click                        yes           yes
     hw.mouse.recalibrate                yes           no
     hw.mouse.disable                    yes           yes
     hw.mouse.intclick                   yes           yes
     hw.mouse.extclick                   yes           yes
     hw.mouse.sensitivity                yes           yes
     hw.serial.power                     yes           yes

EXAMPLES
     For example, to retrieve the current internal battery charge level, one
     would use the following request:
           tadpolectl hw.power.battery.int.chargelevel

     To set the speaker beep frequency of the system to 1000, one would use
     the following request:
           tadpolectl -w hw.speaker.freq=1000

SEE ALSO
     sysctl(8)

HISTORY
     tadpolectl first appeared in NetBSD 1.5.

NetBSD 5.0_STABLE              December 16, 1999             NetBSD 5.0_STABLE
