User's Manual

Datalogic Scanning, Inc
959 Terry Street
Eugene, Oregon 97402
Page 8 10/23/2009
Revision X2
For BlueCore01b, the key's range is normally 0x04 to 0x3f. 0x04 gives the slowest ramp rate.
Although the hardware supports values below 0x04, using them will put the software timings so far out that
the module may not work.
The key's value has different effects according to whether the module uses the chip's internal power
amplifier or an external amplifier. (See PSKEY_TXRX_PIO_CONTROL
.)
If the internal power amplifier is ramped then the microseconds taken to complete the ramp is
(4*final_value)/ramp_rate.
If an external power amplifier is ramped then the microseconds taken to complete the ramp is
(final_value)/ramp_rate.
In both cases the final_value is taken from PSKEY_LC_POWER_TABLE.
Key value zero has a special behaviour - power is applied without a ramp.
Key Name Key
Number
Type Default Setting
PSKEY_LC_FC_POOLS_LOW_WATER_MARK 0x0020 lc_fc_lwm 0x0014, 0x0018, 0x001a
As PSKEY_LC_FC_BUFFER_LOW_WATER_MARK, but describing numbers of available pool memory
blocks.
Key Name Key Number Type Default Setting
PSKEY_LC_DEFAULT_TX_POWER 0x0021 int16 4
The radio's default transmit power, measured in dBm. The chip uses this for page, inquiry and their scan
responses. This is also the power used for new connections.
In 12.X builds the firmware uses the entry in the power table that is closest to this pskey's value. (If the two
closest power tables are equidistant from this key's value then it is indeterminate which power table entry is
used.)
In 13.X and later builds the firmware uses the highest value in the power table that is less than or equal to
the requested default power.
Correct operation depends on the the device having a valid power table - see
PSKEY_LC_POWER_TABLE.
Key Name Key Number Type Default Setting
PSKEY_LC_RSSI_GOLDEN_RANGE 0x0022 uint8 80
The RSSI signal used to measure the signal strength relative to the golden receive range as defined in
section 4.7 of part A of the Bluetooth spec.
Pre 19.x builds:
With the attenuator setting specified in PSKEY_LC_ATTEN_GOLDEN_RANGE_MINIMUM you should
get this RSSI reading for a signal at the bottom of the golden receive range. With the attenuator setting