1# Changelog 2All notable changes to this project are documented in this file. 3 4## [3.1.0] - 2023-06-28 5 6### Added 7- Added the HALY layer for the NFCT. HALY is an extension of the HAL layer that aggregates basic hardware use cases within single functions. Now it is used instead of HAL in the NFCT drivers. 8- Added the NRFX_IN_RANGE() macro for checking if a given value is in a given range. 9- Added functions for writing a word to the flash and reading a buffer, word, halfword, and byte in the NVMC HAL. 10 11### Changed 12- Updated MDK to version 8.55.0. 13- Modified the power management in the SPIM driver. Now the nrfx_spim_abort() function must be called once all expected transactions using the NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER, NRFX_SPIM_FLAG_HOLD_XFER, or NRFX_SPIM_FLAG_REPEATED_XFER option flags are finalized. 14 15### Fixed 16- Fixed a workaround for the anomaly 109 on the nRF52 family in the SPIM and SPIS drivers. 17- Fixed the NRFX_TIMER_FREQUENCY_STATIC_CHECK() and NRFX_SPIM_FREQUENCY_STATIC_CHECK() macros. 18- Fixed the nrfx_wdt_reconfigure() function that was returning the NRFX_ERROR_INVALID_STATE error code when the driver instance has been initialized. 19- Fixed the nrfx_pwm_stopped_check() function when used without user's handler function. 20 21## [3.0.0] - 2023-04-25 22### Added 23- Added the HALY layer for the following peripherals: COMP, DPPI, GPIO, GPIOTE, I2S, LPCOMP, PDM, PWM, QDEC, RTC, SAADC, SPIM, TEMP, TIMER, TWIM, UARTE, WDT. HALY is an extension of the HAL layer that aggregates basic hardware use cases within single functions. Now it is used instead of HAL in the corresponding drivers. 24- Added functions for reconfiguring a peripheral outside of the initialization process in the following drivers: COMP, PDM, PWM, QDEC, QSPI, SPI, SPIM, SPIS, TIMER, TWI, TWIM, TWIS, UART, UARTE, WDT. 25- Added multi-instance support for the I2S and QDEC drivers. Now a pointer to the driver instance needs to be specified in all relevant functions. 26- Added the reportper_inten member to the configuration structure for the QDEC driver. It allows to explicitly enable interrupts associated with the REPORTRDY peripheral event. 27- Added the NRFX_ERROR_FORBIDDEN error being returned from the nrfx_spim_init() function when a user attempts to configure a hardware-controlled and software-controlled chip select simultaneously. 28- Added the NRFX_TIMER_FREQUENCY_STATIC_CHECK() macro to statically check if the given frequency is achievable for the specified TIMER instance. 29- Added the NRFX_TWIM_XFER_DESC() macro to support creation of any type of TWIM transaction for the TWIM driver. 30- Added auxiliary macros NRFX_KHZ_TO_HZ() and NRFX_MHZ_TO_HZ() for converting specified frequency value to Hertz. 31- Added auxiliary macros for sophisticated handling of the preprocessor symbols to `nrfx_utils.h`. 32- Added functions for getting the number of available channels and groups for a given peripheral instance in the DPPIC HAL. 33- Added functions for getting the SEQSTART tasks and SEQEND events associated with a specified sequence index in the PWM HAL. 34- Added the nrf_rtc_capture_task_get() function for getting the CAPTURE task associated with the specified CC channel in the RTC HAL. 35- Added functions for managing the non-maskable watchdog interrupts in the WDT HAL. 36- Added functions for getting the address of peripheral tasks and events in the EGU HAL. 37- Added a function for enabling the watchdog STOP task in the WDT HAL. 38- Added a function for getting the bitmask of all watchdog requests' statuses in the WDT HAL. 39- Added a function for clearing the event and task endpoints for a given channel in the GPPI helper. 40 41### Changed 42- Renamed a macro from NRFX_VOLTAGE_THRESHOLD_TO_INT() to NRFX_COMP_VOLTAGE_THRESHOLD_TO_INT() in the COMP HAL. 43- Renamed functions for getting the task of event address in the following drivers: CLOCK, GPIOTE, PPI, SPIM, TWIM. Now they follow a common scheme. 44- Renamed configuration structure members `hal` and `hal_config`, containing low-level peripheral settings, to `config` in the LPCOMP and UARTE drivers. 45- Renamed a function from nrfx_pwm_is_stopped() to nrfx_pwm_stopped_check() in the PWM driver. 46- Renamed a symbol from NRF_QDEC_LED_NOT_CONNECTED to NRF_QDEC_PIN_NOT_CONNECTED in the QDEC HAL. Now it is consistent with other, similar symbols. 47- Changed the way the API version to be used is specified. Now the following dedicated symbols shall be defined to form the API version as a numerical value: NRFX_CONFIG_API_VER_MAJOR, NRFX_CONFIG_API_VER_MINOR, NRFX_CONFIG_API_VER_MICRO. 48- Changed prototypes of several functions in the UARTE driver. Now all functions have a return value, and some of them accept additional parameters. 49- Changed a type of configuration structure members that hold a pin number from `uint8_t` to `uint32_t` in the following drivers: I2S, PWM, SPIM. 50- Changed the prototypes of the nrf_i2s_pins_set() and nrf_i2s_configure() functions in the I2S HAL. Now they accept a pointer to the configuration structure instead of several individual parameters. 51- Changed a default value of the `gain` structure member from `1/6` to `1` in the SAADC driver configuration structure. 52- Changed a type of the configuration structure member specifying the clock frequency from an enumeration to an unsigned integer in the TIMER driver. Now the timer clock frequency must be specified in Hertz. Use the NRFX_TIMER_FREQUENCY_STATIC_CHECK() macro to check if the requested frequency is achievable for a given TIMER instance. 53- Changed a type of the configuration structure member specifying the clock frequency from an enumeration to an unsigned integer in the SPIM driver. Now the clock signal frequency must be specified in Hertz. Use the NRFX_SPIM_FREQUENCY_STATIC_CHECK() macro to check if the requested frequency is achievable for a given SPIM instance. 54- Changed the prototype of the NRFX_TIMER_DEFAULT_CONFIG() macro in the TIMER driver. Now the desired timer clock frequency in Hertz needs to be specified as a parameter. 55- Changed a prototype of the WDT driver callback. Now a bitmask specifying which reload request caused the timeout is provided. 56- Changed the prototype of the initialization and callback functions of the QDEC driver. Now the user context can be provided and accessed during the interrupt handler execution. 57- Removed the deprecated nrf_gpio_pin_mcu_select() function and the corresponding nrf_gpio_pin_mcusel_t enumerator. Use the nrf_gpio_pin_control_select() function and the nrf_gpio_pin_sel_t enumerator instead. 58- Removed the deprecated and spurious NRF_QDEC_REPORTPER_DISABLED symbol from the QDEC HAL. 59- Removed the deprecated nrf_qdec_pio_assign() function from the QDEC HAL. Use the nrf_qdec_pins_set() function instead. 60- Removed the deprecated nrf_timer_frequency_set() and nrf_timer_frequency_get() functions in the TIMER HAL. Use nrf_timer_prescaler_set() and nrf_timer_prescaler_get() instead. 61- Removed symbols that mark a pin as unused in the following drivers: I2S, PWM, SPIM, SPIS. Now the HAL variant should be used instead. 62- Removed deprecated functions from the GPIOTE driver. Use new functions instead. 63- Removed the deprecated callback prototype in the IPC driver. Use a new variant instead. 64- Removed the following redundant functions from the PWM driver: nrfx_pwm_sequence_values_update(), nrfx_pwm_sequence_length_update(), nrfx_pwm_sequence_repeats_update(), nrfx_pwm_sequence_end_delay_update(). Use the nrfx_pwm_sequence_update() function instead. 65- Moved static inline functions from the header file to the source file in the GPPI helper. 66- Refactored the method of configuring pins that should use inverted polarity in the PWM driver. Now an array inside driver configuration structure needs to be used instead of masking the pin number value. As a consequence, the NRFX_PWM_PIN_INVERTED symbol was removed. 67- Renamed configuration structure members used for setting peripheral pins in the following drivers: PDM, TWIM, TWIS, UARTE. Now they use a common scheme. 68- Renamed the nrf_wdt_started() and nrf_wdt_request_status() functions in the WDT HAL. Now they are named as nrf_wdt_started_check() and nrf_wdt_request_status_check() respectively. 69 70### Fixed 71- Fixed a misleading description for the nrf_rtc_event_disable() function in the RTC HAL. It accepts a bitmask of events instead of a single event. 72 73## [2.11.0] - 2023-04-07 74### Added 75- Added support for the nRF9161 and nRF9131 SiPs. Use `NRF9120_XXAA` as the compilation symbol. 76- Implemented a workaround for the anomaly 161 on the nRF5340 SoC in the RESET HAL. 77 78### Changed 79- Updated MDK to version 8.53.1. 80 81### Fixed 82- Removed a spurious function call causing aborting of endpoints in the SUSPEND event for the USBD driver. 83 84## [2.10.0] - 2022-10-25 85### Added 86- Added NRFX_CONFIG_API_VER_2_9 and NRFX_CONFIG_API_VER_2_10 symbols that guard API-breaking changes. Deprecated API is used by default. 87- Added new signature for the event handler in the IPC driver that accepts event index instead of event bitmask. The previous signature is deprecated. 88- Added nrfx_ipc_gpmem_get() function that is used to get data from the GPMEM register in IPC. It should be now used instead of nrfx_ipc_mem_get(), which is deprecated. 89- Added samples for the following drivers: EGU, PWM, RNG, SAADC, SPIM, SPIS, TEMP, TIMER, TWIM, TWIS, UARTE. They are a part of `zephyrproject-rtos/hal_nordic/nrfx` repository. 90- Introduced the NRFX_{PERIPH}_INST_HANDLER_GET() macro for getting interrupt handler associated with the specified driver instance. 91- Introduced the NRFX_{PERIPH}_INST_GET() macro for getting pointer to the structure of the registers of the specified peripheral. 92- Introduced the NRF_TIMER_PRESCALER_CALCULATE() macro for computing prescaler value for given TIMER base frequency and desired frequency. 93- Introduced the NRF_TIMER_BASE_FREQUENCY_GET() macro for getting base frequency in Hz for the specified TIMER instance. 94- Added missing NRFX_RESET_REASON_CTRLAP_MASK in nrfx_reset_reason_mask_t for nRF9160. 95- Added missing NRFX_RESET_REASON_SREQ_MASK in nrfx_reset_reason_mask_t. 96 97### Changed 98- Updated MDK to version 8.51.0. 99- Refactored the TIMER driver to allow user handler to be NULL. 100- Removed magic numbers from nrf_twim_event_t type in TWIM HAL. 101 102### Fixed 103- Fixed the NRFX_ROUNDED_DIV() macro for negative numbers. 104- Disabled array bounds warning for nrf_clock_is_running() function that was false positive in GCC 12 and above. 105 106## [2.9.0] - 2022-07-19 107### Added 108- Added configuration parameter NRFX_NFCT_PARAM_ID_FDT_MIN that allows settting the value of the FRAMEDELAYMIN register. 109- Added nrf_gpio_pin_sel_t enumerator. It should be now used instead of nrf_gpio_pin_mcusel_t, which is deprecated. 110- Added nrf_gpio_pin_control_select() function. It should be now used instead of nrf_gpio_pin_mcu_select(), which is deprecated. 111- Added NRF_TIMER_CC_COUNT_MAX symbol that specifies maximum number of available compare channels. 112- Added NRF_TIMER_ALL_CHANNELS_INT_MASK symbol that is used for creating the interrupt bitmask for all compare channels. 113- Added nrf_timer_prescaler_set() and nrf_timer_prescaler_get() functions that are used for setting and retrieving the prescaler factor. They should be now used instead of nrf_timer_frequency_set() and nrf_timer_frequency_get(), which are deprecated. 114- Added NRFX_MAX(), NRFX_MIN() and NRFX_ABS() macros. 115 116### Changed 117- Updated MDK to version 8.47.0. 118 119### Fixed 120- Fixed logging level in nrfx_uart_init() and nrfx_uarte_init() functions. It was reduced from warning to info. 121- Fixed IO3 level used in nrfx_qspi_mem_busy_check(). The line is now kept high to prevent memory status from being read incorrectly. 122 123## [2.8.0] - 2022-04-05 124### Added 125- Added function for getting the currently configured channels in the SAADC driver. 126- Added callback for the RXFRAMESTART event in the NFCT driver. 127- Added function for transmitting the NFC frame with specified number of bits in the NFCT driver. 128- Added functions for getting and setting SEL_RES auto response configuration in the NFCT HAL. 129 130### Changed 131- Refactored calibration procedure in the SAADC driver, so it retains previously configured mode. 132- Improved management of low frequency clock source during initialization in the CLOCK driver. Compatible source that already runs or is starting during initialization is now used without reconfiguration. 133- Improved software-managed triggering of the START task on an END event in the SAADC driver. 134 135### Fixed 136- Fixed event processing order in the SAADC driver. Previously, incorrect buffer might have been filled when double-buffered sampling was used with END event and START task being connected through (D)PPI. 137- Fixed the limits feature that could be spuriously triggered during calibration procedure in the SAADC driver. 138 139## [2.7.0] - 2021-12-16 140### Added 141- Added new fields in the driver configuration structures to allow skipping GPIO and/or PSEL register configuration. Affected drivers: I2S, PDM, PWM, QDEC, QSPI, SPI, SPIM, SPIS, TWI, TWIM, TWIS, UART, UARTE. 142 143### Changed 144- Updated MDK to version 8.44.2. 145 146### Fixed 147- Fixed the inability to start subsequent simple mode conversion from the user callback context in the SAADC driver. 148 149## [2.6.0] - 2021-11-22 150### Added 151- Added new functions for the GPIOTE peripheral management in the GPIOTE driver. Legacy API is now deprecated. 152- Added support for the TIMER CC channels 6 and 7. 153- Added the nrfx_flag32_allocator helper layer to unify resource allocation mechanism across several drivers. 154- Added functions for getting shortcut bitmask associated with specified channel in the TIMER HAL. 155- Added functions for channel allocation and deallocation in the nrfx_gppi helper layer. 156- Added the nrf_gpio_reconfigure() function for selective reconfiguration of the specified pin. 157- Introduced the NRFX_CLOCK_CONFIG_CT_ENABLED symbol for enabling the calibration timer support in the CLOCK driver. The symbol is enabled by default on supported SoCs. 158- Introduced the NRFX_CTZ and NRFX_CLZ macros to allow providing custom implementation for these functionalities. By default `__RBIT()` and `__CLZ()` CMSIS macros are used. 159- Introduced the NRFX_ATOMIC_CAS macro to allow providing custom implementation for atomic compare-and-swap functionality. 160- Implemented workaround for the nRF9160 anomaly 7 in the NVMC driver. 161 162### Changed 163- Updated MDK to version 8.44.1. 164 165### Fixed 166- Fixed missing disabling of interrupts in the nrfx_qspi_lfm_start() and nrfx_qspi_lfm_xfer() functions. 167- Fixed manual sample fetching when REPORTPER is disabled in the QDEC driver. 168- Fixed a race condition in the NFCT driver when starting the transfer. 169 170## [2.5.0] - 2021-05-05 171### Added 172- Added support for double-buffered transfers in the QSPI driver. 173- Added support for one-by-one channel configuration in the SAADC driver. 174- Added critical sections for channel allocation and deallocation in the DPPI driver. 175- Added support for generating documentation in the RST format using Sphinx tool. 176- Added high-drive pin configuration in the QSPI, TWIM, and SPIM drivers. 177- Added report period setting of 1 sample in the QDEC HAL. 178- Implemented workaround for nRF53 Series anomaly 121 in the QSPI driver. 179 180### Changed 181- Updated MDK to version 8.40.2. 182- Removed implicit channel deallocation during initialization in the GPIOTE driver. 183- Restricted pins that are supported for specific configuration on nRF5340 in the QSPI, TWIM, and SPIM drivers. 184- Aligned IRQ handler symbols to new naming scheme for nRF53 Series. 185 186### Fixed 187- Fixed register access sequence in the COMP driver. 188- Fixed memory corruption when uninitialized channel was freed in the GPIOTE driver. 189- Fixed spurious access of DCX pin for every instance of the peripheral when extended features were enabled in the SPIM driver. 190- Fixed overwrite of MCUSEL configuration in the nrf_gpio_cfg() function. 191- Fixed driver behavior for zero-length transfer in the TWIM driver. 192- Fixed internal state handling when transfer is aborted before finishing in the TWI and TWIM drivers. 193- Corrected assertions for MPS requirements in the USBD driver. 194- Corrected symbol describing maximum data payload for a full-speed isochronous endpoint in the USBD driver. 195 196## [2.4.0] - 2020-11-13 197### Added 198- Added the channel allocator feature in the GPIOTE driver. 199- Added support for registers associated with the Direction Finding feature in the RADIO HAL. 200- Added support for the SUBSCRIBE and PUBLISH registers in the following HALs: AAR, CCM, ECB, RADIO, and RNG. 201- Added support for the LATENCY register present on nRF5340 in the GPIOTE driver and the GPIOTE HAL. 202- Implemented workaround for nRF53 Series anomaly 53 in the POWER driver. 203 204### Changed 205- Updated MDK to 8.37.0. 206 207### Fixed 208- Fixed unused parameters in the PPI, CLOCK, SPIM and POWER drivers to resolve compilation warnings, such as 'flags' in the SPIM driver. 209- Fixed a race condition in the COMP driver when interrupt occured before update of the driver internal state. 210- Fixed minor C++ compilation warnings in the drivers. 211- Fixed implementation of workaround for nRF52 Series anomaly 197 in the POWER HAL, which was applied in incorrect configuration. 212- Fixed implementation of workaround for nRF53 Series anomaly 4 in the CLOCK driver, which was applied in incorrect configuration. 213- Fixed the incorrect signature of the nrf_clock_alwaysrun_set() function. 214 215## [2.3.0] - 2020-08-19 216### Added 217- Added support for nRF52805. 218- Implemented workaround for nRF52 Series anomaly 197 in the POWER HAL. 219- Implemented workaround for nRF52 Series anomalies 211 and 223 in the USBD driver. 220- Added support for the nRF53 Series in the QSPI HAL. 221- Added function in the GPIO HAL that returns port index. 222- Introduced a QSPI HAL symbol that indicates the availability of the QSPI mode 1. 223- Introduced shortcut functionality in the CCM HAL. 224- Added function in the TIMER HAL for setting the specified shortcuts. 225- Added optional two-stage start procedure of the LFXO in the CLOCK driver. 226 227### Changed 228- Updated MDK to 8.35.0. 229- Divided network and application core-specific functionalities for nRF5340 in the RESET HAL and the reset reason helper. 230 231### Fixed 232- Corrected assertions in the NVMC driver. 233- Corrected return types in the CCM HAL. 234- Fixed setting of program memory access mode for secure code in the NVMC driver. 235- Removed usage of the NRF_UICR symbol on non-secure targets in address validity checks in the NVMC driver. 236- Fixed an error message in the SPIM driver that prevented successful compilation with logging enabled. 237- Fixed unused parameters in the PPI HAL. 238 239## [2.2.0] - 2020-04-28 240### Added 241- Added support for nRF52820. 242- Added possibility to use the nRF52833 DK in development for nRF52820. LEDs and buttons in this DK use GPIOs that are not present in the actual nRF52820 device, so accesses to these need special handling in the GPIO HAL. 243- Added the nrfx_reset_reason helper layer, to facilitate developing generic code that uses the RESETREAS register. 244- Implemented workarounds for nRF52 Series anomalies 170 and 196 in the I2S driver. 245- Added implicit casting of uint32_t to unsigned long in log messages, to prevent compiler warnings. 246- Added missing secure and non-secure peripheral symbol translations for nRF5340 and nRF9160. 247- Added functions in the NVMC driver for reading and writing halfword data from the OTP region of the UICR. 248 249### Changed 250- Updated MDK to 8.32.1. 251- Improved documentation regarding double-buffered reception in the UARTE driver. 252- Unified policy of pin cleanup procedure during uninitialization of the drivers. Now every driver restores utilized pins to default setting. 253- Removed support for revision Engineering A of nRF52840 in the USBD driver. 254- Changed selected while() loops to NRFX_WAIT_FOR() macro in the SPIM, UARTE and CLOCK drivers to improve robustness. 255 256### Fixed 257- Fixed assertions that check write addresses in the NVMC driver. Now the UICR memory region is handled properly. 258- Fixed a race condition in the CLOCK driver when requested clock was stopped during ramp-up from high priority interrupt. 259- Fixed assertions that check pin numbers in the GPIO HAL and GPIOTE driver. Now noncontiguous groups of available pin numbers are handled properly. 260- Fixed assertion that checks correctness of limit setting in the SAADC driver. 261- Fixed spurious callback invocation when the SPIM driver was reinitialized to blocking mode from non-blocking mode. 262- Fixed missing workaround for I2S STOP anomaly for nRF52833. 263- Fixed handling of NRFX_SPIM_FLAG_HOLD_XFER setting in the blocking mode of the SPIM driver. 264- Fixed void pointer cast in the CLOCK HAL, which could cause memory corruption with specific compiler settings. 265- Fixed definition of the NRF_CLOCK_LFCLK_Synth value, to make it available also in builds for nRF5340. 266 267## [2.1.0] - 2020-01-24 268### Added 269- Added HALs for DCNF, OSCILLATORS, USBREG, and VREQCTRL. 270- Added support for 1-MHz clock frequency in TWIM. 271- Introduced the NRFX_I2S_STATUS_TRANSFER_STOPPED flag in the I2S driver. 272- Introduced the nrfx_power_compat layer that allows use of the nrfx_power API with new SoC. 273- Added encryption support in the QSPI driver. 274- Added support for USBD in nRF5340. 275- Expanded HALs to cover new functions in nRF5340: GPIO, I2S, PDM, POWER, QSPI, and REGULATORS. 276- Introduced new clock management system in the CLOCK driver. 277- Introduced new audio clock configuration settings in the I2S and PDM drivers for nRF5340. 278- Implemented workaround for nRF5340 anomaly 4 in the CLOCK driver. 279- Implemented workaround for nRF5340 anomaly 10 in the CCM HAL. 280- Implemented workaround for nRF9160 anomaly 21 and nRF5340 anomaly 6 in the NVMC HAL. 281- Implemented workaround for nRF9160 anomaly 23 and nRF5340 anomaly 44 in the UARTE driver. 282- Introduced the NRFX_TWIM_NO_SPURIOUS_STOP_CHECK flag in the TWIM driver. 283- Added functions for getting shortcut configuration in the TWIM HAL. 284 285### Changed 286- Updated MDK to 8.30.2. 287- Reorganized templates of nrfx_config header files for different SoCs. Now they are included through one common file according to the selected SoC. 288- Improved the UARTE driver to consume less current after the driver uninitialization. Now all clocks are disabled properly after uninitialization. 289- Improved the GPIOTE driver robustness by setting the LATCH functionality to be used by default. 290- Changed names of the frequency divider symbols in the QSPI HAL to reflect the new frequencies in nRF5340. Old API names were preserved and are still supported. 291- Improved spurious STOP condition handling in the TWIM driver. 292- Improved sampling procedure in the advanced blocking mode in the SAADC driver. 293- Improved calibration procedure in the SAADC driver for nRF5340 and nRF9160. 294 295### Fixed 296- Fixed address assertions in NVMC driver for the nRF5340 network core. 297- Fixed an issue in the TWI driver that would make the driver stuck when a premature STOP condition was generated by a slave device. The driver now handles this situation properly and signals that a bus error occurred. 298- Fixed the stopping procedure in the PWM driver. Previously in very specific circumstances the PWM output might be not stopped at all or might be immediately restarted. 299 300## [2.0.0] - 2019-11-06 301### Added 302- Added support for nRF5340. 303- Added HALs for: CACHE, FPU, MUTEX, and RESET. 304- Added driver and HAL for IPC. 305- Added possibility to configure in UART and UARTE the number of stop bits and the type of parity, when a given SoC allows it. 306- Added function in the GPIO HAL for selecting the MCU to control the specified pin. 307- Added support for ONESHOT register in the TIMER HAL. 308- Added support for LIST feature in HALs for SPIS and TWIS. 309- Added possibility to choose TIMER instance used for workarounds in the NFCT driver. 310 311### Changed 312- Updated MDK to 8.29.0. 313- Enhanced PWM driver API: added the "p_context" parameter to the event handler. 314- Updated address and task getters in all HALs to return values as uint32_t type. 315- Updated all HAL functions to take the pointer to the structure of registers of the peripheral as their first argument. 316- Changed __STATIC_INLINE symbol to NRF_STATIC_INLINE for HALs and NRFX_STATIC_INLINE for drivers. 317- Refactored the SAADC driver and HAL. 318- Refactored the WDT driver and HAL to support multiple instances. 319- Changed nrfx_gpiote_init() function to take the interrupt priority as its parameter. Previously this priority was an nrfx_config option. 320- Changed nrf_usbd_ep_all_disable() function to disable really all endpoints. Use nrf_usbd_ep_default_config() to restore the default endpoint configuration. 321- Updated nrfx_gpiote_out_init() and nrfx_gpiote_in_init() return codes. Now NRFX_ERROR_INVALID_STATE is changed to NRFX_ERROR_BUSY. 322- Replaced the SWI/EGU driver with one for EGU only. 323- Aligned symbol names for default IRQ priority in nrfx_config. These symbols are now adhering to the following standard: NRFX_xxx_DEFAULT_CONFIG_IRQ_PRIORITY. 324- Changed the way of configuring the MISO pin pull setting in SPI and SPIM drivers. Now it can be set separately for each instance. 325 326### Removed 327- Removed deprecated functions from drivers: TWI and TWIM. See migration guide for details. 328- Removed deprecated functions from HALs: ECB, NVMC, and TEMP. See migration guide for details. 329- Removed redundant bariers in the nrfx_usbd driver. 330- Removed the default configuration values for drivers from the nrfx_config header files. 331 332## [1.8.1] - 2019-10-21 333### Added 334- Added functions in the GPIOTE driver for getting task or event for the specified GPIO pin. 335 336### Changed 337- Updated MDK to version 8.27.1. 338- Moved the nrfx_gppi helper from helpers/nrfx_gppi/ to helpers/. 339- Changed the interrupt initialization in the GPIOTE driver, so that mapping of the GPIOTEx_IRQn enumeration values is no longer needed for nRF9160. 340 341## [1.8.0] - 2019-08-27 342### Added 343- Added support for nRF52833. 344- Added bus recovery feature in the TWI and TWIM drivers. 345- Added the nrfx_gppi helper layer to facilitate developing generic code that can utilize PPI or DPPI, depending on which interface is available in a given SoC. 346 347### Changed 348- Updated MDK to version 8.27.0. 349 350### Fixed 351- Fixed an issue in the TWIM driver that would make the driver stuck when a premature STOP condition was generated by a slave device. The driver now handles this situation properly and signals that a bus error occurred. 352- Fixed a frame timing bug in the NFCT driver. Previously, the timing of the SENS_RES response could be violated after the NFCT peripheral was put to the Sleep state with the SLP_REQ command. 353 354## [1.7.2] - 2019-07-25 355### Added 356- Added functions in the DPPI, GPIOTE, PPI, RTC, and TIMER HALs for getting tasks and events specified by index. 357- Added the possibility of suspending transfers in the TWI driver. This allows combining several transfers into one continuous TWI transaction. 358- Added termination of transfers at deinitialization of the UARTE driver. 359- Added buffer alignment checks in the QSPI driver. 360- Introduced the NRFX_OFFSETOF macro that duplicates the functionality of the built-in offsetof() mechanism, but can be used without issues also with non-constant expressions. 361- Added an alternative way of ending the DMA transfer loop in the USBD driver. 362- Added the CTSTARTED and CTSTOPPED events to the CLOCK HAL. 363 364### Changed 365- Removed an assertion that prevented setting the data payload size of isochronous endpoints to zero, to fulfill requirements of the USB 2.0 specification, paragraph 5.6.3. 366- Declared the tx_buffer_length field in the UART driver's control block as volatile to prevent issues in case of compilation with high optimization level. 367 368### Fixed 369- Fixed an incorrect conversion of frequency values in the RADIO HAL. 370- Fixed an incorrectly enabled interrupt in the QSPI driver. 371- Corrected the LFCLK source selection values in the template configuration file for nRF9160. 372- Fixed support for external LFCLK sources for nRF52811. 373 374## [1.7.1] - 2019-04-08 375### Added 376- Added functions in the NVMC driver for getting the flash page size, the count of pages and the total flash size. 377 378### Fixed 379- Fixed handling of short unaligned write requests (1 or 2 bytes in length) in the nrfx_nvmc_bytes_write() function. 380 381## [1.7.0] - 2019-03-29 382### Added 383- Added drivers for NVMC and TEMP. 384- Added HALs: AAR and FICR. 385- Added support for the custom instruction long frame mode in the QSPI driver. 386 387### Changed 388- Reworked HAL for NVMC. Now it can be used for all SoCs supported by nrfx. 389- Reworked HAL for TEMP. 390- Improved documentation. Now it is more precise and can be generated without warnings with newer versions of doxygen. 391- Improved the UARTE driver to consume less current after the TX operation. Now at the end of the transmission the transmitter is turned off by the STOPTX task. 392- Improved C++ support in drivers. Now fields in structures are filled up in the correct order. 393- Changed to size_t the type used for holding the amount of data in the TWIS driver. 394 395### Fixed 396- Fixed a race condition in the USBD driver. It could occur when an IN transfer was interrupted by an OUT transaction, which in turn was interrupted by a process with a higher priority. 397 398## [1.6.2] - 2019-02-12 399### Added 400- Added the possibility to use the macro NRFX_COREDEP_DELAY_US_LOOP_CYCLES to specify the number of cycles consumed by one iteration of the internal loop in the function nrfx_coredep_delay_us(). 401 402### Changed 403- Updated MDK to version 8.24.1. 404 405## [1.6.1] - 2019-01-29 406### Fixed 407- Fixed an issue in the NFCT driver that caused a performance loss on nRF52832. The interrupt configuration is now properly restored after the NRFX_NFCT_EVT_FIELD_LOST event. 408 409## [1.6.0] - 2019-01-18 410### Added 411- Added support for nRF52811. 412- Added support for the legacy peripherals SPI, TWI, and UART in nRF52810. 413- Added support for SAMPLERATE in nrf_saadc.h. 414- Added clearing of the STOPPED event in the nrfx_saadc_init() function to prevent driver deadlock in some cases. 415- Added HALs: BPROT, MPU, MWU. 416- Added function for reading the pin input buffer configuration in the GPIO HAL. 417- Implemented workaround for nRF9160 anomaly 1 in the I2S driver. 418 419### Changed 420- Improved handling of hardware anomalies in the USBD driver. 421- Updated MDK to version 8.23.1. 422 423### Fixed 424- Fixed the condition in NRFX_WAIT_FOR in the nrfx_saadc_abort() function. The macro now correctly waits for a stop of the driver. 425- Fixed the pending interrupt clearing in NVIC in the nrfx_usbd_stop() function. The driver now correctly handles power management. 426- Fixed the case when nrfx_uarte_tx_in_progress() function would return an incorrect value. The driver now correctly updates the tx_buffer_length variable internally. 427 428## [1.5.0] - 2018-12-12 429### Added 430- Added support for nRF9160. 431- Added allocator for DPPI. 432- Added HALs: DPPI, KMU, REGULATORS, SPU, VMC. 433- Added support for DPPI subscription and publishing in HALs related to nRF9160. 434- Added support for instances 2 and 3 in SPIS, TWIM, TWIS, and UARTE drivers. 435 436### Changed 437- Updated MDK to version 8.21.1. 438 439### Fixed 440- Corrected NRFX_I2S_CONFIG_RATIO value in nrfx_config.h. It now correctly uses supported value. 441 442## [1.4.0] - 2018-11-30 443### Added 444- Added the nrfx_is_word_aligned() function for checking whether an address is word-aligned. 445- Added HAL for ACL. 446- Added functions for disabling and re-enabling interrupts in the SWI driver. 447- Added possibility to completely remove interrupt handling from the WDT driver. 448 449### Changed 450- Updated the documentation for the nrfx_uarte_rx() function. It now correctly reflects the actual behavior of the function. 451 452### Fixed 453- Corrected the type of the nrfx_uarte_xfer_evt_t structure field that holds the amount of transferred bytes. 454- Corrected the way of disabling interrupts in the NFCT driver when moving the peripheral to the disabled state. 455- Fixed a typo in the name of the bmRequest field in the nrfx_usbd_setup_t structure. The new correct name is bRequest. 456- Fixed the nrfx_ppi_channel_fork_assign() function. It now accepts also pre-programmed channels. 457- Fixed handling of long custom instruction responses in the QSPI driver. 458- Fixed a bug affecting the conversion of time to ticks in the TIMER HAL. 459 460## [1.3.1] - 2018-09-28 461### Fixed 462- Corrected the type of nrfx_usbd_ep_status_get() return value. 463- Corrected calls to undefined macros in NFCT and USBD drivers. 464 465## [1.3.0] - 2018-09-21 466### Added 467- Added HAL and driver for NFCT. 468- Added driver for USBD. 469- Added function for setting the burst mode in the SAADC HAL. 470- Added the NRFX_ARRAY_SIZE macro. 471 472### Changed 473- Moved the implementation of nrfx_power_clock_irq_handler() to nrfx_power.c, removed nrfx_power_clock.c. 474 475### Fixed 476- Replaced ARRAY_SIZE macro calls with NRFX_ARRAY_SIZE ones. 477 478## [1.2.0] - 2018-09-06 479### Added 480- Added function for checking if a specific channel is enabled in the GPIOTE HAL. 481- Added support for using the QDEC driver without LED. 482- Added functions for modifying only the event endpoint or only the task endpoint in the PPI HAL. 483- Added function for reading the pin pull configuration in the GPIO HAL. 484 485### Changed 486- Corrected ISOSPLIT enumerator names in the USBD HAL. 487 488### Fixed 489- Fixed a double buffering bug that occurred in the UARTE driver after the RX abort. 490- Fixed the TXRX transfers in the TWIM driver. They can now be started after transfers that are not ended with the stop condition. 491 492## [1.1.0] - 2018-06-15 493### Added 494- Implemented workaround for nRF52832 and nRF52840 anomaly 194 in the I2S driver. 495- Implemented workaround for nRF52840 anomaly 195 in the SPIM driver. 496- Added HALs for CCM, ECB, and RADIO. 497- Extended HALs for GPIO, PPI, SAADC, and USBD. 498- Added support for external LFCLK sources. 499 500### Changed 501- Corrected handling of transfer lengths in the TWI driver. 502- Updated MDK to version 8.17.0. 503 504### Fixed 505- Fixed logging in the PPI driver. 506- Fixed SPIM interrupt definition for nRF52810. 507- Fixed Slave Select configuration in the SPIM driver. 508- Corrected default settings for NRF_SPIM3. 509- Fixed a typo in the UARTE TXDRDY event definition. 510- Corrected the TIMEOUT event clearing in the WDT interrupt handler. 511 512## [1.0.0] - 2018-03-21 513### Added 514- Added the NRFX_WAIT_FOR macro to improve the time-out functionality in QSPI and SAADC drivers. 515- Added glue layer macros for checking and modifying the pending status of interrupts. 516- Added new enumeration values for interrupts and events in the UARTE HAL. 517- Implemented workarounds for nRF52 anomalies 192 and 201 in the CLOCK driver. 518- Implemented workaround for nRF52840 anomaly 122 in the QSPI driver. 519- Implemented workaround for nRF52840 anomaly 198 in the SPIM driver. 520 521### Changed 522- Updated MDK to 8.16.0. 523- Extended input pin configuration in the GPIOTE driver. 524- Unified the way of checking if a required event handler was provided. Now, all drivers do it with assertions. 525- Changed the RNG bias correction configuration option to be enabled by default. 526- Refactored the ADC driver and HAL. 527- Corrected assertions in the TIMER driver to make it usable in debug version with PPI. 528- Improved buffer handling in the I2S driver. The API of the driver has been slightly modified. 529- Enhanced SPIS driver API: added the "p_context" parameter, allowed NULL pointers for zero-length buffers. 530 531### Fixed 532- Fixed result value casting in the TEMP HAL. 533- Fixed types of conversion result and buffer size in the ADC HAL and driver. 534- Fixed time-out in the SAADC driver in abort function. 535 536## [0.8.0] - 2017-12-20 537### Added 538- Added XIP support in the QSPI driver. 539- Implemented Errata 132 in the CLOCK driver. 540- Added function for checking if a TIMER instance is enabled. 541- Added extended SPIM support. 542 543### Changed 544- Updated MDK to 8.15.0. Introduced Segger Embedded Studio startup files. 545- Updated drivers: COMP, PWM, QDEC, SAADC, SPIS, TIMER, TWI, TWIS. 546- Changed the type used for transfer lengths to 'size_t' in drivers: SPI, SPIM, SPIS, TWI, TWIM, TWIS, UART, UARTE. Introduced checking of EasyDMA transfers limits. 547- Updated HALs: COMP, NVMC, UART, UARTE, USBD. 548- Updated template files and documentation of configuration options. 549 550### Fixed 551- Fixed TWI and TWIM drivers so that they now support GPIOs from all ports. 552- Fixed definitions related to compare channels in the TIMER HAL. 553 554### Removed 555- Removed the possibility of passing NULL instead of configuration to get default settings during drivers initialization. 556- Removed support for UART1 and PRS box #5. 557 558## [0.7.0] - 2017-10-20 559### Added 560- This CHANGELOG.md file. 561- README.md file with simple description and explanations. 562- HAL for: ADC, CLOCK, COMP, ECB, EGU, GPIO, GPIOTE, I2S, LPCOMP, NVMC, PDM, POWER, PPI, PWM, QDEC, QSPI, RNG, RTC, SAADC, SPI, SPIM, SPIS, ARM(R) SysTick, TEMP, TIMER, TWI, TWIM, TWIS, UART, UARTE, USBD, WDT. 563- Drivers for: ADC, CLOCK, COMP, GPIOTE, I2S, LPCOMP, PDM, POWER, PWM, QDEC, QSPI, RNG, RTC, SAADC, SPI, SPIM, SPIS, ARM(R) SysTick, TIMER, TWI, TWIM, TWIS, UART, UARTE, WDT. 564- Allocators for: PPI, SWI/EGU. 565- MDK in version 8.14.0. 566- Offline documentation for every added driver and simple integration description. 567- Template integration files. 568
