SWRU455M February 2017 – October 2020 CC3120 , CC3120MOD , CC3130 , CC3135 , CC3135MOD , CC3220MOD , CC3220MODA , CC3220R , CC3220S , CC3220SF , CC3230S , CC3230SF , CC3235MODAS , CC3235MODASF , CC3235MODS , CC3235MODSF , CC3235S , CC3235SF
This feature allows the host to define a trigger that can generate an asynchronous event when there is a change in the conditions and quality level of the active connection. RSSI triggers are supported on all device types with one exception, CC3120 and CC3220 parts support only a single index and CC3x3x parts support two indices. In addition, CC3120 and CC3220 parts support RSSI trigger starting from service pack v3.10.0.5.
The trigger can be enabled or disabled when needed, and can be updated with new values at runtime.
Updating a trigger is done by setting the trigger with new attributes. The received event contains the value that triggered the event.
For more information on device types, refer to Table 2-1.
The soft-roaming feature is based on internal RSSI trigger and shares the same API and settings as the RSSI trigger. The index of the RSSI trigger in the API is index 0.
The table below describes the attributes of the trigger and the constraints per each device type. The default value of attributes that cannot be set under CC3x20 device type, are marked in brackets:
Name | Description | CC3x20 (default) | CC3x35 | Values / Comment |
---|---|---|---|---|
Threshold | Defines the threshold value in which the event is triggered | + | + | Units: dBm Range: (-100 ... 100) |
Pacing | Defines the minimum delay between consecutive events | + | + | Units: milliseconds; Range: (0 .. 60000) |
Metric | Defines how the quality condition is measured | - (0) | + | 0 - RSSI Beacon, 1 - RSSI Packet |
Type | The type of the trigger
Edge: Event is sent once when the threshold is crossed. Level: Event is sent each time that the threshold is crossed. | - (0) | + | 0 - Level, 1 – Edge |
Direction | The direction of the change the caused the trigger | - (0) | + | 0 - Low, 1 - High, 2 - Bidirectional |
Hysteresis | Margin relative to the threshold value | + | + | Units: dB ; Threshold range: (0 .. 255) |
TriggerId | The index of the trigger | - (0) | + | 0 - RSSI trigger, 1 - Soft-Roaming trigger |
Enable | Enable/Disable a trigger | + | + | 0 - Disable, 1 – Enable |