Throughput User Interface API#

API for drawing throughput test state and results to LCD

Functions#

void
throughput_ui_init(void)

Initilize the the UI.

void
throughput_ui_update(void)

Updates the the UI.

void
throughput_ui_set_state(throughput_state_t state)

Sets the state value on UI.

void
throughput_ui_set_role(throughput_role_t role)

Sets the role value on UI.

void
throughput_ui_set_tx_power(throughput_tx_power_t power)

Sets the TX Power value on UI.

void
throughput_ui_set_rssi(throughput_rssi_t rssi)

Sets the RSSI value on UI.

void
throughput_ui_set_connection_interval(throughput_time_t interval)

Sets the connection interval value on UI.

void
throughput_ui_set_pdu_size(throughput_pdu_size_t size)

Sets the PDU size value on UI.

void
throughput_ui_set_mtu_size(throughput_mtu_size_t size)

Sets the MTU size value on UI.

void
throughput_ui_set_data_size(throughput_data_size_t size)

Sets the data size value on UI.

void
throughput_ui_set_phy(throughput_phy_t phy)

Sets the PHY on UI.

void
throughput_ui_set_notifications(throughput_notification_t notifications)

Sets the notification state on UI.

void
throughput_ui_set_indications(throughput_notification_t indications)

Sets the indication state on UI.

void
throughput_ui_set_throughput(throughput_value_t throughput)

Sets the throughput value on UI.

void
throughput_ui_set_count(throughput_count_t count)

Sets the counter value on UI.

void
throughput_ui_set_all(throughput_t status)

Sets all values.

Macros#

#define
THROUGHPUT_UI_LOG_ENABLE 1
#define
THROUGHPUT_UI_PRINT_RSSI 0
#define
THROUGHPUT_UI_LOG_ENABLE 1
#define
THROUGHPUT_UI_LOG_REFRESH_ALL 1
#define
THROUGHPUT_UI_LOG_BOX_ENABLE 1

Function Documentation#

throughput_ui_init#

void throughput_ui_init (void )

Initilize the the UI.

Parameters
TypeDirectionArgument NameDescription
voidN/A

throughput_ui_update#

void throughput_ui_update (void )

Updates the the UI.

Parameters
TypeDirectionArgument NameDescription
voidN/A

throughput_ui_set_state#

void throughput_ui_set_state (throughput_state_t state)

Sets the state value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_state_t[in]state

current state


throughput_ui_set_role#

void throughput_ui_set_role (throughput_role_t role)

Sets the role value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_role_t[in]role

the role can be

  • THROUGHPUT_UI_ROLE_PERIPHERAL or

  • THROUGHPUT_UI_ROLE_CENTRAL


throughput_ui_set_tx_power#

void throughput_ui_set_tx_power (throughput_tx_power_t power)

Sets the TX Power value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_tx_power_t[in]power

TX power in dBm


throughput_ui_set_rssi#

void throughput_ui_set_rssi (throughput_rssi_t rssi)

Sets the RSSI value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_rssi_t[in]rssi

measured RSSI value


throughput_ui_set_connection_interval#

void throughput_ui_set_connection_interval (throughput_time_t interval)

Sets the connection interval value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_time_t[in]interval

connectio interval in ms


throughput_ui_set_pdu_size#

void throughput_ui_set_pdu_size (throughput_pdu_size_t size)

Sets the PDU size value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_pdu_size_t[in]size

PDU size in bytes


throughput_ui_set_mtu_size#

void throughput_ui_set_mtu_size (throughput_mtu_size_t size)

Sets the MTU size value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_mtu_size_t[in]size

MTU size in bytes


throughput_ui_set_data_size#

void throughput_ui_set_data_size (throughput_data_size_t size)

Sets the data size value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_data_size_t[in]size

data size in bytes


throughput_ui_set_phy#

void throughput_ui_set_phy (throughput_phy_t phy)

Sets the PHY on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_phy_t[in]phy

can be either of

  • sl_bt_gap_phy_coding_1m_uncoded: 1M phy

  • sl_bt_gap_phy_coding_2m_uncoded: 2M phy

  • sl_bt_gap_phy_coding_500k_coded: Coded phy


throughput_ui_set_notifications#

void throughput_ui_set_notifications (throughput_notification_t notifications)

Sets the notification state on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_notification_t[in]notifications

settings in CCCD, that can be either of

  • sl_bt_gatt_notification: notifications enabled

  • sl_bt_gatt_disable: notifications disabled


throughput_ui_set_indications#

void throughput_ui_set_indications (throughput_notification_t indications)

Sets the indication state on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_notification_t[in]indications

settings in CCCD, that can be either of

  • sl_bt_gatt_indication: indications enabled

  • sl_bt_gatt_disable: indications disabled


throughput_ui_set_throughput#

void throughput_ui_set_throughput (throughput_value_t throughput)

Sets the throughput value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_value_t[in]throughput

measured throughput in bits/second (bps)


throughput_ui_set_count#

void throughput_ui_set_count (throughput_count_t count)

Sets the counter value on UI.

Parameters
TypeDirectionArgument NameDescription
throughput_count_t[in]count

counted bytes


throughput_ui_set_all#

void throughput_ui_set_all (throughput_t status)

Sets all values.

Parameters
TypeDirectionArgument NameDescription
throughput_t[in]status

throughput status