Cooexistence 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: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

  • 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: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

  • 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