Ebx 3

Help
type:execute
--------------------------------------------------------------------------
systemInfo.themeVersion=SET0100CA.10
Theme Version
type:string *Read Only
--------------------------------------------------------------------------
==========================================================================
radioSettings
==========================================================================
radioSettings.radioMode=Endpoint
Radio Operational Mode

This item configures the device as a Gateway, Endpoint,
Gateway-Repeater or Endpoint-Repeater unit. Each network
should have only ONE Gateway or Gateway-Repeater unit and the
rest of the units should be configured as Endpoints or
Endpoint-Repeaters. The Gateway or Gateway-Repeater device will
always have a nodeId of value 1 and it cannot be changed. An
Endpoint or Endpoint-Repeater can have a node ID setting of any
16 bit value greater than 1.
type:uint32_t default:Endpoint
options:["Gateway","Endpoint","Gateway_Repeater","Endpoint_Repeater"]
** Savable Configuration Item **
--------------------------------------------------------------------------
radioSettings.rfDataRate=RATE_500K
RF Link Data Rate

This item controls the RF link data rate speed in units of
bits per second. A higher data rate will give you more
throughput at the expense of link distance or fade margin. When
changing from lower data rates to higher ones, such as
RATE_115.2K to RATE_1M, the radioFrequency may be set back to
915.000 MHz if the frequency would have been out of band.
Note: When selecting data rates of either RATE_115.2K or

RATE_250K, radioHoppingMode is automatically forced to
Hopping_On and cannot be turned off. For all other data
rates, radioHoppingMode is left to its current setting.
Note: Both Gateway and Endpoint radios must use the same value
for this setting.
Note: The RATE_1.5M_BETA_FEATURE data rate is a Beta feature

not recommended for production deployment.
type:uint32_t default:RATE_500K
options:["RATE_4M","RATE_1M","RATE_1.5M_BETA_FEATURE","RATE_500K","RATE_250K",
"RATE_115.2K"]
--------------------------------------------------------------------------
radioSettings.txPower=30dbm
Transmit Power
This item sets the transmit power. A higher power can be used
to increase link margin. Use a lower transmit power to reduce
interference when multiple radio links are in close proximity.
The maximum transmit power can be limited if radioHoppingMode
is set to Hopping_On. See frequencyMasks for more details.
type:uint32_t default:30dbm
options:["30dbm","29dbm","28dbm","27dbm","26dbm",
"25dbm","24dbm","23dbm","22dbm","21dbm",
"10dbm","min"]
--------------------------------------------------------------------------
radioSettings.networkId=51966
Network Identifier
This setting can be used to subdivide traffic on radio units.
Radio units can only communicate with other units that have the
same networkId setting.
Note: If radios are on the same frequency they will still

receive data from radios of a different networkId, but
the data will be dropped.
type:uint16_t min:1 max:65533 default:51966

--------------------------------------------------------------------------
radioSettings.nodeId=53593
Node ID
Each radio with the same networkId must have a unique nodeId.
The Gateway node will have a nodeId of 1. This is unchangeable
for Gateway devices. Endpoints can be configured to any value
greater than 1. Setting to 0 will cause the radio to select
a unique nodeId.

--------------------------------------------------------------------------
radioSettings.radioHoppingMode=Hopping_On
Radio Hopping Mode

This parameter is used to enable or disable frequency hopping.
For rfDataRate values less then 500 Kb/s, radioHoppingMode
will be forced on and not allowed to be set off. For all other
rates it is optional. For rfDataRate values of 500 Kb/s and
greater, the choice of hoping mode should be selected based on
network frequency planning and channel conditions.
for this setting.
type:uint32_t default:Hopping_On
options:["Hopping_Off","Hopping_On"]
--------------------------------------------------------------------------
radioSettings.lnaBypass=0
LNA Bypass
When set to a value of 1, the LNA of the radio module will be
bypassed. It can be useful to bypass the LNA if there is a
presence of strong signals in band and packet reception is not
good.
type:uint32_t default:0
options:["0","1"]
--------------------------------------------------------------------------
radioSettings.maxLinkDistanceInMiles=20
The max link distance in miles

