Coexistence interface (coex)#
Coexistence BGAPI class. Coexistence interface is enabled and initialized with gecko_initCoexHAL() function.
coex commands#
coex_get_counters#
This command is used to read coexistence statistic counters from the device. Response contains the list of uint32 type counter values. Counters in the list are in following order: low priority requested, high priority requested, low priority denied, high priority denied, low priority tx aborted, high priority tx aborted.
Command#
Byte | Type | Name | Description |
|---|---|---|---|
0 | 0x20 | hilen | Message type: Command |
1 | 0x01 | lolen | Minimum payload length |
2 | 0x20 | class | Message class:Coexistence interface |
3 | 0x01 | method | Message ID |
4 | uint8 | reset | Reset counter values |
Response#
Byte | Type | Name | Description |
|---|---|---|---|
0 | 0x20 | hilen | Message type: Response |
1 | 0x03 | lolen | Minimum payload length |
2 | 0x20 | class | Message class:Coexistence interface |
3 | 0x01 | method | Message ID |
4-5 | uint16 | result | Result code |
0: success
Non-zero: an error occurred
For other values refer to the Error codes
6 | uint8array | counters | Variable length byte array. The first byte
defines the length of the data that follows, 0 - 255 bytes.
API#
/* Function */
struct gecko_msg_coex_get_counters_rsp_t *gecko_cmd_coex_get_counters(uint8 reset);
/* Response id */
gecko_rsp_coex_get_counters_id
/* Response structure */
struct gecko_msg_coex_get_counters_rsp_t
{
uint16 result,
uint8array counters
} coex_set_options#
This command is used to configure coexistence options at runtime.
Command#
Byte | Type | Name | Description |
|---|---|---|---|
0 | 0x20 | hilen | Message type: Command |
1 | 0x08 | lolen | Minimum payload length |
2 | 0x20 | class | Message class:Coexistence interface |
3 | 0x00 | method | Message ID |
4-7 | uint32 | mask | Mask defines which coexistence options are changed. |
8-11 | uint32 | options | Value of options to be changed. This parameter is |
used together with mask parameter. |
Response#
Byte | Type | Name | Description |
|---|---|---|---|
0 | 0x20 | hilen | Message type: Response |
1 | 0x02 | lolen | Minimum payload length |
2 | 0x20 | class | Message class:Coexistence interface |
3 | 0x00 | method | Message ID |
4-5 | uint16 | result | Result code |
0: success
Non-zero: an error occurred
For other values refer to the Error codes
API#
/* Function */
struct gecko_msg_coex_set_options_rsp_t *gecko_cmd_coex_set_options(uint32 mask, uint32 options);
/* Response id */
gecko_rsp_coex_set_options_id
/* Response structure */
struct gecko_msg_coex_set_options_rsp_t
{
uint16 result
} coex enumerations#
coex_option#
Coexistence configuration options
Enumerations#
Value | Name | Description |
|---|---|---|
256 | coex_option_enable | Enable coexistence feature |
1024 | coex_option_tx_abort | Abort transmission if grant is denied |
2048 | coex_option_high_priority | Enable priority signal |