Cooexistence interface (coex)#
Coexistence BGAPI class. Coexistence interface is enabled and initialised with gecko_initCoexHAL() function. Interface is configured with HAL configurator.
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:Cooexistence 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:Cooexistence interface |
3 | 0x01 | method | Message ID |
4-5 | uint16 | result | Result code:
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:Cooexistence 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:Cooexistence interface |
3 | 0x00 | method | Message ID |
4-5 | uint16 | result | Result code:
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
}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 |