TWIM HAL

group nrf_twim_hal

Hardware access layer for managing the TWIM peripheral.

Defines

NRF_TWIM_HAS_1000_KHZ_FREQ: Symbol indicating whether 1000 kHz clock frequency is available.

Enums

enum nrf_twim_task_t

TWIM tasks.

Values:

enumerator NRF_TWIM_TASK_STARTRX: Start TWI receive sequence.

enumerator NRF_TWIM_TASK_STARTTX: Start TWI transmit sequence.

enumerator NRF_TWIM_TASK_STOP: Stop TWI transaction.

enumerator NRF_TWIM_TASK_SUSPEND: Suspend TWI transaction.

enumerator NRF_TWIM_TASK_RESUME: Resume TWI transaction.

enum nrf_twim_event_t

TWIM events.

Values:

enumerator NRF_TWIM_EVENT_STOPPED: TWI stopped.

enumerator NRF_TWIM_EVENT_ERROR: TWI error.

enumerator NRF_TWIM_EVENT_SUSPENDED: TWI suspended.

enumerator NRF_TWIM_EVENT_RXSTARTED: Receive sequence started.

enumerator NRF_TWIM_EVENT_TXSTARTED: Transmit sequence started.

enumerator NRF_TWIM_EVENT_LASTRX: Byte boundary, starting to receive the last byte.

enumerator NRF_TWIM_EVENT_LASTTX: Byte boundary, starting to transmit the last byte.

enum nrf_twim_short_mask_t

TWIM shortcuts.

Values:

enumerator NRF_TWIM_SHORT_LASTTX_STARTRX_MASK: Shortcut between LASTTX event and STARTRX task.

enumerator NRF_TWIM_SHORT_LASTTX_SUSPEND_MASK: Shortcut between LASTTX event and SUSPEND task.

enumerator NRF_TWIM_SHORT_LASTTX_STOP_MASK: Shortcut between LASTTX event and STOP task.

enumerator NRF_TWIM_SHORT_LASTRX_STARTTX_MASK: Shortcut between LASTRX event and STARTTX task.

enumerator NRF_TWIM_SHORT_LASTRX_STOP_MASK: Shortcut between LASTRX event and STOP task.

enumerator NRF_TWIM_ALL_SHORTS_MASK: All TWIM shortcuts.

enum nrf_twim_int_mask_t

TWIM interrupts.

Values:

enumerator NRF_TWIM_INT_STOPPED_MASK: Interrupt on STOPPED event.

enumerator NRF_TWIM_INT_ERROR_MASK: Interrupt on ERROR event.

enumerator NRF_TWIM_INT_SUSPENDED_MASK: Interrupt on SUSPENDED event.

enumerator NRF_TWIM_INT_RXSTARTED_MASK: Interrupt on RXSTARTED event.

enumerator NRF_TWIM_INT_TXSTARTED_MASK: Interrupt on TXSTARTED event.

enumerator NRF_TWIM_INT_LASTRX_MASK: Interrupt on LASTRX event.

enumerator NRF_TWIM_INT_LASTTX_MASK: Interrupt on LASTTX event.

enumerator NRF_TWIM_ALL_INTS_MASK: All TWIM interrupts.

enum nrf_twim_frequency_t

TWIM master clock frequency.

Values:

enumerator NRF_TWIM_FREQ_100K: 100 kbps.

enumerator NRF_TWIM_FREQ_250K: 250 kbps.

enumerator NRF_TWIM_FREQ_400K: 400 kbps.

enumerator NRF_TWIM_FREQ_1000K: 1000 kbps.

enum nrf_twim_error_t

TWIM error source.

Values:

enumerator NRF_TWIM_ERROR_ADDRESS_NACK: NACK received after sending the address.

enumerator NRF_TWIM_ERROR_DATA_NACK: NACK received after sending a data byte.

enumerator NRF_TWIM_ERROR_OVERRUN

Overrun error.

A new byte was received before the previous byte was handled by peripheral. (previous data is lost).

Functions

NRF_STATIC_INLINE void nrf_twim_task_trigger(NRF_TWIM_Type *p_reg, nrf_twim_task_t task)

Function for activating the specified TWIM task.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
task – [in] Task to be activated.

NRF_STATIC_INLINE uint32_t nrf_twim_task_address_get(NRF_TWIM_Type const *p_reg, nrf_twim_task_t task)

Function for getting the address of the specified TWIM task register.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
task – [in] The specified task.

Returns

Address of the specified task register.

NRF_STATIC_INLINE void nrf_twim_event_clear(NRF_TWIM_Type *p_reg, nrf_twim_event_t event)

Function for clearing the specified TWIM event.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
event – [in] Event to clear.

NRF_STATIC_INLINE bool nrf_twim_event_check(NRF_TWIM_Type const *p_reg, nrf_twim_event_t event)

Function for retrieving the state of the TWIM event.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
event – [in] Event to be checked.

Return values

true – The event has been generated.
false – The event has not been generated.

NRF_STATIC_INLINE uint32_t nrf_twim_event_address_get(NRF_TWIM_Type const *p_reg, nrf_twim_event_t event)

Function for getting the address of the specified TWIM event register.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
event – [in] The specified event.

Returns

Address of the specified event register.

NRF_STATIC_INLINE void nrf_twim_shorts_enable(NRF_TWIM_Type *p_reg, uint32_t mask)

Function for enabling the specified shortcuts.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
mask – [in] Shortcuts to be enabled.

NRF_STATIC_INLINE void nrf_twim_shorts_disable(NRF_TWIM_Type *p_reg, uint32_t mask)

Function for disabling the specified shortcuts.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
mask – [in] Shortcuts to be disabled.