The maximum one-way distance in miles between any node in the
network. All nodes in the network that communicate with each
other should use the same distance value.

--------------------------------------------------------------------------
radioSettings.frequencyMasks
Frequency Masks
Frequency Masks allow for frequencies or a set of frequencies
in the hopping pattern to be removed from usage. Frequency
Masks only take effect if radioHoppingMode is set to
Hopping_On.
The mask format is:
frequencyMasks=xxx.yyyy,xxx.yyyy,xxx.yyyy
for single channels.
example:
frequencyMasks=903.0000,908.0000,925.0000
frequencyMasks=xxx.yyyy-xxx.yyyy,xxx.yyyy
for ranges of channels.
example:
frequencyMasks=902.1000-905.1000,920.1000-927.9000
or for a combination
frequencyMasks=902.1000-905.1000,920.1000-927.9000,915.0200
where xxx is a value between 902-927 yyyy is a value between

.0000-.9999 Note: Least significant zeros are not required.
For example .9, .09, .009 are valid entries
Frequency mask entries must be less than 128 bytes. A comma

must separate the values, not a comma and space.
A single entry such as 904.0 masks off any frequencies using

904.0 as a center frequency along with any bandwidth on each
side of the center frequency as a function of rfDataRate. A
frequency range such as 904.0-906.9999 masks off any
frequencies in the range of 904.0 minus the bandwidth
associated with the data rate, through 906.9999 plus the
bandwidth associated with the data rate.
Special rules must be applied for the 115.2 Kb/s and the
250 Kb/s data rates to enforce regulatory rules.
At 250 Kb/s: If the number of hopping channels contained in the

hop table is 50 or more, txPower can be set to values up to and
including 30 dBm. TxPower is not automatically changed. If
the number of hopping channels contained in the hop table is
greater or equal to 25, but less than 50, txPower can be set to
values up to and including 24 dBm. TxPower is automatically
reduced to 24 dBm. If the number of hopping channels contained
in the hop table is less than 25, all masking is removed and
all of the channels contained in the hop table are re-enabled.
txPower is not automatically changed.
At 115.2 Kb/s: If the number of hopping channels contained in

the hop table is 50 or more, txPower can be set to values up to
and including 30 dBm. TxPower is not automatically changed. If
the number of hopping channels contained in the hop table is
less than 50, all masking is removed and all of the channels
contained in the hop table are re-enabled. txPower is not
change.
After setting a frequency mask, wait a few seconds after the

RESULT:0:OK for the radio to process the command, and then
issue a radioSettings command to determine if the mask was
accepted. If the frequency mask setting is not what was
requested, issue a frequencyMasksErrors to determine the error
that exist in the frequency mask string.

Ebx 3

Uploaded by

Copyright:

Available Formats

Ebx 3

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Ebx 3

Uploaded by

Copyright:

Available Formats

Help

type:string *Read Only

Radio Operational Mode

RF Link Data Rate

Note: When selecting data rates of either RATE_115.2K or

Note: The RATE_1.5M_BETA_FEATURE data rate is a Beta feature

Note: If radios are on the same frequency they will still

type:uint16_t min:1 max:65533 default:51966

type:uint16_t min:0 max:65533 default:0

Radio Hopping Mode

The max link distance in miles

type:uint32_t min:5 max:120 default:20

The mask format is:

for single channels.

for ranges of channels.

where xxx is a value between 902-927 yyyy is a value between

Frequency mask entries must be less than 128 bytes. A comma

A single entry such as 904.0 masks off any frequencies using

At 250 Kb/s: If the number of hopping channels contained in the

At 115.2 Kb/s: If the number of hopping channels contained in

After setting a frequency mask, wait a few seconds after the

You might also like