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