QDEC HAL

group nrf_qdec_hal

Hardware access layer for managing the Quadrature Decoder (QDEC) peripheral.

Defines

NRF_QDEC_LED_NOT_CONNECTED

This value can be provided as a parameter for the nrf_qdec_pio_assign function call to specify that a LED signal shall not be use by the QDEC and connected to a physical pin.

Enums

enum nrf_qdec_task_t

QDEC tasks.

Values:

enumerator NRF_QDEC_TASK_START

Starting the quadrature decoder.

enumerator NRF_QDEC_TASK_STOP

Stopping the quadrature decoder.

enumerator NRF_QDEC_TASK_READCLRACC

Reading and clearing ACC and ACCDBL registers.

enum nrf_qdec_event_t

QDEC events.

Values:

enumerator NRF_QDEC_EVENT_SAMPLERDY

Event generated for every new sample.

enumerator NRF_QDEC_EVENT_REPORTRDY

Event generated for every new report.

enumerator NRF_QDEC_EVENT_ACCOF

Event generated for every accumulator overflow.

enum nrf_qdec_short_mask_t

QDEC shortcuts.

Values:

enumerator NRF_QDEC_SHORT_REPORTRDY_READCLRACC_MASK

Shortcut between REPORTRDY event and READCLRACC task.

enumerator NRF_QDEC_SHORT_SAMPLERDY_STOP_MASK

Shortcut between SAMPLERDY event and STOP task.

enum nrf_qdec_int_mask_t

QDEC interrupts.

Values:

enumerator NRF_QDEC_INT_SAMPLERDY_MASK

Mask for enabling or disabling an interrupt on SAMPLERDY event.

enumerator NRF_QDEC_INT_REPORTRDY_MASK

Mask for enabling or disabling an interrupt on REPORTRDY event.

enumerator NRF_QDEC_INT_ACCOF_MASK

Mask for enabling or disabling an interrupt on ACCOF event.

enum nrf_qdec_enable_t

States of the enable bit.

Values:

enumerator NRF_QDEC_DISABLE

Mask for disabling the QDEC periperal. When disabled, the QDEC decoder pins are not active.

enumerator NRF_QDEC_ENABLE

Mask for enabling the QDEC periperal. When enabled, the QDEC pins are active.

enum nrf_qdec_dbfen_t

States of the debounce filter enable bit.

Values:

enumerator NRF_QDEC_DBFEN_DISABLE

Mask for disabling the debounce filter.

enumerator NRF_QDEC_DBFEN_ENABLE

Mask for enabling the debounce filter.

enum nrf_qdec_ledpol_t

Active LED polarity.

Values:

enumerator NRF_QDEC_LEPOL_ACTIVE_LOW

QDEC LED active on output pin low.

enumerator NRF_QDEC_LEPOL_ACTIVE_HIGH

QDEC LED active on output pin high.

enum nrf_qdec_sampleper_t

Available sampling periods.

Values:

enumerator NRF_QDEC_SAMPLEPER_128us

QDEC sampling period 128 microseconds.

enumerator NRF_QDEC_SAMPLEPER_256us

QDEC sampling period 256 microseconds.

enumerator NRF_QDEC_SAMPLEPER_512us

QDEC sampling period 512 microseconds.

enumerator NRF_QDEC_SAMPLEPER_1024us

QDEC sampling period 1024 microseconds.

enumerator NRF_QDEC_SAMPLEPER_2048us

QDEC sampling period 2048 microseconds.

enumerator NRF_QDEC_SAMPLEPER_4096us

QDEC sampling period 4096 microseconds.

enumerator NRF_QDEC_SAMPLEPER_8192us

QDEC sampling period 8192 microseconds.

enumerator NRF_QDEC_SAMPLEPER_16384us

QDEC sampling period 16384 microseconds.

enum nrf_qdec_reportper_t

Available report periods.

Values:

enumerator NRF_QDEC_REPORTPER_1

QDEC report period 1 sample.

enumerator NRF_QDEC_REPORTPER_10

QDEC report period 10 samples.

enumerator NRF_QDEC_REPORTPER_40

QDEC report period 40 samples.

enumerator NRF_QDEC_REPORTPER_80

QDEC report period 80 samples.

enumerator NRF_QDEC_REPORTPER_120

QDEC report period 120 samples.

enumerator NRF_QDEC_REPORTPER_160

QDEC report period 160 samples.

enumerator NRF_QDEC_REPORTPER_200