NRF_STATIC_INLINE void nrf_twim_int_enable(NRF_TWIM_Type *p_reg, uint32_t mask)

Function for enabling the specified interrupts.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
mask – [in] Mask of interrupts to be enabled.

NRF_STATIC_INLINE void nrf_twim_int_disable(NRF_TWIM_Type *p_reg, uint32_t mask)

Function for disabling the specified interrupts.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
mask – [in] Mask of interrupts to be disabled.

NRF_STATIC_INLINE uint32_t nrf_twim_int_enable_check(NRF_TWIM_Type const *p_reg, uint32_t mask)

Function for checking if the specified interrupts are enabled.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
mask – [in] Mask of interrupts to be checked.

Returns

Mask of enabled interrupts.

NRF_STATIC_INLINE void nrf_twim_subscribe_set(NRF_TWIM_Type *p_reg, nrf_twim_task_t task, uint8_t channel)

Function for setting the subscribe configuration for a given TWIM task.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
task – [in] Task for which to set the configuration.
channel – [in] Channel through which to subscribe events.

NRF_STATIC_INLINE void nrf_twim_subscribe_clear(NRF_TWIM_Type *p_reg, nrf_twim_task_t task)

Function for clearing the subscribe configuration for a given TWIM task.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
task – [in] Task for which to clear the configuration.

NRF_STATIC_INLINE void nrf_twim_publish_set(NRF_TWIM_Type *p_reg, nrf_twim_event_t event, uint8_t channel)

Function for setting the publish configuration for a given TWIM event.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
event – [in] Event for which to set the configuration.
channel – [in] Channel through which to publish the event.

NRF_STATIC_INLINE void nrf_twim_publish_clear(NRF_TWIM_Type *p_reg, nrf_twim_event_t event)

Function for clearing the publish configuration for a given TWIM event.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
event – [in] Event for which to clear the configuration.

NRF_STATIC_INLINE void nrf_twim_enable(NRF_TWIM_Type *p_reg)

Function for enabling the TWIM peripheral.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

NRF_STATIC_INLINE void nrf_twim_disable(NRF_TWIM_Type *p_reg)

Function for disabling the TWIM peripheral.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

NRF_STATIC_INLINE void nrf_twim_pins_set(NRF_TWIM_Type *p_reg, uint32_t scl_pin, uint32_t sda_pin)

Function for configuring TWI pins.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
scl_pin – [in] SCL pin number.
sda_pin – [in] SDA pin number.

NRF_STATIC_INLINE uint32_t nrf_twim_scl_pin_get(NRF_TWIM_Type const *p_reg)

Function for retrieving the SCL pin selection.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

Returns

SCL pin selection.

NRF_STATIC_INLINE uint32_t nrf_twim_sda_pin_get(NRF_TWIM_Type const *p_reg)

Function for retrieving the SDA pin selection.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

Returns

SDA pin selection.

NRF_STATIC_INLINE void nrf_twim_frequency_set(NRF_TWIM_Type *p_reg, nrf_twim_frequency_t frequency)

Function for setting the TWI master clock frequency.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
frequency – [in] TWI frequency.

NRF_STATIC_INLINE uint32_t nrf_twim_errorsrc_get_and_clear(NRF_TWIM_Type *p_reg)

Function for checking the TWI error source.

The error flags are cleared after reading.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

Returns

Mask with error source flags.

NRF_STATIC_INLINE void nrf_twim_address_set(NRF_TWIM_Type *p_reg, uint8_t address)

Function for setting the address to be used in TWI transfers.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
address – [in] Address to be used in transfers.

NRF_STATIC_INLINE void nrf_twim_tx_buffer_set(NRF_TWIM_Type *p_reg, uint8_t const *p_buffer, size_t length)

Function for setting the transmit buffer.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
p_buffer – [in] Pointer to the buffer with data to send.
length – [in] Maximum number of data bytes to transmit.

NRF_STATIC_INLINE void nrf_twim_rx_buffer_set(NRF_TWIM_Type *p_reg, uint8_t *p_buffer, size_t length)

Function for setting the receive buffer.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
p_buffer – [in] Pointer to the buffer for received data.
length – [in] Maximum number of data bytes to receive.

NRF_STATIC_INLINE void nrf_twim_shorts_set(NRF_TWIM_Type *p_reg, uint32_t mask)

Function for setting the specified shortcuts.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.
mask – [in] Shortcuts to be set.

NRF_STATIC_INLINE uint32_t nrf_twim_shorts_get(NRF_TWIM_Type const *p_reg)

Function for getting the shortcut setting.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

Returns

Current shortcut configuration.

NRF_STATIC_INLINE size_t nrf_twim_txd_amount_get(NRF_TWIM_Type const *p_reg)

Function for getting the amount of transmitted bytes.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

Returns

Amount of transmitted bytes.

NRF_STATIC_INLINE size_t nrf_twim_rxd_amount_get(NRF_TWIM_Type const *p_reg)

Function for getting the amount of received bytes.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

Returns

Amount of received bytes.

NRF_STATIC_INLINE void nrf_twim_tx_list_enable(NRF_TWIM_Type *p_reg)

Function for enabling the TX list feature.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

NRF_STATIC_INLINE void nrf_twim_tx_list_disable(NRF_TWIM_Type *p_reg)

Function for disabling the TX list feature.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

NRF_STATIC_INLINE void nrf_twim_rx_list_enable(NRF_TWIM_Type *p_reg)

Function for enabling the RX list feature.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.

NRF_STATIC_INLINE void nrf_twim_rx_list_disable(NRF_TWIM_Type *p_reg)

Function for disabling the RX list feature.

Parameters

p_reg – [in] Pointer to the structure of registers of the peripheral.