© 2014 Tarts Sensors, LLC. All Rights Reserved.
6
Tarts Basic Control User
’s Guide (12/14)
Software
Basic Control as a Sensor
Tarts Basic Control is treated by the software as another sensor object; even though it is not technically a sensor, it is
another wireless device on the network and behaves like a sensor. Therefore, all features in Report Interval, Link
Interval, Retry, and Recovery are also valid for this device. Therefore, it defines its own sensor type.
Tarts Basic Control can be used to activate a switch (open it or close it), or you can create an application such that the
unit reacts to other sensor types, such as temperature (ie, if a temperature sensor reports above 30°C, Basic Control will
turn on a fan).
Basic Control-specific Properties and Methods
To manipulate these features, use these functions
:
Type
Function Call
Parameters
Default State
void
setDefaultSwitchClosed(bool value)
OPEN=TRUE, CLOSE=FALSE
TRUE
void
setUseLowPower(bool value)
TRUE, FALSE
TRUE
void
setLedMode(TartsBasic Control::ledOptions value)
enum{ALWAYS_OFF= 0, ALWAYS_ON=1,
FLASH_WITH_POLL=2}
ALWAYS_OFF
void
setPollRate(uint16_t value)
0-65535 seconds
60
bool
getDefaultSwitchClosed()
OPEN=1, CLOSE=0
bool
getUseLowPower()
TRUE=1, FALSE=0
TartsBasic
Control::ledO
ptions
getLedMode()
enum{ALWAYS_OFF= 0, ALWAYS_ON=1,
FLASH_WITH_POLL=2}
uint16_t
getPollRate()
0-65535 seconds
void
sendControl(TartsBasic Control::switchOptions
option)
enum{OPEN = 1, CLOSE=2, TOGGLE=3}
void
sendControl(TartsBasic Control::switchOptions
option, uint16_t commandDuration)
enum{OPEN=1, CLOSE=2, TOGGLE=3},
0-65535 seconds
Tip
: When you are sending configuration settings to Tarts Basic Control using the ‘set’ methods, the program will revert
to default configurations for parameters that are either not set and stored in global variables in the code file, or not
stored in persistent memory. This can be a cause for confusion. Also, when Tarts Basic Control is power cycled, it will
revert to the defaultSwitchClosed state, regardless of what state is was in prior to that.
Default Switch Closed:
This defines what the default state of the switch is when the device enters its application mode,
such as on power up.
Low Power Mode:
This mode selection allows the user to select if the device will be in a low power mode or a high
power mode.
When this property is TRUE, the device turns off the radio receiver in between poll intervals to save power. Therefore,
the selection of the poll interval is critical. In essence, the larger the poll interval, the longer the battery life. If an
application does not require immediate reaction, power consumption can further be reduced by setting long poll
intervals. See “
Poll interval
” property for details below.
Содержание Basic control
Страница 1: ...Tarts Basic Control User s Guide TM TM...