QDEC report period 200 samples.

enumerator NRF_QDEC_REPORTPER_240

QDEC report period 240 samples.

enumerator NRF_QDEC_REPORTPER_280

QDEC report period 280 samples.

enumerator NRF_QDEC_REPORTPER_DISABLED

QDEC reporting disabled. Deprecated.

Functions

NRF_STATIC_INLINE void nrf_qdec_enable(NRF_QDEC_Type *p_reg)

Function for enabling QDEC.

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

NRF_STATIC_INLINE void nrf_qdec_disable(NRF_QDEC_Type *p_reg)

Function for disabling QDEC.

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

NRF_STATIC_INLINE uint32_t nrf_qdec_enable_get(NRF_QDEC_Type const *p_reg)

Function for returning the enable state of QDEC.

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

Returns

State of the register.

NRF_STATIC_INLINE void nrf_qdec_int_enable(NRF_QDEC_Type *p_reg, uint32_t mask)

Function for enabling QDEC interrupts by mask.

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_qdec_int_disable(NRF_QDEC_Type *p_reg, uint32_t mask)

Function for disabling QDEC interrupts by mask.

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_qdec_int_enable_check(NRF_QDEC_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_qdec_dbfen_enable(NRF_QDEC_Type *p_reg)

Function for enabling the QDEC debouncing filter.

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

NRF_STATIC_INLINE void nrf_qdec_dbfen_disable(NRF_QDEC_Type *p_reg)

Function for disabling the QDEC debouncing filter.

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

NRF_STATIC_INLINE uint32_t nrf_qdec_dbfen_get(NRF_QDEC_Type const *p_reg)

Function for getting the state of the QDEC debouncing filter.

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

Return values
  • NRF_QDEC_DBFEN_DISABLE – The debouncing filter is disabled.

  • NRF_QDEC_DBFEN_ENABLE – The debouncing filter is enabled.

NRF_STATIC_INLINE void nrf_qdec_pins_set(NRF_QDEC_Type *p_reg, uint32_t phase_a_pin, uint32_t phase_b_pin, uint32_t led_pin)

Function for configuring QDEC pins.

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

  • phase_a_pin[in] Phase A pin number.

  • phase_b_pin[in] Phase B pin number.

  • led_pin[in] LED pin number.

NRF_STATIC_INLINE void nrf_qdec_pio_assign(NRF_QDEC_Type *p_reg, uint32_t psela, uint32_t pselb, uint32_t pselled)

Function for assigning QDEC pins.

Note

This function is deprecated. Use nrf_qdec_pins_set instead.

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

  • psela[in] Pin number.

  • pselb[in] Pin number.

  • pselled[in] Pin number.

NRF_STATIC_INLINE uint32_t nrf_qdec_phase_a_pin_get(NRF_QDEC_Type const *p_reg)

Function for getting the Phase A pin selection.

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

Returns

Phase A pin selection.

NRF_STATIC_INLINE uint32_t nrf_qdec_phase_b_pin_get(NRF_QDEC_Type const *p_reg)

Function for getting the Phase B pin selection.

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

Returns

Phase B pin selection.

NRF_STATIC_INLINE uint32_t nrf_qdec_led_pin_get(NRF_QDEC_Type const *p_reg)

Function for getting the LED pin selection.

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

Returns

LED pin selection.

NRF_STATIC_INLINE void nrf_qdec_task_trigger(NRF_QDEC_Type *p_reg, nrf_qdec_task_t task)

Function for setting the specified QDEC task.

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

  • task[in] QDEC task to be triggered.

NRF_STATIC_INLINE uint32_t nrf_qdec_task_address_get(NRF_QDEC_Type const *p_reg, nrf_qdec_task_t task)

Function for retrieving the address of a QDEC task register.

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

  • task[in] QDEC task to get its address.

Returns

Address of the specified QDEC task.

NRF_STATIC_INLINE void nrf_qdec_event_clear(NRF_QDEC_Type *p_reg, nrf_qdec_event_t event)

Function for clearing the specified QDEC event.

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

  • event[in] QDEC event to be cleared.

NRF_STATIC_INLINE bool nrf_qdec_event_check(NRF_QDEC_Type const *p_reg, nrf_qdec_event_t event)

Function for getting the state of the specified QDEC event.

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

  • event[in] QDEC event to be checked.

Returns

State of the specified QDEC event.

NRF_STATIC_INLINE uint32_t nrf_qdec_event_address_get(NRF_QDEC_Type const *p_reg, nrf_qdec_event_t event)

Function for retrieving the address of the specified QDEC event register.

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

  • event[in] QDEC event to get its address.

Returns

Address of the specified QDEC event.

NRF_STATIC_INLINE void nrf_qdec_shorts_enable(NRF_QDEC_Type *p_reg, uint32_t mask)

Function for setting QDEC shortcuts.

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

  • mask[in] Mask of QDEC shortcuts to be set.

NRF_STATIC_INLINE void nrf_qdec_shorts_disable(NRF_QDEC_Type *p_reg, uint32_t mask)

Function for clearing shortcuts of the QDEC by mask.

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

  • mask[in] Mask of QDEC shortcuts to be cleared.

NRF_STATIC_INLINE uint32_t nrf_qdec_sampleper_to_value(nrf_qdec_sampleper_t sampleper)

Function for converting return value of the nrf_qdec_sampleper_get function to microseconds.

Parameters
  • sampleper[in] The sampling period.

Returns

Period in microseconds.

NRF_STATIC_INLINE void nrf_qdec_sampleper_set(NRF_QDEC_Type *p_reg, nrf_qdec_sampleper_t sampleper)

Function for setting value of the QDEC sampling period.

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

  • sampleper[in] The sampling period.

NRF_STATIC_INLINE nrf_qdec_sampleper_t nrf_qdec_sampleper_get(NRF_QDEC_Type const *p_reg)

Function for retrieving value of the QDEC sampling period.

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

Returns

Sampling period.

NRF_STATIC_INLINE int32_t nrf_qdec_sample_get(NRF_QDEC_Type const *p_reg)

Function for retrieving value of the QDEC SAMPLE register.

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

Returns

Value of the SAMPLE register.

NRF_STATIC_INLINE int32_t nrf_qdec_acc_get(NRF_QDEC_Type const *p_reg)

Function for retrieving value of the QDEC ACC register.

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

Returns

Value of the ACC register.

NRF_STATIC_INLINE int32_t nrf_qdec_accread_get(NRF_QDEC_Type const *p_reg)

Function for retrieving value of the QDEC ACCREAD register.

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

Returns

Value of the ACCREAD register.

NRF_STATIC_INLINE uint32_t nrf_qdec_accdbl_get(NRF_QDEC_Type const *p_reg)

Function for retrieving value of the QDEC ACCDBL register.

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

Returns

Value of the ACCDBL register.

NRF_STATIC_INLINE uint32_t nrf_qdec_accdblread_get(NRF_QDEC_Type const *p_reg)

Function for retrieving value of the QDEC ACCDBLREAD register.

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

Returns

Value of the ACCDBLREAD register.

NRF_STATIC_INLINE void nrf_qdec_ledpre_set(NRF_QDEC_Type *p_reg, uint32_t time_us)

Function for setting delay time between setting LED active state and start sampling.

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

  • time_us[in] Delay time (in microseconds) between setting LED active state and start sampling.

NRF_STATIC_INLINE uint32_t nrf_qdec_ledpre_get(NRF_QDEC_Type const *p_reg)

Function for retrieving how long the LED is switched on before sampling.

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

Returns

The gap in time in microseconds between switched LED to active state and start sampling.

NRF_STATIC_INLINE void nrf_qdec_reportper_set(NRF_QDEC_Type *p_reg, nrf_qdec_reportper_t reportper)

Function for setting the report period (in samples).

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

  • reportper[in] The number of samples.

NRF_STATIC_INLINE uint32_t nrf_qdec_reportper_get(NRF_QDEC_Type const *p_reg)

Function for retrieving the report period.

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

Returns

The report period.

NRF_STATIC_INLINE uint32_t nrf_qdec_reportper_to_value(uint32_t reportper)

Function for retrieving the value of QDEC SAMPLEPER register.

Parameters
  • reportper[in] Reportper to be converted to amount of samples per report.

Returns

Number of samples per report.

NRF_STATIC_INLINE void nrf_qdec_ledpol_set(NRF_QDEC_Type *p_reg, nrf_qdec_ledpol_t pol)

Function for setting the active level for the LED.

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

  • pol[in] Level of the active signal of the LED.

NRF_STATIC_INLINE uint32_t nrf_qdec_ledpol_get(NRF_QDEC_Type const *p_reg)

Function for retrieving the active level for the LED.

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

Returns

Level of the active signal of the LED.