[nordic] update nrfx to 1.6.0 (#3515)

third_party/NordicSemiconductor/drivers/usbd/nrf_drv_usbd.c

@@ -1384,7 +1384,7 @@ static inline size_t usbd_ep_iso_capacity(nrf_drv_usbd_ep_t ep)
 {
     UNUSED_PARAMETER(ep);
     nrf_usbd_isosplit_t split = nrf_usbd_isosplit_get();
-    if (NRF_USBD_ISOSPLIT_Half == split)
+    if (NRF_USBD_ISOSPLIT_HALF == split)
     {
         return NRF_DRV_USBD_ISOSIZE / 2;
     }
@@ -1846,7 +1846,7 @@ void nrf_drv_usbd_enable(void)
         __DSB();
     }
 
-    nrf_usbd_isosplit_set(NRF_USBD_ISOSPLIT_Half);
+    nrf_usbd_isosplit_set(NRF_USBD_ISOSPLIT_HALF);
 
     if (USBD_CONFIG_ISO_IN_ZLP)
     {

third_party/NordicSemiconductor/nrfx/.gitignore

@@ -0,0 +1,2 @@
+doc/html/*
+doc/warnings_nrfx.txt

third_party/NordicSemiconductor/nrfx/CHANGELOG.md

@@ -1,79 +1,162 @@
-# Changelog
-All notable changes to this project are documented in this file.
-
-## [1.1.0] - 2018-06-15
-### Added
-- Implemented workaround for nRF52832 and nRF52840 anomaly 194 in the I2S driver.
-- Implemented workaround for nRF52840 anomaly 195 in the SPIM driver.
-- Added HALs for CCM, ECB, and RADIO.
-- Extended HALs for GPIO, PPI, SAADC, and USBD.
-- Added support for external LFCLK sources.
-
-### Changed
-- Corrected handling of transfer lengths in the TWI driver.
-- Updated MDK to version 8.17.0.
-
-### Fixed
-- Fixed logging in the PPI driver.
-- Fixed SPIM interrupt definition for nRF52810.
-- Fixed Slave Select configuration in the SPIM driver.
-- Corrected default settings for NRF_SPIM3.
-- Fixed a typo in the UARTE TXDRDY event definition.
-- Corrected the TIMEOUT event clearing in the WDT interrupt handler.
-
-## [1.0.0] - 2018-03-21
-### Added
-- Added the NRFX_WAIT_FOR macro to improve the time-out functionality in QSPI and SAADC drivers.
-- Added glue layer macros for checking and modifying the pending status of interrupts.
-- Added new enumeration values for interrupts and events in the UARTE HAL.
-- Implemented workarounds for nRF52 anomalies 192 and 201 in the CLOCK driver.
-- Implemented workaround for nRF52840 anomaly 122 in the QSPI driver.
-- Implemented workaround for nRF52840 anomaly 198 in the SPIM driver.
-
-### Changed
-- Updated MDK to 8.16.0.
-- Extended input pin configuration in the GPIOTE driver.
-- Unified the way of checking if a required event handler was provided. Now, all drivers do it with assertions.
-- Changed the RNG bias correction configuration option to be enabled by default.
-- Refactored the ADC driver and HAL.
-- Corrected assertions in the TIMER driver to make it usable in debug version with PPI.
-- Improved buffer handling in the I2S driver. The API of the driver has been sligthly modified.
-- Enhanced SPIS driver API: added the "p_context" parameter, allowed NULL pointers for zero-length buffers.
-
-### Fixed
-- Fixed result value casting in the TEMP HAL.
-- Fixed types of conversion result and buffer size in the ADC HAL and driver.
-- Fixed time-out in the SAADC driver in abort function.
-
-## [0.8.0] - 2017-12-20
-### Added
-- Added XIP support in the QSPI driver.
-- Implemented Errata 132 in the CLOCK driver.
-- Added function for checking if a TIMER instance is enabled.
-- Added extended SPIM support.
-
-### Changed
-- Updated MDK to 8.15.0. Introduced Segger Embedded Studio startup files.
-- Updated drivers: COMP, PWM, QDEC, SAADC, SPIS, TIMER, TWI, TWIS.
-- 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.
-- Updated HALs: COMP, NVMC, UART, UARTE, USBD.
-- Updated template files and documentation of configuration options.
-
-### Fixed
-- Fixed TWI and TWIM drivers so that they now support GPIOs from all ports.
-- Fixed definitions related to compare channels in the TIMER HAL.
-
-### Removed
-- Removed the possibility of passing NULL instead of configuration to get default settings during drivers initialization.
-- Removed support for UART1 and PRS box #5.
-
-## [0.7.0] - 2017-10-20
-### Added
-- This CHANGELOG.md file.
-- README.md file with simple description and explanations.
-- 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.
-- 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.
-- Allocators for: PPI, SWI/EGU.
-- MDK in version 8.14.0.
-- Offline documentation for every added driver and simple integration description.
-- Template integration files.
+# Changelog
+All notable changes to this project are documented in this file.
+
+## [1.6.0] - 2019-01-18
+### Added
+- Added support for nRF52811.
+- Added support for the legacy peripherals SPI, TWI, and UART in nRF52810.
+- Added support for SAMPLERATE in nrf_saadc.h.
+- Added clearing of the STOPPED event in the nrfx_saadc_init() function to prevent driver deadlock in some cases.
+- Added HALs: BPROT, MPU, MWU.
+- Added function for reading the pin input buffer configuration in the GPIO HAL.
+- Implemented workaround for nRF9160 anomaly 1 in the I2S driver.
+
+### Changed
+- Improved handling of hardware anomalies in the USBD driver.
+- Updated MDK to version 8.23.1.
+
+### Fixed
+- Fixed the condition in NRFX_WAIT_FOR in the nrfx_saadc_abort() function. The macro now correctly waits for a stop of the driver.
+- Fixed the pending interrupt clearing in NVIC in the nrfx_usbd_stop() function. The driver now correctly handles power management.
+- 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.
+
+## [1.5.0] - 2018-12-12
+### Added
+- Added support for nRF9160.
+- Added allocator for DPPI.
+- Added HALs: DPPI, KMU, REGULATORS, SPU, VMC.
+- Added support for DPPI subscription and publishing in HALs related to nRF9160.
+- Added support for instances 2 and 3 in SPIS, TWIM, TWIS, and UARTE drivers.
+
+### Changed
+- Updated MDK to version 8.21.1.
+
+### Fixed
+- Corrected NRFX_I2S_CONFIG_RATIO value in nrfx_config.h. It now correctly uses supported value.
+
+## [1.4.0] - 2018-11-30
+### Added
+- Added the nrfx_is_word_aligned() function for checking whether an address is word-aligned.
+- Added HAL for ACL.
+- Added functions for disabling and re-enabling interrupts in the SWI driver.
+- Added possibility to completely remove interrupt handling from the WDT driver.
+
+### Changed
+- Updated the documentation for the nrfx_uarte_rx() function. It now correctly reflects the actual behavior of the function.
+
+### Fixed
+- Corrected the type of the nrfx_uarte_xfer_evt_t structure field that holds the amount of transferred bytes.
+- Corrected the way of disabling interrupts in the NFCT driver when moving the peripheral to the disabled state.
+- Fixed a typo in the name of the bmRequest field in the nrfx_usbd_setup_t structure. The new correct name is bRequest.
+- Fixed the nrfx_ppi_channel_fork_assign() function. It now accepts also pre-programmed channels.
+- Fixed handling of long custom instruction responses in the QSPI driver.
+- Fixed a bug affecting the conversion of time to ticks in the TIMER HAL.
+
+## [1.3.1] - 2018-09-28
+### Fixed
+- Corrected the type of nrfx_usbd_ep_status_get() return value.
+- Corrected calls to undefined macros in NFCT and USBD drivers.
+
+## [1.3.0] - 2018-09-21
+### Added
+- Added HAL and driver for NFCT.
+- Added driver for USBD.
+- Added function for setting the burst mode in the SAADC HAL.
+- Added the NRFX_ARRAY_SIZE macro.
+
+### Changed
+- Moved the implementation of nrfx_power_clock_irq_handler() to nrfx_power.c, removed nrfx_power_clock.c.
+
+### Fixed
+- Replaced ARRAY_SIZE macro calls with NRFX_ARRAY_SIZE ones.
+
+## [1.2.0] - 2018-09-06
+### Added
+- Added function for checking if a specific channel is enabled in the GPIOTE HAL.
+- Added support for using the QDEC driver without LED.
+- Added functions for modifying only the event endpoint or only the task endpoint in the PPI HAL.
+- Added function for reading the pin pull configuration in the GPIO HAL.
+
+### Changed
+- Corrected ISOSPLIT enumerator names in the USBD HAL.
+
+### Fixed
+- Fixed a double buffering bug that occurred in the UARTE driver after the RX abort.
+- Fixed the TXRX transfers in the TWIM driver. They can now be started after transfers that are not ended with the stop condition.
+
+## [1.1.0] - 2018-06-15
+### Added
+- Implemented workaround for nRF52832 and nRF52840 anomaly 194 in the I2S driver.
+- Implemented workaround for nRF52840 anomaly 195 in the SPIM driver.
+- Added HALs for CCM, ECB, and RADIO.
+- Extended HALs for GPIO, PPI, SAADC, and USBD.
+- Added support for external LFCLK sources.
+
+### Changed
+- Corrected handling of transfer lengths in the TWI driver.
+- Updated MDK to version 8.17.0.
+
+### Fixed
+- Fixed logging in the PPI driver.
+- Fixed SPIM interrupt definition for nRF52810.
+- Fixed Slave Select configuration in the SPIM driver.
+- Corrected default settings for NRF_SPIM3.
+- Fixed a typo in the UARTE TXDRDY event definition.
+- Corrected the TIMEOUT event clearing in the WDT interrupt handler.
+
+## [1.0.0] - 2018-03-21
+### Added
+- Added the NRFX_WAIT_FOR macro to improve the time-out functionality in QSPI and SAADC drivers.
+- Added glue layer macros for checking and modifying the pending status of interrupts.
+- Added new enumeration values for interrupts and events in the UARTE HAL.
+- Implemented workarounds for nRF52 anomalies 192 and 201 in the CLOCK driver.
+- Implemented workaround for nRF52840 anomaly 122 in the QSPI driver.
+- Implemented workaround for nRF52840 anomaly 198 in the SPIM driver.
+
+### Changed
+- Updated MDK to 8.16.0.
+- Extended input pin configuration in the GPIOTE driver.
+- Unified the way of checking if a required event handler was provided. Now, all drivers do it with assertions.
+- Changed the RNG bias correction configuration option to be enabled by default.
+- Refactored the ADC driver and HAL.
+- Corrected assertions in the TIMER driver to make it usable in debug version with PPI.
+- Improved buffer handling in the I2S driver. The API of the driver has been slightly modified.
+- Enhanced SPIS driver API: added the "p_context" parameter, allowed NULL pointers for zero-length buffers.
+
+### Fixed
+- Fixed result value casting in the TEMP HAL.
+- Fixed types of conversion result and buffer size in the ADC HAL and driver.
+- Fixed time-out in the SAADC driver in abort function.
+
+## [0.8.0] - 2017-12-20
+### Added
+- Added XIP support in the QSPI driver.
+- Implemented Errata 132 in the CLOCK driver.
+- Added function for checking if a TIMER instance is enabled.
+- Added extended SPIM support.
+
+### Changed
+- Updated MDK to 8.15.0. Introduced Segger Embedded Studio startup files.
+- Updated drivers: COMP, PWM, QDEC, SAADC, SPIS, TIMER, TWI, TWIS.
+- 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.
+- Updated HALs: COMP, NVMC, UART, UARTE, USBD.
+- Updated template files and documentation of configuration options.
+
+### Fixed
+- Fixed TWI and TWIM drivers so that they now support GPIOs from all ports.
+- Fixed definitions related to compare channels in the TIMER HAL.
+
+### Removed
+- Removed the possibility of passing NULL instead of configuration to get default settings during drivers initialization.
+- Removed support for UART1 and PRS box #5.
+
+## [0.7.0] - 2017-10-20
+### Added
+- This CHANGELOG.md file.
+- README.md file with simple description and explanations.
+- 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.
+- 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.
+- Allocators for: PPI, SWI/EGU.
+- MDK in version 8.14.0.
+- Offline documentation for every added driver and simple integration description.
+- Template integration files.

third_party/NordicSemiconductor/nrfx/LICENSE

@@ -1,39 +1,29 @@
-/**
- * Copyright (c) 2017 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
+Copyright (c) 2017 - 2019, Nordic Semiconductor ASA
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from this
+   software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+

third_party/NordicSemiconductor/nrfx/README.md

@@ -1,37 +1,42 @@
-# nrfx
-
-## Overview
-
-nrfx is an extract from the nRF5 SDK that contains solely the drivers for
-peripherals present in Nordic SoCs, for convenience complemented with the MDK
-package containing required structures and bitfields definitions, startup
-files etc.
-
-## Supported SoCs
-
-* nRF51 Series
-* nRF52810
-* nRF52832
-* nRF52840
-
-## Directories
-
-```
- .
- ├── doc             # Project documentation files
- ├── drivers         # nrfx drivers files
- │   └── include     # nrfx drivers headers
- │   └── src         # nrfx drivers sources
- ├── hal             # Hardware Access Layer files
- ├── mdk             # Nordic MDK files
- ├── soc             # Nordic SoC related files
- └── templates       # Templates of nrfx integration files
-```
-
-## Generating documentation
-
-nrfx documentation is availabe in the `doc\html` folder of the release package.
-
-You can also generate documentation yourself from the source code. To do it, install doxygen
-and run one of the scripts: `generate_html_doc.bat` or `generate_html_doc.sh`. Generated
-documentation will be stored in the `doc\html` directory. Use `index.html` to open it.
+# nrfx
+
+## Overview
+
+nrfx is a standalone set of drivers for peripherals present in Nordic
+Semiconductor's SoCs. It originated as an extract from the nRF5 SDK.
+The intention was to provide drivers that can be used in various environments
+without the necessity to integrate other parts of the SDK into them.
+For the user's convenience, the drivers come with the MDK package. This package
+contains definitions of register structures and bitfields for all supported
+SoCs, as well as startup and initialization files for them.
+
+## Supported SoCs
+
+* nRF51 Series
+* nRF52810
+* nRF52811
+* nRF52832
+* nRF52840
+* nRF9160
+
+## Directories
+
+```
+ .
+ ├── doc             # Project documentation files
+ ├── drivers         # nrfx drivers files
+ │   └── include     # nrfx drivers headers
+ │   └── src         # nrfx drivers sources
+ ├── hal             # Hardware Access Layer files
+ ├── mdk             # Nordic MDK files
+ ├── soc             # Nordic SoC related files
+ └── templates       # Templates of nrfx integration files
+```
+
+## Generating documentation
+
+nrfx documentation is available in the `doc\html` folder of the release package.
+
+You can also generate documentation yourself from the source code. To do it, install doxygen
+and run one of the scripts: `generate_html_doc.bat` or `generate_html_doc.sh`. Generated
+documentation will be stored in the `doc\html` directory. Use `index.html` to open it.

third_party/NordicSemiconductor/nrfx/doc/buildfiles/footer.html

@@ -1,13 +1,10 @@
-<div id="nav-path" class="topicfooter">
-<a href="mailto:docfeedback@nordicsemi.no?subject=Documentation%20feedback" id="maillink">Documentation feedback</a> | <a href="https://devzone.nordicsemi.com/questions/" target="_blank">Developer Zone</a> | <a href="http://response.nordicsemi.com/subscribe-to-our-newsletters" target="_blank">Subscribe</a> | Updated <span id="date"/>
-
-<script>
-var date = new Date("$date" + " UTC");
-document.getElementById("date").innerHTML = date.toJSON().slice(0, 10);
-var url=window.location.href.split("?")[0];
-var filename=url.substring(url.lastIndexOf('/')+1);
-document.getElementById("maillink").href = "mailto:[email protected]?subject=Documentation%20feedback"+decodeURIComponent("%26")+"body=File%20name%3A%20"+encodeURIComponent(filename);
-</script>
-</div>
-</body>
-</html>
+<div id="nav-path" class="topicfooter">
+<a href="https://github.com/NordicSemiconductor/nrfx/issues" target="_blank">nrfx feedback</a> | <a href="https://devzone.nordicsemi.com/" target="_blank">Nordic DevZone</a> | <a href="http://response.nordicsemi.com/subscribe-to-our-newsletters" target="_blank">Subscribe</a> | Updated <span id="date"/>
+
+<script>
+var date = new Date("$date" + " UTC");
+document.getElementById("date").innerHTML = date.toJSON().slice(0, 10);
+</script>
+</div>
+</body>
+</html>

third_party/NordicSemiconductor/nrfx/doc/buildfiles/header.html

@@ -1,68 +1,58 @@
-<!-- HTML header for doxygen 1.8.3.1-->
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
-<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
-<meta http-equiv="X-UA-Compatible" content="IE=9"/>
-<meta name="generator" content="Doxygen $doxygenversion"/>
-<!--BEGIN PROJECT_NAME--><title>$projectname $projectnumber: $title</title><!--END PROJECT_NAME-->
-<!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
-<link href="$relpath^tabs.css" rel="stylesheet" type="text/css"/>
-<script type="text/javascript" src="$relpath^jquery.js"></script>
-<script type="text/javascript" src="$relpath^dynsections.js"></script>
-$treeview
-$search
-$mathjax
-<link href="$relpath^$stylesheet" rel="stylesheet" type="text/css" />
-$extrastylesheet
-<link href="$relpath^nordic.css" rel="stylesheet" type="text/css" />
-<link rel="Shortcut icon" href="./favicon.ico" type="image/x-icon" />
-</head>
-<body>
-
-<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
-
-<!--BEGIN TITLEAREA-->
-<div id="titlearea">
-<table cellspacing="0" cellpadding="0" width="100%" class="blank">
- <tbody>
- <tr style="height: 56px;">
-  <!--BEGIN PROJECT_LOGO-->
-  <td id="projectlogo"><img alt="Nordic Semiconductor" src="$relpath^$projectlogo"/></td>
-  <!--END PROJECT_LOGO-->
-  <!--BEGIN PROJECT_NAME-->
-  <td style="padding-left: 0.5em;">
-   <div id="projectname">$projectname
-   <!--BEGIN PROJECT_NUMBER-->&#160;<span id="projectnumber">$projectnumber</span><!--END PROJECT_NUMBER-->
-   </div>
-   <!--BEGIN PROJECT_BRIEF--><div id="projectbrief">$projectbrief</div><!--END PROJECT_BRIEF-->
-  </td>
-  <!--END PROJECT_NAME-->
-  <!--BEGIN !PROJECT_NAME-->
-   <!--BEGIN PROJECT_BRIEF-->
-    <td style="padding-left: 0.5em;">
-    <div id="projectbrief">$projectbrief</div>
-    </td>
-   <!--END PROJECT_BRIEF-->
-  <!--END !PROJECT_NAME-->
-  <!--BEGIN DISABLE_INDEX-->
-   <!--BEGIN SEARCHENGINE-->
-   <td>$searchbox</td>
-   <!--END SEARCHENGINE-->
-  <!--END DISABLE_INDEX-->
- </tr>
- </tbody>
-</table>
-<script>
-var url=window.location.href.split("/").reverse()[1];
-var validLinks= ["nrf5","s132","s140","s212","s332"];
-var index;
-for (index = 0; index < validLinks.length; ++index) {
-   if ( url.indexOf(validLinks[index]) !== -1 ) {
-      document.getElementById(validLinks[index]).setAttribute('class', 'doclinks docselected');
-   };
-};
-</script>
-</div>
-<!--END TITLEAREA-->
-<!-- end header part -->
+<!-- HTML header for doxygen 1.8.3.1-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<meta http-equiv="X-UA-Compatible" content="IE=9"/>
+<meta name="generator" content="Doxygen $doxygenversion"/>
+<!--BEGIN PROJECT_NAME--><title>$projectname $projectnumber: $title</title><!--END PROJECT_NAME-->
+<!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
+<link href="$relpath^tabs.css" rel="stylesheet" type="text/css"/>
+<script type="text/javascript" src="$relpath^jquery.js"></script>
+<script type="text/javascript" src="$relpath^dynsections.js"></script>
+$treeview
+$search
+$mathjax
+<link href="$relpath^$stylesheet" rel="stylesheet" type="text/css" />
+$extrastylesheet
+<link href="$relpath^nordic.css" rel="stylesheet" type="text/css" />
+<link rel="Shortcut icon" href="./favicon.ico" type="image/x-icon" />
+</head>
+<body>
+
+<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
+
+<!--BEGIN TITLEAREA-->
+<div id="titlearea">
+<table cellspacing="0" cellpadding="0" width="100%" class="blank">
+ <tbody>
+ <tr style="height: 56px;">
+  <!--BEGIN PROJECT_LOGO-->
+  <td id="projectlogo"><img alt="Nordic Semiconductor" src="$relpath^$projectlogo"/></td>
+  <!--END PROJECT_LOGO-->
+  <!--BEGIN PROJECT_NAME-->
+  <td style="padding-left: 0.5em;">
+   <div id="projectname">$projectname
+   <!--BEGIN PROJECT_NUMBER-->&#160;<span id="projectnumber">$projectnumber</span><!--END PROJECT_NUMBER-->
+   </div>
+   <!--BEGIN PROJECT_BRIEF--><div id="projectbrief">$projectbrief</div><!--END PROJECT_BRIEF-->
+  </td>
+  <!--END PROJECT_NAME-->
+  <!--BEGIN !PROJECT_NAME-->
+   <!--BEGIN PROJECT_BRIEF-->
+    <td style="padding-left: 0.5em;">
+    <div id="projectbrief">$projectbrief</div>
+    </td>
+   <!--END PROJECT_BRIEF-->
+  <!--END !PROJECT_NAME-->
+  <!--BEGIN DISABLE_INDEX-->
+   <!--BEGIN SEARCHENGINE-->
+   <td>$searchbox</td>
+   <!--END SEARCHENGINE-->
+  <!--END DISABLE_INDEX-->
+ </tr>
+ </tbody>
+</table>
+</div>
+<!--END TITLEAREA-->
+<!-- end header part -->

third_party/NordicSemiconductor/nrfx/doc/buildfiles/index.html

@@ -1,9 +0,0 @@
-<html>
-   <head>
-      
-      <script type="text/javascript">
-              window.location="nrf5/index.html";
-      </script>
-      
-   </head>
-</html>

third_party/NordicSemiconductor/nrfx/doc/buildfiles/layout.xml

@@ -1,187 +1,187 @@
-<doxygenlayout version="1.0">
-  <!-- Navigation index tabs for HTML output -->
-  <navindex>
-    <tab type="mainpage" visible="yes" title="Home"/>
-    <tab type="pages" visible="yes" title="" intro=""/>
-    <tab type="modules" visible="yes" title="API Reference" intro=""/>
-    <tab type="namespaces" visible="no" title="">
-      <tab type="namespacelist" visible="yes" title="" intro=""/>
-      <tab type="namespacemembers" visible="yes" title="" intro=""/>
-    </tab>
-    <tab type="usergroup" visible="yes" title="Data Structures">
-      <tab type="classlist" visible="yes" title="" intro=""/>
-      <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/>
-      <tab type="hierarchy" visible="no" title="" intro=""/>
-      <tab type="classmembers" visible="yes" title="" intro=""/>
-    </tab>
-    <tab type="files" visible="no" title="">
-      <tab type="filelist" visible="yes" title="" intro=""/>
-      <tab type="globals" visible="yes" title="" intro=""/>
-    </tab>
-    <tab type="examples" visible="yes" title="Source" intro=""/>
-  </navindex>
-
-  <!-- Layout definition for a class page -->
-  <class>
-    <briefdescription visible="yes"/>
-    <includes visible="$SHOW_INCLUDE_FILES"/>
-    <inheritancegraph visible="$CLASS_GRAPH"/>
-    <collaborationgraph visible="$COLLABORATION_GRAPH"/>
-    <memberdecl>
-      <nestedclasses visible="yes" title=""/>
-      <publictypes title=""/>
-      <publicslots title=""/>
-      <signals title=""/>
-      <publicmethods title=""/>
-      <publicstaticmethods title=""/>
-      <publicattributes title=""/>
-      <publicstaticattributes title=""/>
-      <protectedtypes title=""/>
-      <protectedslots title=""/>
-      <protectedmethods title=""/>
-      <protectedstaticmethods title=""/>
-      <protectedattributes title=""/>
-      <protectedstaticattributes title=""/>
-      <packagetypes title=""/>
-      <packagemethods title=""/>
-      <packagestaticmethods title=""/>
-      <packageattributes title=""/>
-      <packagestaticattributes title=""/>
-      <properties title=""/>
-      <events title=""/>
-      <privatetypes title=""/>
-      <privateslots title=""/>
-      <privatemethods title=""/>
-      <privatestaticmethods title=""/>
-      <privateattributes title=""/>
-      <privatestaticattributes title=""/>
-      <friends title=""/>
-      <related title="" subtitle=""/>
-      <membergroups visible="yes"/>
-    </memberdecl>
-    <detaileddescription title=""/>
-    <memberdef>
-      <inlineclasses title=""/>
-      <typedefs title=""/>
-      <enums title=""/>
-      <constructors title=""/>
-      <functions title=""/>
-      <related title=""/>
-      <variables title=""/>
-      <properties title=""/>
-      <events title=""/>
-    </memberdef>
-    <allmemberslink visible="yes"/>
-    <usedfiles visible="$SHOW_USED_FILES"/>
-    <authorsection visible="yes"/>
-  </class>
-
-  <!-- Layout definition for a namespace page -->
-  <namespace>
-    <briefdescription visible="yes"/>
-    <memberdecl>
-      <nestednamespaces visible="yes" title=""/>
-      <classes visible="yes" title=""/>
-      <typedefs title=""/>
-      <enums title=""/>
-      <functions title=""/>
-      <variables title=""/>
-      <membergroups visible="yes"/>
-    </memberdecl>
-    <detaileddescription title=""/>
-    <memberdef>
-      <inlineclasses title=""/>
-      <typedefs title=""/>
-      <enums title=""/>
-      <functions title=""/>
-      <variables title=""/>
-    </memberdef>
-    <authorsection visible="yes"/>
-  </namespace>
-
-  <!-- Layout definition for a file page -->
-  <file>
-    <briefdescription visible="yes"/>
-    <includes visible="$SHOW_INCLUDE_FILES"/>
-    <includegraph visible="$INCLUDE_GRAPH"/>
-    <includedbygraph visible="$INCLUDED_BY_GRAPH"/>
-    <sourcelink visible="yes"/>
-    <memberdecl>
-      <classes visible="yes" title=""/>
-      <namespaces visible="yes" title=""/>
-      <defines title=""/>
-      <typedefs title=""/>
-      <enums title=""/>
-      <functions title=""/>
-      <variables title=""/>
-      <membergroups visible="yes"/>
-    </memberdecl>
-    <detaileddescription title=""/>
-    <memberdef>
-      <inlineclasses title=""/>
-      <defines title=""/>
-      <typedefs title=""/>
-      <enums title=""/>
-      <functions title=""/>
-      <variables title=""/>
-    </memberdef>
-    <authorsection/>
-  </file>
-
-  <!-- Layout definition for a group page -->
-  <group>
-    <briefdescription visible="yes"/>
-    <groupgraph visible="$GROUP_GRAPHS"/>
-    <memberdecl>
-      <nestedgroups visible="yes" title=""/>
-      <dirs visible="yes" title=""/>
-      <files visible="yes" title=""/>
-      <namespaces visible="yes" title=""/>
-      <classes visible="yes" title=""/>
-      <defines title=""/>
-      <typedefs title=""/>
-      <enums title=""/>
-      <enumvalues title=""/>
-      <functions title=""/>
-      <variables title=""/>
-      <signals title=""/>
-      <publicslots title=""/>
-      <protectedslots title=""/>
-      <privateslots title=""/>
-      <events title=""/>
-      <properties title=""/>
-      <friends title=""/>
-      <membergroups visible="yes"/>
-    </memberdecl>
-    <detaileddescription title=""/>
-    <memberdef>
-      <pagedocs/>
-      <inlineclasses title=""/>
-      <defines title=""/>
-      <typedefs title=""/>
-      <enums title=""/>
-      <enumvalues title=""/>
-      <functions title=""/>
-      <variables title=""/>
-      <signals title=""/>
-      <publicslots title=""/>
-      <protectedslots title=""/>
-      <privateslots title=""/>
-      <events title=""/>
-      <properties title=""/>
-      <friends title=""/>
-    </memberdef>
-    <authorsection visible="yes"/>
-  </group>
-
-  <!-- Layout definition for a directory page -->
-  <directory>
-    <briefdescription visible="yes"/>
-    <directorygraph visible="yes"/>
-    <memberdecl>
-      <dirs visible="yes"/>
-      <files visible="yes"/>
-    </memberdecl>
-    <detaileddescription title=""/>
-  </directory>
-</doxygenlayout>
+<doxygenlayout version="1.0">
+  <!-- Navigation index tabs for HTML output -->
+  <navindex>
+    <tab type="mainpage" visible="yes" title="Home"/>
+    <tab type="pages" visible="yes" title="" intro=""/>
+    <tab type="modules" visible="yes" title="API Reference" intro=""/>
+    <tab type="namespaces" visible="no" title="">
+      <tab type="namespacelist" visible="yes" title="" intro=""/>
+      <tab type="namespacemembers" visible="yes" title="" intro=""/>
+    </tab>
+    <tab type="usergroup" visible="yes" title="Data Structures">
+      <tab type="classlist" visible="yes" title="" intro=""/>
+      <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/>
+      <tab type="hierarchy" visible="no" title="" intro=""/>
+      <tab type="classmembers" visible="yes" title="" intro=""/>
+    </tab>
+    <tab type="files" visible="no" title="">
+      <tab type="filelist" visible="yes" title="" intro=""/>
+      <tab type="globals" visible="yes" title="" intro=""/>
+    </tab>
+    <tab type="examples" visible="yes" title="Source" intro=""/>
+  </navindex>
+
+  <!-- Layout definition for a class page -->
+  <class>
+    <briefdescription visible="yes"/>
+    <includes visible="$SHOW_INCLUDE_FILES"/>
+    <inheritancegraph visible="$CLASS_GRAPH"/>
+    <collaborationgraph visible="$COLLABORATION_GRAPH"/>
+    <memberdecl>
+      <nestedclasses visible="yes" title=""/>
+      <publictypes title=""/>
+      <publicslots title=""/>
+      <signals title=""/>
+      <publicmethods title=""/>
+      <publicstaticmethods title=""/>
+      <publicattributes title=""/>
+      <publicstaticattributes title=""/>
+      <protectedtypes title=""/>
+      <protectedslots title=""/>
+      <protectedmethods title=""/>
+      <protectedstaticmethods title=""/>
+      <protectedattributes title=""/>
+      <protectedstaticattributes title=""/>
+      <packagetypes title=""/>
+      <packagemethods title=""/>
+      <packagestaticmethods title=""/>
+      <packageattributes title=""/>
+      <packagestaticattributes title=""/>
+      <properties title=""/>
+      <events title=""/>
+      <privatetypes title=""/>
+      <privateslots title=""/>
+      <privatemethods title=""/>
+      <privatestaticmethods title=""/>
+      <privateattributes title=""/>
+      <privatestaticattributes title=""/>
+      <friends title=""/>
+      <related title="" subtitle=""/>
+      <membergroups visible="yes"/>
+    </memberdecl>
+    <detaileddescription title=""/>
+    <memberdef>
+      <inlineclasses title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <constructors title=""/>
+      <functions title=""/>
+      <related title=""/>
+      <variables title=""/>
+      <properties title=""/>
+      <events title=""/>
+    </memberdef>
+    <allmemberslink visible="yes"/>
+    <usedfiles visible="$SHOW_USED_FILES"/>
+    <authorsection visible="yes"/>
+  </class>
+
+  <!-- Layout definition for a namespace page -->
+  <namespace>
+    <briefdescription visible="yes"/>
+    <memberdecl>
+      <nestednamespaces visible="yes" title=""/>
+      <classes visible="yes" title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <functions title=""/>
+      <variables title=""/>
+      <membergroups visible="yes"/>
+    </memberdecl>
+    <detaileddescription title=""/>
+    <memberdef>
+      <inlineclasses title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <functions title=""/>
+      <variables title=""/>
+    </memberdef>
+    <authorsection visible="yes"/>
+  </namespace>
+
+  <!-- Layout definition for a file page -->
+  <file>
+    <briefdescription visible="yes"/>
+    <includes visible="$SHOW_INCLUDE_FILES"/>
+    <includegraph visible="$INCLUDE_GRAPH"/>
+    <includedbygraph visible="$INCLUDED_BY_GRAPH"/>
+    <sourcelink visible="yes"/>
+    <memberdecl>
+      <classes visible="yes" title=""/>
+      <namespaces visible="yes" title=""/>
+      <defines title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <functions title=""/>
+      <variables title=""/>
+      <membergroups visible="yes"/>
+    </memberdecl>
+    <detaileddescription title=""/>
+    <memberdef>
+      <inlineclasses title=""/>
+      <defines title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <functions title=""/>
+      <variables title=""/>
+    </memberdef>
+    <authorsection/>
+  </file>
+
+  <!-- Layout definition for a group page -->
+  <group>
+    <briefdescription visible="yes"/>
+    <groupgraph visible="$GROUP_GRAPHS"/>
+    <memberdecl>
+      <nestedgroups visible="yes" title=""/>
+      <dirs visible="yes" title=""/>
+      <files visible="yes" title=""/>
+      <namespaces visible="yes" title=""/>
+      <classes visible="yes" title=""/>
+      <defines title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <enumvalues title=""/>
+      <functions title=""/>
+      <variables title=""/>
+      <signals title=""/>
+      <publicslots title=""/>
+      <protectedslots title=""/>
+      <privateslots title=""/>
+      <events title=""/>
+      <properties title=""/>
+      <friends title=""/>
+      <membergroups visible="yes"/>
+    </memberdecl>
+    <detaileddescription title=""/>
+    <memberdef>
+      <pagedocs/>
+      <inlineclasses title=""/>
+      <defines title=""/>
+      <typedefs title=""/>
+      <enums title=""/>
+      <enumvalues title=""/>
+      <functions title=""/>
+      <variables title=""/>
+      <signals title=""/>
+      <publicslots title=""/>
+      <protectedslots title=""/>
+      <privateslots title=""/>
+      <events title=""/>
+      <properties title=""/>
+      <friends title=""/>
+    </memberdef>
+    <authorsection visible="yes"/>
+  </group>
+
+  <!-- Layout definition for a directory page -->
+  <directory>
+    <briefdescription visible="yes"/>
+    <directorygraph visible="yes"/>
+    <memberdecl>
+      <dirs visible="yes"/>
+      <files visible="yes"/>
+    </memberdecl>
+    <detaileddescription title=""/>
+  </directory>
+</doxygenlayout>

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_adc_dox_config.h

@@ -0,0 +1,82 @@
+/**
+ *
+ * @defgroup nrfx_adc_config ADC peripheral driver configuration
+ * @{
+ * @ingroup nrfx_adc
+ */
+/** @brief Enable the driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_ADC_ENABLED
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_ADC_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_ADC_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_ADC_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_ADC_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_ADC_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_clock_dox_config.h

@@ -0,0 +1,105 @@
+/**
+ *
+ * @defgroup nrfx_clock_config CLOCK peripheral driver configuration
+ * @{
+ * @ingroup nrfx_clock
+ */
+/** @brief Enable CLOCK driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_CLOCK_ENABLED
+/** @brief LF Clock Source
+ *
+ *  Following options are available:
+ * - 0 - RC
+ * - 1 - XTAL
+ * - 2 - Synth
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_CLOCK_CONFIG_LF_SRC
+
+/** @brief Enables LF Clock Calibration Support
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_CLOCK_CONFIG_LF_CAL_ENABLED
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_CLOCK_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_CLOCK_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_CLOCK_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_CLOCK_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_CLOCK_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_comp_dox_config.h

@@ -0,0 +1,158 @@
+/**
+ *
+ * @defgroup nrfx_comp_config COMP peripheral driver configuration
+ * @{
+ * @ingroup nrfx_comp
+ */
+/** @brief Enable COMP driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_ENABLED
+/** @brief Reference voltage
+ *
+ *  Following options are available:
+ * - 0 - Internal 1.2V
+ * - 1 - Internal 1.8V
+ * - 2 - Internal 2.4V
+ * - 4 - VDD
+ * - 7 - ARef
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_REF
+
+/** @brief Main mode
+ *
+ *  Following options are available:
+ * - 0 - Single ended
+ * - 1 - Differential
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_MAIN_MODE
+
+/** @brief Speed mode
+ *
+ *  Following options are available:
+ * - 0 - Low power
+ * - 1 - Normal
+ * - 2 - High speed
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_SPEED_MODE
+
+/** @brief Hystheresis
+ *
+ *  Following options are available:
+ * - 0 - No
+ * - 1 - 50mV
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_HYST
+
+/** @brief Current Source
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - 2.5 uA
+ * - 2 - 5 uA
+ * - 3 - 10 uA
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_ISOURCE
+
+/** @brief Analog input
+ *
+ *  Following options are available:
+ * - 0
+ * - 1
+ * - 2
+ * - 3
+ * - 4
+ * - 5
+ * - 6
+ * - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_INPUT
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_COMP_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_gpiote_dox_config.h

@@ -0,0 +1,93 @@
+/**
+ *
+ * @defgroup nrfx_gpiote_config GPIOTE peripheral driver configuration
+ * @{
+ * @ingroup nrfx_gpiote
+ */
+/** @brief Enable GPIOTE driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_GPIOTE_ENABLED
+/** @brief Number of lower power input pins
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_GPIOTE_CONFIG_NUM_OF_LOW_POWER_EVENTS
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_GPIOTE_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_GPIOTE_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_GPIOTE_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_GPIOTE_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_GPIOTE_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_i2s_dox_config.h

@@ -0,0 +1,225 @@
+/**
+ *
+ * @defgroup nrfx_i2s_config I2S peripheral driver configuration
+ * @{
+ * @ingroup nrfx_i2s
+ */
+/** @brief Enable I2S driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_ENABLED
+/** @brief SCK pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_SCK_PIN
+
+/** @brief LRCK pin
+ *
+ *  Minimum value: 1
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_LRCK_PIN
+
+/** @brief MCK pin
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_MCK_PIN
+
+/** @brief SDOUT pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_SDOUT_PIN
+
+/** @brief SDIN pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_SDIN_PIN
+
+/** @brief Mode
+ *
+ *  Following options are available:
+ * - 0 - Master
+ * - 1 - Slave
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_MASTER
+
+/** @brief Format
+ *
+ *  Following options are available:
+ * - 0 - I2S
+ * - 1 - Aligned
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_FORMAT
+
+/** @brief Alignment
+ *
+ *  Following options are available:
+ * - 0 - Left
+ * - 1 - Right
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_ALIGN
+
+/** @brief Sample width (bits)
+ *
+ *  Following options are available:
+ * - 0 - 8
+ * - 1 - 16
+ * - 2 - 24
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_SWIDTH
+
+/** @brief Channels
+ *
+ *  Following options are available:
+ * - 0 - Stereo
+ * - 1 - Left
+ * - 2 - Right
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_CHANNELS
+
+/** @brief MCK behavior
+ *
+ *  Following options are available:
+ * - 0 - Disabled
+ * - 2147483648 - 32MHz/2
+ * - 1342177280 - 32MHz/3
+ * - 1073741824 - 32MHz/4
+ * - 805306368 - 32MHz/5
+ * - 671088640 - 32MHz/6
+ * - 536870912 - 32MHz/8
+ * - 402653184 - 32MHz/10
+ * - 369098752 - 32MHz/11
+ * - 285212672 - 32MHz/15
+ * - 268435456 - 32MHz/16
+ * - 201326592 - 32MHz/21
+ * - 184549376 - 32MHz/23
+ * - 142606336 - 32MHz/30
+ * - 138412032 - 32MHz/31
+ * - 134217728 - 32MHz/32
+ * - 100663296 - 32MHz/42
+ * - 68157440 - 32MHz/63
+ * - 34340864 - 32MHz/125
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_MCK_SETUP
+
+/** @brief MCK/LRCK ratio
+ *
+ *  Following options are available:
+ * - 0 - 32x
+ * - 1 - 48x
+ * - 2 - 64x
+ * - 3 - 96x
+ * - 4 - 128x
+ * - 5 - 192x
+ * - 6 - 256x
+ * - 7 - 384x
+ * - 8 - 512x
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_RATIO
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_I2S_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_lpcomp_dox_config.h

@@ -0,0 +1,146 @@
+/**
+ *
+ * @defgroup nrfx_lpcomp_config LPCOMP peripheral driver configuration
+ * @{
+ * @ingroup nrfx_lpcomp
+ */
+/** @brief Enable LPCOMP driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_ENABLED
+/** @brief Reference voltage
+ *
+ *  Following options are available:
+ * - 0 - Supply 1/8
+ * - 1 - Supply 2/8
+ * - 2 - Supply 3/8
+ * - 3 - Supply 4/8
+ * - 4 - Supply 5/8
+ * - 5 - Supply 6/8
+ * - 6 - Supply 7/8
+ * - 8 - Supply 1/16 (nRF52)
+ * - 9 - Supply 3/16 (nRF52)
+ * - 10 - Supply 5/16 (nRF52)
+ * - 11 - Supply 7/16 (nRF52)
+ * - 12 - Supply 9/16 (nRF52)
+ * - 13 - Supply 11/16 (nRF52)
+ * - 14 - Supply 13/16 (nRF52)
+ * - 15 - Supply 15/16 (nRF52)
+ * - 7 - External Ref 0
+ * - 65543 - External Ref 1
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_CONFIG_REFERENCE
+
+/** @brief Detection
+ *
+ *  Following options are available:
+ * - 0 - Crossing
+ * - 1 - Up
+ * - 2 - Down
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_CONFIG_DETECTION
+
+/** @brief Analog input
+ *
+ *  Following options are available:
+ * - 0
+ * - 1
+ * - 2
+ * - 3
+ * - 4
+ * - 5
+ * - 6
+ * - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_CONFIG_INPUT
+
+/** @brief Hysteresis
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_CONFIG_HYST
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_LPCOMP_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_nfct_dox_config.h

@@ -0,0 +1,88 @@
+/**
+ *
+ * @defgroup nrfx_nfct_config NFCT peripheral driver configuration
+ * @{
+ * @ingroup nrfx_nfct
+ */
+/** @brief Enable NFCT driver.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_NFCT_ENABLED
+
+/** @brief Interrupt priority.
+ *
+ *  The following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_NFCT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_NFCT_CONFIG_LOG_ENABLED
+
+/** @brief Default Severity level.
+ *
+ *  The following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_NFCT_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  The following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_NFCT_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  The following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_NFCT_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_pdm_dox_config.h

@@ -0,0 +1,117 @@
+/**
+ *
+ * @defgroup nrfx_pdm_config PDM peripheral driver configuration
+ * @{
+ * @ingroup nrfx_pdm
+ */
+/** @brief Enable PDM driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PDM_ENABLED
+/** @brief Mode
+ *
+ *  Following options are available:
+ * - 0 - Stereo
+ * - 1 - Mono
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PDM_CONFIG_MODE
+
+/** @brief Edge
+ *
+ *  Following options are available:
+ * - 0 - Left falling
+ * - 1 - Left rising
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PDM_CONFIG_EDGE
+
+/** @brief Clock frequency
+ *
+ *  Following options are available:
+ * - 134217728 - 1000k
+ * - 138412032 - 1032k (default)
+ * - 142606336 - 1067k
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PDM_CONFIG_CLOCK_FREQ
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PDM_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PDM_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PDM_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PDM_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PDM_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_power_dox_config.h

@@ -0,0 +1,51 @@
+/**
+ *
+ * @defgroup nrfx_power_config POWER peripheral driver configuration
+ * @{
+ * @ingroup nrfx_power
+ */
+/** @brief Enable POWER driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_POWER_ENABLED
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_POWER_CONFIG_IRQ_PRIORITY
+
+/** @brief The default configuration of main DCDC regulator
+ *
+ * This settings means only that components for DCDC regulator are installed and it can be enabled.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_POWER_CONFIG_DEFAULT_DCDCEN
+
+/** @brief The default configuration of High Voltage DCDC regulator
+ *
+ * This settings means only that components for DCDC regulator are installed and it can be enabled.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_POWER_CONFIG_DEFAULT_DCDCENHV
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_ppi_dox_config.h

@@ -0,0 +1,70 @@
+/**
+ *
+ * @defgroup nrfx_ppi_config PPI peripheral allocator configuration
+ * @{
+ * @ingroup nrfx_ppi
+ */
+/** @brief Enabling PPI allocator
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PPI_ENABLED
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PPI_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PPI_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PPI_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PPI_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_prs_dox_config.h

@@ -0,0 +1,110 @@
+/**
+ *
+ * @defgroup nrfx_prs_config Peripheral Resource Sharing module configuration
+ * @{
+ * @ingroup nrfx_prs
+ */
+/** @brief Enabling peripherals with same ID coexistence
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_ENABLED
+/** @brief Enables box 0 in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_BOX_0_ENABLED
+
+/** @brief Enables box 1 in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_BOX_1_ENABLED
+
+/** @brief Enables box 2 in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_BOX_2_ENABLED
+
+/** @brief Enables box 3 in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_BOX_3_ENABLED
+
+/** @brief Enables box 4 in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_BOX_4_ENABLED
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PRS_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_pwm_dox_config.h

@@ -0,0 +1,239 @@
+/**
+ *
+ * @defgroup nrfx_pwm_config PWM peripheral driver configuration
+ * @{
+ * @ingroup nrfx_pwm
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_ENABLED
+/** @brief Enable PWM0 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM0_ENABLED
+
+/** @brief Enable PWM1 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM1_ENABLED
+
+/** @brief Enable PWM2 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM2_ENABLED
+
+/** @brief Enable PWM3 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM3_ENABLED
+
+/** @brief Out0 pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_OUT0_PIN
+
+/** @brief Out1 pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_OUT1_PIN
+
+/** @brief Out2 pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_OUT2_PIN
+
+/** @brief Out3 pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_OUT3_PIN
+
+/** @brief Base clock
+ *
+ *  Following options are available:
+ * - 0 - 16 MHz
+ * - 1 - 8 MHz
+ * - 2 - 4 MHz
+ * - 3 - 2 MHz
+ * - 4 - 1 MHz
+ * - 5 - 500 kHz
+ * - 6 - 250 kHz
+ * - 7 - 125 kHz
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_BASE_CLOCK
+
+/** @brief Count mode
+ *
+ *  Following options are available:
+ * - 0 - Up
+ * - 1 - Up and Down
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_COUNT_MODE
+
+/** @brief Top value
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_TOP_VALUE
+
+/** @brief Load mode
+ *
+ *  Following options are available:
+ * - 0 - Common
+ * - 1 - Grouped
+ * - 2 - Individual
+ * - 3 - Waveform
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_LOAD_MODE
+
+/** @brief Step mode
+ *
+ *  Following options are available:
+ * - 0 - Auto
+ * - 1 - Triggered
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_STEP_MODE
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_CONFIG_DEBUG_COLOR
+
+
+/** @brief Enables nRF52 Anomaly 109 workaround for PWM.
+ *
+ * The workaround uses interrupts to wake up the CPU and ensure
+ * it is active when PWM is about to start a DMA transfer. For
+ * initial transfer, done when a playback is started via PPI,
+ * a specific EGU instance is used to generate the interrupt.
+ * During the playback, the PWM interrupt triggered on SEQEND
+ * event of a preceding sequence is used to protect the transfer
+ * done for the next sequence to be played.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_NRF52_ANOMALY_109_WORKAROUND_ENABLED
+/** @brief EGU instance used by the nRF52 Anomaly 109 workaround for PWM.
+ *
+ *  Following options are available:
+ * - 0 - EGU0
+ * - 1 - EGU1
+ * - 2 - EGU2
+ * - 3 - EGU3
+ * - 4 - EGU4
+ * - 5 - EGU5
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_PWM_NRF52_ANOMALY_109_EGU_INSTANCE
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_qdec_dox_config.h

@@ -0,0 +1,178 @@
+/**
+ *
+ * @defgroup nrfx_qdec_config QDEC peripheral driver configuration
+ * @{
+ * @ingroup nrfx_qdec
+ */
+/** @brief Enable QDEC driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_ENABLED
+/** @brief Report period
+ *
+ *  Following options are available:
+ * - 0 - 10 Samples
+ * - 1 - 40 Samples
+ * - 2 - 80 Samples
+ * - 3 - 120 Samples
+ * - 4 - 160 Samples
+ * - 5 - 200 Samples
+ * - 6 - 240 Samples
+ * - 7 - 280 Samples
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_REPORTPER
+
+/** @brief Sample period
+ *
+ *  Following options are available:
+ * - 0 - 128 us
+ * - 1 - 256 us
+ * - 2 - 512 us
+ * - 3 - 1024 us
+ * - 4 - 2048 us
+ * - 5 - 4096 us
+ * - 6 - 8192 us
+ * - 7 - 16384 us
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_SAMPLEPER
+
+/** @brief A pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_PIO_A
+
+/** @brief B pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_PIO_B
+
+/** @brief LED pin
+ *
+ *  Minimum value: 0
+ *  Maximum value: 31
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_PIO_LED
+
+/** @brief LED pre
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_LEDPRE
+
+/** @brief LED polarity
+ *
+ *  Following options are available:
+ * - 0 - Active low
+ * - 1 - Active high
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_LEDPOL
+
+/** @brief Debouncing enable
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_DBFEN
+
+/** @brief Sample ready interrupt enable
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_SAMPLE_INTEN
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QDEC_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_qspi_dox_config.h

@@ -0,0 +1,170 @@
+/**
+ *
+ * @defgroup nrfx_qspi_config QSPI peripheral driver configuration
+ * @{
+ * @ingroup nrfx_qspi
+ */
+/** @brief Enable QSPI driver.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_ENABLED
+/** @brief tSHSL, tWHSL and tSHWL in number of 16 MHz periods (62.5 ns).
+ *
+ *  Minimum value: 0
+ *  Maximum value: 255
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_CONFIG_SCK_DELAY
+
+/** @brief Address offset in the external memory for Execute in Place operation.
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_CONFIG_XIP_OFFSET
+
+/** @brief Number of data lines and opcode used for reading.
+ *
+ *  Following options are available:
+ * - 0 - FastRead
+ * - 1 - Read2O
+ * - 2 - Read2IO
+ * - 3 - Read4O
+ * - 4 - Read4IO
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_CONFIG_READOC
+
+/** @brief Number of data lines and opcode used for writing.
+ *
+ *  Following options are available:
+ * - 0 - PP
+ * - 1 - PP2O
+ * - 2 - PP4O
+ * - 3 - PP4IO
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_CONFIG_WRITEOC
+
+/** @brief Addressing mode.
+ *
+ *  Following options are available:
+ * - 0 - 24bit
+ * - 1 - 32bit
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_CONFIG_ADDRMODE
+
+/** @brief SPI mode.
+ *
+ *  Following options are available:
+ * - 0 - Mode 0
+ * - 1 - Mode 1
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_CONFIG_MODE
+
+/** @brief Frequency divider.
+ *
+ *  Following options are available:
+ * - 0 - 32MHz/1
+ * - 1 - 32MHz/2
+ * - 2 - 32MHz/3
+ * - 3 - 32MHz/4
+ * - 4 - 32MHz/5
+ * - 5 - 32MHz/6
+ * - 6 - 32MHz/7
+ * - 7 - 32MHz/8
+ * - 8 - 32MHz/9
+ * - 9 - 32MHz/10
+ * - 10 - 32MHz/11
+ * - 11 - 32MHz/12
+ * - 12 - 32MHz/13
+ * - 13 - 32MHz/14
+ * - 14 - 32MHz/15
+ * - 15 - 32MHz/16
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_CONFIG_FREQUENCY
+
+/** @brief SCK pin value.
+ *
+ *  Minimum value: 0
+ *  Maximum value: 255
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_PIN_SCK
+
+/** @brief CSN pin value.
+ *
+ *  Minimum value: 0
+ *  Maximum value: 255
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_PIN_CSN
+
+/** @brief IO0 pin value.
+ *
+ *  Minimum value: 0
+ *  Maximum value: 255
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_PIN_IO0
+
+/** @brief IO1 pin value.
+ *
+ *  Minimum value: 0
+ *  Maximum value: 255
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_PIN_IO1
+
+/** @brief IO2 pin value.
+ *
+ *  Minimum value: 0
+ *  Maximum value: 255
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_PIN_IO2
+
+/** @brief IO3 pin value.
+ *
+ *  Minimum value: 0
+ *  Maximum value: 255
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_PIN_IO3
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_QSPI_CONFIG_IRQ_PRIORITY
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_rng_dox_config.h

@@ -0,0 +1,94 @@
+/**
+ *
+ * @defgroup nrfx_rng_config RNG peripheral driver configuration
+ * @{
+ * @ingroup nrfx_rng
+ */
+/** @brief Enable RNG driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RNG_ENABLED
+/** @brief Error correction
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RNG_CONFIG_ERROR_CORRECTION
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RNG_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RNG_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RNG_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RNG_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RNG_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_rtc_dox_config.h

@@ -0,0 +1,134 @@
+/**
+ *
+ * @defgroup nrfx_rtc_config RTC peripheral driver configuration
+ * @{
+ * @ingroup nrfx_rtc
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC_ENABLED
+/** @brief Enable RTC0 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC0_ENABLED
+
+/** @brief Enable RTC1 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC1_ENABLED
+
+/** @brief Enable RTC2 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC2_ENABLED
+
+/** @brief Maximum possible time[us] in highest priority interrupt
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC_MAXIMUM_LATENCY_US
+
+/** @brief Frequency
+ *
+ *  Minimum value: 16
+ *  Maximum value: 32768
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC_DEFAULT_CONFIG_FREQUENCY
+
+/** @brief Ensures safe compare event triggering
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC_DEFAULT_CONFIG_RELIABLE
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_RTC_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_saadc_dox_config.h

@@ -0,0 +1,123 @@
+/**
+ *
+ * @defgroup nrfx_saadc_config SAADC peripheral driver configuration
+ * @{
+ * @ingroup nrfx_saadc
+ */
+/** @brief Enable SAADC driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SAADC_ENABLED
+/** @brief Resolution
+ *
+ *  Following options are available:
+ * - 0 - 8 bit
+ * - 1 - 10 bit
+ * - 2 - 12 bit
+ * - 3 - 14 bit
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SAADC_CONFIG_RESOLUTION
+
+/** @brief Sample period
+ *
+ *  Following options are available:
+ * - 0 - Disabled
+ * - 1 - 2x
+ * - 2 - 4x
+ * - 3 - 8x
+ * - 4 - 16x
+ * - 5 - 32x
+ * - 6 - 64x
+ * - 7 - 128x
+ * - 8 - 256x
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SAADC_CONFIG_OVERSAMPLE
+
+/** @brief Enabling low power mode
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SAADC_CONFIG_LP_MODE
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SAADC_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SAADC_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SAADC_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SAADC_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SAADC_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_spi_dox_config.h

@@ -0,0 +1,121 @@
+/**
+ *
+ * @defgroup nrfx_spi_config SPI peripheral driver configuration
+ * @{
+ * @ingroup nrfx_spi
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI_ENABLED
+/** @brief Enable SPI0 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI0_ENABLED
+
+/** @brief Enable SPI1 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI1_ENABLED
+
+/** @brief Enable SPI2 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI2_ENABLED
+
+/** @brief MISO pin pull configuration.
+ *
+ *  Following options are available:
+ * - 0 - NRF_GPIO_PIN_NOPULL
+ * - 1 - NRF_GPIO_PIN_PULLDOWN
+ * - 3 - NRF_GPIO_PIN_PULLUP
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI_MISO_PULL_CFG
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPI_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_spim_dox_config.h

@@ -0,0 +1,163 @@
+/**
+ *
+ * @defgroup nrfx_spim_config SPIM peripheral driver configuration
+ * @{
+ * @ingroup nrfx_spim
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM_ENABLED
+/** @brief Enable SPIM0 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM0_ENABLED
+
+/** @brief Enable SPIM1 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM1_ENABLED
+
+/** @brief Enable SPIM2 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM2_ENABLED
+
+/** @brief Enable SPIM3 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM3_ENABLED
+
+/** @brief Enable extended SPIM features
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM_EXTENDED_ENABLED
+
+/** @brief MISO pin pull configuration.
+ *
+ *  Following options are available:
+ * - 0 - NRF_GPIO_PIN_NOPULL
+ * - 1 - NRF_GPIO_PIN_PULLDOWN
+ * - 3 - NRF_GPIO_PIN_PULLUP
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM_MISO_PULL_CFG
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM_CONFIG_DEBUG_COLOR
+
+
+/** @brief Enables nRF52 anomaly 109 workaround for SPIM.
+ *
+ * The workaround uses interrupts to wake up the CPU by catching
+ * a start event of zero-length transmission to start the clock. This 
+ * ensures that the DMA transfer will be executed without issues and
+ * that the proper transfer will be started. See more in the Errata 
+ * document or Anomaly 109 Addendum located at 
+ * https://infocenter.nordicsemi.com/
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM_NRF52_ANOMALY_109_WORKAROUND_ENABLED
+
+/** @brief Enables nRF52840 anomaly 198 workaround for SPIM3.
+ *
+ * See more in the Errata document located at 
+ * https://infocenter.nordicsemi.com/
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIM3_NRF52840_ANOMALY_198_WORKAROUND_ENABLED
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_spis_dox_config.h

@@ -0,0 +1,143 @@
+/**
+ *
+ * @defgroup nrfx_spis_config SPIS peripheral driver configuration
+ * @{
+ * @ingroup nrfx_spis
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS_ENABLED
+/** @brief Enable SPIS0 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS0_ENABLED
+
+/** @brief Enable SPIS1 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS1_ENABLED
+
+/** @brief Enable SPIS2 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS2_ENABLED
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief SPIS default DEF character
+ *
+ *  Minimum value: 0
+ *  Maximum value: 255
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS_DEFAULT_DEF
+
+/** @brief SPIS default ORC character
+ *
+ *  Minimum value: 0
+ *  Maximum value: 255
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS_DEFAULT_ORC
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS_CONFIG_DEBUG_COLOR
+
+
+/** @brief Enables nRF52 Anomaly 109 workaround for SPIS.
+ *
+ * The workaround uses a GPIOTE channel to generate interrupts
+ * on falling edges detected on the CSN line. This will make
+ * the CPU active for the moment when SPIS starts DMA transfers,
+ * and this way the transfers will be protected.
+ * This workaround uses GPIOTE driver, so this driver must be
+ * enabled as well.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SPIS_NRF52_ANOMALY_109_WORKAROUND_ENABLED
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_swi_dox_config.h

@@ -0,0 +1,126 @@
+/**
+ *
+ * @defgroup nrfx_swi_config SWI/EGU peripheral allocator configuration
+ * @{
+ * @ingroup nrfx_swi
+ */
+/** @brief Enable SWI/EGU allocator
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI_ENABLED
+/** @brief Enable EGU support
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_EGU_ENABLED
+
+/** @brief Exclude SWI0 from being utilized by the driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI0_DISABLED
+
+/** @brief Exclude SWI1 from being utilized by the driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI1_DISABLED
+
+/** @brief Exclude SWI2 from being utilized by the driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI2_DISABLED
+
+/** @brief Exclude SWI3 from being utilized by the driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI3_DISABLED
+
+/** @brief Exclude SWI4 from being utilized by the driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI4_DISABLED
+
+/** @brief Exclude SWI5 from being utilized by the driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI5_DISABLED
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SWI_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_systick_dox_config.h

@@ -0,0 +1,15 @@
+/**
+ *
+ * @defgroup nrfx_systick_config ARM(R) SysTick driver configuration
+ * @{
+ * @ingroup nrfx_systick
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_SYSTICK_ENABLED
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_timer_dox_config.h

@@ -0,0 +1,166 @@
+/**
+ *
+ * @defgroup nrfx_timer_config TIMER periperal driver configuration
+ * @{
+ * @ingroup nrfx_timer
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER_ENABLED
+/** @brief Enable TIMER0 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER0_ENABLED
+
+/** @brief Enable TIMER1 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER1_ENABLED
+
+/** @brief Enable TIMER2 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER2_ENABLED
+
+/** @brief Enable TIMER3 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER3_ENABLED
+
+/** @brief Enable TIMER4 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER4_ENABLED
+
+/** @brief Timer frequency if in Timer mode
+ *
+ *  Following options are available:
+ * - 0 - 16 MHz
+ * - 1 - 8 MHz
+ * - 2 - 4 MHz
+ * - 3 - 2 MHz
+ * - 4 - 1 MHz
+ * - 5 - 500 kHz
+ * - 6 - 250 kHz
+ * - 7 - 125 kHz
+ * - 8 - 62.5 kHz
+ * - 9 - 31.25 kHz
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER_DEFAULT_CONFIG_FREQUENCY
+
+/** @brief Timer mode or operation
+ *
+ *  Following options are available:
+ * - 0 - Timer
+ * - 1 - Counter
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER_DEFAULT_CONFIG_MODE
+
+/** @brief Timer counter bit width
+ *
+ *  Following options are available:
+ * - 0 - 16 bit
+ * - 1 - 8 bit
+ * - 2 - 24 bit
+ * - 3 - 32 bit
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER_DEFAULT_CONFIG_BIT_WIDTH
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TIMER_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_twi_dox_config.h

@@ -0,0 +1,121 @@
+/**
+ *
+ * @defgroup nrfx_twi_config TWI peripheral driver configuration
+ * @{
+ * @ingroup nrfx_twi
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI_ENABLED
+/** @brief Enable TWI0 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI0_ENABLED
+
+/** @brief Enable TWI1 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI1_ENABLED
+
+/** @brief Frequency
+ *
+ *  Following options are available:
+ * - 26738688 - 100k
+ * - 67108864 - 250k
+ * - 104857600 - 400k
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI_DEFAULT_CONFIG_FREQUENCY
+
+/** @brief Enables bus holding after uninit
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI_DEFAULT_CONFIG_HOLD_BUS_UNINIT
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWI_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_twim_dox_config.h

@@ -0,0 +1,135 @@
+/**
+ *
+ * @defgroup nrfx_twim_config TWIM peripheral driver configuration
+ * @{
+ * @ingroup nrfx_twim
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM_ENABLED
+/** @brief Enable TWIM0 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM0_ENABLED
+
+/** @brief Enable TWIM1 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM1_ENABLED
+
+/** @brief Frequency
+ *
+ *  Following options are available:
+ * - 26738688 - 100k
+ * - 67108864 - 250k
+ * - 104857600 - 400k
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM_DEFAULT_CONFIG_FREQUENCY
+
+/** @brief Enables bus holding after uninit
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM_DEFAULT_CONFIG_HOLD_BUS_UNINIT
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM_CONFIG_DEBUG_COLOR
+
+
+/** @brief Enables nRF52 anomaly 109 workaround for TWIM.
+ *
+ * The workaround uses interrupts to wake up the CPU by catching
+ * the start event of zero-frequency transmission, clear the 
+ * peripheral, set desired frequency, start the peripheral, and
+ * the proper transmission. See more in the Errata document or
+ * Anomaly 109 Addendum located at https://infocenter.nordicsemi.com/
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIM_NRF52_ANOMALY_109_WORKAROUND_ENABLED
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_twis_dox_config.h

@@ -0,0 +1,158 @@
+/**
+ *
+ * @defgroup nrfx_twis_config TWIS peripheral driver configuration
+ * @{
+ * @ingroup nrfx_twis
+ */
+/** @brief 
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_ENABLED
+/** @brief Enable TWIS0 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS0_ENABLED
+
+/** @brief Enable TWIS1 instance
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS1_ENABLED
+
+/** @brief Assume that any instance would be initialized only once
+ *
+ * Optimization flag. Registers used by TWIS are shared by other peripherals. Normally, during initialization driver tries to clear all registers to known state before doing the initialization itself. This gives initialization safe procedure, no matter when it would be called. If you activate TWIS only once and do never uninitialize it - set this flag to 1 what gives more optimal code.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_ASSUME_INIT_AFTER_RESET_ONLY
+
+/** @brief Remove support for synchronous mode
+ *
+ * Synchronous mode would be used in specific situations. And it uses some additional code and data memory to safely process state machine by polling it in status functions. If this functionality is not required it may be disabled to free some resources.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_NO_SYNC_MODE
+
+/** @brief Address0
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_DEFAULT_CONFIG_ADDR0
+
+/** @brief Address1
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_DEFAULT_CONFIG_ADDR1
+
+/** @brief SCL pin pull configuration
+ *
+ *  Following options are available:
+ * - 0 - Disabled
+ * - 1 - Pull down
+ * - 3 - Pull up
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_DEFAULT_CONFIG_SCL_PULL
+
+/** @brief SDA pin pull configuration
+ *
+ *  Following options are available:
+ * - 0 - Disabled
+ * - 1 - Pull down
+ * - 3 - Pull up
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_DEFAULT_CONFIG_SDA_PULL
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_TWIS_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_uart_dox_config.h

@@ -0,0 +1,139 @@
+/**
+ *
+ * @defgroup nrfx_uart_config UART peripheral driver configuration
+ * @{
+ * @ingroup nrfx_uart
+ */
+/** @brief Enable UART driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART_ENABLED
+/** @brief Enable UART0 instance
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART0_ENABLED
+
+/** @brief Hardware Flow Control
+ *
+ *  Following options are available:
+ * - 0 - Disabled
+ * - 1 - Enabled
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART_DEFAULT_CONFIG_HWFC
+
+/** @brief Parity
+ *
+ *  Following options are available:
+ * - 0 - Excluded
+ * - 14 - Included
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART_DEFAULT_CONFIG_PARITY
+
+/** @brief Default Baudrate
+ *
+ *  Following options are available:
+ * - 323584 - 1200 baud
+ * - 643072 - 2400 baud
+ * - 1290240 - 4800 baud
+ * - 2576384 - 9600 baud
+ * - 3866624 - 14400 baud
+ * - 5152768 - 19200 baud
+ * - 7729152 - 28800 baud
+ * - 8388608 - 31250 baud
+ * - 10309632 - 38400 baud
+ * - 15007744 - 56000 baud
+ * - 15462400 - 57600 baud
+ * - 20615168 - 76800 baud
+ * - 30924800 - 115200 baud
+ * - 61845504 - 230400 baud
+ * - 67108864 - 250000 baud
+ * - 123695104 - 460800 baud
+ * - 247386112 - 921600 baud
+ * - 268435456 - 1000000 baud
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART_DEFAULT_CONFIG_BAUDRATE
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UART_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_uarte_dox_config.h

@@ -0,0 +1,146 @@
+/**
+ *
+ * @defgroup nrfx_uarte_config UARTE peripheral driver configuration
+ * @{
+ * @ingroup nrfx_uarte
+ */
+/** @brief Enable UARTE driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE_ENABLED
+/** @brief Enable UARTE0 instance
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE0_ENABLED
+
+/** @brief Enable UARTE1 instance
+ *
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE1_ENABLED
+
+/** @brief Hardware Flow Control
+ *
+ *  Following options are available:
+ * - 0 - Disabled
+ * - 1 - Enabled
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE_DEFAULT_CONFIG_HWFC
+
+/** @brief Parity
+ *
+ *  Following options are available:
+ * - 0 - Excluded
+ * - 14 - Included
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE_DEFAULT_CONFIG_PARITY
+
+/** @brief Default Baudrate
+ *
+ *  Following options are available:
+ * - 323584 - 1200 baud
+ * - 643072 - 2400 baud
+ * - 1290240 - 4800 baud
+ * - 2576384 - 9600 baud
+ * - 3862528 - 14400 baud
+ * - 5152768 - 19200 baud
+ * - 7716864 - 28800 baud
+ * - 8388608 - 31250 baud
+ * - 10289152 - 38400 baud
+ * - 15007744 - 56000 baud
+ * - 15400960 - 57600 baud
+ * - 20615168 - 76800 baud
+ * - 30801920 - 115200 baud
+ * - 61865984 - 230400 baud
+ * - 67108864 - 250000 baud
+ * - 121634816 - 460800 baud
+ * - 251658240 - 921600 baud
+ * - 268435456 - 1000000 baud
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE_DEFAULT_CONFIG_BAUDRATE
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE_DEFAULT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_UARTE_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_usbd_dox_config.h

@@ -0,0 +1,56 @@
+/**
+ *
+ * @defgroup nrfx_usbd_config USBD peripheral driver configuration
+ * @{
+ * @ingroup nrfx_usbd
+ */
+/** @brief Enable USB driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_USBD_ENABLED
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4
+ * - 5 - 5
+ * - 6 - 6
+ * - 7 - 7
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_USBD_CONFIG_IRQ_PRIORITY
+
+/** @brief Give priority to isochronous transfers
+ *
+ * This option gives priority to isochronous transfers.
+ * Enabling it assures that isochronous transfers are always processed,
+ * even if multiple other transfers are pending.
+ * Isochronous endpoints are prioritized before the usbd_dma_scheduler_algorithm
+ * function is called, so the option is independent of the algorithm chosen.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_USBD_CONFIG_DMASCHEDULER_ISO_BOOST
+
+/** @brief Respond to an IN token on ISO IN endpoint with ZLP when no data is ready
+ *
+ * If set, ISO IN endpoint will respond to an IN token with ZLP when no data is ready to be sent.
+ * Else, there will be no response.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_USBD_CONFIG_ISO_IN_ZLP
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/config_dox/nrfx_wdt_dox_config.h

@@ -0,0 +1,117 @@
+/**
+ *
+ * @defgroup nrfx_wdt_config WDT peripheral driver configuration
+ * @{
+ * @ingroup nrfx_wdt
+ */
+/** @brief Enable WDT driver
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_WDT_ENABLED
+/** @brief WDT behavior in CPU SLEEP or HALT mode
+ *
+ *  Following options are available:
+ * - 1 - Run in SLEEP, Pause in HALT
+ * - 8 - Pause in SLEEP, Run in HALT
+ * - 9 - Run in SLEEP and HALT
+ * - 0 - Pause in SLEEP and HALT
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_WDT_CONFIG_BEHAVIOUR
+
+/** @brief Reload value
+ *
+ *  Minimum value: 15
+ *  Maximum value: 4294967295
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_WDT_CONFIG_RELOAD_VALUE
+
+/** @brief Remove WDT IRQ handling from WDT driver
+ *
+ *  Following options are available:
+ * - 0 - Include WDT IRQ handling
+ * - 1 - Remove WDT IRQ handling
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_WDT_CONFIG_NO_IRQ
+
+/** @brief Interrupt priority
+ *
+ *  Following options are available:
+ * - 0 - 0 (highest)
+ * - 1 - 1
+ * - 2 - 2
+ * - 3 - 3
+ * - 4 - 4 (Not applicable for nRF51)
+ * - 5 - 5 (Not applicable for nRF51)
+ * - 6 - 6 (Not applicable for nRF51)
+ * - 7 - 7 (Not applicable for nRF51)
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_WDT_CONFIG_IRQ_PRIORITY
+
+/** @brief Enables logging in the module.
+ *
+ *  Set to 1 to activate.
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_WDT_CONFIG_LOG_ENABLED
+/** @brief Default Severity level
+ *
+ *  Following options are available:
+ * - 0 - Off
+ * - 1 - Error
+ * - 2 - Warning
+ * - 3 - Info
+ * - 4 - Debug
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_WDT_CONFIG_LOG_LEVEL
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_WDT_CONFIG_INFO_COLOR
+
+/** @brief ANSI escape code prefix.
+ *
+ *  Following options are available:
+ * - 0 - Default
+ * - 1 - Black
+ * - 2 - Red
+ * - 3 - Green
+ * - 4 - Yellow
+ * - 5 - Blue
+ * - 6 - Magenta
+ * - 7 - Cyan
+ * - 8 - White
+ *
+ * @note This is an NRF_CONFIG macro.
+ */
+#define NRFX_WDT_CONFIG_DEBUG_COLOR
+
+
+
+/** @} */

third_party/NordicSemiconductor/nrfx/doc/drv_supp_matrix.dox

@@ -1,44 +1,53 @@
-/**
-@page nrfx_drv_supp_matrix Driver Support Matrix
-This matrix shows which drivers are supported by particular Nordic SoCs.
-@{
-
-Driver           | nRF51 Series | nRF52810     | nRF52832     | nRF52840     |
------------------|--------------|--------------| -------------| -------------|
-@ref nrf_adc     |@tagGreenTick |@tagRedCross  |@tagRedCross  |@tagRedCross  |
-@ref nrf_ccm     |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_clock   |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_comp    |@tagRedCross  |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_ecb     |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_gpio    |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_gpiote  |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_i2s     |@tagRedCross  |@tagRedCross  |@tagGreenTick |@tagGreenTick |
-@ref nrf_lpcomp  |@tagGreenTick |@tagRedCross  |@tagGreenTick |@tagGreenTick |
-@ref nrf_nvmc    |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_pdm     |@tagRedCross  |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_power   |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_ppi     |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_pwm     |@tagRedCross  |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_qdec    |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_qspi    |@tagRedCross  |@tagRedCross  |@tagRedCross  |@tagGreenTick |
-@ref nrf_radio   |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_rng     |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_rtc     |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_saadc   |@tagRedCross  |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_spi     |@tagGreenTick |@tagRedCross  |@tagGreenTick |@tagGreenTick |
-@ref nrf_spim    |@tagRedCross  |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_spis    |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_systick |@tagRedCross  |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_swi_egu |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_temp    |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_timer   |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_twi     |@tagGreenTick |@tagRedCross  |@tagGreenTick |@tagGreenTick |
-@ref nrf_twim    |@tagRedCross  |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_twis    |@tagRedCross  |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_uart    |@tagGreenTick |@tagRedCross  |@tagGreenTick |@tagGreenTick |
-@ref nrf_uarte   |@tagRedCross  |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-@ref nrf_usbd    |@tagRedCross  |@tagRedCross  |@tagRedCross  |@tagGreenTick |
-@ref nrf_wdt     |@tagGreenTick |@tagGreenTick |@tagGreenTick |@tagGreenTick |
-
-@}
-*/
+/**
+@page nrfx_drv_supp_matrix Driver support matrix
+The following matrix shows which drivers are supported by specific Nordic SoCs.
+@{
+
+Driver           | nRF51 Series | nRF52810/nRF52811 | nRF52832     | nRF52840     | nRF9160      |
+-----------------|--------------|-------------------| -------------| -------------| -------------|
+@ref nrf_adc     |@tagGreenTick |@tagRedCross       |@tagRedCross  |@tagRedCross  |@tagRedCross  |
+@ref nrf_acl     |@tagRedCross  |@tagRedCross       |@tagRedCross  |@tagGreenTick |@tagRedCross  |
+@ref nrf_bprot   |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagRedCross  |@tagRedCross  |
+@ref nrf_ccm     |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_clock   |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_comp    |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_dppi    |@tagRedCross  |@tagRedCross       |@tagRedCross  |@tagRedCross  |@tagGreenTick |
+@ref nrf_ecb     |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_gpio    |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_gpiote  |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_i2s     |@tagRedCross  |@tagRedCross       |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_kmu     |@tagRedCross  |@tagRedCross       |@tagRedCross  |@tagRedCross  |@tagGreenTick |
+@ref nrf_lpcomp  |@tagGreenTick |@tagRedCross       |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_mpu     |@tagGreenTick |@tagRedCross       |@tagRedCross  |@tagRedCross  |@tagRedCross  |
+@ref nrf_mwu     |@tagRedCross  |@tagRedCross       |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_nfct    |@tagRedCross  |@tagRedCross       |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_nvmc    |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_pdm     |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_power   |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_ppi     |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_pwm     |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_qdec    |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_qspi    |@tagRedCross  |@tagRedCross       |@tagRedCross  |@tagGreenTick |@tagRedCross  |
+@ref nrf_radio   |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_rng     |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_rtc     |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_saadc   |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_spi     |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_spim    |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_spis    |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_spu     |@tagRedCross  |@tagRedCross       |@tagRedCross  |@tagRedCross  |@tagGreenTick |
+@ref nrf_systick |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_swi_egu |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_temp    |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_timer   |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_twi     |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_twim    |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_twis    |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_uart    |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagRedCross  |
+@ref nrf_uarte   |@tagRedCross  |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+@ref nrf_usbd    |@tagRedCross  |@tagRedCross       |@tagRedCross  |@tagGreenTick |@tagRedCross  |
+@ref nrf_vmc     |@tagRedCross  |@tagRedCross       |@tagRedCross  |@tagRedCross  |@tagGreenTick |
+@ref nrf_wdt     |@tagGreenTick |@tagGreenTick      |@tagGreenTick |@tagGreenTick |@tagGreenTick |
+
+@}
+*/

third_party/NordicSemiconductor/nrfx/doc/generate_html_doc.bat

@@ -1,2 +1,2 @@
-del html\*.* /Q
-doxygen nrfx.doxyfile
+del html\*.* /Q
+doxygen nrfx.doxyfile

third_party/NordicSemiconductor/nrfx/doc/main_page.dox

@@ -1,86 +1,89 @@
-/**
-@mainpage Introduction
-
-@em nrfx is an extract from the nRF5 SDK that contains solely the drivers for
-peripherals present in Nordic SoCs, for convenience complemented with the MDK
-package containing required structures and bitfields definitions, startup
-files etc.
-
-Refer to the @ref nrfx_drv_supp_matrix to check which drivers are suitable
-for a given SoC.
-
-@section nrfx_integration Integration
-
-The purpose of @em nrfx is to make it possible to use the same set of peripheral
-drivers in various environments, from RTOSes to bare metal applications.
-Hence, for a given host environment, a light integration layer must be provided
-that implements certain specific routines, like interrupt management, critical
-sections, assertions, or logging. This is done by filling a predefined set of
-macros with proper implementations (or keeping some empty if desired) in files
-named:
-- @ref nrfx_glue
-- @ref nrfx_log
-
-Templates of these files are provided
-in the <a href="../../templates/">templates</a> subfolder. Their customized
-versions can be placed in any location within the host environment that the
-used compiler can access via include paths.
-
-In addition, the following locations should be specified as include paths
-([nrfx] stands for the @em nrfx root folder location):
-@code
-[nrfx]/
-[nrfx]/drivers/include
-[nrfx]/mdk
-@endcode
-
-@section nrfx_irq_handlers IRQ handlers
-
-The IRQ handlers in all drivers are implemented as ordinary API functions
-named "nrfx_*_irq_handler". They can be bound to some structures or called in
-a specific way according to the requirements of the host environment.
-To install the handlers in the standard MDK way, you must only add the following
-line to the @ref nrfx_glue file:
-
-@code
-#include <soc/nrfx_irqs.h>
-@endcode
-
-This will cause the preprocessor to properly rename all the IRQ handler
-functions so that the linker could install them in the vector table.
-
-@section nrfx_configuration Configuration
-
-The drivers use both dynamic (run time) and static (compile time) configuration.
-
-Dynamic configuration is done by specifying desired options in configuration
-structures passed to the drivers during their initialization.
-Refer to the API reference for a given driver to see the members of its
-configuration structure.
-
-Static configuration allows enabling and disabling (excluding their code from
-compilation) particular drivers or in some cases their specific features,
-defining default parameters for dynamic configuration, parametrization of
-logging in particular drivers. It is done by specifying desired values of macros
-in a file named:
-
-- nrfx_config.h
-
-This file, similarly to the integration files mentioned above, can be placed
-in any suitable location within the host environment.
-The <a href="../../templates/">templates</a> subfolder contains templates of
-configuration files for all currently supported Nordic SoCs placed in respective
-subfolders.
-Refer to the "driver configuration" section in the API reference for a given
-driver for more information regarding configuration options available for it.
-
-@section nrfx_additional_reqs Additional requirements
-
-Nordic SoCs are based on ARM® Cortex™-M series processors. Before you can
-start developing with @em nrfx, you must add the CMSIS header files to include
-paths during the compilation process. Download these files from the following
-website:
-
--  <a href="https://github.com/ARM-software/CMSIS"> ARM® CMSIS repository</a>
-(CMSIS/Include directory)
-*/
+/**
+@mainpage Introduction
+
+@em nrfx is a standalone set of drivers for peripherals present in Nordic
+Semiconductor's SoCs. It originated as an extract from the nRF5 SDK.
+The intention was to provide drivers that can be used in various environments
+without the necessity to integrate other parts of the SDK into them.
+For the user's convenience, the drivers come with the MDK package. This package
+contains definitions of register structures and bitfields for all supported
+SoCs, as well as startup and initialization files for them.
+
+Refer to the @ref nrfx_drv_supp_matrix to check which drivers are suitable
+for a given SoC.
+
+@section nrfx_integration Integration
+
+The purpose of @em nrfx is to make it possible to use the same set of peripheral
+drivers in various environments, from RTOSes to bare metal applications.
+Hence, for a given host environment, a light integration layer must be provided
+that implements certain specific routines, like interrupt management, critical
+sections, assertions, or logging. This is done by filling a predefined set of
+macros with proper implementations (or keeping some empty if desired) in files
+named:
+- @ref nrfx_glue
+- @ref nrfx_log
+
+Templates of these files are provided
+in the <a href="../../templates/">templates</a> subfolder. Their customized
+versions can be placed in any location within the host environment that the
+used compiler can access via include paths.
+
+In addition, the following locations should be specified as include paths
+([nrfx] stands for the @em nrfx root folder location):
+@code
+[nrfx]/
+[nrfx]/drivers/include
+[nrfx]/mdk
+@endcode
+
+@section nrfx_irq_handlers IRQ handlers
+
+The IRQ handlers in all drivers are implemented as ordinary API functions
+named "nrfx_*_irq_handler". They can be bound to some structures or called in
+a specific way according to the requirements of the host environment.
+To install the handlers in the standard MDK way, you must only add the following
+line to the @ref nrfx_glue file:
+
+@code
+#include <soc/nrfx_irqs.h>
+@endcode
+
+This will cause the preprocessor to properly rename all the IRQ handler
+functions so that the linker could install them in the vector table.
+
+@section nrfx_configuration Configuration
+
+The drivers use both dynamic (run time) and static (compile time) configuration.
+
+Dynamic configuration is done by specifying desired options in configuration
+structures passed to the drivers during their initialization.
+Refer to the API reference for a given driver to see the members of its
+configuration structure.
+
+Static configuration allows enabling and disabling (excluding their code from
+compilation) particular drivers or in some cases their specific features,
+defining default parameters for dynamic configuration, parametrization of
+logging in particular drivers. It is done by specifying desired values of macros
+in a file named:
+
+- nrfx_config.h
+
+This file, similarly to the integration files mentioned above, can be placed
+in any suitable location within the host environment.
+The <a href="../../templates/">templates</a> subfolder contains templates of
+configuration files for all currently supported Nordic SoCs placed in respective
+subfolders.
+Refer to the "driver configuration" section in the API reference for a given
+driver for more information regarding configuration options available for it.
+
+@section nrfx_additional_reqs Additional requirements
+
+Nordic SoCs are based on ARM® Cortex™-M series processors. Before you can
+start developing with @em nrfx, you must add the CMSIS header files to include
+paths during the compilation process. Download these files from the following
+website:
+
+-  <a href="https://github.com/ARM-software/CMSIS"> ARM® CMSIS repository</a>
+(CMSIS/Include directory)
+*/

third_party/NordicSemiconductor/nrfx/doc/nrf51_series.dox

@@ -1,50 +1,52 @@
-/**
-@page nrf51_series_drivers nRF51 Series Drivers
-@{
-
-@ref nrf_adc
-
-@ref nrf_ccm
-
-@ref nrf_clock
-
-@ref nrf_ecb
-
-@ref nrf_gpio
-
-@ref nrf_gpiote
-
-@ref nrf_lpcomp
-
-@ref nrf_nvmc
-
-@ref nrf_power
-
-@ref nrf_ppi
-
-@ref nrf_qdec
-
-@ref nrf_radio
-
-@ref nrf_rng
-
-@ref nrf_rtc
-
-@ref nrf_spi
-
-@ref nrf_spis
-
-@ref nrf_swi_egu
-
-@ref nrf_temp
-
-@ref nrf_timer
-
-@ref nrf_twi
-
-@ref nrf_uart
-
-@ref nrf_wdt
-
-@}
-*/
+/**
+@page nrf51_series_drivers nRF51 Series Drivers
+@{
+
+@ref nrf_adc
+
+@ref nrf_ccm
+
+@ref nrf_clock
+
+@ref nrf_ecb
+
+@ref nrf_gpio
+
+@ref nrf_gpiote
+
+@ref nrf_lpcomp
+
+@ref nrf_mpu
+
+@ref nrf_nvmc
+
+@ref nrf_power
+
+@ref nrf_ppi
+
+@ref nrf_qdec
+
+@ref nrf_radio
+
+@ref nrf_rng
+
+@ref nrf_rtc
+
+@ref nrf_spi
+
+@ref nrf_spis
+
+@ref nrf_swi_egu
+
+@ref nrf_temp
+
+@ref nrf_timer
+
+@ref nrf_twi
+
+@ref nrf_uart
+
+@ref nrf_wdt
+
+@}
+*/

third_party/NordicSemiconductor/nrfx/doc/nrf52810.dox

@@ -1,58 +1,66 @@
-/**
-@page nrf52810_drivers nRF52810 Drivers
-@{
-
-@ref nrf_ccm
-
-@ref nrf_clock
-
-@ref nrf_comp
-
-@ref nrf_ecb
-
-@ref nrf_gpio
-
-@ref nrf_gpiote
-
-@ref nrf_nvmc
-
-@ref nrf_pdm
-
-@ref nrf_power
-
-@ref nrf_ppi
-
-@ref nrf_pwm
-
-@ref nrf_qdec
-
-@ref nrf_radio
-
-@ref nrf_rng
-
-@ref nrf_rtc
-
-@ref nrf_saadc
-
-@ref nrf_spim
-
-@ref nrf_spis
-
-@ref nrf_systick
-
-@ref nrf_swi_egu
-
-@ref nrf_temp
-
-@ref nrf_timer
-
-@ref nrf_twim
-
-@ref nrf_twis
-
-@ref nrf_uarte
-
-@ref nrf_wdt
-
-@}
-*/
+/**
+@page nrf52810_drivers nRF52810/nRF52811 Drivers
+@{
+
+@ref nrf_bprot
+
+@ref nrf_ccm
+
+@ref nrf_clock
+
+@ref nrf_comp
+
+@ref nrf_ecb
+
+@ref nrf_gpio
+
+@ref nrf_gpiote
+
+@ref nrf_nvmc
+
+@ref nrf_pdm
+
+@ref nrf_power
+
+@ref nrf_ppi
+
+@ref nrf_pwm
+
+@ref nrf_qdec
+
+@ref nrf_radio
+
+@ref nrf_rng
+
+@ref nrf_rtc
+
+@ref nrf_saadc
+
+@ref nrf_spi
+
+@ref nrf_spim
+
+@ref nrf_spis
+
+@ref nrf_systick
+
+@ref nrf_swi_egu
+
+@ref nrf_temp
+
+@ref nrf_timer
+
+@ref nrf_twi
+
+@ref nrf_twim
+
+@ref nrf_twis
+
+@ref nrf_uart
+
+@ref nrf_uarte
+
+@ref nrf_wdt
+
+@}
+*/

third_party/NordicSemiconductor/nrfx/doc/nrf52832.dox

@@ -1,68 +1,74 @@
-/**
-@page nrf52832_drivers nRF52832 Drivers
-@{
-
-@ref nrf_ccm
-
-@ref nrf_clock
-
-@ref nrf_comp
-
-@ref nrf_ecb
-
-@ref nrf_gpio
-
-@ref nrf_gpiote
-
-@ref nrf_i2s
-
-@ref nrf_lpcomp
-
-@ref nrf_nvmc
-
-@ref nrf_pdm
-
-@ref nrf_power
-
-@ref nrf_ppi
-
-@ref nrf_pwm
-
-@ref nrf_qdec
-
-@ref nrf_radio
-
-@ref nrf_rng
-
-@ref nrf_rtc
-
-@ref nrf_saadc
-
-@ref nrf_spi
-
-@ref nrf_spim
-
-@ref nrf_spis
-
-@ref nrf_systick
-
-@ref nrf_swi_egu
-
-@ref nrf_temp
-
-@ref nrf_timer
-
-@ref nrf_twi
-
-@ref nrf_twim
-
-@ref nrf_twis
-
-@ref nrf_uart
-
-@ref nrf_uarte
-
-@ref nrf_wdt
-
-@}
-*/
+/**
+@page nrf52832_drivers nRF52832 Drivers
+@{
+
+@ref nrf_bprot
+
+@ref nrf_ccm
+
+@ref nrf_clock
+
+@ref nrf_comp
+
+@ref nrf_ecb
+
+@ref nrf_gpio
+
+@ref nrf_gpiote
+
+@ref nrf_i2s
+
+@ref nrf_lpcomp
+
+@ref nrf_mwu
+
+@ref nrf_nfct
+
+@ref nrf_nvmc
+
+@ref nrf_pdm
+
+@ref nrf_power
+
+@ref nrf_ppi
+
+@ref nrf_pwm
+
+@ref nrf_qdec
+
+@ref nrf_radio
+
+@ref nrf_rng
+
+@ref nrf_rtc
+
+@ref nrf_saadc
+
+@ref nrf_spi
+
+@ref nrf_spim
+
+@ref nrf_spis
+
+@ref nrf_systick
+
+@ref nrf_swi_egu
+
+@ref nrf_temp
+
+@ref nrf_timer
+
+@ref nrf_twi
+
+@ref nrf_twim
+
+@ref nrf_twis
+
+@ref nrf_uart
+
+@ref nrf_uarte
+
+@ref nrf_wdt
+
+@}
+*/

third_party/NordicSemiconductor/nrfx/doc/nrf52840.dox

@@ -1,72 +1,78 @@
-/**
-@page nrf52840_drivers nRF52840 Drivers
-@{
-
-@ref nrf_ccm
-
-@ref nrf_clock
-
-@ref nrf_comp
-
-@ref nrf_ecb
-
-@ref nrf_gpio
-
-@ref nrf_gpiote
-
-@ref nrf_i2s
-
-@ref nrf_lpcomp
-
-@ref nrf_nvmc
-
-@ref nrf_pdm
-
-@ref nrf_power
-
-@ref nrf_ppi
-
-@ref nrf_pwm
-
-@ref nrf_qdec
-
-@ref nrf_qspi
-
-@ref nrf_radio
-
-@ref nrf_rng
-
-@ref nrf_rtc
-
-@ref nrf_saadc
-
-@ref nrf_spi
-
-@ref nrf_spim
-
-@ref nrf_spis
-
-@ref nrf_systick
-
-@ref nrf_swi_egu
-
-@ref nrf_temp
-
-@ref nrf_timer
-
-@ref nrf_twi
-
-@ref nrf_twim
-
-@ref nrf_twis
-
-@ref nrf_uart
-
-@ref nrf_uarte
-
-@ref nrf_usbd
-
-@ref nrf_wdt
-
-@}
-*/
+/**
+@page nrf52840_drivers nRF52840 Drivers
+@{
+
+@ref nrf_acl
+
+@ref nrf_ccm
+
+@ref nrf_clock
+
+@ref nrf_comp
+
+@ref nrf_ecb
+
+@ref nrf_gpio
+
+@ref nrf_gpiote
+
+@ref nrf_i2s
+
+@ref nrf_lpcomp
+
+@ref nrf_mwu
+
+@ref nrf_nfct
+
+@ref nrf_nvmc
+
+@ref nrf_pdm
+
+@ref nrf_power
+
+@ref nrf_ppi
+
+@ref nrf_pwm
+
+@ref nrf_qdec
+
+@ref nrf_qspi
+
+@ref nrf_radio
+
+@ref nrf_rng
+
+@ref nrf_rtc
+
+@ref nrf_saadc
+
+@ref nrf_spi
+
+@ref nrf_spim
+
+@ref nrf_spis
+
+@ref nrf_systick
+
+@ref nrf_swi_egu
+
+@ref nrf_temp
+
+@ref nrf_timer
+
+@ref nrf_twi
+
+@ref nrf_twim
+
+@ref nrf_twis
+
+@ref nrf_uart
+
+@ref nrf_uarte
+
+@ref nrf_usbd
+
+@ref nrf_wdt
+
+@}
+*/

third_party/NordicSemiconductor/nrfx/doc/nrf9160.dox

@@ -0,0 +1,50 @@
+/**
+@page nrf9160_drivers nRF9160 drivers
+@{
+
+@ref nrf_clock
+
+@ref nrf_systick
+
+@ref nrf_dppi
+
+@ref nrf_gpio
+
+@ref nrf_gpiote
+
+@ref nrf_i2s
+
+@ref nrf_kmu
+
+@ref nrf_pdm
+
+@ref nrf_power
+
+@ref nrf_pwm
+
+@ref nrf_rtc
+
+@ref nrf_saadc
+
+@ref nrf_spim
+
+@ref nrf_spis
+
+@ref nrf_spu
+
+@ref nrf_swi_egu
+
+@ref nrf_timer
+
+@ref nrf_twim
+
+@ref nrf_twis
+
+@ref nrf_uarte
+
+@ref nrf_vmc
+
+@ref nrf_wdt
+
+@}
+*/

third_party/NordicSemiconductor/nrfx/doc/nrfx_api.dox

@@ -1,75 +1,93 @@
-/**
-@defgroup nrfx_drivers Drivers
-@{
-@brief List of all drivers available in nrfx.
-@defgroup nrf_adc ADC
-
-@defgroup nrf_ccm CCM
-
-@defgroup nrf_clock CLOCK
-
-@defgroup nrf_comp COMP
-
-@defgroup nrf_ecb ECB
-
-@defgroup nrf_gpio GPIO
-
-@defgroup nrf_gpiote GPIOTE
-
-@defgroup nrf_i2s I2S
-
-@defgroup nrf_lpcomp LPCOMP
-
-@defgroup nrf_nvmc NVMC
-
-@defgroup nrf_pdm PDM
-
-@defgroup nrf_power POWER
-
-@defgroup nrf_ppi PPI
-
-@defgroup nrf_pwm PWM
-
-@defgroup nrf_qdec QDEC
-
-@defgroup nrf_qspi QSPI
-
-@defgroup nrf_radio RADIO
-
-@defgroup nrf_rng RNG
-
-@defgroup nrf_rtc RTC
-
-@defgroup nrf_saadc SAADC
-
-@defgroup nrf_spi SPI
-
-@defgroup nrf_spim SPIM
-
-@defgroup nrf_spis SPIS
-
-@defgroup nrf_systick Cortex-M Systick
-
-@defgroup nrf_swi_egu SWI/EGU
-
-@defgroup nrf_temp TEMP
-
-@defgroup nrf_timer TIMER
-
-@defgroup nrf_twi TWI
-
-@defgroup nrf_twim TWIM
-
-@defgroup nrf_twis TWIS
-
-@defgroup nrf_uart UART
-
-@defgroup nrf_uarte UARTE
-
-@defgroup nrf_usbd USBD
-
-@defgroup nrf_wdt WDT
-@}
-
-@defgroup nrfx nrfx API
-*/
+/**
+@defgroup nrfx_drivers Drivers
+@{
+@brief List of all drivers available in nrfx.
+@defgroup nrf_adc ADC
+
+@defgroup nrf_acl ACL
+
+@defgroup nrf_bprot BPROT
+
+@defgroup nrf_ccm CCM
+
+@defgroup nrf_clock CLOCK
+
+@defgroup nrf_comp COMP
+
+@defgroup nrf_dppi DPPI
+
+@defgroup nrf_ecb ECB
+
+@defgroup nrf_gpio GPIO
+
+@defgroup nrf_gpiote GPIOTE
+
+@defgroup nrf_i2s I2S
+
+@defgroup nrf_kmu KMU
+
+@defgroup nrf_lpcomp LPCOMP
+
+@defgroup nrf_mpu MPU
+
+@defgroup nrf_mwu MWU
+
+@defgroup nrf_nfct NFCT
+
+@defgroup nrf_nvmc NVMC
+
+@defgroup nrf_pdm PDM
+
+@defgroup nrf_power POWER
+
+@defgroup nrf_ppi PPI
+
+@defgroup nrf_pwm PWM
+
+@defgroup nrf_qdec QDEC
+
+@defgroup nrf_qspi QSPI
+
+@defgroup nrf_radio RADIO
+
+@defgroup nrf_rng RNG
+
+@defgroup nrf_rtc RTC
+
+@defgroup nrf_saadc SAADC
+
+@defgroup nrf_spi SPI
+
+@defgroup nrf_spim SPIM
+
+@defgroup nrf_spis SPIS
+
+@defgroup nrf_spu SPU
+
+@defgroup nrf_systick Cortex-M Systick
+
+@defgroup nrf_swi_egu SWI/EGU
+
+@defgroup nrf_temp TEMP
+
+@defgroup nrf_timer TIMER
+
+@defgroup nrf_twi TWI
+
+@defgroup nrf_twim TWIM
+
+@defgroup nrf_twis TWIS
+
+@defgroup nrf_uart UART
+
+@defgroup nrf_uarte UARTE
+
+@defgroup nrf_usbd USBD
+
+@defgroup nrf_vmc VMC
+
+@defgroup nrf_wdt WDT
+@}
+
+@defgroup nrfx nrfx API
+*/

third_party/NordicSemiconductor/nrfx/drivers/include/nrf_bitmask.h

@@ -1,156 +1,147 @@
-/**
- * Copyright (c) 2016 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRF_BITMASK_H
-#define NRF_BITMASK_H
-
-#include <nrfx.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrf_bitmask Bitmask module
- * @{
- * @ingroup nrfx
- * @brief   Bitmask managing module.
- */
-
-#define BITMASK_BYTE_GET(abs_bit) ((abs_bit)/8)
-#define BITMASK_RELBIT_GET(abs_bit) ((abs_bit) & 0x00000007)
-
-/**
- * Function for checking if bit in the multi-byte bit mask is set.
- *
- * @param bit    Bit index.
- * @param p_mask A pointer to mask with bit fields.
- *
- * @return 0 if bit is not set, positive value otherwise.
- */
-__STATIC_INLINE uint32_t nrf_bitmask_bit_is_set(uint32_t bit, void const * p_mask)
-{
-    uint8_t const * p_mask8 = (uint8_t const *)p_mask;
-    uint32_t byte_idx = BITMASK_BYTE_GET(bit);
-    bit = BITMASK_RELBIT_GET(bit);
-    return (1 << bit) & p_mask8[byte_idx];
-}
-
-/**
- * Function for setting a bit in the multi-byte bit mask.
- *
- * @param bit    Bit index.
- * @param p_mask A pointer to mask with bit fields.
- */
-__STATIC_INLINE void nrf_bitmask_bit_set(uint32_t bit, void * p_mask)
-{
-    uint8_t * p_mask8 = (uint8_t *)p_mask;
-    uint32_t byte_idx = BITMASK_BYTE_GET(bit);
-    bit = BITMASK_RELBIT_GET(bit);
-    p_mask8[byte_idx] |= (1 << bit);
-}
-
-/**
- * Function for clearing a bit in the multi-byte bit mask.
- *
- * @param bit    Bit index.
- * @param p_mask A pointer to mask with bit fields.
- */
-__STATIC_INLINE void nrf_bitmask_bit_clear(uint32_t bit, void * p_mask)
-{
-    uint8_t * p_mask8 = (uint8_t *)p_mask;
-    uint32_t byte_idx = BITMASK_BYTE_GET(bit);
-    bit = BITMASK_RELBIT_GET(bit);
-    p_mask8[byte_idx] &= ~(1 << bit);
-}
-
-/**
- * Function for performing bitwise OR operation on two multi-byte bit masks.
- *
- * @param p_mask1    A pointer to the first bit mask.
- * @param p_mask2    A pointer to the second bit mask.
- * @param p_out_mask A pointer to the output bit mask.
- * @param length     Length of output mask in bytes.
- */
-__STATIC_INLINE void nrf_bitmask_masks_or(void const *   p_mask1,
-                                          void const *   p_mask2,
-                                          void *         p_out_mask,
-                                          uint32_t       length)
-{
-    uint8_t const * p_mask8_1 = (uint8_t const *)p_mask1;
-    uint8_t const * p_mask8_2 = (uint8_t const *)p_mask2;
-    uint8_t * p_mask8_out = (uint8_t *)p_out_mask;
-    uint32_t i;
-    for (i = 0; i < length; i++)
-    {
-        p_mask8_out[i] = p_mask8_1[i] | p_mask8_2[i];
-    }
-}
-
-/**
- * Function for performing bitwise AND operation on two multi-byte bit masks.
- *
- * @param p_mask1    A pointer to the first bit mask.
- * @param p_mask2    A pointer to the second bit mask.
- * @param p_out_mask A pointer to the output bit mask.
- * @param length     Length of output mask in bytes.
- */
-__STATIC_INLINE void nrf_bitmask_masks_and(void const *   p_mask1,
-                                           void const *   p_mask2,
-                                           void *         p_out_mask,
-                                           uint32_t       length)
-{
-    uint8_t const * p_mask8_1 = (uint8_t const *)p_mask1;
-    uint8_t const * p_mask8_2 = (uint8_t const *)p_mask2;
-    uint8_t * p_mask8_out = (uint8_t *)p_out_mask;
-    uint32_t i;
-    for (i = 0; i < length; i++)
-    {
-        p_mask8_out[i] = p_mask8_1[i] & p_mask8_2[i];
-    }
-}
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRF_BITMASK_H
+/*
+ * Copyright (c) 2016 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRF_BITMASK_H
+#define NRF_BITMASK_H
+
+#include <nrfx.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrf_bitmask Bitmask module
+ * @{
+ * @ingroup nrfx
+ * @brief   Bitmask managing module.
+ */
+
+#define BITMASK_BYTE_GET(abs_bit) ((abs_bit)/8)
+#define BITMASK_RELBIT_GET(abs_bit) ((abs_bit) & 0x00000007)
+
+/**
+ * Function for checking if bit in the multi-byte bit mask is set.
+ *
+ * @param bit    Bit index.
+ * @param p_mask A pointer to mask with bit fields.
+ *
+ * @return 0 if bit is not set, positive value otherwise.
+ */
+__STATIC_INLINE uint32_t nrf_bitmask_bit_is_set(uint32_t bit, void const * p_mask)
+{
+    uint8_t const * p_mask8 = (uint8_t const *)p_mask;
+    uint32_t byte_idx = BITMASK_BYTE_GET(bit);
+    bit = BITMASK_RELBIT_GET(bit);
+    return (1 << bit) & p_mask8[byte_idx];
+}
+
+/**
+ * Function for setting a bit in the multi-byte bit mask.
+ *
+ * @param bit    Bit index.
+ * @param p_mask A pointer to mask with bit fields.
+ */
+__STATIC_INLINE void nrf_bitmask_bit_set(uint32_t bit, void * p_mask)
+{
+    uint8_t * p_mask8 = (uint8_t *)p_mask;
+    uint32_t byte_idx = BITMASK_BYTE_GET(bit);
+    bit = BITMASK_RELBIT_GET(bit);
+    p_mask8[byte_idx] |= (1 << bit);
+}
+
+/**
+ * Function for clearing a bit in the multi-byte bit mask.
+ *
+ * @param bit    Bit index.
+ * @param p_mask A pointer to mask with bit fields.
+ */
+__STATIC_INLINE void nrf_bitmask_bit_clear(uint32_t bit, void * p_mask)
+{
+    uint8_t * p_mask8 = (uint8_t *)p_mask;
+    uint32_t byte_idx = BITMASK_BYTE_GET(bit);
+    bit = BITMASK_RELBIT_GET(bit);
+    p_mask8[byte_idx] &= ~(1 << bit);
+}
+
+/**
+ * Function for performing bitwise OR operation on two multi-byte bit masks.
+ *
+ * @param p_mask1    A pointer to the first bit mask.
+ * @param p_mask2    A pointer to the second bit mask.
+ * @param p_out_mask A pointer to the output bit mask.
+ * @param length     Length of output mask in bytes.
+ */
+__STATIC_INLINE void nrf_bitmask_masks_or(void const *   p_mask1,
+                                          void const *   p_mask2,
+                                          void *         p_out_mask,
+                                          uint32_t       length)
+{
+    uint8_t const * p_mask8_1 = (uint8_t const *)p_mask1;
+    uint8_t const * p_mask8_2 = (uint8_t const *)p_mask2;
+    uint8_t * p_mask8_out = (uint8_t *)p_out_mask;
+    uint32_t i;
+    for (i = 0; i < length; i++)
+    {
+        p_mask8_out[i] = p_mask8_1[i] | p_mask8_2[i];
+    }
+}
+
+/**
+ * Function for performing bitwise AND operation on two multi-byte bit masks.
+ *
+ * @param p_mask1    A pointer to the first bit mask.
+ * @param p_mask2    A pointer to the second bit mask.
+ * @param p_out_mask A pointer to the output bit mask.
+ * @param length     Length of output mask in bytes.
+ */
+__STATIC_INLINE void nrf_bitmask_masks_and(void const *   p_mask1,
+                                           void const *   p_mask2,
+                                           void *         p_out_mask,
+                                           uint32_t       length)
+{
+    uint8_t const * p_mask8_1 = (uint8_t const *)p_mask1;
+    uint8_t const * p_mask8_2 = (uint8_t const *)p_mask2;
+    uint8_t * p_mask8_out = (uint8_t *)p_out_mask;
+    uint32_t i;
+    for (i = 0; i < length; i++)
+    {
+        p_mask8_out[i] = p_mask8_1[i] & p_mask8_2[i];
+    }
+}
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRF_BITMASK_H

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_adc.h

@@ -1,295 +1,286 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_ADC_H__
-#define NRFX_ADC_H__
-
-#include <nrfx.h>
-#include <hal/nrf_adc.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_adc ADC driver
- * @{
- * @ingroup nrf_adc
- * @brief   Analog-to-Digital Converter (ADC) peripheral driver.
- */
-
-/**
- * @brief Driver event types.
- */
-typedef enum
-{
-    NRFX_ADC_EVT_DONE,    ///< Event generated when the buffer is filled with samples.
-    NRFX_ADC_EVT_SAMPLE,  ///< Event generated when the requested channel is sampled.
-} nrfx_adc_evt_type_t;
-
-/**
- * @brief Analog-to-digital converter driver DONE event.
- */
-typedef struct
-{
-    nrf_adc_value_t * p_buffer; ///< Pointer to the buffer with converted samples.
-    uint16_t          size;     ///< Number of samples in the buffer.
-} nrfx_adc_done_evt_t;
-
-/**
- * @brief Analog-to-digital converter driver SAMPLE event.
- */
-typedef struct
-{
-    nrf_adc_value_t   sample; ///< Converted sample.
-} nrfx_adc_sample_evt_t;
-
-/**
- * @brief Analog-to-digital converter driver event.
- */
-typedef struct
-{
-    nrfx_adc_evt_type_t type;  ///< Event type.
-    union
-    {
-        nrfx_adc_done_evt_t   done;   ///< Data for DONE event.
-        nrfx_adc_sample_evt_t sample; ///< Data for SAMPLE event.
-    } data;
-} nrfx_adc_evt_t;
-
-/**@brief Macro for initializing the ADC channel with the default configuration. */
-#define NRFX_ADC_DEFAULT_CHANNEL(analog_input)                 \
- {                                                             \
-     NULL,                                                     \
-     {                                                         \
-        .resolution = NRF_ADC_CONFIG_RES_10BIT,                \
-        .scaling    = NRF_ADC_CONFIG_SCALING_INPUT_FULL_SCALE, \
-        .reference  = NRF_ADC_CONFIG_REF_VBG,                  \
-        .input      = (analog_input),                          \
-        .extref     = NRF_ADC_CONFIG_EXTREFSEL_NONE            \
-     }                                                         \
- }
-
-// Forward declaration of the nrfx_adc_channel_t type.
-typedef struct nrfx_adc_channel_s nrfx_adc_channel_t;
-
-/**
- * @brief ADC channel.
- *
- * This structure is defined by the user and used by the driver. Therefore, it should
- * not be defined on the stack as a local variable.
- */
-struct nrfx_adc_channel_s
-{
-    nrfx_adc_channel_t * p_next; ///< Pointer to the next enabled channel (for internal use).
-    nrf_adc_config_t     config; ///< ADC configuration for the current channel.
-};
-
-/**
- * @brief ADC configuration.
- */
-typedef struct
-{
-    uint8_t interrupt_priority; ///< Priority of ADC interrupt.
-} nrfx_adc_config_t;
-
-/** @brief ADC default configuration. */
-#define NRFX_ADC_DEFAULT_CONFIG                        \
-{                                                      \
-    .interrupt_priority = NRFX_ADC_CONFIG_IRQ_PRIORITY \
-}
-
-/**
- * @brief User event handler prototype.
- *
- * This function is called when the requested number of samples has been processed.
- *
- * @param p_event Event.
- */
-typedef void (*nrfx_adc_event_handler_t)(nrfx_adc_evt_t const * p_event);
-
-/**
- * @brief Function for initializing the ADC.
- *
- * If a valid event handler is provided, the driver is initialized in non-blocking mode.
- * If event_handler is NULL, the driver works in blocking mode.
- *
- * @param[in] p_config      Pointer to the structure with initial configuration.
- * @param[in] event_handler Event handler provided by the user.
- *
- * @retval    NRFX_SUCCESS If initialization was successful.
- * @retval    NRFX_ERROR_INVALID_STATE If the driver is already initialized.
- */
-nrfx_err_t nrfx_adc_init(nrfx_adc_config_t const * p_config,
-                         nrfx_adc_event_handler_t  event_handler);
-
-/**
- * @brief Function for uninitializing the ADC.
- *
- * This function stops all ongoing conversions and disables all channels.
- */
-void nrfx_adc_uninit(void);
-
-/**
- * @brief Function for enabling an ADC channel.
- *
- * This function configures and enables the channel. When @ref nrfx_adc_buffer_convert is
- * called, all channels that have been enabled with this function are sampled.
- *
- * This function can be called only when there is no conversion in progress
- * (the ADC is not busy).
- *
- * @note The channel instance variable @p p_channel is used by the driver as an item
- *       in a list. Therefore, it cannot be an automatic variable that is located on the stack.
- */
-void nrfx_adc_channel_enable(nrfx_adc_channel_t * const p_channel);
-
-/**
- * @brief Function for disabling an ADC channel.
- *
- * This function can be called only when there is no conversion in progress
- * (the ADC is not busy).
- */
-void nrfx_adc_channel_disable(nrfx_adc_channel_t * const p_channel);
-
-/**
- * @brief Function for disabling all ADC channels.
- *
- * This function can be called only when there is no conversion in progress
- * (the ADC is not busy).
- */
-void nrfx_adc_all_channels_disable(void);
-
-/**
- * @brief Function for starting ADC sampling.
- *
- * This function triggers single ADC sampling. If more than one channel is enabled, the driver
- * emulates scanning and all channels are sampled in the order they were enabled.
- */
-void nrfx_adc_sample(void);
-
-/**
- * @brief Function for executing a single ADC conversion.
- *
- * This function selects the desired input and starts a single conversion. If a valid pointer
- * is provided for the result, the function blocks until the conversion is completed. Otherwise, the
- * function returns when the conversion is started, and the result is provided in an event (driver
- * must be initialized in non-blocking mode, otherwise an assertion will fail). The function will
- * fail if ADC is busy. The channel does not need to be enabled to perform a single conversion.
- *
- * @param[in]  p_channel Channel.
- * @param[out] p_value   Pointer to the location where the result should be placed. Unless NULL is
- *                       provided, the function is blocking.
- *
- * @retval NRFX_SUCCESS    If conversion was successful.
- * @retval NRFX_ERROR_BUSY If the ADC driver is busy.
- */
-nrfx_err_t nrfx_adc_sample_convert(nrfx_adc_channel_t const * const p_channel,
-                                   nrf_adc_value_t                * p_value);
-
-/**
- * @brief Function for converting data to the buffer.
- *
- * If the driver is initialized in non-blocking mode, this function returns when the first
- * conversion is set up. When the buffer is filled, the application is notified by the event
- * handler. If the driver is initialized in blocking mode, the function returns when the buffer is
- * filled.
- *
- * Conversion is done on all enabled channels, but it is not triggered by this
- * function. This function will prepare the ADC for sampling and then
- * wait for the SAMPLE task. Sampling can be triggered manually by the @ref
- * nrfx_adc_sample function or by PPI using the @ref NRF_ADC_TASK_START task.
- *
- * @note If more than one channel is enabled, the function emulates scanning, and
- * a single START task will trigger conversion on all enabled channels. For example:
- * If 3 channels are enabled and the user requests 6 samples, the completion event
- * handler will be called after 2 START tasks.
- *
- * @note The application must adjust the sampling frequency. The maximum frequency
- * depends on the sampling timer and the maximum latency of the ADC interrupt. If
- * an interrupt is not handled before the next sampling is triggered, the sample
- * will be lost.
- *
- * @param[in] buffer Result buffer.
- * @param[in] size   Buffer size in samples.
- *
- * @retval NRFX_SUCCESS    If conversion was successful.
- * @retval NRFX_ERROR_BUSY If the driver is busy.
- */
-nrfx_err_t nrfx_adc_buffer_convert(nrf_adc_value_t * buffer, uint16_t size);
-
-/**
- * @brief Function for retrieving the ADC state.
- *
- * @retval true  If the ADC is busy.
- * @retval false If the ADC is ready.
- */
-bool nrfx_adc_is_busy(void);
-
-/**
- * @brief Function for getting the address of the ADC START task.
- *
- * This function is used to get the address of the START task, which can be used to trigger ADC
- * conversion.
- *
- * @return Start task address.
- */
-__STATIC_INLINE uint32_t nrfx_adc_start_task_get(void);
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-
-__STATIC_INLINE uint32_t nrfx_adc_start_task_get(void)
-{
-    return nrf_adc_task_address_get(NRF_ADC_TASK_START);
-}
-
-#endif
-
-
-void nrfx_adc_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_ADC_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_ADC_H__
+#define NRFX_ADC_H__
+
+#include <nrfx.h>
+#include <hal/nrf_adc.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_adc ADC driver
+ * @{
+ * @ingroup nrf_adc
+ * @brief   Analog-to-Digital Converter (ADC) peripheral driver.
+ */
+
+/**
+ * @brief Driver event types.
+ */
+typedef enum
+{
+    NRFX_ADC_EVT_DONE,    ///< Event generated when the buffer is filled with samples.
+    NRFX_ADC_EVT_SAMPLE,  ///< Event generated when the requested channel is sampled.
+} nrfx_adc_evt_type_t;
+
+/**
+ * @brief Analog-to-digital converter driver DONE event.
+ */
+typedef struct
+{
+    nrf_adc_value_t * p_buffer; ///< Pointer to the buffer with converted samples.
+    uint16_t          size;     ///< Number of samples in the buffer.
+} nrfx_adc_done_evt_t;
+
+/**
+ * @brief Analog-to-digital converter driver SAMPLE event.
+ */
+typedef struct
+{
+    nrf_adc_value_t   sample; ///< Converted sample.
+} nrfx_adc_sample_evt_t;
+
+/**
+ * @brief Analog-to-digital converter driver event.
+ */
+typedef struct
+{
+    nrfx_adc_evt_type_t type;  ///< Event type.
+    union
+    {
+        nrfx_adc_done_evt_t   done;   ///< Data for DONE event.
+        nrfx_adc_sample_evt_t sample; ///< Data for SAMPLE event.
+    } data;
+} nrfx_adc_evt_t;
+
+/**@brief Macro for initializing the ADC channel with the default configuration. */
+#define NRFX_ADC_DEFAULT_CHANNEL(analog_input)                 \
+ {                                                             \
+     NULL,                                                     \
+     {                                                         \
+        .resolution = NRF_ADC_CONFIG_RES_10BIT,                \
+        .scaling    = NRF_ADC_CONFIG_SCALING_INPUT_FULL_SCALE, \
+        .reference  = NRF_ADC_CONFIG_REF_VBG,                  \
+        .input      = (analog_input),                          \
+        .extref     = NRF_ADC_CONFIG_EXTREFSEL_NONE            \
+     }                                                         \
+ }
+
+// Forward declaration of the nrfx_adc_channel_t type.
+typedef struct nrfx_adc_channel_s nrfx_adc_channel_t;
+
+/**
+ * @brief ADC channel.
+ *
+ * This structure is defined by the user and used by the driver. Therefore, it should
+ * not be defined on the stack as a local variable.
+ */
+struct nrfx_adc_channel_s
+{
+    nrfx_adc_channel_t * p_next; ///< Pointer to the next enabled channel (for internal use).
+    nrf_adc_config_t     config; ///< ADC configuration for the current channel.
+};
+
+/**
+ * @brief ADC configuration.
+ */
+typedef struct
+{
+    uint8_t interrupt_priority; ///< Priority of ADC interrupt.
+} nrfx_adc_config_t;
+
+/** @brief ADC default configuration. */
+#define NRFX_ADC_DEFAULT_CONFIG                        \
+{                                                      \
+    .interrupt_priority = NRFX_ADC_CONFIG_IRQ_PRIORITY \
+}
+
+/**
+ * @brief User event handler prototype.
+ *
+ * This function is called when the requested number of samples has been processed.
+ *
+ * @param p_event Event.
+ */
+typedef void (*nrfx_adc_event_handler_t)(nrfx_adc_evt_t const * p_event);
+
+/**
+ * @brief Function for initializing the ADC.
+ *
+ * If a valid event handler is provided, the driver is initialized in non-blocking mode.
+ * If event_handler is NULL, the driver works in blocking mode.
+ *
+ * @param[in] p_config      Pointer to the structure with initial configuration.
+ * @param[in] event_handler Event handler provided by the user.
+ *
+ * @retval    NRFX_SUCCESS If initialization was successful.
+ * @retval    NRFX_ERROR_INVALID_STATE If the driver is already initialized.
+ */
+nrfx_err_t nrfx_adc_init(nrfx_adc_config_t const * p_config,
+                         nrfx_adc_event_handler_t  event_handler);
+
+/**
+ * @brief Function for uninitializing the ADC.
+ *
+ * This function stops all ongoing conversions and disables all channels.
+ */
+void nrfx_adc_uninit(void);
+
+/**
+ * @brief Function for enabling an ADC channel.
+ *
+ * This function configures and enables the channel. When @ref nrfx_adc_buffer_convert is
+ * called, all channels that have been enabled with this function are sampled.
+ *
+ * This function can be called only when there is no conversion in progress
+ * (the ADC is not busy).
+ *
+ * @note The channel instance variable @p p_channel is used by the driver as an item
+ *       in a list. Therefore, it cannot be an automatic variable that is located on the stack.
+ */
+void nrfx_adc_channel_enable(nrfx_adc_channel_t * const p_channel);
+
+/**
+ * @brief Function for disabling an ADC channel.
+ *
+ * This function can be called only when there is no conversion in progress
+ * (the ADC is not busy).
+ */
+void nrfx_adc_channel_disable(nrfx_adc_channel_t * const p_channel);
+
+/**
+ * @brief Function for disabling all ADC channels.
+ *
+ * This function can be called only when there is no conversion in progress
+ * (the ADC is not busy).
+ */
+void nrfx_adc_all_channels_disable(void);
+
+/**
+ * @brief Function for starting ADC sampling.
+ *
+ * This function triggers single ADC sampling. If more than one channel is enabled, the driver
+ * emulates scanning and all channels are sampled in the order they were enabled.
+ */
+void nrfx_adc_sample(void);
+
+/**
+ * @brief Function for executing a single ADC conversion.
+ *
+ * This function selects the desired input and starts a single conversion. If a valid pointer
+ * is provided for the result, the function blocks until the conversion is completed. Otherwise, the
+ * function returns when the conversion is started, and the result is provided in an event (driver
+ * must be initialized in non-blocking mode, otherwise an assertion will fail). The function will
+ * fail if ADC is busy. The channel does not need to be enabled to perform a single conversion.
+ *
+ * @param[in]  p_channel Channel.
+ * @param[out] p_value   Pointer to the location where the result should be placed. Unless NULL is
+ *                       provided, the function is blocking.
+ *
+ * @retval NRFX_SUCCESS    If conversion was successful.
+ * @retval NRFX_ERROR_BUSY If the ADC driver is busy.
+ */
+nrfx_err_t nrfx_adc_sample_convert(nrfx_adc_channel_t const * const p_channel,
+                                   nrf_adc_value_t                * p_value);
+
+/**
+ * @brief Function for converting data to the buffer.
+ *
+ * If the driver is initialized in non-blocking mode, this function returns when the first
+ * conversion is set up. When the buffer is filled, the application is notified by the event
+ * handler. If the driver is initialized in blocking mode, the function returns when the buffer is
+ * filled.
+ *
+ * Conversion is done on all enabled channels, but it is not triggered by this
+ * function. This function will prepare the ADC for sampling and then
+ * wait for the SAMPLE task. Sampling can be triggered manually by the @ref
+ * nrfx_adc_sample function or by PPI using the @ref NRF_ADC_TASK_START task.
+ *
+ * @note If more than one channel is enabled, the function emulates scanning, and
+ * a single START task will trigger conversion on all enabled channels. For example:
+ * If 3 channels are enabled and the user requests 6 samples, the completion event
+ * handler will be called after 2 START tasks.
+ *
+ * @note The application must adjust the sampling frequency. The maximum frequency
+ * depends on the sampling timer and the maximum latency of the ADC interrupt. If
+ * an interrupt is not handled before the next sampling is triggered, the sample
+ * will be lost.
+ *
+ * @param[in] buffer Result buffer.
+ * @param[in] size   Buffer size in samples.
+ *
+ * @retval NRFX_SUCCESS    If conversion was successful.
+ * @retval NRFX_ERROR_BUSY If the driver is busy.
+ */
+nrfx_err_t nrfx_adc_buffer_convert(nrf_adc_value_t * buffer, uint16_t size);
+
+/**
+ * @brief Function for retrieving the ADC state.
+ *
+ * @retval true  If the ADC is busy.
+ * @retval false If the ADC is ready.
+ */
+bool nrfx_adc_is_busy(void);
+
+/**
+ * @brief Function for getting the address of the ADC START task.
+ *
+ * This function is used to get the address of the START task, which can be used to trigger ADC
+ * conversion.
+ *
+ * @return Start task address.
+ */
+__STATIC_INLINE uint32_t nrfx_adc_start_task_get(void);
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+
+__STATIC_INLINE uint32_t nrfx_adc_start_task_get(void)
+{
+    return nrf_adc_task_address_get(NRF_ADC_TASK_START);
+}
+
+#endif
+
+
+void nrfx_adc_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_ADC_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_clock.h

@@ -1,223 +1,214 @@
-/**
- * Copyright (c) 2016 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_CLOCK_H__
-#define NRFX_CLOCK_H__
-
-#include <nrfx.h>
-#include <hal/nrf_clock.h>
-#include <nrfx_power_clock.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_clock CLOCK driver
- * @{
- * @ingroup nrf_clock
- * @brief   CLOCK peripheral driver.
- */
-
-/**
- * @brief Clock events.
- */
-typedef enum
-{
-    NRFX_CLOCK_EVT_HFCLK_STARTED, ///< HFCLK has been started.
-    NRFX_CLOCK_EVT_LFCLK_STARTED, ///< LFCLK has been started.
-    NRFX_CLOCK_EVT_CTTO,          ///< Calibration timeout.
-    NRFX_CLOCK_EVT_CAL_DONE       ///< Calibration has been done.
-} nrfx_clock_evt_type_t;
-
-/**
- * @brief Clock event handler.
- *
- * @param[in] event  Event.
- */
-typedef void (*nrfx_clock_event_handler_t)(nrfx_clock_evt_type_t event);
-
-/**
- * @brief Function for initializing internal structures in the nrfx_clock module.
- *
- * After initialization, the module is in power off state (clocks are not started).
- *
- * @param[in] event_handler Event handler provided by the user.
- *                          Must not be NULL.
- *
- * @retval NRFX_SUCCESS                   If the procedure was successful.
- * @retval NRFX_ERROR_ALREADY_INITIALIZED If the driver was already initialized.
- */
-nrfx_err_t nrfx_clock_init(nrfx_clock_event_handler_t  event_handler);
-
-/**
- * @brief Function for enabling interrupts in the clock module.
- */
-void nrfx_clock_enable(void);
-
-/**
- * @brief Function for disabling interrupts in the clock module.
- */
-void nrfx_clock_disable(void);
-
-/**
- * @brief Function for uninitializing the clock module.
- */
-void nrfx_clock_uninit(void);
-
-/**
- * @brief Function for starting the LFCLK.
- */
-void nrfx_clock_lfclk_start(void);
-
-/**
- * @brief Function for stoping the LFCLK.
- */
-void nrfx_clock_lfclk_stop(void);
-
-/**
- * @brief Function for checking the LFCLK state.
- *
- * @retval true If the LFCLK is running.
- * @retval false If the LFCLK is not running.
- */
-__STATIC_INLINE bool nrfx_clock_lfclk_is_running(void);
-
-/**
- * @brief Function for starting the high-accuracy source HFCLK.
- */
-void nrfx_clock_hfclk_start(void);
-
-/**
- * @brief Function for stoping external high-accuracy source HFCLK.
- */
-void nrfx_clock_hfclk_stop(void);
-
-/**
- * @brief Function for checking the HFCLK state.
- *
- * @retval true If the HFCLK is running (XTAL source).
- * @retval false If the HFCLK is not running.
- */
-__STATIC_INLINE bool nrfx_clock_hfclk_is_running(void);
-
-/**
- * @brief Function for starting calibration of internal LFCLK.
- *
- * This function starts the calibration process. The process cannot be aborted. LFCLK and HFCLK
- * must be running before this function is called.
- *
- * @retval     NRFX_SUCCESS                        If the procedure was successful.
- * @retval     NRFX_ERROR_INVALID_STATE            If the low-frequency of high-frequency clock is off.
- * @retval     NRFX_ERROR_BUSY                     If calibration is in progress.
- */
-nrfx_err_t nrfx_clock_calibration_start(void);
-
-/**
- * @brief Function for checking if calibration is in progress.
- *
- * This function indicates that the system is in calibration phase.
- *
- * @retval     NRFX_SUCCESS                        If the procedure was successful.
- * @retval     NRFX_ERROR_BUSY                     If calibration is in progress.
- */
-nrfx_err_t nrfx_clock_is_calibrating(void);
-
-/**
- * @brief Function for starting calibration timer.
- * @param interval Time after which the CTTO event and interrupt will be generated (in 0.25 s units).
- */
-void nrfx_clock_calibration_timer_start(uint8_t interval);
-
-/**
- * @brief Function for stoping calibration timer.
- */
-void nrfx_clock_calibration_timer_stop(void);
-
-/**@brief Function for returning a requested task address for the clock driver module.
- *
- * @param[in]  task                               One of the peripheral tasks.
- *
- * @return     Task address.
- */
-__STATIC_INLINE uint32_t nrfx_clock_ppi_task_addr(nrf_clock_task_t task);
-
-/**@brief Function for returning a requested event address for the clock driver module.
- *
- * @param[in]  event                              One of the peripheral events.
- *
- * @return     Event address.
- */
-__STATIC_INLINE uint32_t nrfx_clock_ppi_event_addr(nrf_clock_event_t event);
-
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-__STATIC_INLINE uint32_t nrfx_clock_ppi_task_addr(nrf_clock_task_t task)
-{
-    return nrf_clock_task_address_get(task);
-}
-
-__STATIC_INLINE uint32_t nrfx_clock_ppi_event_addr(nrf_clock_event_t event)
-{
-    return nrf_clock_event_address_get(event);
-}
-
-__STATIC_INLINE bool nrfx_clock_hfclk_is_running(void)
-{
-    return nrf_clock_hf_is_running(NRF_CLOCK_HFCLK_HIGH_ACCURACY);
-}
-
-__STATIC_INLINE bool nrfx_clock_lfclk_is_running(void)
-{
-    return nrf_clock_lf_is_running();
-}
-#endif //SUPPRESS_INLINE_IMPLEMENTATION
-
-
-void nrfx_clock_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_CLOCK_H__
+/*
+ * Copyright (c) 2016 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_CLOCK_H__
+#define NRFX_CLOCK_H__
+
+#include <nrfx.h>
+#include <hal/nrf_clock.h>
+#include <nrfx_power_clock.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_clock CLOCK driver
+ * @{
+ * @ingroup nrf_clock
+ * @brief   CLOCK peripheral driver.
+ */
+
+/**
+ * @brief Clock events.
+ */
+typedef enum
+{
+    NRFX_CLOCK_EVT_HFCLK_STARTED, ///< HFCLK has been started.
+    NRFX_CLOCK_EVT_LFCLK_STARTED, ///< LFCLK has been started.
+    NRFX_CLOCK_EVT_CTTO,          ///< Calibration timeout.
+    NRFX_CLOCK_EVT_CAL_DONE       ///< Calibration has been done.
+} nrfx_clock_evt_type_t;
+
+/**
+ * @brief Clock event handler.
+ *
+ * @param[in] event  Event.
+ */
+typedef void (*nrfx_clock_event_handler_t)(nrfx_clock_evt_type_t event);
+
+/**
+ * @brief Function for initializing internal structures in the nrfx_clock module.
+ *
+ * After initialization, the module is in power off state (clocks are not started).
+ *
+ * @param[in] event_handler Event handler provided by the user.
+ *                          Must not be NULL.
+ *
+ * @retval NRFX_SUCCESS                   If the procedure was successful.
+ * @retval NRFX_ERROR_ALREADY_INITIALIZED If the driver was already initialized.
+ */
+nrfx_err_t nrfx_clock_init(nrfx_clock_event_handler_t  event_handler);
+
+/**
+ * @brief Function for enabling interrupts in the clock module.
+ */
+void nrfx_clock_enable(void);
+
+/**
+ * @brief Function for disabling interrupts in the clock module.
+ */
+void nrfx_clock_disable(void);
+
+/**
+ * @brief Function for uninitializing the clock module.
+ */
+void nrfx_clock_uninit(void);
+
+/**
+ * @brief Function for starting the LFCLK.
+ */
+void nrfx_clock_lfclk_start(void);
+
+/**
+ * @brief Function for stoping the LFCLK.
+ */
+void nrfx_clock_lfclk_stop(void);
+
+/**
+ * @brief Function for checking the LFCLK state.
+ *
+ * @retval true If the LFCLK is running.
+ * @retval false If the LFCLK is not running.
+ */
+__STATIC_INLINE bool nrfx_clock_lfclk_is_running(void);
+
+/**
+ * @brief Function for starting the high-accuracy source HFCLK.
+ */
+void nrfx_clock_hfclk_start(void);
+
+/**
+ * @brief Function for stoping external high-accuracy source HFCLK.
+ */
+void nrfx_clock_hfclk_stop(void);
+
+/**
+ * @brief Function for checking the HFCLK state.
+ *
+ * @retval true If the HFCLK is running (XTAL source).
+ * @retval false If the HFCLK is not running.
+ */
+__STATIC_INLINE bool nrfx_clock_hfclk_is_running(void);
+
+/**
+ * @brief Function for starting calibration of internal LFCLK.
+ *
+ * This function starts the calibration process. The process cannot be aborted. LFCLK and HFCLK
+ * must be running before this function is called.
+ *
+ * @retval     NRFX_SUCCESS                        If the procedure was successful.
+ * @retval     NRFX_ERROR_INVALID_STATE            If the low-frequency of high-frequency clock is off.
+ * @retval     NRFX_ERROR_BUSY                     If calibration is in progress.
+ */
+nrfx_err_t nrfx_clock_calibration_start(void);
+
+/**
+ * @brief Function for checking if calibration is in progress.
+ *
+ * This function indicates that the system is in calibration phase.
+ *
+ * @retval     NRFX_SUCCESS                        If the procedure was successful.
+ * @retval     NRFX_ERROR_BUSY                     If calibration is in progress.
+ */
+nrfx_err_t nrfx_clock_is_calibrating(void);
+
+/**
+ * @brief Function for starting calibration timer.
+ * @param interval Time after which the CTTO event and interrupt will be generated (in 0.25 s units).
+ */
+void nrfx_clock_calibration_timer_start(uint8_t interval);
+
+/**
+ * @brief Function for stoping calibration timer.
+ */
+void nrfx_clock_calibration_timer_stop(void);
+
+/**@brief Function for returning a requested task address for the clock driver module.
+ *
+ * @param[in]  task                               One of the peripheral tasks.
+ *
+ * @return     Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_clock_ppi_task_addr(nrf_clock_task_t task);
+
+/**@brief Function for returning a requested event address for the clock driver module.
+ *
+ * @param[in]  event                              One of the peripheral events.
+ *
+ * @return     Event address.
+ */
+__STATIC_INLINE uint32_t nrfx_clock_ppi_event_addr(nrf_clock_event_t event);
+
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+__STATIC_INLINE uint32_t nrfx_clock_ppi_task_addr(nrf_clock_task_t task)
+{
+    return nrf_clock_task_address_get(task);
+}
+
+__STATIC_INLINE uint32_t nrfx_clock_ppi_event_addr(nrf_clock_event_t event)
+{
+    return nrf_clock_event_address_get(event);
+}
+
+__STATIC_INLINE bool nrfx_clock_hfclk_is_running(void)
+{
+    return nrf_clock_hf_is_running(NRF_CLOCK_HFCLK_HIGH_ACCURACY);
+}
+
+__STATIC_INLINE bool nrfx_clock_lfclk_is_running(void)
+{
+    return nrf_clock_lf_is_running();
+}
+#endif //SUPPRESS_INLINE_IMPLEMENTATION
+
+
+void nrfx_clock_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_CLOCK_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_comp.h

@@ -1,247 +1,238 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_COMP_H__
-#define NRFX_COMP_H__
-
-#include <nrfx.h>
-#include <hal/nrf_comp.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_comp COMP driver
- * @{
- * @ingroup nrf_comp
- * @brief   Comparator (COMP) peripheral driver.
- */
-
-/**
- * @brief Macro to convert the threshold voltage to an integer value
- *        (needed by the COMP_TH register).
- *
- * @param[in] vol   Voltage to be changed to COMP_TH register value. This value
- *                  must not be smaller than reference voltage divided by 64.
- * @param[in] ref   Reference voltage.
- */
-#define NRFX_VOLTAGE_THRESHOLD_TO_INT(vol, ref) \
-    (uint8_t)(((vol) > ((ref) / 64)) ? (NRFX_ROUNDED_DIV((vol) * 64,(ref)) - 1) : 0)
-
-/**
- * @brief COMP event handler function type.
- * @param[in] event  COMP event.
- */
-typedef void (* nrfx_comp_event_handler_t)(nrf_comp_event_t event);
-
-/** @brief COMP shortcut masks. */
-typedef enum
-{
-    NRFX_COMP_SHORT_STOP_AFTER_CROSS_EVT = COMP_SHORTS_CROSS_STOP_Msk, /*!< Shortcut between the CROSS event and the STOP task. */
-    NRFX_COMP_SHORT_STOP_AFTER_UP_EVT = COMP_SHORTS_UP_STOP_Msk,       /*!< Shortcut between the UP event and the STOP task. */
-    NRFX_COMP_SHORT_STOP_AFTER_DOWN_EVT = COMP_SHORTS_DOWN_STOP_Msk    /*!< Shortcut between the DOWN event and the STOP task. */
-} nrfx_comp_short_mask_t;
-
-/** @brief COMP events masks. */
-typedef enum
-{
-    NRFX_COMP_EVT_EN_CROSS_MASK = COMP_INTENSET_CROSS_Msk, /*!< CROSS event (generated after VIN+ == VIN-). */
-    NRFX_COMP_EVT_EN_UP_MASK = COMP_INTENSET_UP_Msk,       /*!< UP event (generated when VIN+ crosses VIN- while increasing). */
-    NRFX_COMP_EVT_EN_DOWN_MASK = COMP_INTENSET_DOWN_Msk,   /*!< DOWN event (generated when VIN+ crosses VIN- while decreasing). */
-    NRFX_COMP_EVT_EN_READY_MASK = COMP_INTENSET_READY_Msk  /*!< READY event (generated when the module is ready). */
-} nrfx_comp_evt_en_mask_t;
-
-/** @brief COMP configuration. */
-typedef struct
-{
-    nrf_comp_ref_t          reference;          /**< Reference selection. */
-    nrf_comp_ext_ref_t      ext_ref;            /**< External analog reference selection. */
-    nrf_comp_main_mode_t    main_mode;          /**< Main operation mode. */
-    nrf_comp_th_t           threshold;          /**< Structure holding THDOWN and THUP values needed by the COMP_TH register. */
-    nrf_comp_sp_mode_t      speed_mode;         /**< Speed and power mode. */
-    nrf_comp_hyst_t         hyst;               /**< Comparator hysteresis.*/
-#if defined (COMP_ISOURCE_ISOURCE_Msk) || defined (__NRFX_DOXYGEN__)
-    nrf_isource_t           isource;            /**< Current source selected on analog input. */
-#endif
-    nrf_comp_input_t        input;              /**< Input to be monitored. */
-    uint8_t                 interrupt_priority; /**< Interrupt priority. */
-} nrfx_comp_config_t;
-
-/** @brief COMP threshold default configuration. */
-#define NRFX_COMP_CONFIG_TH                             \
-{                                                       \
-    .th_down = NRFX_VOLTAGE_THRESHOLD_TO_INT(0.5, 1.8), \
-    .th_up   = NRFX_VOLTAGE_THRESHOLD_TO_INT(1.5, 1.8)  \
-}
-
-/** @brief COMP driver default configuration including the COMP HAL configuration. */
-#if defined (COMP_ISOURCE_ISOURCE_Msk) || defined (__NRFX_DOXYGEN__)
-#define NRFX_COMP_DEFAULT_CONFIG(_input)                                    \
-{                                                                           \
-    .reference          = (nrf_comp_ref_t)NRFX_COMP_CONFIG_REF,             \
-    .main_mode          = (nrf_comp_main_mode_t)NRFX_COMP_CONFIG_MAIN_MODE, \
-    .threshold          = NRFX_COMP_CONFIG_TH,                              \
-    .speed_mode         = (nrf_comp_sp_mode_t)NRFX_COMP_CONFIG_SPEED_MODE,  \
-    .hyst               = (nrf_comp_hyst_t)NRFX_COMP_CONFIG_HYST,           \
-    .isource            = (nrf_isource_t)NRFX_COMP_CONFIG_ISOURCE,          \
-    .input              = (nrf_comp_input_t)_input,                         \
-    .interrupt_priority = NRFX_COMP_CONFIG_IRQ_PRIORITY                     \
-}
-#else
-#define NRFX_COMP_DEFAULT_CONFIG(_input)                                    \
-{                                                                           \
-    .reference          = (nrf_comp_ref_t)NRFX_COMP_CONFIG_REF,             \
-    .main_mode          = (nrf_comp_main_mode_t)NRFX_COMP_CONFIG_MAIN_MODE, \
-    .threshold          = NRFX_COMP_CONFIG_TH,                              \
-    .speed_mode         = (nrf_comp_sp_mode_t)NRFX_COMP_CONFIG_SPEED_MODE,  \
-    .hyst               = (nrf_comp_hyst_t)NRFX_COMP_CONFIG_HYST,           \
-    .input              = (nrf_comp_input_t)_input,                         \
-    .interrupt_priority = NRFX_COMP_CONFIG_IRQ_PRIORITY                     \
-}
-#endif
-
-/**
- * @brief Function for initializing the COMP driver.
- *
- * This function initializes the COMP driver, but does not enable the peripheral or any interrupts.
- * To start the driver, call the function @ref nrfx_comp_start() after initialization.
- *
- * @param[in] p_config      Pointer to the structure with initial configuration.
- * @param[in] event_handler Event handler provided by the user.
- *                          Must not be NULL.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver has already been initialized.
- * @retval NRFX_ERROR_BUSY          If the LPCOMP peripheral is already in use.
- *                                  This is possible only if @ref nrfx_prs module
- *                                  is enabled.
- */
-nrfx_err_t nrfx_comp_init(nrfx_comp_config_t const * p_config,
-                          nrfx_comp_event_handler_t  event_handler);
-
-
-/**
- *  @brief Function for uninitializing the COMP driver.
- *
- *  This function uninitializes the COMP driver. The COMP peripheral and
- *  its interrupts are disabled, and local variables are cleaned. After this call, you must
- *  initialize the driver again by calling nrfx_comp_init() if you want to use it.
- *
- *  @sa nrfx_comp_stop()
- */
-void nrfx_comp_uninit(void);
-
-/**
- * @brief Function for setting the analog input.
- *
- * @param[in] psel  COMP analog pin selection.
- */
-void nrfx_comp_pin_select(nrf_comp_input_t psel);
-
-/**
- * @brief Function for starting the COMP peripheral and interrupts.
- *
- * Before calling this function, the driver must be initialized. This function
- * enables the COMP peripheral and its interrupts.
- *
- * @param[in] comp_evt_en_mask  Mask of events to be enabled. This parameter should be built as
- *                              'or' of elements from @ref nrfx_comp_evt_en_mask_t.
- * @param[in] comp_shorts_mask  Mask of shorts to be enabled. This parameter should be built as
- *                              'or' of elements from @ref nrfx_comp_short_mask_t.
- *
- * @sa nrfx_comp_init()
- *
- */
-void nrfx_comp_start(uint32_t comp_evt_en_mask, uint32_t comp_shorts_mask);
-
-/**@brief Function for stopping the COMP peripheral.
- *
- * Before calling this function, the driver must be enabled. This function disables the COMP
- * peripheral and its interrupts.
- *
- * @sa nrfx_comp_uninit()
- *
- */
-void nrfx_comp_stop(void);
-
-/**
- * @brief Function for copying the current state of the comparator result to the RESULT register.
- *
- * @retval 0 If the input voltage is below the threshold (VIN+ < VIN-).
- * @retval 1 If the input voltage is above the threshold (VIN+ > VIN-).
- */
-uint32_t nrfx_comp_sample(void);
-
-/**
- * @brief Function for getting the address of a COMP task.
- *
- * @param[in] task  COMP task.
- *
- * @return Address of the given COMP task.
- */
-__STATIC_INLINE uint32_t nrfx_comp_task_address_get(nrf_comp_task_t task)
-{
-    return (uint32_t)nrf_comp_task_address_get(task);
-}
-
-/**
- * @brief Function for getting the address of a COMP event.
- *
- * @param[in] event COMP event.
- *
- * @return Address of the given COMP event.
- */
-__STATIC_INLINE uint32_t nrfx_comp_event_address_get(nrf_comp_event_t event)
-{
-    return (uint32_t)nrf_comp_event_address_get(event);
-}
-
-
-void nrfx_comp_irq_handler(void);
-
-
-/** @} **/
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_COMP_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_COMP_H__
+#define NRFX_COMP_H__
+
+#include <nrfx.h>
+#include <hal/nrf_comp.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_comp COMP driver
+ * @{
+ * @ingroup nrf_comp
+ * @brief   Comparator (COMP) peripheral driver.
+ */
+
+/**
+ * @brief Macro to convert the threshold voltage to an integer value
+ *        (needed by the COMP_TH register).
+ *
+ * @param[in] vol   Voltage to be changed to COMP_TH register value. This value
+ *                  must not be smaller than reference voltage divided by 64.
+ * @param[in] ref   Reference voltage.
+ */
+#define NRFX_VOLTAGE_THRESHOLD_TO_INT(vol, ref) \
+    (uint8_t)(((vol) > ((ref) / 64)) ? (NRFX_ROUNDED_DIV((vol) * 64,(ref)) - 1) : 0)
+
+/**
+ * @brief COMP event handler function type.
+ * @param[in] event  COMP event.
+ */
+typedef void (* nrfx_comp_event_handler_t)(nrf_comp_event_t event);
+
+/** @brief COMP shortcut masks. */
+typedef enum
+{
+    NRFX_COMP_SHORT_STOP_AFTER_CROSS_EVT = COMP_SHORTS_CROSS_STOP_Msk, /*!< Shortcut between the CROSS event and the STOP task. */
+    NRFX_COMP_SHORT_STOP_AFTER_UP_EVT = COMP_SHORTS_UP_STOP_Msk,       /*!< Shortcut between the UP event and the STOP task. */
+    NRFX_COMP_SHORT_STOP_AFTER_DOWN_EVT = COMP_SHORTS_DOWN_STOP_Msk    /*!< Shortcut between the DOWN event and the STOP task. */
+} nrfx_comp_short_mask_t;
+
+/** @brief COMP events masks. */
+typedef enum
+{
+    NRFX_COMP_EVT_EN_CROSS_MASK = COMP_INTENSET_CROSS_Msk, /*!< CROSS event (generated after VIN+ == VIN-). */
+    NRFX_COMP_EVT_EN_UP_MASK = COMP_INTENSET_UP_Msk,       /*!< UP event (generated when VIN+ crosses VIN- while increasing). */
+    NRFX_COMP_EVT_EN_DOWN_MASK = COMP_INTENSET_DOWN_Msk,   /*!< DOWN event (generated when VIN+ crosses VIN- while decreasing). */
+    NRFX_COMP_EVT_EN_READY_MASK = COMP_INTENSET_READY_Msk  /*!< READY event (generated when the module is ready). */
+} nrfx_comp_evt_en_mask_t;
+
+/** @brief COMP configuration. */
+typedef struct
+{
+    nrf_comp_ref_t          reference;          /**< Reference selection. */
+    nrf_comp_ext_ref_t      ext_ref;            /**< External analog reference selection. */
+    nrf_comp_main_mode_t    main_mode;          /**< Main operation mode. */
+    nrf_comp_th_t           threshold;          /**< Structure holding THDOWN and THUP values needed by the COMP_TH register. */
+    nrf_comp_sp_mode_t      speed_mode;         /**< Speed and power mode. */
+    nrf_comp_hyst_t         hyst;               /**< Comparator hysteresis.*/
+#if defined (COMP_ISOURCE_ISOURCE_Msk) || defined (__NRFX_DOXYGEN__)
+    nrf_isource_t           isource;            /**< Current source selected on analog input. */
+#endif
+    nrf_comp_input_t        input;              /**< Input to be monitored. */
+    uint8_t                 interrupt_priority; /**< Interrupt priority. */
+} nrfx_comp_config_t;
+
+/** @brief COMP threshold default configuration. */
+#define NRFX_COMP_CONFIG_TH                             \
+{                                                       \
+    .th_down = NRFX_VOLTAGE_THRESHOLD_TO_INT(0.5, 1.8), \
+    .th_up   = NRFX_VOLTAGE_THRESHOLD_TO_INT(1.5, 1.8)  \
+}
+
+/** @brief COMP driver default configuration including the COMP HAL configuration. */
+#if defined (COMP_ISOURCE_ISOURCE_Msk) || defined (__NRFX_DOXYGEN__)
+#define NRFX_COMP_DEFAULT_CONFIG(_input)                                    \
+{                                                                           \
+    .reference          = (nrf_comp_ref_t)NRFX_COMP_CONFIG_REF,             \
+    .main_mode          = (nrf_comp_main_mode_t)NRFX_COMP_CONFIG_MAIN_MODE, \
+    .threshold          = NRFX_COMP_CONFIG_TH,                              \
+    .speed_mode         = (nrf_comp_sp_mode_t)NRFX_COMP_CONFIG_SPEED_MODE,  \
+    .hyst               = (nrf_comp_hyst_t)NRFX_COMP_CONFIG_HYST,           \
+    .isource            = (nrf_isource_t)NRFX_COMP_CONFIG_ISOURCE,          \
+    .input              = (nrf_comp_input_t)_input,                         \
+    .interrupt_priority = NRFX_COMP_CONFIG_IRQ_PRIORITY                     \
+}
+#else
+#define NRFX_COMP_DEFAULT_CONFIG(_input)                                    \
+{                                                                           \
+    .reference          = (nrf_comp_ref_t)NRFX_COMP_CONFIG_REF,             \
+    .main_mode          = (nrf_comp_main_mode_t)NRFX_COMP_CONFIG_MAIN_MODE, \
+    .threshold          = NRFX_COMP_CONFIG_TH,                              \
+    .speed_mode         = (nrf_comp_sp_mode_t)NRFX_COMP_CONFIG_SPEED_MODE,  \
+    .hyst               = (nrf_comp_hyst_t)NRFX_COMP_CONFIG_HYST,           \
+    .input              = (nrf_comp_input_t)_input,                         \
+    .interrupt_priority = NRFX_COMP_CONFIG_IRQ_PRIORITY                     \
+}
+#endif
+
+/**
+ * @brief Function for initializing the COMP driver.
+ *
+ * This function initializes the COMP driver, but does not enable the peripheral or any interrupts.
+ * To start the driver, call the function @ref nrfx_comp_start() after initialization.
+ *
+ * @param[in] p_config      Pointer to the structure with initial configuration.
+ * @param[in] event_handler Event handler provided by the user.
+ *                          Must not be NULL.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver has already been initialized.
+ * @retval NRFX_ERROR_BUSY          If the LPCOMP peripheral is already in use.
+ *                                  This is possible only if @ref nrfx_prs module
+ *                                  is enabled.
+ */
+nrfx_err_t nrfx_comp_init(nrfx_comp_config_t const * p_config,
+                          nrfx_comp_event_handler_t  event_handler);
+
+
+/**
+ *  @brief Function for uninitializing the COMP driver.
+ *
+ *  This function uninitializes the COMP driver. The COMP peripheral and
+ *  its interrupts are disabled, and local variables are cleaned. After this call, you must
+ *  initialize the driver again by calling nrfx_comp_init() if you want to use it.
+ *
+ *  @sa nrfx_comp_stop()
+ */
+void nrfx_comp_uninit(void);
+
+/**
+ * @brief Function for setting the analog input.
+ *
+ * @param[in] psel  COMP analog pin selection.
+ */
+void nrfx_comp_pin_select(nrf_comp_input_t psel);
+
+/**
+ * @brief Function for starting the COMP peripheral and interrupts.
+ *
+ * Before calling this function, the driver must be initialized. This function
+ * enables the COMP peripheral and its interrupts.
+ *
+ * @param[in] comp_evt_en_mask  Mask of events to be enabled. This parameter should be built as
+ *                              'or' of elements from @ref nrfx_comp_evt_en_mask_t.
+ * @param[in] comp_shorts_mask  Mask of shorts to be enabled. This parameter should be built as
+ *                              'or' of elements from @ref nrfx_comp_short_mask_t.
+ *
+ * @sa nrfx_comp_init()
+ *
+ */
+void nrfx_comp_start(uint32_t comp_evt_en_mask, uint32_t comp_shorts_mask);
+
+/**@brief Function for stopping the COMP peripheral.
+ *
+ * Before calling this function, the driver must be enabled. This function disables the COMP
+ * peripheral and its interrupts.
+ *
+ * @sa nrfx_comp_uninit()
+ *
+ */
+void nrfx_comp_stop(void);
+
+/**
+ * @brief Function for copying the current state of the comparator result to the RESULT register.
+ *
+ * @retval 0 If the input voltage is below the threshold (VIN+ < VIN-).
+ * @retval 1 If the input voltage is above the threshold (VIN+ > VIN-).
+ */
+uint32_t nrfx_comp_sample(void);
+
+/**
+ * @brief Function for getting the address of a COMP task.
+ *
+ * @param[in] task  COMP task.
+ *
+ * @return Address of the given COMP task.
+ */
+__STATIC_INLINE uint32_t nrfx_comp_task_address_get(nrf_comp_task_t task)
+{
+    return (uint32_t)nrf_comp_task_address_get(task);
+}
+
+/**
+ * @brief Function for getting the address of a COMP event.
+ *
+ * @param[in] event COMP event.
+ *
+ * @return Address of the given COMP event.
+ */
+__STATIC_INLINE uint32_t nrfx_comp_event_address_get(nrf_comp_event_t event)
+{
+    return (uint32_t)nrf_comp_event_address_get(event);
+}
+
+
+void nrfx_comp_irq_handler(void);
+
+
+/** @} **/
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_COMP_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_dppi.h

@@ -0,0 +1,176 @@
+/*
+ * Copyright (c) 2018 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_DPPI_H__
+#define NRFX_DPPI_H__
+
+#include <nrfx.h>
+#include <hal/nrf_dppi.h>
+
+/**
+ * @defgroup nrfx_dppi DPPI allocator
+ * @{
+ * @ingroup nrf_dppi
+ * @brief   Distributed Programmable Peripheral Interconnect (DPPI) allocator.
+ */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** @brief Function for freeing all allocated channels and groups. */
+void nrfx_dppi_free(void);
+
+/**
+ * @brief Function for allocating a DPPI channel.
+ * @details This function allocates the first unused DPPI channel.
+ *
+ * @param[out] p_channel Pointer to the DPPI channel number that has been allocated.
+ *
+ * @retval NRFX_SUCCESS      If the channel was successfully allocated.
+ * @retval NRFX_ERROR_NO_MEM If there is no available channel to be used.
+ */
+nrfx_err_t nrfx_dppi_channel_alloc(uint8_t * p_channel);
+
+/**
+ * @brief Function for freeing a DPPI channel.
+ * @details This function also disables the chosen channel.
+ *
+ * @param[in] channel DPPI channel to be freed.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully freed.
+ * @retval NRFX_ERROR_INVALID_PARAM If the specified channel is not allocated.
+ */
+nrfx_err_t nrfx_dppi_channel_free(uint8_t channel);
+
+/**
+ * @brief Function for enabling a DPPI channel.
+ *
+ * @param[in] channel DPPI channel to be enabled.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully enabled.
+ * @retval NRFX_ERROR_INVALID_PARAM If the specified channel is not allocated.
+ */
+nrfx_err_t nrfx_dppi_channel_enable(uint8_t channel);
+
+/**
+ * @brief Function for disabling a DPPI channel.
+ *
+ * @param[in] channel DPPI channel to be disabled.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully disabled.
+ * @retval NRFX_ERROR_INVALID_PARAM If the specified channel is not allocated.
+ */
+nrfx_err_t nrfx_dppi_channel_disable(uint8_t channel);
+
+/**
+ * @brief Function for allocating a DPPI channel group.
+ * @details This function allocates the first unused DPPI group.
+ *
+ * @param[out] p_group Pointer to the DPPI channel group that has been allocated.
+ *
+ * @retval NRFX_SUCCESS      If the channel group was successfully allocated.
+ * @retval NRFX_ERROR_NO_MEM If there is no available channel group to be used.
+ */
+nrfx_err_t nrfx_dppi_group_alloc(nrf_dppi_channel_group_t * p_group);
+
+/**
+ * @brief Function for freeing a DPPI channel group.
+ * @details This function also disables the chosen group.
+ *
+ * @param[in] group DPPI channel group to be freed.
+ *
+ * @retval NRFX_SUCCESS             If the channel group was successfully freed.
+ * @retval NRFX_ERROR_INVALID_PARAM If the specified group is not allocated.
+ */
+nrfx_err_t nrfx_dppi_group_free(nrf_dppi_channel_group_t group);
+
+/**
+ * @brief Function for including a DPPI channel in a channel group.
+ *
+ * @param[in] channel DPPI channel to be added.
+ * @param[in] group   Channel group in which to include the channel.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully included.
+ * @retval NRFX_ERROR_INVALID_PARAM If the specified group or channel is not allocated.
+ */
+nrfx_err_t nrfx_dppi_channel_include_in_group(uint8_t                  channel,
+                                              nrf_dppi_channel_group_t group);
+
+/**
+ * @brief Function for removing a DPPI channel from a channel group.
+ *
+ * @param[in] channel DPPI channel to be removed.
+ * @param[in] group   Channel group from which to remove the channel.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully removed.
+ * @retval NRFX_ERROR_INVALID_PARAM If the specified group or channel is not allocated.
+ */
+nrfx_err_t nrfx_dppi_channel_remove_from_group(uint8_t                  channel,
+                                               nrf_dppi_channel_group_t group);
+
+/**
+ * @brief Function for clearing a DPPI channel group.
+ *
+ * @param[in] group Channel group to be cleared.
+ *
+ * @retval NRFX_SUCCESS             If the group was successfully cleared.
+ * @retval NRFX_ERROR_INVALID_PARAM If the specified group is not allocated.
+ */
+nrfx_err_t nrfx_dppi_group_clear(nrf_dppi_channel_group_t group);
+
+/**
+ * @brief Function for enabling a DPPI channel group.
+ *
+ * @param[in] group Channel group to be enabled.
+ *
+ * @retval NRFX_SUCCESS             If the group was successfully enabled.
+ * @retval NRFX_ERROR_INVALID_PARAM If the specified group is not allocated.
+ */
+nrfx_err_t nrfx_dppi_group_enable(nrf_dppi_channel_group_t group);
+
+/**
+ * @brief Function for disabling a DPPI channel group.
+ *
+ * @param[in] group Channel group to be disabled.
+ *
+ * @retval NRFX_SUCCESS             If the group was successfully disabled.
+ * @retval NRFX_ERROR_INVALID_PARAM If the specified group is not allocated.
+ */
+nrfx_err_t nrfx_dppi_group_disable(nrf_dppi_channel_group_t group);
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_DPPI_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_gpiote.h

@@ -1,423 +1,414 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_GPIOTE_H__
-#define NRFX_GPIOTE_H__
-
-#include <nrfx.h>
-#include <hal/nrf_gpiote.h>
-#include <hal/nrf_gpio.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_gpiote GPIOTE driver
- * @{
- * @ingroup nrf_gpiote
- * @brief   GPIOTE peripheral driver.
- */
-
-/**@brief Input pin configuration. */
-typedef struct
-{
-    nrf_gpiote_polarity_t sense;               /**< Transition that triggers interrupt. */
-    nrf_gpio_pin_pull_t   pull;                /**< Pulling mode. */
-    bool                  is_watcher      : 1; /**< True when the input pin is tracking an output pin. */
-    bool                  hi_accuracy     : 1; /**< True when high accuracy (IN_EVENT) is used. */
-    bool                  skip_gpio_setup : 1; /**< Do not change GPIO configuration */
-} nrfx_gpiote_in_config_t;
-
-/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect low-to-high transition.
- * @details Set hi_accu to true to use IN_EVENT. */
-#define NRFX_GPIOTE_CONFIG_IN_SENSE_LOTOHI(hi_accu) \
-    {                                               \
-        .is_watcher = false,                        \
-        .hi_accuracy = hi_accu,                     \
-        .pull = NRF_GPIO_PIN_NOPULL,                \
-        .sense = NRF_GPIOTE_POLARITY_LOTOHI,        \
-    }
-
-/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect high-to-low transition.
- * @details Set hi_accu to true to use IN_EVENT. */
-#define NRFX_GPIOTE_CONFIG_IN_SENSE_HITOLO(hi_accu) \
-    {                                               \
-        .is_watcher = false,                        \
-        .hi_accuracy = hi_accu,                     \
-        .pull = NRF_GPIO_PIN_NOPULL,                \
-        .sense = NRF_GPIOTE_POLARITY_HITOLO,        \
-    }
-
-/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect any change on the pin.
- * @details Set hi_accu to true to use IN_EVENT.*/
-#define NRFX_GPIOTE_CONFIG_IN_SENSE_TOGGLE(hi_accu) \
-    {                                               \
-        .is_watcher = false,                        \
-        .hi_accuracy = hi_accu,                     \
-        .pull = NRF_GPIO_PIN_NOPULL,                \
-        .sense = NRF_GPIOTE_POLARITY_TOGGLE,        \
-    }
-
-/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect low-to-high transition.
- * @details Set hi_accu to true to use IN_EVENT.
- * @note This macro prepares configuration that skips GPIO setup. */
-#define NRFX_GPIOTE_RAW_CONFIG_IN_SENSE_LOTOHI(hi_accu) \
-    {                                               \
-        .is_watcher = false,                        \
-        .hi_accuracy = hi_accu,                     \
-        .pull = NRF_GPIO_PIN_NOPULL,                \
-        .sense = NRF_GPIOTE_POLARITY_LOTOHI,        \
-        .skip_gpio_setup = true,                    \
-    }
-
-/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect high-to-low transition.
- * @details Set hi_accu to true to use IN_EVENT.
- * @note This macro prepares configuration that skips GPIO setup. */
-#define NRFX_GPIOTE_RAW_CONFIG_IN_SENSE_HITOLO(hi_accu) \
-    {                                               \
-        .is_watcher = false,                        \
-        .hi_accuracy = hi_accu,                     \
-        .pull = NRF_GPIO_PIN_NOPULL,                \
-        .sense = NRF_GPIOTE_POLARITY_HITOLO,        \
-        .skip_gpio_setup = true,                    \
-    }
-
-/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect any change on the pin.
- * @details Set hi_accu to true to use IN_EVENT.
- * @note This macro prepares configuration that skips GPIO setup. */
-#define NRFX_GPIOTE_RAW_CONFIG_IN_SENSE_TOGGLE(hi_accu) \
-    {                                               \
-        .is_watcher = false,                        \
-        .hi_accuracy = hi_accu,                     \
-        .pull = NRF_GPIO_PIN_NOPULL,                \
-        .sense = NRF_GPIOTE_POLARITY_TOGGLE,        \
-        .skip_gpio_setup = true,                    \
-    }
-
-
-/**@brief Output pin configuration. */
-typedef struct
-{
-    nrf_gpiote_polarity_t action;     /**< Configuration of the pin task. */
-    nrf_gpiote_outinit_t  init_state; /**< Initial state of the output pin. */
-    bool                  task_pin;   /**< True if the pin is controlled by a GPIOTE task. */
-} nrfx_gpiote_out_config_t;
-
-/**@brief Macro for configuring a pin to use as output. GPIOTE is not used for the pin. */
-#define NRFX_GPIOTE_CONFIG_OUT_SIMPLE(init_high)                                                \
-    {                                                                                           \
-        .init_state = init_high ? NRF_GPIOTE_INITIAL_VALUE_HIGH : NRF_GPIOTE_INITIAL_VALUE_LOW, \
-        .task_pin = false,                                                                      \
-    }
-
-/**@brief Macro for configuring a pin to use the GPIO OUT TASK to change the state from high to low.
- * @details The task will clear the pin. Therefore, the pin is set initially.  */
-#define NRFX_GPIOTE_CONFIG_OUT_TASK_LOW              \
-    {                                                \
-        .init_state = NRF_GPIOTE_INITIAL_VALUE_HIGH, \
-        .task_pin   = true,                          \
-        .action     = NRF_GPIOTE_POLARITY_HITOLO,    \
-    }
-
-/**@brief Macro for configuring a pin to use the GPIO OUT TASK to change the state from low to high.
- * @details The task will set the pin. Therefore, the pin is cleared initially.  */
-#define NRFX_GPIOTE_CONFIG_OUT_TASK_HIGH            \
-    {                                               \
-        .init_state = NRF_GPIOTE_INITIAL_VALUE_LOW, \
-        .task_pin   = true,                         \
-        .action     = NRF_GPIOTE_POLARITY_LOTOHI,   \
-    }
-
-/**@brief Macro for configuring a pin to use the GPIO OUT TASK to toggle the pin state.
- * @details The initial pin state must be provided.  */
-#define NRFX_GPIOTE_CONFIG_OUT_TASK_TOGGLE(init_high)                                           \
-    {                                                                                           \
-        .init_state = init_high ? NRF_GPIOTE_INITIAL_VALUE_HIGH : NRF_GPIOTE_INITIAL_VALUE_LOW, \
-        .task_pin   = true,                                                                     \
-        .action     = NRF_GPIOTE_POLARITY_TOGGLE,                                               \
-    }
-
-/** @brief Pin. */
-typedef uint32_t nrfx_gpiote_pin_t;
-
-/**
- * @brief Pin event handler prototype.
- *
- * @param pin    Pin that triggered this event.
- * @param action Action that lead to triggering this event.
- */
-typedef void (*nrfx_gpiote_evt_handler_t)(nrfx_gpiote_pin_t pin, nrf_gpiote_polarity_t action);
-
-/**
- * @brief Function for initializing the GPIOTE module.
- *
- * @details Only static configuration is supported to prevent the shared
- * resource being customized by the initiator.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
- */
-nrfx_err_t nrfx_gpiote_init(void);
-
-/**
- * @brief Function for checking if the GPIOTE module is initialized.
- *
- * @details The GPIOTE module is a shared module. Therefore, you should check if
- * the module is already initialized and skip initialization if it is.
- *
- * @retval true  If the module is already initialized.
- * @retval false If the module is not initialized.
- */
-bool nrfx_gpiote_is_init(void);
-
-/**
- * @brief Function for uninitializing the GPIOTE module.
- */
-void nrfx_gpiote_uninit(void);
-
-/**
- * @brief Function for initializing a GPIOTE output pin.
- * @details The output pin can be controlled by the CPU or by PPI. The initial
- * configuration specifies which mode is used. If PPI mode is used, the driver
- * attempts to allocate one of the available GPIOTE channels. If no channel is
- * available, an error is returned.
- *
- * @param[in] pin      Pin.
- * @param[in] p_config Initial configuration.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver is not initialized or the pin is already used.
- * @retval NRFX_ERROR_NO_MEM        If no GPIOTE channel is available.
- */
-nrfx_err_t nrfx_gpiote_out_init(nrfx_gpiote_pin_t                pin,
-                                nrfx_gpiote_out_config_t const * p_config);
-
-/**
- * @brief Function for uninitializing a GPIOTE output pin.
- * @details The driver frees the GPIOTE channel if the output pin was using one.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_out_uninit(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for setting a GPIOTE output pin.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_out_set(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for clearing a GPIOTE output pin.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_out_clear(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for toggling a GPIOTE output pin.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_out_toggle(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for enabling a GPIOTE output pin task.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_out_task_enable(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for disabling a GPIOTE output pin task.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_out_task_disable(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for getting the address of a configurable GPIOTE task.
- *
- * @param[in] pin Pin.
- *
- * @return Address of OUT task.
- */
-uint32_t nrfx_gpiote_out_task_addr_get(nrfx_gpiote_pin_t pin);
-
-#if defined(GPIOTE_FEATURE_SET_PRESENT) || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Function for getting the address of a configurable GPIOTE task.
- *
- * @param[in] pin Pin.
- *
- * @return Address of SET task.
- */
-uint32_t nrfx_gpiote_set_task_addr_get(nrfx_gpiote_pin_t pin);
-#endif // defined(GPIOTE_FEATURE_SET_PRESENT) || defined(__NRFX_DOXYGEN__)
-
-#if defined(GPIOTE_FEATURE_CLR_PRESENT) || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Function for getting the address of a configurable GPIOTE task.
- *
- * @param[in] pin Pin.
- *
- * @return Address of CLR task.
- */
-uint32_t nrfx_gpiote_clr_task_addr_get(nrfx_gpiote_pin_t pin);
-#endif // defined(GPIOTE_FEATURE_CLR_PRESENT) || defined(__NRFX_DOXYGEN__)
-
-/**
- * @brief Function for initializing a GPIOTE input pin.
- * @details The input pin can act in two ways:
- * - lower accuracy but low power (high frequency clock not needed)
- * - higher accuracy (high frequency clock required)
- *
- * The initial configuration specifies which mode is used.
- * If high-accuracy mode is used, the driver attempts to allocate one
- * of the available GPIOTE channels. If no channel is
- * available, an error is returned.
- * In low accuracy mode SENSE feature is used. In this case only one active pin
- * can be detected at a time. It can be worked around by setting all of the used
- * low accuracy pins to toggle mode.
- * For more information about SENSE functionality, refer to Product Specification.
- *
- * @param[in] pin         Pin.
- * @param[in] p_config    Initial configuration.
- * @param[in] evt_handler User function to be called when the configured transition occurs.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver is not initialized or the pin is already used.
- * @retval NRFX_ERROR_NO_MEM        If no GPIOTE channel is available.
- */
-nrfx_err_t nrfx_gpiote_in_init(nrfx_gpiote_pin_t               pin,
-                               nrfx_gpiote_in_config_t const * p_config,
-                               nrfx_gpiote_evt_handler_t       evt_handler);
-
-/**
- * @brief Function for uninitializing a GPIOTE input pin.
- * @details The driver frees the GPIOTE channel if the input pin was using one.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_in_uninit(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for enabling sensing of a GPIOTE input pin.
- *
- * @details If the input pin is configured as high-accuracy pin, the function
- * enables an IN_EVENT. Otherwise, the function enables the GPIO sense mechanism.
- * Note that a PORT event is shared between multiple pins, therefore the
- * interrupt is always enabled.
- *
- * @param[in] pin        Pin.
- * @param[in] int_enable True to enable the interrupt. Always valid for a high-accuracy pin.
- */
-void nrfx_gpiote_in_event_enable(nrfx_gpiote_pin_t pin, bool int_enable);
-
-/**
- * @brief Function for disabling a GPIOTE input pin.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_in_event_disable(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for checking if a GPIOTE input pin is set.
- *
- * @param[in] pin Pin.
- *
- * @retval true  If the input pin is set.
- * @retval false If the input pin is not set.
- */
-bool nrfx_gpiote_in_is_set(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for getting the address of a GPIOTE input pin event.
- * @details If the pin is configured to use low-accuracy mode, the address of the PORT event is returned.
- *
- * @param[in] pin Pin.
- */
-uint32_t nrfx_gpiote_in_event_addr_get(nrfx_gpiote_pin_t pin);
-
-/**
- * @brief Function for forcing a specific state on the pin configured as task.
- *
- * @param[in] pin   Pin.
- * @param[in] state Pin state.
- */
-void nrfx_gpiote_out_task_force(nrfx_gpiote_pin_t pin, uint8_t state);
-
-/**
- * @brief Function for triggering the task OUT manually.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_out_task_trigger(nrfx_gpiote_pin_t pin);
-
-#if defined(GPIOTE_FEATURE_SET_PRESENT) || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Function for triggering the task SET manually.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_set_task_trigger(nrfx_gpiote_pin_t pin);
-#endif // defined(GPIOTE_FEATURE_SET_PRESENT) || defined(__NRFX_DOXYGEN__)
-
-#if defined(GPIOTE_FEATURE_CLR_PRESENT) || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Function for triggering the task CLR manually.
- *
- * @param[in] pin Pin.
- */
-void nrfx_gpiote_clr_task_trigger(nrfx_gpiote_pin_t pin);
-#endif // defined(GPIOTE_FEATURE_CLR_PRESENT) || defined(__NRFX_DOXYGEN__)
-
-
-void nrfx_gpiote_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_GPIOTE_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_GPIOTE_H__
+#define NRFX_GPIOTE_H__
+
+#include <nrfx.h>
+#include <hal/nrf_gpiote.h>
+#include <hal/nrf_gpio.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_gpiote GPIOTE driver
+ * @{
+ * @ingroup nrf_gpiote
+ * @brief   GPIOTE peripheral driver.
+ */
+
+/**@brief Input pin configuration. */
+typedef struct
+{
+    nrf_gpiote_polarity_t sense;               /**< Transition that triggers interrupt. */
+    nrf_gpio_pin_pull_t   pull;                /**< Pulling mode. */
+    bool                  is_watcher      : 1; /**< True when the input pin is tracking an output pin. */
+    bool                  hi_accuracy     : 1; /**< True when high accuracy (IN_EVENT) is used. */
+    bool                  skip_gpio_setup : 1; /**< Do not change GPIO configuration */
+} nrfx_gpiote_in_config_t;
+
+/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect low-to-high transition.
+ * @details Set hi_accu to true to use IN_EVENT. */
+#define NRFX_GPIOTE_CONFIG_IN_SENSE_LOTOHI(hi_accu) \
+    {                                               \
+        .is_watcher = false,                        \
+        .hi_accuracy = hi_accu,                     \
+        .pull = NRF_GPIO_PIN_NOPULL,                \
+        .sense = NRF_GPIOTE_POLARITY_LOTOHI,        \
+    }
+
+/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect high-to-low transition.
+ * @details Set hi_accu to true to use IN_EVENT. */
+#define NRFX_GPIOTE_CONFIG_IN_SENSE_HITOLO(hi_accu) \
+    {                                               \
+        .is_watcher = false,                        \
+        .hi_accuracy = hi_accu,                     \
+        .pull = NRF_GPIO_PIN_NOPULL,                \
+        .sense = NRF_GPIOTE_POLARITY_HITOLO,        \
+    }
+
+/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect any change on the pin.
+ * @details Set hi_accu to true to use IN_EVENT.*/
+#define NRFX_GPIOTE_CONFIG_IN_SENSE_TOGGLE(hi_accu) \
+    {                                               \
+        .is_watcher = false,                        \
+        .hi_accuracy = hi_accu,                     \
+        .pull = NRF_GPIO_PIN_NOPULL,                \
+        .sense = NRF_GPIOTE_POLARITY_TOGGLE,        \
+    }
+
+/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect low-to-high transition.
+ * @details Set hi_accu to true to use IN_EVENT.
+ * @note This macro prepares configuration that skips GPIO setup. */
+#define NRFX_GPIOTE_RAW_CONFIG_IN_SENSE_LOTOHI(hi_accu) \
+    {                                               \
+        .is_watcher = false,                        \
+        .hi_accuracy = hi_accu,                     \
+        .pull = NRF_GPIO_PIN_NOPULL,                \
+        .sense = NRF_GPIOTE_POLARITY_LOTOHI,        \
+        .skip_gpio_setup = true,                    \
+    }
+
+/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect high-to-low transition.
+ * @details Set hi_accu to true to use IN_EVENT.
+ * @note This macro prepares configuration that skips GPIO setup. */
+#define NRFX_GPIOTE_RAW_CONFIG_IN_SENSE_HITOLO(hi_accu) \
+    {                                               \
+        .is_watcher = false,                        \
+        .hi_accuracy = hi_accu,                     \
+        .pull = NRF_GPIO_PIN_NOPULL,                \
+        .sense = NRF_GPIOTE_POLARITY_HITOLO,        \
+        .skip_gpio_setup = true,                    \
+    }
+
+/**@brief Macro for configuring a pin to use a GPIO IN or PORT EVENT to detect any change on the pin.
+ * @details Set hi_accu to true to use IN_EVENT.
+ * @note This macro prepares configuration that skips GPIO setup. */
+#define NRFX_GPIOTE_RAW_CONFIG_IN_SENSE_TOGGLE(hi_accu) \
+    {                                               \
+        .is_watcher = false,                        \
+        .hi_accuracy = hi_accu,                     \
+        .pull = NRF_GPIO_PIN_NOPULL,                \
+        .sense = NRF_GPIOTE_POLARITY_TOGGLE,        \
+        .skip_gpio_setup = true,                    \
+    }
+
+
+/**@brief Output pin configuration. */
+typedef struct
+{
+    nrf_gpiote_polarity_t action;     /**< Configuration of the pin task. */
+    nrf_gpiote_outinit_t  init_state; /**< Initial state of the output pin. */
+    bool                  task_pin;   /**< True if the pin is controlled by a GPIOTE task. */
+} nrfx_gpiote_out_config_t;
+
+/**@brief Macro for configuring a pin to use as output. GPIOTE is not used for the pin. */
+#define NRFX_GPIOTE_CONFIG_OUT_SIMPLE(init_high)                                                \
+    {                                                                                           \
+        .init_state = init_high ? NRF_GPIOTE_INITIAL_VALUE_HIGH : NRF_GPIOTE_INITIAL_VALUE_LOW, \
+        .task_pin = false,                                                                      \
+    }
+
+/**@brief Macro for configuring a pin to use the GPIO OUT TASK to change the state from high to low.
+ * @details The task will clear the pin. Therefore, the pin is set initially.  */
+#define NRFX_GPIOTE_CONFIG_OUT_TASK_LOW              \
+    {                                                \
+        .init_state = NRF_GPIOTE_INITIAL_VALUE_HIGH, \
+        .task_pin   = true,                          \
+        .action     = NRF_GPIOTE_POLARITY_HITOLO,    \
+    }
+
+/**@brief Macro for configuring a pin to use the GPIO OUT TASK to change the state from low to high.
+ * @details The task will set the pin. Therefore, the pin is cleared initially.  */
+#define NRFX_GPIOTE_CONFIG_OUT_TASK_HIGH            \
+    {                                               \
+        .init_state = NRF_GPIOTE_INITIAL_VALUE_LOW, \
+        .task_pin   = true,                         \
+        .action     = NRF_GPIOTE_POLARITY_LOTOHI,   \
+    }
+
+/**@brief Macro for configuring a pin to use the GPIO OUT TASK to toggle the pin state.
+ * @details The initial pin state must be provided.  */
+#define NRFX_GPIOTE_CONFIG_OUT_TASK_TOGGLE(init_high)                                           \
+    {                                                                                           \
+        .init_state = init_high ? NRF_GPIOTE_INITIAL_VALUE_HIGH : NRF_GPIOTE_INITIAL_VALUE_LOW, \
+        .task_pin   = true,                                                                     \
+        .action     = NRF_GPIOTE_POLARITY_TOGGLE,                                               \
+    }
+
+/** @brief Pin. */
+typedef uint32_t nrfx_gpiote_pin_t;
+
+/**
+ * @brief Pin event handler prototype.
+ *
+ * @param pin    Pin that triggered this event.
+ * @param action Action that lead to triggering this event.
+ */
+typedef void (*nrfx_gpiote_evt_handler_t)(nrfx_gpiote_pin_t pin, nrf_gpiote_polarity_t action);
+
+/**
+ * @brief Function for initializing the GPIOTE module.
+ *
+ * @details Only static configuration is supported to prevent the shared
+ * resource being customized by the initiator.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
+ */
+nrfx_err_t nrfx_gpiote_init(void);
+
+/**
+ * @brief Function for checking if the GPIOTE module is initialized.
+ *
+ * @details The GPIOTE module is a shared module. Therefore, you should check if
+ * the module is already initialized and skip initialization if it is.
+ *
+ * @retval true  If the module is already initialized.
+ * @retval false If the module is not initialized.
+ */
+bool nrfx_gpiote_is_init(void);
+
+/**
+ * @brief Function for uninitializing the GPIOTE module.
+ */
+void nrfx_gpiote_uninit(void);
+
+/**
+ * @brief Function for initializing a GPIOTE output pin.
+ * @details The output pin can be controlled by the CPU or by PPI. The initial
+ * configuration specifies which mode is used. If PPI mode is used, the driver
+ * attempts to allocate one of the available GPIOTE channels. If no channel is
+ * available, an error is returned.
+ *
+ * @param[in] pin      Pin.
+ * @param[in] p_config Initial configuration.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver is not initialized or the pin is already used.
+ * @retval NRFX_ERROR_NO_MEM        If no GPIOTE channel is available.
+ */
+nrfx_err_t nrfx_gpiote_out_init(nrfx_gpiote_pin_t                pin,
+                                nrfx_gpiote_out_config_t const * p_config);
+
+/**
+ * @brief Function for uninitializing a GPIOTE output pin.
+ * @details The driver frees the GPIOTE channel if the output pin was using one.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_out_uninit(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for setting a GPIOTE output pin.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_out_set(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for clearing a GPIOTE output pin.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_out_clear(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for toggling a GPIOTE output pin.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_out_toggle(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for enabling a GPIOTE output pin task.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_out_task_enable(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for disabling a GPIOTE output pin task.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_out_task_disable(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for getting the address of a configurable GPIOTE task.
+ *
+ * @param[in] pin Pin.
+ *
+ * @return Address of OUT task.
+ */
+uint32_t nrfx_gpiote_out_task_addr_get(nrfx_gpiote_pin_t pin);
+
+#if defined(GPIOTE_FEATURE_SET_PRESENT) || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Function for getting the address of a configurable GPIOTE task.
+ *
+ * @param[in] pin Pin.
+ *
+ * @return Address of SET task.
+ */
+uint32_t nrfx_gpiote_set_task_addr_get(nrfx_gpiote_pin_t pin);
+#endif // defined(GPIOTE_FEATURE_SET_PRESENT) || defined(__NRFX_DOXYGEN__)
+
+#if defined(GPIOTE_FEATURE_CLR_PRESENT) || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Function for getting the address of a configurable GPIOTE task.
+ *
+ * @param[in] pin Pin.
+ *
+ * @return Address of CLR task.
+ */
+uint32_t nrfx_gpiote_clr_task_addr_get(nrfx_gpiote_pin_t pin);
+#endif // defined(GPIOTE_FEATURE_CLR_PRESENT) || defined(__NRFX_DOXYGEN__)
+
+/**
+ * @brief Function for initializing a GPIOTE input pin.
+ * @details The input pin can act in two ways:
+ * - lower accuracy but low power (high frequency clock not needed)
+ * - higher accuracy (high frequency clock required)
+ *
+ * The initial configuration specifies which mode is used.
+ * If high-accuracy mode is used, the driver attempts to allocate one
+ * of the available GPIOTE channels. If no channel is
+ * available, an error is returned.
+ * In low accuracy mode SENSE feature is used. In this case only one active pin
+ * can be detected at a time. It can be worked around by setting all of the used
+ * low accuracy pins to toggle mode.
+ * For more information about SENSE functionality, refer to Product Specification.
+ *
+ * @param[in] pin         Pin.
+ * @param[in] p_config    Initial configuration.
+ * @param[in] evt_handler User function to be called when the configured transition occurs.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver is not initialized or the pin is already used.
+ * @retval NRFX_ERROR_NO_MEM        If no GPIOTE channel is available.
+ */
+nrfx_err_t nrfx_gpiote_in_init(nrfx_gpiote_pin_t               pin,
+                               nrfx_gpiote_in_config_t const * p_config,
+                               nrfx_gpiote_evt_handler_t       evt_handler);
+
+/**
+ * @brief Function for uninitializing a GPIOTE input pin.
+ * @details The driver frees the GPIOTE channel if the input pin was using one.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_in_uninit(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for enabling sensing of a GPIOTE input pin.
+ *
+ * @details If the input pin is configured as high-accuracy pin, the function
+ * enables an IN_EVENT. Otherwise, the function enables the GPIO sense mechanism.
+ * Note that a PORT event is shared between multiple pins, therefore the
+ * interrupt is always enabled.
+ *
+ * @param[in] pin        Pin.
+ * @param[in] int_enable True to enable the interrupt. Always valid for a high-accuracy pin.
+ */
+void nrfx_gpiote_in_event_enable(nrfx_gpiote_pin_t pin, bool int_enable);
+
+/**
+ * @brief Function for disabling a GPIOTE input pin.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_in_event_disable(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for checking if a GPIOTE input pin is set.
+ *
+ * @param[in] pin Pin.
+ *
+ * @retval true  If the input pin is set.
+ * @retval false If the input pin is not set.
+ */
+bool nrfx_gpiote_in_is_set(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for getting the address of a GPIOTE input pin event.
+ * @details If the pin is configured to use low-accuracy mode, the address of the PORT event is returned.
+ *
+ * @param[in] pin Pin.
+ */
+uint32_t nrfx_gpiote_in_event_addr_get(nrfx_gpiote_pin_t pin);
+
+/**
+ * @brief Function for forcing a specific state on the pin configured as task.
+ *
+ * @param[in] pin   Pin.
+ * @param[in] state Pin state.
+ */
+void nrfx_gpiote_out_task_force(nrfx_gpiote_pin_t pin, uint8_t state);
+
+/**
+ * @brief Function for triggering the task OUT manually.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_out_task_trigger(nrfx_gpiote_pin_t pin);
+
+#if defined(GPIOTE_FEATURE_SET_PRESENT) || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Function for triggering the task SET manually.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_set_task_trigger(nrfx_gpiote_pin_t pin);
+#endif // defined(GPIOTE_FEATURE_SET_PRESENT) || defined(__NRFX_DOXYGEN__)
+
+#if defined(GPIOTE_FEATURE_CLR_PRESENT) || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Function for triggering the task CLR manually.
+ *
+ * @param[in] pin Pin.
+ */
+void nrfx_gpiote_clr_task_trigger(nrfx_gpiote_pin_t pin);
+#endif // defined(GPIOTE_FEATURE_CLR_PRESENT) || defined(__NRFX_DOXYGEN__)
+
+
+void nrfx_gpiote_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_GPIOTE_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_i2s.h

@@ -1,254 +1,245 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_I2S_H__
-#define NRFX_I2S_H__
-
-#include <nrfx.h>
-#include <hal/nrf_i2s.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_i2s I2S driver
- * @{
- * @ingroup nrf_i2s
- * @brief   Inter-IC Sound (I2S) peripheral driver.
- */
-
-
-/**
- * @brief This value can be provided instead of a pin number for the signals
- *        SDOUT, SDIN, and MCK to specify that a given signal is not used
- *        and therefore does not need to be connected to a pin.
- */
-#define NRFX_I2S_PIN_NOT_USED  0xFF
-
-/** @brief I2S driver configuration structure. */
-typedef struct
-{
-    uint8_t sck_pin;      ///< SCK pin number.
-    uint8_t lrck_pin;     ///< LRCK pin number.
-    uint8_t mck_pin;      ///< MCK pin number.
-                          /**< Optional. Use @ref NRFX_I2S_PIN_NOT_USED
-                           *   if this signal is not needed. */
-    uint8_t sdout_pin;    ///< SDOUT pin number.
-                          /**< Optional. Use @ref NRFX_I2S_PIN_NOT_USED
-                           *   if this signal is not needed. */
-    uint8_t sdin_pin;     ///< SDIN pin number.
-                          /**< Optional. Use @ref NRFX_I2S_PIN_NOT_USED
-                           *   if this signal is not needed. */
-    uint8_t irq_priority; ///< Interrupt priority.
-
-    nrf_i2s_mode_t     mode;         ///< Mode of operation.
-    nrf_i2s_format_t   format;       ///< Frame format.
-    nrf_i2s_align_t    alignment;    ///< Alignment of sample within a frame.
-    nrf_i2s_swidth_t   sample_width; ///< Sample width.
-    nrf_i2s_channels_t channels;     ///< Enabled channels.
-    nrf_i2s_mck_t      mck_setup;    ///< Master clock setup.
-    nrf_i2s_ratio_t    ratio;        ///< MCK/LRCK ratio.
-} nrfx_i2s_config_t;
-
-/** @brief I2S driver buffers structure. */
-typedef struct
-{
-    uint32_t       * p_rx_buffer;
-    uint32_t const * p_tx_buffer;
-} nrfx_i2s_buffers_t;
-
-/**
- * @brief I2S driver default configuration.
- */
-#define NRFX_I2S_DEFAULT_CONFIG                                   \
-{                                                                 \
-    .sck_pin      = NRFX_I2S_CONFIG_SCK_PIN,                      \
-    .lrck_pin     = NRFX_I2S_CONFIG_LRCK_PIN,                     \
-    .mck_pin      = NRFX_I2S_CONFIG_MCK_PIN,                      \
-    .sdout_pin    = NRFX_I2S_CONFIG_SDOUT_PIN,                    \
-    .sdin_pin     = NRFX_I2S_CONFIG_SDIN_PIN,                     \
-    .irq_priority = NRFX_I2S_CONFIG_IRQ_PRIORITY,                 \
-    .mode         = (nrf_i2s_mode_t)NRFX_I2S_CONFIG_MASTER,       \
-    .format       = (nrf_i2s_format_t)NRFX_I2S_CONFIG_FORMAT,     \
-    .alignment    = (nrf_i2s_align_t)NRFX_I2S_CONFIG_ALIGN,       \
-    .sample_width = (nrf_i2s_swidth_t)NRFX_I2S_CONFIG_SWIDTH,     \
-    .channels     = (nrf_i2s_channels_t)NRFX_I2S_CONFIG_CHANNELS, \
-    .mck_setup    = (nrf_i2s_mck_t)NRFX_I2S_CONFIG_MCK_SETUP,     \
-    .ratio        = (nrf_i2s_ratio_t)NRFX_I2S_CONFIG_RATIO,       \
-}
-
-
-#define NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED  (1UL << 0)
-    /**< The application should provide buffers that are to be used in the next
-     *   part of the transfer. A call to @ref nrfx_i2s_next_buffers_set should
-     *   be done before the currently used buffers are completely processed
-     *   (i.e. the time remaining for supplying the next buffers depends on
-     *   the used size of the buffers). */
-
-/**
- * @brief I2S driver data handler type.
- *
- * A data handling function of this type must be specified during initialization
- * of the driver. The driver will call this function when it finishes using
- * buffers passed to it by the application, and when it needs to be provided
- * with buffers for the next part of the transfer.
- *
- * @note The @c p_released pointer passed to this function is temporary and
- *       will be invalid after the function returns, hence it cannot be stored
- *       and used later. If needed, the pointed content (i.e. buffers pointers)
- *       should be copied instead.
- *
- * @param[in] p_released  Pointer to a structure with pointers to buffers
- *                        passed previously to the driver that will no longer
- *                        be access by it (they can be now safely released or
- *                        used for another purpose, in particular for a next
- *                        part of the transfer).
- *                        This pointer will be NULL if the application did not
- *                        supply the buffers for the next part of the transfer
- *                        (via a call to @ref nrfx_i2s_next_buffers_set) since
- *                        the previous time the data handler signaled such need.
- *                        This means that data corruption occurred (the previous
- *                        buffers are used for the second time) and no buffers
- *                        can be released at the moment.
- *                        Both pointers in this structure are NULL when the
- *                        handler is called for the first time after a transfer
- *                        is started, because no data has been transferred yet
- *                        at this point. In all successive calls the pointers
- *                        specify what has been sent (TX) and what has been
- *                        received (RX) in the part of transfer that has just
- *                        been completed (provided that a given direction is
- *                        enabled, see @ref nrfx_i2s_start).
- * @param[in] status  Bit field describing the current status of the transfer.
- *                    It can be 0 or a combination of the following flags:
- *                    - @ref NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED
- */
-typedef void (* nrfx_i2s_data_handler_t)(nrfx_i2s_buffers_t const * p_released,
-                                         uint32_t                   status);
-
-
-/**
- * @brief Function for initializing the I2S driver.
- *
- * @param[in] p_config  Pointer to the structure with initial configuration.
- * @param[in] handler   Data handler provided by the user. Must not be NULL.
- *
- * @retval NRFX_SUCCESS              If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE  If the driver was already initialized.
- * @retval NRFX_ERROR_INVALID_PARAM  If the requested combination of configuration
- *                                   options is not allowed by the I2S peripheral.
- */
-nrfx_err_t nrfx_i2s_init(nrfx_i2s_config_t const * p_config,
-                         nrfx_i2s_data_handler_t   handler);
-
-/** @brief Function for uninitializing the I2S driver. */
-void nrfx_i2s_uninit(void);
-
-/**
- * @brief Function for starting the continuous I2S transfer.
- *
- * The I2S data transfer can be performed in one of three modes: RX (reception)
- * only, TX (transmission) only, or in both directions simultaneously.
- * The mode is selected by specifying a proper buffer for a given direction
- * in the call to this function or by passing NULL instead if this direction
- * should be disabled.
- *
- * The length of the buffer (which is a common value for RX and TX if both
- * directions are enabled) is specified in 32-bit words. One 32-bit memory
- * word can either contain four 8-bit samples, two 16-bit samples, or one
- * right-aligned 24-bit sample sign-extended to a 32-bit value.
- * For a detailed memory mapping for different supported configurations,
- * see the @linkProductSpecification52.
- *
- * @note Peripherals using EasyDMA (including I2S) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param[in] p_initial_buffers  Pointer to a structure specifying the buffers
- *                               to be used in the initial part of the transfer
- *                               (buffers for all consecutive parts are provided
- *                               through the data handler).
- * @param[in] buffer_size        Size of the buffers (in 32-bit words).
- *                               Must not be 0.
- * @param[in] flags              Transfer options (0 for default settings).
- *                               Currently, no additional flags are available.
- *
- * @retval NRFX_SUCCESS              If the operation was successful.
- * @retval NRFX_ERROR_INVALID_STATE  If a transfer was already started or
- *                                   the driver has not been initialized.
- * @retval NRFX_ERROR_INVALID_ADDR   If the provided buffers are not placed
- *                                   in the Data RAM region.
- */
-nrfx_err_t nrfx_i2s_start(nrfx_i2s_buffers_t const * p_initial_buffers,
-                          uint16_t                   buffer_size,
-                          uint8_t                    flags);
-
-/**
- * @brief Function for supplying the buffers to be used in the next part of
- *        the transfer.
- *
- * The application should call this function when the data handler receives
- * @ref NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED in the @c status parameter.
- * The call can be done immediately from the data handler function or later,
- * but it has to be done before the I2S peripheral finishes processing the
- * buffers supplied previously. Otherwise, data corruption will occur.
- *
- * @sa nrfx_i2s_data_handler_t
- *
- * @retval NRFX_SUCCESS              If the operation was successful.
- * @retval NRFX_ERROR_INVALID_STATE  If the buffers were already supplied or
- *                                   the peripheral is currently being stopped.
- */
-nrfx_err_t nrfx_i2s_next_buffers_set(nrfx_i2s_buffers_t const * p_buffers);
-
-/** @brief Function for stopping the I2S transfer. */
-void nrfx_i2s_stop(void);
-
-/** @} */
-
-
-void nrfx_i2s_irq_handler(void);
-
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_I2S_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_I2S_H__
+#define NRFX_I2S_H__
+
+#include <nrfx.h>
+#include <hal/nrf_i2s.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_i2s I2S driver
+ * @{
+ * @ingroup nrf_i2s
+ * @brief   Inter-IC Sound (I2S) peripheral driver.
+ */
+
+
+/**
+ * @brief This value can be provided instead of a pin number for the signals
+ *        SDOUT, SDIN, and MCK to specify that a given signal is not used
+ *        and therefore does not need to be connected to a pin.
+ */
+#define NRFX_I2S_PIN_NOT_USED  0xFF
+
+/** @brief I2S driver configuration structure. */
+typedef struct
+{
+    uint8_t sck_pin;      ///< SCK pin number.
+    uint8_t lrck_pin;     ///< LRCK pin number.
+    uint8_t mck_pin;      ///< MCK pin number.
+                          /**< Optional. Use @ref NRFX_I2S_PIN_NOT_USED
+                           *   if this signal is not needed. */
+    uint8_t sdout_pin;    ///< SDOUT pin number.
+                          /**< Optional. Use @ref NRFX_I2S_PIN_NOT_USED
+                           *   if this signal is not needed. */
+    uint8_t sdin_pin;     ///< SDIN pin number.
+                          /**< Optional. Use @ref NRFX_I2S_PIN_NOT_USED
+                           *   if this signal is not needed. */
+    uint8_t irq_priority; ///< Interrupt priority.
+
+    nrf_i2s_mode_t     mode;         ///< Mode of operation.
+    nrf_i2s_format_t   format;       ///< Frame format.
+    nrf_i2s_align_t    alignment;    ///< Alignment of sample within a frame.
+    nrf_i2s_swidth_t   sample_width; ///< Sample width.
+    nrf_i2s_channels_t channels;     ///< Enabled channels.
+    nrf_i2s_mck_t      mck_setup;    ///< Master clock setup.
+    nrf_i2s_ratio_t    ratio;        ///< MCK/LRCK ratio.
+} nrfx_i2s_config_t;
+
+/** @brief I2S driver buffers structure. */
+typedef struct
+{
+    uint32_t       * p_rx_buffer;
+    uint32_t const * p_tx_buffer;
+} nrfx_i2s_buffers_t;
+
+/**
+ * @brief I2S driver default configuration.
+ */
+#define NRFX_I2S_DEFAULT_CONFIG                                   \
+{                                                                 \
+    .sck_pin      = NRFX_I2S_CONFIG_SCK_PIN,                      \
+    .lrck_pin     = NRFX_I2S_CONFIG_LRCK_PIN,                     \
+    .mck_pin      = NRFX_I2S_CONFIG_MCK_PIN,                      \
+    .sdout_pin    = NRFX_I2S_CONFIG_SDOUT_PIN,                    \
+    .sdin_pin     = NRFX_I2S_CONFIG_SDIN_PIN,                     \
+    .irq_priority = NRFX_I2S_CONFIG_IRQ_PRIORITY,                 \
+    .mode         = (nrf_i2s_mode_t)NRFX_I2S_CONFIG_MASTER,       \
+    .format       = (nrf_i2s_format_t)NRFX_I2S_CONFIG_FORMAT,     \
+    .alignment    = (nrf_i2s_align_t)NRFX_I2S_CONFIG_ALIGN,       \
+    .sample_width = (nrf_i2s_swidth_t)NRFX_I2S_CONFIG_SWIDTH,     \
+    .channels     = (nrf_i2s_channels_t)NRFX_I2S_CONFIG_CHANNELS, \
+    .mck_setup    = (nrf_i2s_mck_t)NRFX_I2S_CONFIG_MCK_SETUP,     \
+    .ratio        = (nrf_i2s_ratio_t)NRFX_I2S_CONFIG_RATIO,       \
+}
+
+
+#define NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED  (1UL << 0)
+    /**< The application should provide buffers that are to be used in the next
+     *   part of the transfer. A call to @ref nrfx_i2s_next_buffers_set should
+     *   be done before the currently used buffers are completely processed
+     *   (i.e. the time remaining for supplying the next buffers depends on
+     *   the used size of the buffers). */
+
+/**
+ * @brief I2S driver data handler type.
+ *
+ * A data handling function of this type must be specified during initialization
+ * of the driver. The driver will call this function when it finishes using
+ * buffers passed to it by the application, and when it needs to be provided
+ * with buffers for the next part of the transfer.
+ *
+ * @note The @c p_released pointer passed to this function is temporary and
+ *       will be invalid after the function returns, hence it cannot be stored
+ *       and used later. If needed, the pointed content (i.e. buffers pointers)
+ *       should be copied instead.
+ *
+ * @param[in] p_released  Pointer to a structure with pointers to buffers
+ *                        passed previously to the driver that will no longer
+ *                        be access by it (they can be now safely released or
+ *                        used for another purpose, in particular for a next
+ *                        part of the transfer).
+ *                        This pointer will be NULL if the application did not
+ *                        supply the buffers for the next part of the transfer
+ *                        (via a call to @ref nrfx_i2s_next_buffers_set) since
+ *                        the previous time the data handler signaled such need.
+ *                        This means that data corruption occurred (the previous
+ *                        buffers are used for the second time) and no buffers
+ *                        can be released at the moment.
+ *                        Both pointers in this structure are NULL when the
+ *                        handler is called for the first time after a transfer
+ *                        is started, because no data has been transferred yet
+ *                        at this point. In all successive calls the pointers
+ *                        specify what has been sent (TX) and what has been
+ *                        received (RX) in the part of transfer that has just
+ *                        been completed (provided that a given direction is
+ *                        enabled, see @ref nrfx_i2s_start).
+ * @param[in] status  Bit field describing the current status of the transfer.
+ *                    It can be 0 or a combination of the following flags:
+ *                    - @ref NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED
+ */
+typedef void (* nrfx_i2s_data_handler_t)(nrfx_i2s_buffers_t const * p_released,
+                                         uint32_t                   status);
+
+
+/**
+ * @brief Function for initializing the I2S driver.
+ *
+ * @param[in] p_config  Pointer to the structure with initial configuration.
+ * @param[in] handler   Data handler provided by the user. Must not be NULL.
+ *
+ * @retval NRFX_SUCCESS              If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE  If the driver was already initialized.
+ * @retval NRFX_ERROR_INVALID_PARAM  If the requested combination of configuration
+ *                                   options is not allowed by the I2S peripheral.
+ */
+nrfx_err_t nrfx_i2s_init(nrfx_i2s_config_t const * p_config,
+                         nrfx_i2s_data_handler_t   handler);
+
+/** @brief Function for uninitializing the I2S driver. */
+void nrfx_i2s_uninit(void);
+
+/**
+ * @brief Function for starting the continuous I2S transfer.
+ *
+ * The I2S data transfer can be performed in one of three modes: RX (reception)
+ * only, TX (transmission) only, or in both directions simultaneously.
+ * The mode is selected by specifying a proper buffer for a given direction
+ * in the call to this function or by passing NULL instead if this direction
+ * should be disabled.
+ *
+ * The length of the buffer (which is a common value for RX and TX if both
+ * directions are enabled) is specified in 32-bit words. One 32-bit memory
+ * word can either contain four 8-bit samples, two 16-bit samples, or one
+ * right-aligned 24-bit sample sign-extended to a 32-bit value.
+ * For a detailed memory mapping for different supported configurations,
+ * see the @linkProductSpecification52.
+ *
+ * @note Peripherals using EasyDMA (including I2S) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param[in] p_initial_buffers  Pointer to a structure specifying the buffers
+ *                               to be used in the initial part of the transfer
+ *                               (buffers for all consecutive parts are provided
+ *                               through the data handler).
+ * @param[in] buffer_size        Size of the buffers (in 32-bit words).
+ *                               Must not be 0.
+ * @param[in] flags              Transfer options (0 for default settings).
+ *                               Currently, no additional flags are available.
+ *
+ * @retval NRFX_SUCCESS              If the operation was successful.
+ * @retval NRFX_ERROR_INVALID_STATE  If a transfer was already started or
+ *                                   the driver has not been initialized.
+ * @retval NRFX_ERROR_INVALID_ADDR   If the provided buffers are not placed
+ *                                   in the Data RAM region.
+ */
+nrfx_err_t nrfx_i2s_start(nrfx_i2s_buffers_t const * p_initial_buffers,
+                          uint16_t                   buffer_size,
+                          uint8_t                    flags);
+
+/**
+ * @brief Function for supplying the buffers to be used in the next part of
+ *        the transfer.
+ *
+ * The application should call this function when the data handler receives
+ * @ref NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED in the @c status parameter.
+ * The call can be done immediately from the data handler function or later,
+ * but it has to be done before the I2S peripheral finishes processing the
+ * buffers supplied previously. Otherwise, data corruption will occur.
+ *
+ * @sa nrfx_i2s_data_handler_t
+ *
+ * @retval NRFX_SUCCESS              If the operation was successful.
+ * @retval NRFX_ERROR_INVALID_STATE  If the buffers were already supplied or
+ *                                   the peripheral is currently being stopped.
+ */
+nrfx_err_t nrfx_i2s_next_buffers_set(nrfx_i2s_buffers_t const * p_buffers);
+
+/** @brief Function for stopping the I2S transfer. */
+void nrfx_i2s_stop(void);
+
+/** @} */
+
+
+void nrfx_i2s_irq_handler(void);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_I2S_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_lpcomp.h

@@ -1,150 +1,141 @@
-/**
- * Copyright (c) 2014 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_LPCOMP_H__
-#define NRFX_LPCOMP_H__
-
-#include <nrfx.h>
-#include <hal/nrf_lpcomp.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_lpcomp LPCOMP driver
- * @{
- * @ingroup nrf_lpcomp
- * @brief   Low Power Comparator (LPCOMP) peripheral driver.
- */
-
-/**
- * @brief LPCOMP event handler function type.
- * @param[in] event  LPCOMP event.
- */
-typedef void (* nrfx_lpcomp_event_handler_t)(nrf_lpcomp_event_t event);
-
-/** @brief LPCOMP configuration. */
-typedef struct
-{
-    nrf_lpcomp_config_t hal;                /**< LPCOMP HAL configuration. */
-    nrf_lpcomp_input_t  input;              /**< Input to be monitored. */
-    uint8_t             interrupt_priority; /**< LPCOMP interrupt priority. */
-} nrfx_lpcomp_config_t;
-
-/** @brief LPCOMP driver default configuration including the LPCOMP HAL configuration. */
-#ifdef NRF52_SERIES
-#define NRFX_LPCOMP_DEFAULT_CONFIG                                      \
-    {                                                                   \
-        .hal    = { (nrf_lpcomp_ref_t)NRFX_LPCOMP_CONFIG_REFERENCE ,    \
-                    (nrf_lpcomp_detect_t)NRFX_LPCOMP_CONFIG_DETECTION,  \
-                    (nrf_lpcomp_hysteresis_t)NRFX_LPCOMP_CONFIG_HYST }, \
-        .input  = (nrf_lpcomp_input_t)NRFX_LPCOMP_CONFIG_INPUT,         \
-        .interrupt_priority = NRFX_LPCOMP_CONFIG_IRQ_PRIORITY           \
-    }
-#else
-#define NRFX_LPCOMP_DEFAULT_CONFIG                                       \
-    {                                                                    \
-        .hal    = { (nrf_lpcomp_ref_t)NRFX_LPCOMP_CONFIG_REFERENCE ,     \
-                    (nrf_lpcomp_detect_t)NRFX_LPCOMP_CONFIG_DETECTION }, \
-        .input  = (nrf_lpcomp_input_t)NRFX_LPCOMP_CONFIG_INPUT,          \
-        .interrupt_priority = NRFX_LPCOMP_CONFIG_IRQ_PRIORITY            \
-    }
-#endif
-
-/**
- * @brief Function for initializing the LPCOMP driver.
- *
- * This function initializes the LPCOMP driver, but does not enable the peripheral or any interrupts.
- * To start the driver, call the function nrfx_lpcomp_enable() after initialization.
- *
- * @param[in] p_config      Pointer to the structure with initial configuration.
- * @param[in] event_handler Event handler provided by the user.
- *                          Must not be NULL.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver has already been initialized.
- * @retval NRFX_ERROR_BUSY          If the COMP peripheral is already in use.
- *                                  This is possible only if @ref nrfx_prs module
- *                                  is enabled.
- */
-nrfx_err_t nrfx_lpcomp_init(nrfx_lpcomp_config_t const * p_config,
-                            nrfx_lpcomp_event_handler_t  event_handler);
-
-/**
- *  @brief Function for uninitializing the LCOMP driver.
- *
- *  This function uninitializes the LPCOMP driver. The LPCOMP peripheral and
- *  its interrupts are disabled, and local variables are cleaned. After this call, you must
- *  initialize the driver again by calling nrfx_lpcomp_init() if you want to use it.
- *
- *  @sa nrfx_lpcomp_disable()
- *  @sa nrfx_lpcomp_init()
- */
-void  nrfx_lpcomp_uninit(void);
-
-/**@brief Function for enabling the LPCOMP peripheral and interrupts.
- *
- * Before calling this function, the driver must be initialized. This function
- * enables the LPCOMP peripheral and its interrupts.
- *
- * @sa nrfx_lpcomp_disable()
- */
-void nrfx_lpcomp_enable(void);
-
-/**@brief Function for disabling the LPCOMP peripheral.
- *
- * Before calling this function, the driver must be initialized. This function disables the LPCOMP
- * peripheral and its interrupts.
- *
- * @sa nrfx_lpcomp_enable()
- */
-void nrfx_lpcomp_disable(void);
-
-
-void nrfx_lpcomp_irq_handler(void);
-
-/** @} **/
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_LPCOMP_H__
+/*
+ * Copyright (c) 2014 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_LPCOMP_H__
+#define NRFX_LPCOMP_H__
+
+#include <nrfx.h>
+#include <hal/nrf_lpcomp.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_lpcomp LPCOMP driver
+ * @{
+ * @ingroup nrf_lpcomp
+ * @brief   Low Power Comparator (LPCOMP) peripheral driver.
+ */
+
+/**
+ * @brief LPCOMP event handler function type.
+ * @param[in] event  LPCOMP event.
+ */
+typedef void (* nrfx_lpcomp_event_handler_t)(nrf_lpcomp_event_t event);
+
+/** @brief LPCOMP configuration. */
+typedef struct
+{
+    nrf_lpcomp_config_t hal;                /**< LPCOMP HAL configuration. */
+    nrf_lpcomp_input_t  input;              /**< Input to be monitored. */
+    uint8_t             interrupt_priority; /**< LPCOMP interrupt priority. */
+} nrfx_lpcomp_config_t;
+
+/** @brief LPCOMP driver default configuration including the LPCOMP HAL configuration. */
+#ifdef NRF52_SERIES
+#define NRFX_LPCOMP_DEFAULT_CONFIG                                      \
+    {                                                                   \
+        .hal    = { (nrf_lpcomp_ref_t)NRFX_LPCOMP_CONFIG_REFERENCE ,    \
+                    (nrf_lpcomp_detect_t)NRFX_LPCOMP_CONFIG_DETECTION,  \
+                    (nrf_lpcomp_hysteresis_t)NRFX_LPCOMP_CONFIG_HYST }, \
+        .input  = (nrf_lpcomp_input_t)NRFX_LPCOMP_CONFIG_INPUT,         \
+        .interrupt_priority = NRFX_LPCOMP_CONFIG_IRQ_PRIORITY           \
+    }
+#else
+#define NRFX_LPCOMP_DEFAULT_CONFIG                                       \
+    {                                                                    \
+        .hal    = { (nrf_lpcomp_ref_t)NRFX_LPCOMP_CONFIG_REFERENCE ,     \
+                    (nrf_lpcomp_detect_t)NRFX_LPCOMP_CONFIG_DETECTION }, \
+        .input  = (nrf_lpcomp_input_t)NRFX_LPCOMP_CONFIG_INPUT,          \
+        .interrupt_priority = NRFX_LPCOMP_CONFIG_IRQ_PRIORITY            \
+    }
+#endif
+
+/**
+ * @brief Function for initializing the LPCOMP driver.
+ *
+ * This function initializes the LPCOMP driver, but does not enable the peripheral or any interrupts.
+ * To start the driver, call the function nrfx_lpcomp_enable() after initialization.
+ *
+ * @param[in] p_config      Pointer to the structure with initial configuration.
+ * @param[in] event_handler Event handler provided by the user.
+ *                          Must not be NULL.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver has already been initialized.
+ * @retval NRFX_ERROR_BUSY          If the COMP peripheral is already in use.
+ *                                  This is possible only if @ref nrfx_prs module
+ *                                  is enabled.
+ */
+nrfx_err_t nrfx_lpcomp_init(nrfx_lpcomp_config_t const * p_config,
+                            nrfx_lpcomp_event_handler_t  event_handler);
+
+/**
+ *  @brief Function for uninitializing the LCOMP driver.
+ *
+ *  This function uninitializes the LPCOMP driver. The LPCOMP peripheral and
+ *  its interrupts are disabled, and local variables are cleaned. After this call, you must
+ *  initialize the driver again by calling nrfx_lpcomp_init() if you want to use it.
+ *
+ *  @sa nrfx_lpcomp_disable()
+ *  @sa nrfx_lpcomp_init()
+ */
+void  nrfx_lpcomp_uninit(void);
+
+/**@brief Function for enabling the LPCOMP peripheral and interrupts.
+ *
+ * Before calling this function, the driver must be initialized. This function
+ * enables the LPCOMP peripheral and its interrupts.
+ *
+ * @sa nrfx_lpcomp_disable()
+ */
+void nrfx_lpcomp_enable(void);
+
+/**@brief Function for disabling the LPCOMP peripheral.
+ *
+ * Before calling this function, the driver must be initialized. This function disables the LPCOMP
+ * peripheral and its interrupts.
+ *
+ * @sa nrfx_lpcomp_enable()
+ */
+void nrfx_lpcomp_disable(void);
+
+
+void nrfx_lpcomp_irq_handler(void);
+
+/** @} **/
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_LPCOMP_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_nfct.h

@@ -0,0 +1,366 @@
+/*
+ * Copyright (c) 2018 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_NFCT_H__
+#define NRFX_NFCT_H__
+
+#include <nrfx.h>
+#include <hal/nrf_nfct.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_nfct NFCT driver
+ * @{
+ * @ingroup nrf_nfct
+ * @brief   Near Field Communication Tag (NFCT) peripheral driver.
+ */
+
+#define NRFX_NFCT_NFCID1_SINGLE_SIZE 4u  ///< Length of single-size NFCID1.
+#define NRFX_NFCT_NFCID1_DOUBLE_SIZE 7u  ///< Length of double-size NFCID1.
+#define NRFX_NFCT_NFCID1_TRIPLE_SIZE 10u ///< Length of triple-size NFCID1.
+
+#define NRFX_NFCT_NFCID1_DEFAULT_LEN NRFX_NFCT_NFCID1_DOUBLE_SIZE ///< Default length of NFC ID. */
+
+/**
+ * @brief NFCT hardware states.
+ */
+typedef enum
+{
+    NRFX_NFCT_STATE_DISABLED  = NRF_NFCT_TASK_DISABLE,  ///< NFC Tag is disabled (no sensing of an external NFC field).
+    NRFX_NFCT_STATE_SENSING   = NRF_NFCT_TASK_SENSE,    ///< NFC Tag is sensing whether there is an external NFC field.
+    NRFX_NFCT_STATE_ACTIVATED = NRF_NFCT_TASK_ACTIVATE, ///< NFC Tag is powered-up (see @ref nrfx_nfct_active_state_t for possible substates).
+} nrfx_nfct_state_t;
+
+/**
+ * @brief NFC tag states, when NFCT hardware is activated.
+ *
+ * @details These states are substates of the @ref NRFX_NFCT_STATE_ACTIVATED state.
+ */
+typedef enum
+{
+    NRFX_NFCT_ACTIVE_STATE_IDLE  = NRF_NFCT_TASK_GOIDLE,  ///< NFC Tag is activated and idle (not selected by a reader).
+    NRFX_NFCT_ACTIVE_STATE_SLEEP = NRF_NFCT_TASK_GOSLEEP, ///< NFC Tag is sleeping.
+    NRFX_NFCT_ACTIVE_STATE_DEFAULT,                       ///< NFC Tag is either sleeping or idle, depending on the previous state before being selected by a poller.
+} nrfx_nfct_active_state_t;
+
+/** 
+ * @brief NFCT driver event types, passed to the upper-layer callback function
+ *        provided during the initialization.
+ */
+typedef enum
+{
+    NRFX_NFCT_EVT_FIELD_DETECTED = NRF_NFCT_INT_FIELDDETECTED_MASK, ///< External NFC field is detected.
+    NRFX_NFCT_EVT_FIELD_LOST     = NRF_NFCT_INT_FIELDLOST_MASK,     ///< External NFC Field is lost.
+    NRFX_NFCT_EVT_SELECTED       = NRF_NFCT_INT_SELECTED_MASK,      ///< Tag was selected by the poller.
+    NRFX_NFCT_EVT_RX_FRAMESTART  = NRF_NFCT_INT_RXFRAMESTART_MASK,  ///< Data frame reception started.
+    NRFX_NFCT_EVT_RX_FRAMEEND    = NRF_NFCT_INT_RXFRAMEEND_MASK,    ///< Data frame is received.
+    NRFX_NFCT_EVT_TX_FRAMESTART  = NRF_NFCT_INT_TXFRAMESTART_MASK,  ///< Data frame transmission started.
+    NRFX_NFCT_EVT_TX_FRAMEEND    = NRF_NFCT_INT_TXFRAMEEND_MASK,    ///< Data frame is transmitted.
+    NRFX_NFCT_EVT_ERROR          = NRF_NFCT_INT_ERROR_MASK,         ///< Error occurred in an NFC communication.
+} nrfx_nfct_evt_id_t;
+
+/**
+ * @brief NFCT timing-related error types.
+ */
+typedef enum
+{
+    NRFX_NFCT_ERROR_FRAMEDELAYTIMEOUT, ///< No response frame was transmitted to the poller in the transmit window.
+    NRFX_NFCT_ERROR_NUM,               ///< Total number of possible errors.
+} nrfx_nfct_error_t;
+
+/**
+ * @brief NFCT driver parameter types.
+ */
+typedef enum
+{
+    NRFX_NFCT_PARAM_ID_FDT,     ///< NFC-A Frame Delay Time parameter.
+    NRFX_NFCT_PARAM_ID_SEL_RES, ///< Value of the 'Protocol' field in the NFC-A SEL_RES frame.
+    NRFX_NFCT_PARAM_ID_NFCID1,  ///< NFC-A NFCID1 setting (NFC tag identifier).
+} nrfx_nfct_param_id_t;
+
+/**
+ * @brief NFCID1 descriptor.
+ */
+typedef struct
+{
+    uint8_t const * p_id;    ///< NFCID1 data.
+    uint8_t         id_size; ///< NFCID1 size.
+} nrfx_nfct_nfcid1_t;
+
+/**
+ * @brief NFCT driver parameter descriptor.
+ */
+typedef struct
+{
+    nrfx_nfct_param_id_t   id;               ///< Type of parameter.
+    union
+    {
+        uint32_t           fdt;              ///< NFC-A Frame Delay Time. Filled when nrfx_nfct_param_t::id is @ref NRFX_NFCT_PARAM_ID_FDT.
+        uint8_t            sel_res_protocol; ///< NFC-A value of the 'Protocol' field in the SEL_RES frame. Filled when nrfx_nfct_param_t::id is @ref NRFX_NFCT_PARAM_ID_SEL_RES.
+        nrfx_nfct_nfcid1_t nfcid1;           ///< NFC-A NFCID1 value (tag identifier). Filled when nrfx_nfct_param_t::id is @ref NRFX_NFCT_PARAM_ID_NFCID1.
+    } data;
+} nrfx_nfct_param_t;
+
+/**
+ * @brief NFCT driver RX/TX buffer descriptor.
+ */
+typedef struct
+{
+    uint32_t        data_size; ///< RX/TX buffer size.
+    uint8_t const * p_data;    ///< RX/TX buffer.
+} nrfx_nfct_data_desc_t;
+
+/**
+ * @brief Structure used to describe the @ref NRFX_NFCT_EVT_RX_FRAMEEND event type.
+ */
+typedef struct
+{
+    uint32_t              rx_status; ///< RX error status.
+    nrfx_nfct_data_desc_t rx_data;   ///< RX buffer.
+} nrfx_nfct_evt_rx_frameend_t;
+
+/**
+ * @brief Structure used to describe the @ref NRFX_NFCT_EVT_TX_FRAMESTART event type.
+ */
+typedef struct
+{
+    nrfx_nfct_data_desc_t tx_data; ///< TX buffer.
+} nrfx_nfct_evt_tx_framestart_t;
+
+/**
+ * @brief Structure used to describe the @ref NRFX_NFCT_EVT_ERROR event type.
+ */
+typedef struct
+{
+    nrfx_nfct_error_t reason; ///< Reason for error.
+} nrfx_nfct_evt_error_t;
+
+/**
+ * @brief NFCT driver event.
+ */
+typedef struct
+{
+    nrfx_nfct_evt_id_t evt_id;                       ///< Type of event.
+    union
+    {
+        nrfx_nfct_evt_rx_frameend_t   rx_frameend;   ///< End of the RX frame data. Filled when nrfx_nfct_evt_t::evt_id is @ref NRFX_NFCT_EVT_RX_FRAMEEND.
+        nrfx_nfct_evt_tx_framestart_t tx_framestart; ///< Start of the TX frame data. Filled when nrfx_nfct_evt_t::evt_id is @ref NRFX_NFCT_EVT_TX_FRAMESTART.
+        nrfx_nfct_evt_error_t         error;         ///< Error data. Filled when nrfx_nfct_evt_t::evt_id is @ref NRFX_NFCT_EVT_ERROR.
+    } params;
+} nrfx_nfct_evt_t;
+
+/** 
+ * @brief Callback descriptor to pass events from the NFCT driver to the upper layer.
+ *
+ * @param[in] p_event Pointer to the event descriptor.
+ */
+typedef void (*nrfx_nfct_handler_t)(nrfx_nfct_evt_t const * p_event);
+
+/** 
+ * @brief NFCT driver configuration structure.
+ */
+typedef struct
+{
+    uint32_t            rxtx_int_mask; ///< Mask for enabling RX/TX events. Indicate which events must be forwarded to the upper layer by using @ref nrfx_nfct_evt_id_t. By default, no events are enabled. */
+    nrfx_nfct_handler_t cb;            ///< Callback.
+} nrfx_nfct_config_t;
+
+/** 
+ * @brief Function for initializing the NFCT driver.
+ *
+ * @param[in] p_config  Pointer to the NFCT driver configuration structure.
+ *
+ * @retval NRFX_SUCCESS             If the NFCT driver was initialized successfully.
+ * @retval NRFX_ERROR_INVALID_STATE If the NFCT driver is already initialized.
+ */
+nrfx_err_t nrfx_nfct_init(nrfx_nfct_config_t const * p_config);
+
+/**
+ * @brief Function for uninitializing the NFCT driver.
+ *
+ * After uninitialization, the instance is in disabled state.
+ */
+void nrfx_nfct_uninit(void);
+
+/**
+ * @brief Function for starting the NFC subsystem.
+ *
+ * After this function completes, NFC readers are able to detect the tag.
+ */
+void nrfx_nfct_enable(void);
+
+/**
+ * @brief Function for disabling the NFCT driver.
+ *
+ * After this function returns, NFC readers are no longer able to connect
+ * to the tag.
+ */
+void nrfx_nfct_disable(void);
+
+/**
+ * @brief Function for checking whether the external NFC field is present in the range of the tag.
+ *
+ * @retval true  If the NFC field is present.
+ * @retval false If no NFC field is present.
+ */
+bool nrfx_nfct_field_check(void);
+
+/** 
+ * @brief Function for preparing the NFCT driver for receiving an NFC frame.
+ *
+ * @param[in] p_rx_data  Pointer to the RX buffer.
+ */
+void nrfx_nfct_rx(nrfx_nfct_data_desc_t const * p_rx_data);
+
+/** 
+ * @brief Function for transmitting an NFC frame.
+ *
+ * @param[in] p_tx_data   Pointer to the TX buffer.
+ * @param[in] delay_mode  Delay mode of the NFCT frame timer.
+ *
+ * @retval NRFX_SUCCESS              If the operation was successful.
+ * @retval NRFX_ERROR_INVALID_LENGTH If the TX buffer size is invalid.
+ */
+nrfx_err_t nrfx_nfct_tx(nrfx_nfct_data_desc_t const * p_tx_data,
+                        nrf_nfct_frame_delay_mode_t   delay_mode);
+
+/**
+ * @brief Function for moving the NFCT to a new state.
+ *
+ * @note  The HFCLK must be running before activating the NFCT with
+ *        @ref NRFX_NFCT_STATE_ACTIVATED.
+ *
+ * @param[in] state  The required state.
+ */
+void nrfx_nfct_state_force(nrfx_nfct_state_t state);
+
+/** 
+ * @brief Function for moving the NFCT to a new initial substate within @ref NRFX_NFCT_STATE_ACTIVATED.
+ *
+ * @param[in] sub_state  The required substate.
+ */
+void nrfx_nfct_init_substate_force(nrfx_nfct_active_state_t sub_state);
+
+/**
+ * @brief Function for setting the NFC communication parameter.
+ *
+ * @note Parameter validation for length and acceptable values.
+ *
+ * @param[in] p_param  Pointer to parameter descriptor.
+ *
+ * @retval NRFX_SUCCESS             If the operation was successful.
+ * @retval NRFX_ERROR_INVALID_PARAM If the parameter data is invalid.
+ */
+nrfx_err_t nrfx_nfct_parameter_set(nrfx_nfct_param_t const * p_param);
+
+/** 
+ * @brief Function for getting default bytes for NFCID1.
+ *
+ * @param[in,out] p_nfcid1_buff    In:  empty buffer for data;
+ *                                 Out: buffer with the NFCID1 default data. These values
+ *                                      can be used to fill the Type 2 Tag Internal Bytes.
+ * @param[in]     nfcid1_buff_len  Length of the NFCID1 buffer.
+ *
+ * @retval NRFX_SUCCESS              If the operation was successful.
+ * @retval NRFX_ERROR_INVALID_LENGTH If length of the NFCID buffer is different than
+ *                                   @ref NRFX_NFCT_NFCID1_SINGLE_SIZE,
+ *                                   @ref NRFX_NFCT_NFCID1_DOUBLE_SIZE, or
+ *                                   @ref NRFX_NFCT_NFCID1_TRIPLE_SIZE.
+ */
+nrfx_err_t nrfx_nfct_nfcid1_default_bytes_get(uint8_t * const p_nfcid1_buff,
+                                              uint32_t        nfcid1_buff_len);
+
+/** 
+ * @brief Function for enabling the automatic collision resolution.
+ *
+ * @details As defined by the NFC Forum Digital Protocol Technical Specification (and ISO 14443-3),
+ *          the automatic collision resolution is implemented in the NFCT hardware.
+ *          This function allows enabling and disabling this feature.
+ */
+void nrfx_nfct_autocolres_enable(void);
+
+/** 
+ * @brief Function for disabling the automatic collision resolution.
+ *
+ * @details See also details in @ref nrfx_nfct_autocolres_enable.
+ */
+void nrfx_nfct_autocolres_disable(void);
+
+
+void nrfx_nfct_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+
+/**
+ * @defgroup nrfx_nfct_fixes NFCT driver fixes and workarounds
+ * @{
+ * @ingroup nrf_nfct
+ * @brief Fixes for hardware-related anomalies.
+ *
+ * If you are using the nRF52832 chip, the workarounds for the following anomalies are applied:
+ * - 79. NFCT: A false EVENTS_FIELDDETECTED event occurs after the field is lost.
+ * - 116. NFCT does not release HFCLK when switching from ACTIVATED to SENSE mode.
+ * To implement the first workaround, an instance of NRF_TIMER is used. After the NFC field is detected,
+ * the timing module periodically polls its state to determine when the field is turned off. 
+ * To implement the second workaround, power reset is used to release the clock acquired by NFCT
+ * after the field is turned off. Note that the NFCT register configuration is restored to defaults.
+ *
+ * If you are using the nRF52840 chip, rev. Engineering A, the workarounds for the following anomalies
+ * are applied:
+ * - 98. NFCT: The NFCT is not able to communicate with the peer.
+ * - 116. NFCT does not release HFCLK when switching from ACTIVATED to SENSE mode.
+ * - 144. NFCT: Not optimal NFC performance
+ *
+ * If you are using the nRF52840 chip, rev. 1, or rev. Engineering B or C, the workarounds for the following
+ * anomalies are applied:
+ * - 190. NFCT: Event FIELDDETECTED can be generated too early.
+ * To implement this workaround, an instance of NRF_TIMER is used. After the NFC field is detected,
+ * the timing module measures the necessary waiting period after which NFCT can be activated.
+ * This debouncing technique is used to filter possible field instabilities.
+ *
+ * The application of the implemented workarounds for the nRF52840 chip is determined at runtime and depends
+ * on the chip variant.
+ *
+ * The current code contains a patch for the anomaly 25 (NFCT: Reset value of 
+ * SENSRES register is incorrect), so that the module now works on Windows Phone.
+ * @}
+ */
+
+#endif // NRFX_NFCT_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_pdm.h

@@ -1,214 +1,205 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_PDM_H__
-#define NRFX_PDM_H__
-
-#include <nrfx.h>
-#include <hal/nrf_pdm.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_pdm PDM driver
- * @{
- * @ingroup nrf_pdm
- * @brief   Pulse Density Modulation (PDM) peripheral driver.
- */
-
-
-#define NRFX_PDM_MAX_BUFFER_SIZE 32767
-
-
-/**
- * @brief PDM error type.
- */
-typedef enum
-{
-    NRFX_PDM_NO_ERROR = 0,
-    NRFX_PDM_ERROR_OVERFLOW = 1
-} nrfx_pdm_error_t;
-
-/**
- * @brief PDM event structure.
- */
-typedef struct
-{
-    bool             buffer_requested;  ///< Buffer request flag.
-    int16_t *        buffer_released;   ///< Pointer to the released buffer. Can be NULL.
-    nrfx_pdm_error_t error;             ///< Error type.
-} nrfx_pdm_evt_t;
-
-/**
- * @brief PDM interface driver configuration structure.
- */
-typedef struct
-{
-    nrf_pdm_mode_t mode;               ///< Interface operation mode.
-    nrf_pdm_edge_t edge;               ///< Sampling mode.
-    uint8_t        pin_clk;            ///< CLK pin.
-    uint8_t        pin_din;            ///< DIN pin.
-    nrf_pdm_freq_t clock_freq;         ///< Clock frequency.
-    nrf_pdm_gain_t gain_l;             ///< Left channel gain.
-    nrf_pdm_gain_t gain_r;             ///< Right channel gain.
-    uint8_t        interrupt_priority; ///< Interrupt priority.
-} nrfx_pdm_config_t;
-
-/**
- * @brief Macro for setting @ref nrfx_pdm_config_t to default settings
- *        in single ended mode.
- *
- * @param _pin_clk  CLK output pin.
- * @param _pin_din  DIN input pin.
- */
-#define NRFX_PDM_DEFAULT_CONFIG(_pin_clk, _pin_din)                   \
-{                                                                     \
-    .mode               = (nrf_pdm_mode_t)NRFX_PDM_CONFIG_MODE,       \
-    .edge               = (nrf_pdm_edge_t)NRFX_PDM_CONFIG_EDGE,       \
-    .pin_clk            = _pin_clk,                                   \
-    .pin_din            = _pin_din,                                   \
-    .clock_freq         = (nrf_pdm_freq_t)NRFX_PDM_CONFIG_CLOCK_FREQ, \
-    .gain_l             = NRF_PDM_GAIN_DEFAULT,                       \
-    .gain_r             = NRF_PDM_GAIN_DEFAULT,                       \
-    .interrupt_priority = NRFX_PDM_CONFIG_IRQ_PRIORITY                \
-}
-
-/**
- * @brief Handler for PDM interface ready events.
- *
- * This event handler is called on a buffer request, an error or when a buffer
- * is full and ready to be processed.
- *
- * @param[in] p_evt Pointer to the PDM event structure.
- */
-typedef void (*nrfx_pdm_event_handler_t)(nrfx_pdm_evt_t const * const p_evt);
-
-
-/**
- * @brief Function for initializing the PDM interface.
- *
- * @param[in] p_config      Pointer to the structure with initial configuration.
- * @param[in] event_handler Event handler provided by the user. Cannot be NULL.
- *
- * @retval    NRFX_SUCCESS If initialization was successful.
- * @retval    NRFX_ERROR_INVALID_STATE If the driver is already initialized.
- * @retval    NRFX_ERROR_INVALID_PARAM If invalid configuration was specified.
- */
-nrfx_err_t nrfx_pdm_init(nrfx_pdm_config_t const * p_config,
-                         nrfx_pdm_event_handler_t  event_handler);
-
-/**
- * @brief Function for uninitializing the PDM interface.
- *
- * This function stops PDM sampling, if it is in progress.
- */
-void nrfx_pdm_uninit(void);
-
-/**
- * @brief Function for getting the address of a PDM interface task.
- *
- * @param[in]  task Task.
- *
- * @return     Task address.
- */
-__STATIC_INLINE uint32_t nrfx_pdm_task_address_get(nrf_pdm_task_t task)
-{
-    return nrf_pdm_task_address_get(task);
-}
-
-/**
- * @brief Function for getting the state of the PDM interface.
- *
- * @retval true  If the PDM interface is enabled.
- * @retval false If the PDM interface is disabled.
- */
-__STATIC_INLINE bool nrfx_pdm_enable_check(void)
-{
-    return nrf_pdm_enable_check();
-}
-
-/**
- * @brief Function for starting PDM sampling.
- *
- * @retval NRFX_SUCCESS    If sampling was started successfully or was already in progress.
- * @retval NRFX_ERROR_BUSY If a previous start/stop operation is in progress.
- */
-nrfx_err_t nrfx_pdm_start(void);
-
-/**
- * @brief   Function for stopping PDM sampling.
- *
- * When this function is called, the PDM interface is stopped after finishing
- * the current frame.
- * The event handler function might be called once more after calling this function.
- *
- * @retval NRFX_SUCCESS    If sampling was stopped successfully or was already stopped before.
- * @retval NRFX_ERROR_BUSY If a previous start/stop operation is in progress.
- */
-nrfx_err_t nrfx_pdm_stop(void);
-
-/**
- * @brief   Function for supplying the sample buffer.
- *
- * Call this function after every buffer request event.
- *
- * @param[in]  buffer        Pointer to the receive buffer. Cannot be NULL.
- * @param[in]  buffer_length Length of the receive buffer in 16-bit words.
- *
- * @retval NRFX_SUCCESS             If the buffer was applied successfully.
- * @retval NRFX_ERROR_BUSY          If the buffer was already supplied or the peripheral is currently being stopped.
- * @retval NRFX_ERROR_INVALID_STATE If the driver was not initialized.
- * @retval NRFX_ERROR_INVALID_PARAM If invalid parameters were provided.
- */
-nrfx_err_t nrfx_pdm_buffer_set(int16_t * buffer, uint16_t buffer_length);
-
-
-void nrfx_pdm_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_PDM_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_PDM_H__
+#define NRFX_PDM_H__
+
+#include <nrfx.h>
+#include <hal/nrf_pdm.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_pdm PDM driver
+ * @{
+ * @ingroup nrf_pdm
+ * @brief   Pulse Density Modulation (PDM) peripheral driver.
+ */
+
+
+#define NRFX_PDM_MAX_BUFFER_SIZE 32767
+
+
+/**
+ * @brief PDM error type.
+ */
+typedef enum
+{
+    NRFX_PDM_NO_ERROR = 0,
+    NRFX_PDM_ERROR_OVERFLOW = 1
+} nrfx_pdm_error_t;
+
+/**
+ * @brief PDM event structure.
+ */
+typedef struct
+{
+    bool             buffer_requested;  ///< Buffer request flag.
+    int16_t *        buffer_released;   ///< Pointer to the released buffer. Can be NULL.
+    nrfx_pdm_error_t error;             ///< Error type.
+} nrfx_pdm_evt_t;
+
+/**
+ * @brief PDM interface driver configuration structure.
+ */
+typedef struct
+{
+    nrf_pdm_mode_t mode;               ///< Interface operation mode.
+    nrf_pdm_edge_t edge;               ///< Sampling mode.
+    uint8_t        pin_clk;            ///< CLK pin.
+    uint8_t        pin_din;            ///< DIN pin.
+    nrf_pdm_freq_t clock_freq;         ///< Clock frequency.
+    nrf_pdm_gain_t gain_l;             ///< Left channel gain.
+    nrf_pdm_gain_t gain_r;             ///< Right channel gain.
+    uint8_t        interrupt_priority; ///< Interrupt priority.
+} nrfx_pdm_config_t;
+
+/**
+ * @brief Macro for setting @ref nrfx_pdm_config_t to default settings
+ *        in single ended mode.
+ *
+ * @param _pin_clk  CLK output pin.
+ * @param _pin_din  DIN input pin.
+ */
+#define NRFX_PDM_DEFAULT_CONFIG(_pin_clk, _pin_din)                   \
+{                                                                     \
+    .mode               = (nrf_pdm_mode_t)NRFX_PDM_CONFIG_MODE,       \
+    .edge               = (nrf_pdm_edge_t)NRFX_PDM_CONFIG_EDGE,       \
+    .pin_clk            = _pin_clk,                                   \
+    .pin_din            = _pin_din,                                   \
+    .clock_freq         = (nrf_pdm_freq_t)NRFX_PDM_CONFIG_CLOCK_FREQ, \
+    .gain_l             = NRF_PDM_GAIN_DEFAULT,                       \
+    .gain_r             = NRF_PDM_GAIN_DEFAULT,                       \
+    .interrupt_priority = NRFX_PDM_CONFIG_IRQ_PRIORITY                \
+}
+
+/**
+ * @brief Handler for PDM interface ready events.
+ *
+ * This event handler is called on a buffer request, an error or when a buffer
+ * is full and ready to be processed.
+ *
+ * @param[in] p_evt Pointer to the PDM event structure.
+ */
+typedef void (*nrfx_pdm_event_handler_t)(nrfx_pdm_evt_t const * const p_evt);
+
+
+/**
+ * @brief Function for initializing the PDM interface.
+ *
+ * @param[in] p_config      Pointer to the structure with initial configuration.
+ * @param[in] event_handler Event handler provided by the user. Cannot be NULL.
+ *
+ * @retval    NRFX_SUCCESS If initialization was successful.
+ * @retval    NRFX_ERROR_INVALID_STATE If the driver is already initialized.
+ * @retval    NRFX_ERROR_INVALID_PARAM If invalid configuration was specified.
+ */
+nrfx_err_t nrfx_pdm_init(nrfx_pdm_config_t const * p_config,
+                         nrfx_pdm_event_handler_t  event_handler);
+
+/**
+ * @brief Function for uninitializing the PDM interface.
+ *
+ * This function stops PDM sampling, if it is in progress.
+ */
+void nrfx_pdm_uninit(void);
+
+/**
+ * @brief Function for getting the address of a PDM interface task.
+ *
+ * @param[in]  task Task.
+ *
+ * @return     Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_pdm_task_address_get(nrf_pdm_task_t task)
+{
+    return nrf_pdm_task_address_get(task);
+}
+
+/**
+ * @brief Function for getting the state of the PDM interface.
+ *
+ * @retval true  If the PDM interface is enabled.
+ * @retval false If the PDM interface is disabled.
+ */
+__STATIC_INLINE bool nrfx_pdm_enable_check(void)
+{
+    return nrf_pdm_enable_check();
+}
+
+/**
+ * @brief Function for starting PDM sampling.
+ *
+ * @retval NRFX_SUCCESS    If sampling was started successfully or was already in progress.
+ * @retval NRFX_ERROR_BUSY If a previous start/stop operation is in progress.
+ */
+nrfx_err_t nrfx_pdm_start(void);
+
+/**
+ * @brief   Function for stopping PDM sampling.
+ *
+ * When this function is called, the PDM interface is stopped after finishing
+ * the current frame.
+ * The event handler function might be called once more after calling this function.
+ *
+ * @retval NRFX_SUCCESS    If sampling was stopped successfully or was already stopped before.
+ * @retval NRFX_ERROR_BUSY If a previous start/stop operation is in progress.
+ */
+nrfx_err_t nrfx_pdm_stop(void);
+
+/**
+ * @brief   Function for supplying the sample buffer.
+ *
+ * Call this function after every buffer request event.
+ *
+ * @param[in]  buffer        Pointer to the receive buffer. Cannot be NULL.
+ * @param[in]  buffer_length Length of the receive buffer in 16-bit words.
+ *
+ * @retval NRFX_SUCCESS             If the buffer was applied successfully.
+ * @retval NRFX_ERROR_BUSY          If the buffer was already supplied or the peripheral is currently being stopped.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver was not initialized.
+ * @retval NRFX_ERROR_INVALID_PARAM If invalid parameters were provided.
+ */
+nrfx_err_t nrfx_pdm_buffer_set(int16_t * buffer, uint16_t buffer_length);
+
+
+void nrfx_pdm_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_PDM_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_power.h

@@ -1,382 +1,377 @@
-/**
- * Copyright (c) 2017 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_POWER_H__
-#define NRFX_POWER_H__
-
-#include <nrfx.h>
-#include <hal/nrf_power.h>
-#include <nrfx_power_clock.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_power POWER driver
- * @{
- * @ingroup nrf_power
- * @brief   POWER peripheral driver.
- */
-
-/**
- * @brief Power mode possible configurations
- */
-typedef enum
-{
-    NRFX_POWER_MODE_CONSTLAT, /**< Constant latency mode */
-    NRFX_POWER_MODE_LOWPWR    /**< Low power mode        */
-}nrfx_power_mode_t;
-
-#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Events from power system
- */
-typedef enum
-{
-    NRFX_POWER_SLEEP_EVT_ENTER, /**< CPU entered WFI/WFE sleep
-                                 *
-                                 * Keep in mind that if this interrupt is enabled,
-                                 * it means that CPU was waken up just after WFI by this interrupt.
-                                 */
-    NRFX_POWER_SLEEP_EVT_EXIT   /**< CPU exited WFI/WFE sleep */
-}nrfx_power_sleep_evt_t;
-#endif /* NRF_POWER_HAS_SLEEPEVT */
-
-#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Events from USB power system
- */
-typedef enum
-{
-    NRFX_POWER_USB_EVT_DETECTED, /**< USB power detected on the connector (plugged in). */
-    NRFX_POWER_USB_EVT_REMOVED,  /**< USB power removed from the connector. */
-    NRFX_POWER_USB_EVT_READY     /**< USB power regulator ready. */
-}nrfx_power_usb_evt_t;
-
-/**
- * @brief USB power state
- *
- * The single enumerator that holds all data about current state of USB
- * related POWER.
- *
- * Organized this way that higher power state has higher numeric value
- */
-typedef enum
-{
-    NRFX_POWER_USB_STATE_DISCONNECTED, /**< No power on USB lines detected */
-    NRFX_POWER_USB_STATE_CONNECTED,    /**< The USB power is detected, but USB power regulator is not ready */
-    NRFX_POWER_USB_STATE_READY         /**< From the power point of view USB is ready for working */
-}nrfx_power_usb_state_t;
-#endif /* NRF_POWER_HAS_USBREG */
-
-/**
- * @name Callback types
- *
- * Defined types of callback functions
- * @{
- */
-/**
- * @brief Event handler for power failure warning
- */
-typedef void (*nrfx_power_pofwarn_event_handler_t)(void);
-
-#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Event handler for entering/exiting sleep
- *
- * @param event Event type
- */
-typedef void (*nrfx_power_sleep_event_handler_t)(nrfx_power_sleep_evt_t event);
-#endif
-
-#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Event handler for USB related power events
- *
- * @param event Event type
- */
-typedef void (*nrfx_power_usb_event_handler_t)(nrfx_power_usb_evt_t event);
-#endif
-/** @} */
-
-/**
- * @brief General power configuration
- *
- * Parameters required to initialize power driver.
- */
-typedef struct
-{
-    /**
-     * @brief Enable main DCDC regulator
-     *
-     * This bit only informs the driver that elements for DCDC regulator
-     * are installed and regulator can be used.
-     * The regulator would be enabled or disabled automatically
-     * by the hardware, basing on current power requirement.
-     */
-    bool dcdcen:1;
-
-#if NRF_POWER_HAS_VDDH || defined(__NRFX_DOXYGEN__)
-    /**
-     * @brief Enable HV DCDC regulator
-     *
-     * This bit only informs the driver that elements for DCDC regulator
-     * are installed and regulator can be used.
-     * The regulator would be enabled or disabled automatically
-     * by the hardware, basing on current power requirement.
-     */
-    bool dcdcenhv: 1;
-#endif
-}nrfx_power_config_t;
-
-/**
- * @brief The configuration for power failure comparator
- *
- * Configuration used to enable and configure power failure comparator
- */
-typedef struct
-{
-    nrfx_power_pofwarn_event_handler_t handler; //!< Event handler
-    nrf_power_pof_thr_t                thr;     //!< Threshold for power failure detection
-#if NRF_POWER_HAS_VDDH || defined(__NRFX_DOXYGEN__)
-    nrf_power_pof_thrvddh_t            thrvddh; //!< Threshold for power failure detection on VDDH pin
-#endif
-}nrfx_power_pofwarn_config_t;
-
-#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
-/**
- * @brief The configuration of sleep event processing
- *
- * Configuration used to enable and configure sleep event handling
- */
-typedef struct
-{
-    nrfx_power_sleep_event_handler_t handler;    //!< Event handler
-    bool                             en_enter:1; //!< Enable event on sleep entering
-    bool                             en_exit :1; //!< Enable event on sleep exiting
-}nrfx_power_sleepevt_config_t;
-#endif
-
-#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
-/**
- * @brief The configuration of USB related power events
- *
- * Configuration used to enable and configure USB power event handling
- */
-typedef struct
-{
-    nrfx_power_usb_event_handler_t handler; //!< Event processing
-}nrfx_power_usbevt_config_t;
-#endif /* NRF_POWER_HAS_USBREG */
-
-/**
- * @brief Function for getting the handler of the power failure comparator.
- * @return Handler of the power failure comparator.
- */
-nrfx_power_pofwarn_event_handler_t nrfx_power_pof_handler_get(void);
-
-#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Function for getting the handler of the USB power.
- * @return Handler of the USB power.
- */
-nrfx_power_usb_event_handler_t nrfx_power_usb_handler_get(void);
-#endif
-
-/**
- * @brief Initialize power module driver
- *
- * Enabled power module driver would process all the interrupts from power system.
- *
- * @param[in] p_config Pointer to the structure with initial configuration.
- *
- * @retval NRFX_SUCCESS                   Successfully initialized.
- * @retval NRFX_ERROR_ALREADY_INITIALIZED Module was already initialized.
- */
-nrfx_err_t nrfx_power_init(nrfx_power_config_t const * p_config);
-
-/**
- * @brief Unintialize power module driver
- *
- * Disables all the interrupt handling in the module.
- *
- * @sa nrfx_power_init
- */
-void nrfx_power_uninit(void);
-
-/**
- * @brief Initialize power failure comparator
- *
- * Configures the power failure comparator. This function does not setup and enable it.
- * Those steps can be done with functions @ref nrfx_power_pof_enable and @ref nrfx_power_pof_disable
- * or with Softdevice API (when Softdevice is using).
- *
- * @param[in] p_config Configuration with values and event handler.
- *                     If event handler is set to NULL, interrupt would be disabled.
- */
-void nrfx_power_pof_init(nrfx_power_pofwarn_config_t const * p_config);
-
-/**
- * @brief Enable power failure comparator
- * Sets and enables interrupt of the power failure comparator. This functions cannot be using
- * when Softdevice is enabled. If event handler set in init function is set to NULL, interrupt
- * would be disabled.
- *
- * @param[in] p_config Configuration with values and event handler.
- */
-void nrfx_power_pof_enable(nrfx_power_pofwarn_config_t const * p_config);
-
-/**
- * @brief Disable the power failure comparator
- *
- * Disables the power failure comparator interrupt.
- */
-void nrfx_power_pof_disable(void);
-
-/**
- * @brief Clear the power failure comparator settings
- *
- * Clears the settings of the power failure comparator.
- */
-void nrfx_power_pof_uninit(void);
-
-#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Initialize sleep entering and exiting events processing
- *
- * Configures and setups the sleep event processing.
- *
- * @param[in] p_config Configuration with values and event handler.
- *
- * @sa nrfx_power_sleepevt_uninit
- *
- */
-void nrfx_power_sleepevt_init(nrfx_power_sleepevt_config_t const * p_config);
-
-/**
- * @brief Enable sleep entering and exiting events processing
- *
- * @param[in] p_config Configuration with values and event handler.
- */
-void nrfx_power_sleepevt_enable(nrfx_power_sleepevt_config_t const * p_config);
-
-/**
- * @brief Disable sleep entering and exiting events processing
- */
-void nrfx_power_sleepevt_disable(void);
-
-/**
- * @brief Uninitialize sleep entering and exiting events processing
- *
- * @sa nrfx_power_sleepevt_init
- */
-void nrfx_power_sleepevt_uninit(void);
-#endif /* NRF_POWER_HAS_SLEEPEVT */
-
-#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Initialize USB power event processing
- *
- * Configures and setups the USB power event processing.
- *
- * @param[in] p_config Configuration with values and event handler.
- *
- * @sa nrfx_power_usbevt_uninit
- */
-void nrfx_power_usbevt_init(nrfx_power_usbevt_config_t const * p_config);
-
-/**
- * @brief Enable USB power event processing
- */
-void nrfx_power_usbevt_enable(void);
-
-/**
- * @brief Disable USB power event processing
- */
-void nrfx_power_usbevt_disable(void);
-
-/**
- * @brief Uninitalize USB power event processing
- *
- * @sa nrfx_power_usbevt_init
- */
-void nrfx_power_usbevt_uninit(void);
-
-/**
- *  @brief Get the status of USB power
- *
- *  @return Current USB power status
- */
-__STATIC_INLINE nrfx_power_usb_state_t nrfx_power_usbstatus_get(void);
-
-#endif /* NRF_POWER_HAS_USBREG */
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-
-#if NRF_POWER_HAS_USBREG
-__STATIC_INLINE nrfx_power_usb_state_t nrfx_power_usbstatus_get(void)
-{
-    uint32_t status = nrf_power_usbregstatus_get();
-    if(0 == (status & NRF_POWER_USBREGSTATUS_VBUSDETECT_MASK))
-    {
-        return NRFX_POWER_USB_STATE_DISCONNECTED;
-    }
-    if(0 == (status & NRF_POWER_USBREGSTATUS_OUTPUTRDY_MASK))
-    {
-        return NRFX_POWER_USB_STATE_CONNECTED;
-    }
-    return NRFX_POWER_USB_STATE_READY;
-}
-#endif /* NRF_POWER_HAS_USBREG */
-
-#endif /* SUPPRESS_INLINE_IMPLEMENTATION */
-
-
-void nrfx_power_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* NRFX_POWER_H__ */
+/*
+ * Copyright (c) 2017 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_POWER_H__
+#define NRFX_POWER_H__
+
+#include <nrfx.h>
+#include <hal/nrf_power.h>
+#include <nrfx_power_clock.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_power POWER driver
+ * @{
+ * @ingroup nrf_power
+ * @brief   POWER peripheral driver.
+ */
+
+/**
+ * @brief Power mode possible configurations
+ */
+typedef enum
+{
+    NRFX_POWER_MODE_CONSTLAT, /**< Constant latency mode */
+    NRFX_POWER_MODE_LOWPWR    /**< Low power mode        */
+}nrfx_power_mode_t;
+
+#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Events from power system
+ */
+typedef enum
+{
+    NRFX_POWER_SLEEP_EVT_ENTER, /**< CPU entered WFI/WFE sleep
+                                 *
+                                 * Keep in mind that if this interrupt is enabled,
+                                 * it means that CPU was waken up just after WFI by this interrupt.
+                                 */
+    NRFX_POWER_SLEEP_EVT_EXIT   /**< CPU exited WFI/WFE sleep */
+}nrfx_power_sleep_evt_t;
+#endif /* NRF_POWER_HAS_SLEEPEVT */
+
+#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Events from USB power system
+ */
+typedef enum
+{
+    NRFX_POWER_USB_EVT_DETECTED, /**< USB power detected on the connector (plugged in). */
+    NRFX_POWER_USB_EVT_REMOVED,  /**< USB power removed from the connector. */
+    NRFX_POWER_USB_EVT_READY     /**< USB power regulator ready. */
+}nrfx_power_usb_evt_t;
+
+/**
+ * @brief USB power state
+ *
+ * The single enumerator that holds all data about current state of USB
+ * related POWER.
+ *
+ * Organized this way that higher power state has higher numeric value
+ */
+typedef enum
+{
+    NRFX_POWER_USB_STATE_DISCONNECTED, /**< No power on USB lines detected */
+    NRFX_POWER_USB_STATE_CONNECTED,    /**< The USB power is detected, but USB power regulator is not ready */
+    NRFX_POWER_USB_STATE_READY         /**< From the power point of view USB is ready for working */
+}nrfx_power_usb_state_t;
+#endif /* NRF_POWER_HAS_USBREG */
+
+/**
+ * @name Callback types
+ *
+ * Defined types of callback functions
+ * @{
+ */
+/**
+ * @brief Event handler for power failure warning
+ */
+typedef void (*nrfx_power_pofwarn_event_handler_t)(void);
+
+#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Event handler for entering/exiting sleep
+ *
+ * @param event Event type
+ */
+typedef void (*nrfx_power_sleep_event_handler_t)(nrfx_power_sleep_evt_t event);
+#endif
+
+#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Event handler for USB related power events
+ *
+ * @param event Event type
+ */
+typedef void (*nrfx_power_usb_event_handler_t)(nrfx_power_usb_evt_t event);
+#endif
+/** @} */
+
+/**
+ * @brief General power configuration
+ *
+ * Parameters required to initialize power driver.
+ */
+typedef struct
+{
+    /**
+     * @brief Enable main DCDC regulator
+     *
+     * This bit only informs the driver that elements for DCDC regulator
+     * are installed and regulator can be used.
+     * The regulator would be enabled or disabled automatically
+     * by the hardware, basing on current power requirement.
+     */
+    bool dcdcen:1;
+
+#if NRF_POWER_HAS_VDDH || defined(__NRFX_DOXYGEN__)
+    /**
+     * @brief Enable HV DCDC regulator
+     *
+     * This bit only informs the driver that elements for DCDC regulator
+     * are installed and regulator can be used.
+     * The regulator would be enabled or disabled automatically
+     * by the hardware, basing on current power requirement.
+     */
+    bool dcdcenhv: 1;
+#endif
+}nrfx_power_config_t;
+
+/**
+ * @brief The configuration for power failure comparator
+ *
+ * Configuration used to enable and configure power failure comparator
+ */
+typedef struct
+{
+    nrfx_power_pofwarn_event_handler_t handler; //!< Event handler
+#if NRF_POWER_HAS_POFCON || defined(__NRFX_DOXYGEN__)
+    nrf_power_pof_thr_t                thr;     //!< Threshold for power failure detection
+#endif
+#if NRF_POWER_HAS_VDDH || defined(__NRFX_DOXYGEN__)
+    nrf_power_pof_thrvddh_t            thrvddh; //!< Threshold for power failure detection on VDDH pin
+#endif
+}nrfx_power_pofwarn_config_t;
+
+#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief The configuration of sleep event processing
+ *
+ * Configuration used to enable and configure sleep event handling
+ */
+typedef struct
+{
+    nrfx_power_sleep_event_handler_t handler;    //!< Event handler
+    bool                             en_enter:1; //!< Enable event on sleep entering
+    bool                             en_exit :1; //!< Enable event on sleep exiting
+}nrfx_power_sleepevt_config_t;
+#endif
+
+#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief The configuration of USB related power events
+ *
+ * Configuration used to enable and configure USB power event handling
+ */
+typedef struct
+{
+    nrfx_power_usb_event_handler_t handler; //!< Event processing
+}nrfx_power_usbevt_config_t;
+#endif /* NRF_POWER_HAS_USBREG */
+
+/**
+ * @brief Function for getting the handler of the power failure comparator.
+ * @return Handler of the power failure comparator.
+ */
+nrfx_power_pofwarn_event_handler_t nrfx_power_pof_handler_get(void);
+
+#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Function for getting the handler of the USB power.
+ * @return Handler of the USB power.
+ */
+nrfx_power_usb_event_handler_t nrfx_power_usb_handler_get(void);
+#endif
+
+/**
+ * @brief Initialize power module driver
+ *
+ * Enabled power module driver would process all the interrupts from power system.
+ *
+ * @param[in] p_config Pointer to the structure with initial configuration.
+ *
+ * @retval NRFX_SUCCESS                   Successfully initialized.
+ * @retval NRFX_ERROR_ALREADY_INITIALIZED Module was already initialized.
+ */
+nrfx_err_t nrfx_power_init(nrfx_power_config_t const * p_config);
+
+/**
+ * @brief Unintialize power module driver
+ *
+ * Disables all the interrupt handling in the module.
+ *
+ * @sa nrfx_power_init
+ */
+void nrfx_power_uninit(void);
+
+#if NRF_POWER_HAS_POFCON || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Initialize power failure comparator
+ *
+ * Configures the power failure comparator. This function does not setup and enable it.
+ * Those steps can be done with functions @ref nrfx_power_pof_enable and @ref nrfx_power_pof_disable
+ * or with Softdevice API (when Softdevice is using).
+ *
+ * @param[in] p_config Configuration with values and event handler.
+ *                     If event handler is set to NULL, interrupt would be disabled.
+ */
+void nrfx_power_pof_init(nrfx_power_pofwarn_config_t const * p_config);
+
+/**
+ * @brief Enable power failure comparator
+ * Sets and enables interrupt of the power failure comparator. This functions cannot be using
+ * when Softdevice is enabled. If event handler set in init function is set to NULL, interrupt
+ * would be disabled.
+ *
+ * @param[in] p_config Configuration with values and event handler.
+ */
+void nrfx_power_pof_enable(nrfx_power_pofwarn_config_t const * p_config);
+
+/**
+ * @brief Disable the power failure comparator
+ *
+ * Disables the power failure comparator interrupt.
+ */
+void nrfx_power_pof_disable(void);
+
+/**
+ * @brief Clear the power failure comparator settings
+ *
+ * Clears the settings of the power failure comparator.
+ */
+void nrfx_power_pof_uninit(void);
+#endif // NRF_POWER_HAS_POFCON || defined(__NRFX_DOXYGEN__)
+
+#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Initialize sleep entering and exiting events processing
+ *
+ * Configures and setups the sleep event processing.
+ *
+ * @param[in] p_config Configuration with values and event handler.
+ *
+ * @sa nrfx_power_sleepevt_uninit
+ *
+ */
+void nrfx_power_sleepevt_init(nrfx_power_sleepevt_config_t const * p_config);
+
+/**
+ * @brief Enable sleep entering and exiting events processing
+ *
+ * @param[in] p_config Configuration with values and event handler.
+ */
+void nrfx_power_sleepevt_enable(nrfx_power_sleepevt_config_t const * p_config);
+
+/**
+ * @brief Disable sleep entering and exiting events processing
+ */
+void nrfx_power_sleepevt_disable(void);
+
+/**
+ * @brief Uninitialize sleep entering and exiting events processing
+ *
+ * @sa nrfx_power_sleepevt_init
+ */
+void nrfx_power_sleepevt_uninit(void);
+#endif /* NRF_POWER_HAS_SLEEPEVT */
+
+#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Initialize USB power event processing
+ *
+ * Configures and setups the USB power event processing.
+ *
+ * @param[in] p_config Configuration with values and event handler.
+ *
+ * @sa nrfx_power_usbevt_uninit
+ */
+void nrfx_power_usbevt_init(nrfx_power_usbevt_config_t const * p_config);
+
+/**
+ * @brief Enable USB power event processing
+ */
+void nrfx_power_usbevt_enable(void);
+
+/**
+ * @brief Disable USB power event processing
+ */
+void nrfx_power_usbevt_disable(void);
+
+/**
+ * @brief Uninitalize USB power event processing
+ *
+ * @sa nrfx_power_usbevt_init
+ */
+void nrfx_power_usbevt_uninit(void);
+
+/**
+ *  @brief Get the status of USB power
+ *
+ *  @return Current USB power status
+ */
+__STATIC_INLINE nrfx_power_usb_state_t nrfx_power_usbstatus_get(void);
+
+#endif /* NRF_POWER_HAS_USBREG */
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+
+#if NRF_POWER_HAS_USBREG
+__STATIC_INLINE nrfx_power_usb_state_t nrfx_power_usbstatus_get(void)
+{
+    uint32_t status = nrf_power_usbregstatus_get();
+    if(0 == (status & NRF_POWER_USBREGSTATUS_VBUSDETECT_MASK))
+    {
+        return NRFX_POWER_USB_STATE_DISCONNECTED;
+    }
+    if(0 == (status & NRF_POWER_USBREGSTATUS_OUTPUTRDY_MASK))
+    {
+        return NRFX_POWER_USB_STATE_CONNECTED;
+    }
+    return NRFX_POWER_USB_STATE_READY;
+}
+#endif /* NRF_POWER_HAS_USBREG */
+
+#endif /* SUPPRESS_INLINE_IMPLEMENTATION */
+
+
+void nrfx_power_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* NRFX_POWER_H__ */

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_power_clock.h

@@ -1,90 +1,81 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_POWER_CLOCK_H__
-#define NRFX_POWER_CLOCK_H__
-
-#include <nrfx.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-
-__STATIC_INLINE void nrfx_power_clock_irq_init(void);
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-__STATIC_INLINE void nrfx_power_clock_irq_init(void)
-{
-    uint8_t priority;
-#if NRFX_CHECK(NRFX_POWER_ENABLED) && NRFX_CHECK(NRFX_CLOCK_ENABLED)
-    #if NRFX_POWER_CONFIG_IRQ_PRIORITY != NRFX_CLOCK_CONFIG_IRQ_PRIORITY
-    #error "IRQ priority for POWER and CLOCK have to be the same. Check <nrfx_config.h>."
-    #endif
-    priority = NRFX_POWER_CONFIG_IRQ_PRIORITY;
-#elif NRFX_CHECK(NRFX_POWER_ENABLED)
-    priority = NRFX_POWER_CONFIG_IRQ_PRIORITY;
-#elif NRFX_CHECK(NRFX_CLOCK_ENABLED)
-    priority = NRFX_CLOCK_CONFIG_IRQ_PRIORITY;
-#endif
-
-    if (!NRFX_IRQ_IS_ENABLED(POWER_CLOCK_IRQn))
-    {
-        NRFX_IRQ_PRIORITY_SET(POWER_CLOCK_IRQn, priority);
-        NRFX_IRQ_ENABLE(POWER_CLOCK_IRQn);
-    }
-}
-#endif // SUPPRESS_INLINE_IMPLEMENTATION
-
-
-#if NRFX_CHECK(NRFX_POWER_ENABLED) && NRFX_CHECK(NRFX_CLOCK_ENABLED)
-void nrfx_power_clock_irq_handler(void);
-#elif NRFX_CHECK(NRFX_POWER_ENABLED)
-#define nrfx_power_irq_handler  nrfx_power_clock_irq_handler
-#elif NRFX_CHECK(NRFX_CLOCK_ENABLED)
-#define nrfx_clock_irq_handler  nrfx_power_clock_irq_handler
-#endif
-
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_POWER_CLOCK_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_POWER_CLOCK_H__
+#define NRFX_POWER_CLOCK_H__
+
+#include <nrfx.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+__STATIC_INLINE void nrfx_power_clock_irq_init(void);
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+__STATIC_INLINE void nrfx_power_clock_irq_init(void)
+{
+    uint8_t priority;
+#if NRFX_CHECK(NRFX_POWER_ENABLED) && NRFX_CHECK(NRFX_CLOCK_ENABLED)
+    #if NRFX_POWER_CONFIG_IRQ_PRIORITY != NRFX_CLOCK_CONFIG_IRQ_PRIORITY
+    #error "IRQ priority for POWER and CLOCK have to be the same. Check <nrfx_config.h>."
+    #endif
+    priority = NRFX_POWER_CONFIG_IRQ_PRIORITY;
+#elif NRFX_CHECK(NRFX_POWER_ENABLED)
+    priority = NRFX_POWER_CONFIG_IRQ_PRIORITY;
+#elif NRFX_CHECK(NRFX_CLOCK_ENABLED)
+    priority = NRFX_CLOCK_CONFIG_IRQ_PRIORITY;
+#endif
+
+    if (!NRFX_IRQ_IS_ENABLED(nrfx_get_irq_number(NRF_CLOCK)))
+    {
+        NRFX_IRQ_PRIORITY_SET(nrfx_get_irq_number(NRF_CLOCK), priority);
+        NRFX_IRQ_ENABLE(nrfx_get_irq_number(NRF_CLOCK));
+    }
+}
+#endif // SUPPRESS_INLINE_IMPLEMENTATION
+
+
+#if NRFX_CHECK(NRFX_POWER_ENABLED) && NRFX_CHECK(NRFX_CLOCK_ENABLED)
+void nrfx_power_clock_irq_handler(void);
+#elif NRFX_CHECK(NRFX_POWER_ENABLED)
+#define nrfx_power_irq_handler  nrfx_power_clock_irq_handler
+#elif NRFX_CHECK(NRFX_CLOCK_ENABLED)
+#define nrfx_clock_irq_handler  nrfx_power_clock_irq_handler
+#endif
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_POWER_CLOCK_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_ppi.h

@@ -1,327 +1,317 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_PPI_H__
-#define NRFX_PPI_H__
-
-#include <nrfx.h>
-#include <hal/nrf_ppi.h>
-
-/**
- * @defgroup nrfx_ppi PPI allocator
- * @{
- * @ingroup nrf_ppi
- * @brief   Programmable Peripheral Interconnect (PPI) allocator.
- */
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-#ifndef NRFX_PPI_CHANNELS_USED
-#define NRFX_PPI_CHANNELS_USED 0
-#endif
-
-#ifndef NRFX_PPI_GROUPS_USED
-#define NRFX_PPI_GROUPS_USED 0
-#endif
-
-#if PPI_CH_NUM > 16
-#define NRFX_PPI_ALL_APP_CHANNELS_MASK   ((uint32_t)0xFFFFFFFFuL & ~(NRFX_PPI_CHANNELS_USED))  /**< All PPI channels available to the application. */
-#define NRFX_PPI_PROG_APP_CHANNELS_MASK  ((uint32_t)0x000FFFFFuL & ~(NRFX_PPI_CHANNELS_USED))  /**< Programmable PPI channels available to the application. */
-#else
-#define NRFX_PPI_ALL_APP_CHANNELS_MASK   ((uint32_t)0xFFF0FFFFuL & ~(NRFX_PPI_CHANNELS_USED))  /**< All PPI channels available to the application. */
-#define NRFX_PPI_PROG_APP_CHANNELS_MASK  ((uint32_t)0x0000FFFFuL & ~(NRFX_PPI_CHANNELS_USED))  /**< Programmable PPI channels available to the application. */
-#endif
-
-#define NRFX_PPI_ALL_APP_GROUPS_MASK     (((1uL << PPI_GROUP_NUM) - 1) & ~(NRFX_PPI_GROUPS_USED))    /**< All PPI groups available to the application. */
-
-/**
- * @brief Function for uninitializing the PPI module.
- *
- * This function disables all channels and clears the channel groups.
- */
-void nrfx_ppi_free_all(void);
-
-/**
- * @brief Function for allocating a PPI channel.
- * @details This function allocates the first unused PPI channel.
- *
- * @param[out] p_channel Pointer to the PPI channel that has been allocated.
- *
- * @retval NRFX_SUCCESS      If the channel was successfully allocated.
- * @retval NRFX_ERROR_NO_MEM If there is no available channel to be used.
- */
-nrfx_err_t nrfx_ppi_channel_alloc(nrf_ppi_channel_t * p_channel);
-
-/**
- * @brief Function for freeing a PPI channel.
- * @details This function also disables the chosen channel.
- *
- * @param[in] channel PPI channel to be freed.
- *
- * @retval NRFX_SUCCESS             If the channel was successfully freed.
- * @retval NRFX_ERROR_INVALID_PARAM If the channel is not user-configurable.
- */
-nrfx_err_t nrfx_ppi_channel_free(nrf_ppi_channel_t channel);
-
-/**
- * @brief Function for assigning task and event endpoints to the PPI channel.
- *
- * @param[in] channel PPI channel to be assigned endpoints.
- * @param[in] eep     Event endpoint address.
- * @param[in] tep     Task endpoint address.
- *
- * @retval NRFX_SUCCESS             If the channel was successfully assigned.
- * @retval NRFX_ERROR_INVALID_STATE If the channel is not allocated for the user.
- * @retval NRFX_ERROR_INVALID_PARAM If the channel is not user-configurable.
- */
-nrfx_err_t nrfx_ppi_channel_assign(nrf_ppi_channel_t channel, uint32_t eep, uint32_t tep);
-
-/**
- * @brief Function for assigning or clearing fork endpoint to the PPI channel.
- *
- * @param[in] channel  PPI channel to be assigned endpoints.
- * @param[in] fork_tep Fork task endpoint address or 0 to clear.
- *
- * @retval NRFX_SUCCESS             If the channel was successfully assigned.
- * @retval NRFX_ERROR_INVALID_STATE If the channel is not allocated for the user.
- * @retval NRFX_ERROR_INVALID_PARAM If the channel is not user-configurable.
- * @retval NRFX_ERROR_NOT_SUPPORTED If function is not supported.
- */
-nrfx_err_t nrfx_ppi_channel_fork_assign(nrf_ppi_channel_t channel, uint32_t fork_tep);
-
-/**
- * @brief Function for enabling a PPI channel.
- *
- * @param[in] channel PPI channel to be enabled.
- *
- * @retval NRFX_SUCCESS             If the channel was successfully enabled.
- * @retval NRFX_ERROR_INVALID_STATE If the user-configurable channel is not allocated.
- * @retval NRFX_ERROR_INVALID_PARAM If the channel cannot be enabled by the user.
- */
-nrfx_err_t nrfx_ppi_channel_enable(nrf_ppi_channel_t channel);
-
-/**
- * @brief Function for disabling a PPI channel.
- *
- * @param[in] channel PPI channel to be disabled.
- *
- * @retval NRFX_SUCCESS             If the channel was successfully disabled.
- * @retval NRFX_ERROR_INVALID_STATE If the user-configurable channel is not allocated.
- * @retval NRFX_ERROR_INVALID_PARAM If the channel cannot be disabled by the user.
- */
-nrfx_err_t nrfx_ppi_channel_disable(nrf_ppi_channel_t channel);
-
-/**
- * @brief Function for allocating a PPI channel group.
- * @details This function allocates the first unused PPI group.
- *
- * @param[out] p_group Pointer to the PPI channel group that has been allocated.
- *
- * @retval NRFX_SUCCESS      If the channel group was successfully allocated.
- * @retval NRFX_ERROR_NO_MEM If there is no available channel group to be used.
- */
-nrfx_err_t nrfx_ppi_group_alloc(nrf_ppi_channel_group_t * p_group);
-
-/**
- * @brief Function for freeing a PPI channel group.
- * @details This function also disables the chosen group.
- *
- * @param[in] group PPI channel group to be freed.
- *
- * @retval NRFX_SUCCESS             If the channel group was successfully freed.
- * @retval NRFX_ERROR_INVALID_PARAM If the channel group is not user-configurable.
- */
-nrfx_err_t nrfx_ppi_group_free(nrf_ppi_channel_group_t group);
-
-/**
- * @brief  Compute a channel mask for NRF_PPI registers.
- *
- * @param[in] channel Channel number to transform to a mask.
- *
- * @retval Channel mask.
- */
-__STATIC_INLINE uint32_t nrfx_ppi_channel_to_mask(nrf_ppi_channel_t channel)
-{
-    return (1uL << (uint32_t) channel);
-}
-
-/**
- * @brief Function for including multiple PPI channels in a channel group.
- *
- * @param[in] channel_mask PPI channels to be added.
- * @param[in] group        Channel group in which to include the channels.
- *
- * @retval NRFX_SUCCESS             If the channels was successfully included.
- * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group or channels are not an
- *                                  application channels.
- * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
- */
-nrfx_err_t nrfx_ppi_channels_include_in_group(uint32_t                channel_mask,
-                                              nrf_ppi_channel_group_t group);
-
-/**
- * @brief Function for including a PPI channel in a channel group.
- *
- * @param[in] channel PPI channel to be added.
- * @param[in] group   Channel group in which to include the channel.
- *
- * @retval NRFX_SUCCESS             If the channel was successfully included.
- * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group or channel is not an
- *                                  application channel.
- * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
- */
-__STATIC_INLINE nrfx_err_t nrfx_ppi_channel_include_in_group(nrf_ppi_channel_t       channel,
-                                                             nrf_ppi_channel_group_t group)
-{
-    return nrfx_ppi_channels_include_in_group(nrfx_ppi_channel_to_mask(channel), group);
-}
-
-/**
- * @brief Function for removing multiple PPI channels from a channel group.
- *
- * @param[in] channel_mask PPI channels to be removed.
- * @param[in] group        Channel group from which to remove the channels.
- *
- * @retval NRFX_SUCCESS             If the channel was successfully removed.
- * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group or channels are not an
- *                                  application channels.
- * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
- */
-nrfx_err_t nrfx_ppi_channels_remove_from_group(uint32_t                channel_mask,
-                                               nrf_ppi_channel_group_t group);
-
-/**
- * @brief Function for removing a PPI channel from a channel group.
- *
- * @param[in] channel PPI channel to be removed.
- * @param[in] group   Channel group from which to remove the channel.
- *
- * @retval NRFX_SUCCESS             If the channel was successfully removed.
- * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group or channel is not an
- *                                  application channel.
- * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
- */
-__STATIC_INLINE nrfx_err_t nrfx_ppi_channel_remove_from_group(nrf_ppi_channel_t       channel,
-                                                              nrf_ppi_channel_group_t group)
-{
-    return nrfx_ppi_channels_remove_from_group(nrfx_ppi_channel_to_mask(channel), group);
-}
-
-/**
- * @brief Function for clearing a PPI channel group.
- *
- * @param[in] group Channel group to be cleared.
- *
- * @retval NRFX_SUCCESS             If the group was successfully cleared.
- * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group.
- * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
- */
-__STATIC_INLINE nrfx_err_t nrfx_ppi_group_clear(nrf_ppi_channel_group_t group)
-{
-    return nrfx_ppi_channels_remove_from_group(NRFX_PPI_ALL_APP_CHANNELS_MASK, group);
-}
-
-/**
- * @brief Function for enabling a PPI channel group.
- *
- * @param[in] group Channel group to be enabled.
- *
- * @retval NRFX_SUCCESS             If the group was successfully enabled.
- * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group.
- * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
- */
-nrfx_err_t nrfx_ppi_group_enable(nrf_ppi_channel_group_t group);
-
-/**
- * @brief Function for disabling a PPI channel group.
- *
- * @param[in] group Channel group to be disabled.
- *
- * @retval NRFX_SUCCESS             If the group was successfully disabled.
- * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group.
- * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
- */
-nrfx_err_t nrfx_ppi_group_disable(nrf_ppi_channel_group_t group);
-
-/**
- * @brief Function for getting the address of a PPI task.
- *
- * @param[in] task Task.
- *
- * @retval Task address.
- */
-__STATIC_INLINE uint32_t nrfx_ppi_task_addr_get(nrf_ppi_task_t task)
-{
-    return (uint32_t) nrf_ppi_task_address_get(task);
-}
-
-/**
- * @brief Function for getting the address of a PPI group enable task.
- *
- * @param[in] group PPI channel group
- *
- * @retval Task address.
- */
-__STATIC_INLINE uint32_t nrfx_ppi_task_addr_group_enable_get(nrf_ppi_channel_group_t group)
-{
-    return (uint32_t) nrf_ppi_task_group_enable_address_get(group);
-}
-
-/**
- * @brief Function for getting the address of a PPI group enable task.
- *
- * @param[in] group PPI channel group
- *
- * @retval Task address.
- */
-__STATIC_INLINE uint32_t nrfx_ppi_task_addr_group_disable_get(nrf_ppi_channel_group_t group)
-{
-    return (uint32_t) nrf_ppi_task_group_disable_address_get(group);
-}
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_PPI_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_PPI_H__
+#define NRFX_PPI_H__
+
+#include <nrfx.h>
+#include <hal/nrf_ppi.h>
+
+/**
+ * @defgroup nrfx_ppi PPI allocator
+ * @{
+ * @ingroup nrf_ppi
+ * @brief   Programmable Peripheral Interconnect (PPI) allocator.
+ */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifndef NRFX_PPI_CHANNELS_USED
+#define NRFX_PPI_CHANNELS_USED 0
+#endif
+
+#ifndef NRFX_PPI_GROUPS_USED
+#define NRFX_PPI_GROUPS_USED 0
+#endif
+
+#if PPI_CH_NUM > 16
+#define NRFX_PPI_ALL_APP_CHANNELS_MASK   ((uint32_t)0xFFFFFFFFuL & ~(NRFX_PPI_CHANNELS_USED))  /**< All PPI channels available to the application. */
+#define NRFX_PPI_PROG_APP_CHANNELS_MASK  ((uint32_t)0x000FFFFFuL & ~(NRFX_PPI_CHANNELS_USED))  /**< Programmable PPI channels available to the application. */
+#else
+#define NRFX_PPI_ALL_APP_CHANNELS_MASK   ((uint32_t)0xFFF0FFFFuL & ~(NRFX_PPI_CHANNELS_USED))  /**< All PPI channels available to the application. */
+#define NRFX_PPI_PROG_APP_CHANNELS_MASK  ((uint32_t)0x0000FFFFuL & ~(NRFX_PPI_CHANNELS_USED))  /**< Programmable PPI channels available to the application. */
+#endif
+
+#define NRFX_PPI_ALL_APP_GROUPS_MASK     (((1uL << PPI_GROUP_NUM) - 1) & ~(NRFX_PPI_GROUPS_USED))    /**< All PPI groups available to the application. */
+
+/**
+ * @brief Function for uninitializing the PPI module.
+ *
+ * This function disables all channels and clears the channel groups.
+ */
+void nrfx_ppi_free_all(void);
+
+/**
+ * @brief Function for allocating a PPI channel.
+ * @details This function allocates the first unused PPI channel.
+ *
+ * @param[out] p_channel Pointer to the PPI channel that has been allocated.
+ *
+ * @retval NRFX_SUCCESS      If the channel was successfully allocated.
+ * @retval NRFX_ERROR_NO_MEM If there is no available channel to be used.
+ */
+nrfx_err_t nrfx_ppi_channel_alloc(nrf_ppi_channel_t * p_channel);
+
+/**
+ * @brief Function for freeing a PPI channel.
+ * @details This function also disables the chosen channel.
+ *
+ * @param[in] channel PPI channel to be freed.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully freed.
+ * @retval NRFX_ERROR_INVALID_PARAM If the channel is not user-configurable.
+ */
+nrfx_err_t nrfx_ppi_channel_free(nrf_ppi_channel_t channel);
+
+/**
+ * @brief Function for assigning task and event endpoints to the PPI channel.
+ *
+ * @param[in] channel PPI channel to be assigned endpoints.
+ * @param[in] eep     Event endpoint address.
+ * @param[in] tep     Task endpoint address.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully assigned.
+ * @retval NRFX_ERROR_INVALID_STATE If the channel is not allocated for the user.
+ * @retval NRFX_ERROR_INVALID_PARAM If the channel is not user-configurable.
+ */
+nrfx_err_t nrfx_ppi_channel_assign(nrf_ppi_channel_t channel, uint32_t eep, uint32_t tep);
+
+/**
+ * @brief Function for assigning or clearing fork endpoint to the PPI channel.
+ *
+ * @param[in] channel  PPI channel to be assigned endpoints.
+ * @param[in] fork_tep Fork task endpoint address or 0 to clear.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully assigned.
+ * @retval NRFX_ERROR_INVALID_STATE If the channel is not allocated for the user.
+ * @retval NRFX_ERROR_NOT_SUPPORTED If function is not supported.
+ */
+nrfx_err_t nrfx_ppi_channel_fork_assign(nrf_ppi_channel_t channel, uint32_t fork_tep);
+
+/**
+ * @brief Function for enabling a PPI channel.
+ *
+ * @param[in] channel PPI channel to be enabled.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully enabled.
+ * @retval NRFX_ERROR_INVALID_STATE If the user-configurable channel is not allocated.
+ * @retval NRFX_ERROR_INVALID_PARAM If the channel cannot be enabled by the user.
+ */
+nrfx_err_t nrfx_ppi_channel_enable(nrf_ppi_channel_t channel);
+
+/**
+ * @brief Function for disabling a PPI channel.
+ *
+ * @param[in] channel PPI channel to be disabled.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully disabled.
+ * @retval NRFX_ERROR_INVALID_STATE If the user-configurable channel is not allocated.
+ * @retval NRFX_ERROR_INVALID_PARAM If the channel cannot be disabled by the user.
+ */
+nrfx_err_t nrfx_ppi_channel_disable(nrf_ppi_channel_t channel);
+
+/**
+ * @brief Function for allocating a PPI channel group.
+ * @details This function allocates the first unused PPI group.
+ *
+ * @param[out] p_group Pointer to the PPI channel group that has been allocated.
+ *
+ * @retval NRFX_SUCCESS      If the channel group was successfully allocated.
+ * @retval NRFX_ERROR_NO_MEM If there is no available channel group to be used.
+ */
+nrfx_err_t nrfx_ppi_group_alloc(nrf_ppi_channel_group_t * p_group);
+
+/**
+ * @brief Function for freeing a PPI channel group.
+ * @details This function also disables the chosen group.
+ *
+ * @param[in] group PPI channel group to be freed.
+ *
+ * @retval NRFX_SUCCESS             If the channel group was successfully freed.
+ * @retval NRFX_ERROR_INVALID_PARAM If the channel group is not user-configurable.
+ */
+nrfx_err_t nrfx_ppi_group_free(nrf_ppi_channel_group_t group);
+
+/**
+ * @brief  Compute a channel mask for NRF_PPI registers.
+ *
+ * @param[in] channel Channel number to transform to a mask.
+ *
+ * @retval Channel mask.
+ */
+__STATIC_INLINE uint32_t nrfx_ppi_channel_to_mask(nrf_ppi_channel_t channel)
+{
+    return (1uL << (uint32_t) channel);
+}
+
+/**
+ * @brief Function for including multiple PPI channels in a channel group.
+ *
+ * @param[in] channel_mask PPI channels to be added.
+ * @param[in] group        Channel group in which to include the channels.
+ *
+ * @retval NRFX_SUCCESS             If the channels was successfully included.
+ * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group or channels are not an
+ *                                  application channels.
+ * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
+ */
+nrfx_err_t nrfx_ppi_channels_include_in_group(uint32_t                channel_mask,
+                                              nrf_ppi_channel_group_t group);
+
+/**
+ * @brief Function for including a PPI channel in a channel group.
+ *
+ * @param[in] channel PPI channel to be added.
+ * @param[in] group   Channel group in which to include the channel.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully included.
+ * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group or channel is not an
+ *                                  application channel.
+ * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
+ */
+__STATIC_INLINE nrfx_err_t nrfx_ppi_channel_include_in_group(nrf_ppi_channel_t       channel,
+                                                             nrf_ppi_channel_group_t group)
+{
+    return nrfx_ppi_channels_include_in_group(nrfx_ppi_channel_to_mask(channel), group);
+}
+
+/**
+ * @brief Function for removing multiple PPI channels from a channel group.
+ *
+ * @param[in] channel_mask PPI channels to be removed.
+ * @param[in] group        Channel group from which to remove the channels.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully removed.
+ * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group or channels are not an
+ *                                  application channels.
+ * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
+ */
+nrfx_err_t nrfx_ppi_channels_remove_from_group(uint32_t                channel_mask,
+                                               nrf_ppi_channel_group_t group);
+
+/**
+ * @brief Function for removing a PPI channel from a channel group.
+ *
+ * @param[in] channel PPI channel to be removed.
+ * @param[in] group   Channel group from which to remove the channel.
+ *
+ * @retval NRFX_SUCCESS             If the channel was successfully removed.
+ * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group or channel is not an
+ *                                  application channel.
+ * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
+ */
+__STATIC_INLINE nrfx_err_t nrfx_ppi_channel_remove_from_group(nrf_ppi_channel_t       channel,
+                                                              nrf_ppi_channel_group_t group)
+{
+    return nrfx_ppi_channels_remove_from_group(nrfx_ppi_channel_to_mask(channel), group);
+}
+
+/**
+ * @brief Function for clearing a PPI channel group.
+ *
+ * @param[in] group Channel group to be cleared.
+ *
+ * @retval NRFX_SUCCESS             If the group was successfully cleared.
+ * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group.
+ * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
+ */
+__STATIC_INLINE nrfx_err_t nrfx_ppi_group_clear(nrf_ppi_channel_group_t group)
+{
+    return nrfx_ppi_channels_remove_from_group(NRFX_PPI_ALL_APP_CHANNELS_MASK, group);
+}
+
+/**
+ * @brief Function for enabling a PPI channel group.
+ *
+ * @param[in] group Channel group to be enabled.
+ *
+ * @retval NRFX_SUCCESS             If the group was successfully enabled.
+ * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group.
+ * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
+ */
+nrfx_err_t nrfx_ppi_group_enable(nrf_ppi_channel_group_t group);
+
+/**
+ * @brief Function for disabling a PPI channel group.
+ *
+ * @param[in] group Channel group to be disabled.
+ *
+ * @retval NRFX_SUCCESS             If the group was successfully disabled.
+ * @retval NRFX_ERROR_INVALID_PARAM If group is not an application group.
+ * @retval NRFX_ERROR_INVALID_STATE If group is not an allocated group.
+ */
+nrfx_err_t nrfx_ppi_group_disable(nrf_ppi_channel_group_t group);
+
+/**
+ * @brief Function for getting the address of a PPI task.
+ *
+ * @param[in] task Task.
+ *
+ * @retval Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_ppi_task_addr_get(nrf_ppi_task_t task)
+{
+    return (uint32_t) nrf_ppi_task_address_get(task);
+}
+
+/**
+ * @brief Function for getting the address of a PPI group enable task.
+ *
+ * @param[in] group PPI channel group
+ *
+ * @retval Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_ppi_task_addr_group_enable_get(nrf_ppi_channel_group_t group)
+{
+    return (uint32_t) nrf_ppi_task_group_enable_address_get(group);
+}
+
+/**
+ * @brief Function for getting the address of a PPI group enable task.
+ *
+ * @param[in] group PPI channel group
+ *
+ * @retval Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_ppi_task_addr_group_disable_get(nrf_ppi_channel_group_t group)
+{
+    return (uint32_t) nrf_ppi_task_group_disable_address_get(group);
+}
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_PPI_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_pwm.h

@@ -1,497 +1,488 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_PWM_H__
-#define NRFX_PWM_H__
-
-#include <nrfx.h>
-#include <hal/nrf_pwm.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_pwm PWM driver
- * @{
- * @ingroup nrf_pwm
- * @brief   Pulse Width Modulation (PWM) peripheral driver.
- */
-
-/**
- * @brief PWM driver instance data structure.
- */
-typedef struct
-{
-    NRF_PWM_Type * p_registers;  ///< Pointer to the structure with PWM peripheral instance registers.
-    uint8_t        drv_inst_idx; ///< Driver instance index.
-} nrfx_pwm_t;
-
-/**
- * @brief Macro for creating a PWM driver instance.
- */
-#define NRFX_PWM_INSTANCE(id)                               \
-{                                                           \
-    .p_registers  = NRFX_CONCAT_2(NRF_PWM, id),             \
-    .drv_inst_idx = NRFX_CONCAT_3(NRFX_PWM, id, _INST_IDX), \
-}
-
-enum {
-#if NRFX_CHECK(NRFX_PWM0_ENABLED)
-    NRFX_PWM0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_PWM1_ENABLED)
-    NRFX_PWM1_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_PWM2_ENABLED)
-    NRFX_PWM2_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_PWM3_ENABLED)
-    NRFX_PWM3_INST_IDX,
-#endif
-    NRFX_PWM_ENABLED_COUNT
-};
-
-/**
- * @brief This value can be provided instead of a pin number for any channel
- *        to specify that its output is not used and therefore does not need
- *        to be connected to a pin.
- */
-#define NRFX_PWM_PIN_NOT_USED    0xFF
-
-/**
- * @brief This value can be added to a pin number to inverse its polarity
- *        (set idle state = 1).
- */
-#define NRFX_PWM_PIN_INVERTED    0x80
-
-/**
- * @brief PWM driver configuration structure.
- */
-typedef struct
-{
-    uint8_t output_pins[NRF_PWM_CHANNEL_COUNT]; ///< Pin numbers for individual output channels (optional).
-                                                /**< Use @ref NRFX_PWM_PIN_NOT_USED
-                                                 *   if a given output channel is not needed. */
-    uint8_t            irq_priority; ///< Interrupt priority.
-    nrf_pwm_clk_t      base_clock;   ///< Base clock frequency.
-    nrf_pwm_mode_t     count_mode;   ///< Operating mode of the pulse generator counter.
-    uint16_t           top_value;    ///< Value up to which the pulse generator counter counts.
-    nrf_pwm_dec_load_t load_mode;    ///< Mode of loading sequence data from RAM.
-    nrf_pwm_dec_step_t step_mode;    ///< Mode of advancing the active sequence.
-} nrfx_pwm_config_t;
-
-/**
- * @brief PWM driver default configuration.
- */
-#define NRFX_PWM_DEFAULT_CONFIG                                            \
-{                                                                          \
-    .output_pins  = { NRFX_PWM_DEFAULT_CONFIG_OUT0_PIN,                    \
-                      NRFX_PWM_DEFAULT_CONFIG_OUT1_PIN,                    \
-                      NRFX_PWM_DEFAULT_CONFIG_OUT2_PIN,                    \
-                      NRFX_PWM_DEFAULT_CONFIG_OUT3_PIN },                  \
-    .irq_priority = NRFX_PWM_DEFAULT_CONFIG_IRQ_PRIORITY,                  \
-    .base_clock   = (nrf_pwm_clk_t)NRFX_PWM_DEFAULT_CONFIG_BASE_CLOCK,     \
-    .count_mode   = (nrf_pwm_mode_t)NRFX_PWM_DEFAULT_CONFIG_COUNT_MODE,    \
-    .top_value    = NRFX_PWM_DEFAULT_CONFIG_TOP_VALUE,                     \
-    .load_mode    = (nrf_pwm_dec_load_t)NRFX_PWM_DEFAULT_CONFIG_LOAD_MODE, \
-    .step_mode    = (nrf_pwm_dec_step_t)NRFX_PWM_DEFAULT_CONFIG_STEP_MODE, \
-}
-
-
-/**
- * @brief PWM flags providing additional playback options.
- */
-typedef enum
-{
-    NRFX_PWM_FLAG_STOP = 0x01, /**< When the requested playback is finished,
-                                    the peripheral should be stopped.
-                                    @note The STOP task is triggered when
-                                    the last value of the final sequence is
-                                    loaded from RAM, and the peripheral stops
-                                    at the end of the current PWM period.
-                                    For sequences with configured repeating
-                                    of duty cycle values, this might result in
-                                    less than the requested number of repeats
-                                    of the last value. */
-    NRFX_PWM_FLAG_LOOP = 0x02, /**< When the requested playback is finished,
-                                    it should be started from the beginning.
-                                    This flag is ignored if used together
-                                    with @ref NRFX_PWM_FLAG_STOP.
-                                    @note The playback restart is done via a
-                                    shortcut configured in the PWM peripheral.
-                                    This shortcut triggers the proper starting
-                                    task when the final value of previous
-                                    playback is read from RAM and applied to
-                                    the pulse generator counter.
-                                    When this mechanism is used together with
-                                    the @ref NRF_PWM_STEP_TRIGGERED mode,
-                                    the playback restart will occur right
-                                    after switching to the final value (this
-                                    final value will be played only once). */
-    NRFX_PWM_FLAG_SIGNAL_END_SEQ0 = 0x04, /**< The event handler should be
-                                               called when the last value
-                                               from sequence 0 is loaded. */
-    NRFX_PWM_FLAG_SIGNAL_END_SEQ1 = 0x08, /**< The event handler should be
-                                               called when the last value
-                                               from sequence 1 is loaded. */
-    NRFX_PWM_FLAG_NO_EVT_FINISHED = 0x10, /**< The playback finished event
-                                               (enabled by default) should be
-                                               suppressed. */
-    NRFX_PWM_FLAG_START_VIA_TASK = 0x80, /**< The playback should not be
-                                              started directly by the called
-                                              function. Instead, the function
-                                              should only prepare it and
-                                              return the address of the task
-                                              to be triggered to start the
-                                              playback. */
-} nrfx_pwm_flag_t;
-
-
-/**
- * @brief PWM driver event type.
- */
-typedef enum
-{
-    NRFX_PWM_EVT_FINISHED, ///< Sequence playback finished.
-    NRFX_PWM_EVT_END_SEQ0, /**< End of sequence 0 reached. Its data can be
-                                safely modified now. */
-    NRFX_PWM_EVT_END_SEQ1, /**< End of sequence 1 reached. Its data can be
-                                safely modified now. */
-    NRFX_PWM_EVT_STOPPED,  ///< The PWM peripheral has been stopped.
-} nrfx_pwm_evt_type_t;
-
-/**
- * @brief PWM driver event handler type.
- */
-typedef void (* nrfx_pwm_handler_t)(nrfx_pwm_evt_type_t event_type);
-
-
-/**
- * @brief Function for initializing the PWM driver.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] p_config   Pointer to the structure with initial configuration.
- *
- * @param[in] handler    Event handler provided by the user. If NULL is passed
- *                       instead, event notifications are not done and PWM
- *                       interrupts are disabled.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
- */
-nrfx_err_t nrfx_pwm_init(nrfx_pwm_t const * const  p_instance,
-                         nrfx_pwm_config_t const * p_config,
-                         nrfx_pwm_handler_t        handler);
-
-/**
- * @brief Function for uninitializing the PWM driver.
- *
- * If any sequence playback is in progress, it is stopped immediately.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_pwm_uninit(nrfx_pwm_t const * const p_instance);
-
-/**
- * @brief Function for starting a single sequence playback.
- *
- * To take advantage of the looping mechanism in the PWM peripheral, both
- * sequences must be used (single sequence can be played back only once by
- * the peripheral). Therefore, the provided sequence is internally set and
- * played back as both sequence 0 and sequence 1. Consequently, if end of
- * sequence notifications are required, events for both sequences should be
- * used (that means that both the @ref NRFX_PWM_FLAG_SIGNAL_END_SEQ0 flag
- * and the @ref NRFX_PWM_FLAG_SIGNAL_END_SEQ1 flag should be specified and
- * the @ref NRFX_PWM_EVT_END_SEQ0 event and the @ref NRFX_PWM_EVT_END_SEQ1
- * event should be handled in the same way).
- *
- * Use the @ref NRFX_PWM_FLAG_START_VIA_TASK flag if you want the playback
- * to be only prepared by this function, and you want to start it later by
- * triggering a task (using PPI for instance). The function will then return
- * the address of the task to be triggered.
- *
- * @note The array containing the duty cycle values for the specified sequence
- *       must be in RAM and cannot be allocated on stack.
- *       For detailed information, see @ref nrf_pwm_sequence_t.
- *
- * @param[in] p_instance     Pointer to the driver instance structure.
- * @param[in] p_sequence     Sequence to be played back.
- * @param[in] playback_count Number of playbacks to be performed (must not be 0).
- * @param[in] flags          Additional options. Pass any combination of
- *                           @ref nrfx_pwm_flag_t "playback flags", or 0
- *                           for default settings.
- *
- * @return Address of the task to be triggered to start the playback if the @ref
- *         NRFX_PWM_FLAG_START_VIA_TASK flag was used, 0 otherwise.
- */
-uint32_t nrfx_pwm_simple_playback(nrfx_pwm_t const * const   p_instance,
-                                  nrf_pwm_sequence_t const * p_sequence,
-                                  uint16_t                   playback_count,
-                                  uint32_t                   flags);
-
-/**
- * @brief Function for starting a two-sequence playback.
- *
- * Use the @ref NRFX_PWM_FLAG_START_VIA_TASK flag if you want the playback
- * to be only prepared by this function, and you want to start it later by
- * triggering a task (using PPI for instance). The function will then return
- * the address of the task to be triggered.
- *
- * @note The array containing the duty cycle values for the specified sequence
- *       must be in RAM and cannot be allocated on stack.
- *       For detailed information, see @ref nrf_pwm_sequence_t.
- *
- * @param[in] p_instance     Pointer to the driver instance structure.
- * @param[in] p_sequence_0   First sequence to be played back.
- * @param[in] p_sequence_1   Second sequence to be played back.
- * @param[in] playback_count Number of playbacks to be performed (must not be 0).
- * @param[in] flags          Additional options. Pass any combination of
- *                           @ref nrfx_pwm_flag_t "playback flags", or 0
- *                           for default settings.
- *
- * @return Address of the task to be triggered to start the playback if the @ref
- *         NRFX_PWM_FLAG_START_VIA_TASK flag was used, 0 otherwise.
- */
-uint32_t nrfx_pwm_complex_playback(nrfx_pwm_t const * const   p_instance,
-                                   nrf_pwm_sequence_t const * p_sequence_0,
-                                   nrf_pwm_sequence_t const * p_sequence_1,
-                                   uint16_t                   playback_count,
-                                   uint32_t                   flags);
-
-/**
- * @brief Function for advancing the active sequence.
- *
- * This function only applies to @ref NRF_PWM_STEP_TRIGGERED mode.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-__STATIC_INLINE void nrfx_pwm_step(nrfx_pwm_t const * const p_instance);
-
-/**
- * @brief Function for stopping the sequence playback.
- *
- * The playback is stopped at the end of the current PWM period.
- * This means that if the active sequence is configured to repeat each duty
- * cycle value for a certain number of PWM periods, the last played value
- * might appear on the output less times than requested.
- *
- * @note This function can be instructed to wait until the playback is stopped
- *       (by setting @p wait_until_stopped to true). Note that, depending on
- *       the length of the PMW period, this might take a significant amount of
- *       time. Alternatively, the @ref nrfx_pwm_is_stopped function can be
- *       used to poll the status, or the @ref NRFX_PWM_EVT_STOPPED event can
- *       be used to get the notification when the playback is stopped, provided
- *       the event handler is defined.
- *
- * @param[in] p_instance         Pointer to the driver instance structure.
- * @param[in] wait_until_stopped If true, the function will not return until
- *                               the playback is stopped.
- *
- * @retval true  If the PWM peripheral is stopped.
- * @retval false If the PWM peripheral is not stopped.
- */
-bool nrfx_pwm_stop(nrfx_pwm_t const * const p_instance,
-                   bool wait_until_stopped);
-
-/**
- * @brief Function for checking the status of the PWM peripheral.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  If the PWM peripheral is stopped.
- * @retval false If the PWM peripheral is not stopped.
- */
-bool nrfx_pwm_is_stopped(nrfx_pwm_t const * const p_instance);
-
-/**
- * @brief Function for updating the sequence data during playback.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] seq_id     Identifier of the sequence (0 or 1).
- * @param[in] p_sequence Pointer to the new sequence definition.
- */
-__STATIC_INLINE void nrfx_pwm_sequence_update(
-                                        nrfx_pwm_t const * const   p_instance,
-                                        uint8_t                    seq_id,
-                                        nrf_pwm_sequence_t const * p_sequence);
-
-/**
- * @brief Function for updating the pointer to the duty cycle values
- *        in the specified sequence during playback.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] seq_id     Identifier of the sequence (0 or 1).
- * @param[in] values     New pointer to the duty cycle values.
- */
-__STATIC_INLINE void nrfx_pwm_sequence_values_update(nrfx_pwm_t const * const p_instance,
-                                                     uint8_t                  seq_id,
-                                                     nrf_pwm_values_t         values);
-
-/**
- * @brief Function for updating the number of duty cycle values
- *        in the specified sequence during playback.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] seq_id     Identifier of the sequence (0 or 1).
- * @param[in] length     New number of the duty cycle values.
- */
-__STATIC_INLINE void nrfx_pwm_sequence_length_update(nrfx_pwm_t const * const p_instance,
-                                                     uint8_t                  seq_id,
-                                                     uint16_t                 length);
-
-/**
- * @brief Function for updating the number of repeats for duty cycle values
- *        in specified sequence during playback.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] seq_id     Identifier of the sequence (0 or 1).
- * @param[in] repeats    New number of repeats.
- */
-__STATIC_INLINE void nrfx_pwm_sequence_repeats_update(nrfx_pwm_t const * const p_instance,
-                                                      uint8_t                  seq_id,
-                                                      uint32_t                 repeats);
-
-/**
- * @brief Function for updating the additional delay after the specified
- *        sequence during playback.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] seq_id     Identifier of the sequence (0 or 1).
- * @param[in] end_delay  New end delay value (in PWM periods).
- */
-__STATIC_INLINE void nrfx_pwm_sequence_end_delay_update(nrfx_pwm_t const * const p_instance,
-                                                        uint8_t                  seq_id,
-                                                        uint32_t                 end_delay);
-
-/**
- * @brief Function for returning the address of a specified PWM task that can
- *        be used in PPI module.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] task       Requested task.
- *
- * @return Task address.
- */
-__STATIC_INLINE uint32_t nrfx_pwm_task_address_get(nrfx_pwm_t const * const p_instance,
-                                                   nrf_pwm_task_t           task);
-
-/**@brief Function for returning the address of a specified PWM event that can
- *        be used in PPI module.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] event      Requested event.
- *
- * @return Event address.
- */
-__STATIC_INLINE uint32_t nrfx_pwm_event_address_get(nrfx_pwm_t const * const p_instance,
-                                                    nrf_pwm_event_t          event);
-
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-
-__STATIC_INLINE void nrfx_pwm_step(nrfx_pwm_t const * const p_instance)
-{
-    nrf_pwm_task_trigger(p_instance->p_registers, NRF_PWM_TASK_NEXTSTEP);
-}
-
-__STATIC_INLINE void nrfx_pwm_sequence_update(nrfx_pwm_t const * const   p_instance,
-                                              uint8_t                    seq_id,
-                                              nrf_pwm_sequence_t const * p_sequence)
-{
-    nrf_pwm_sequence_set(p_instance->p_registers, seq_id, p_sequence);
-}
-
-__STATIC_INLINE void nrfx_pwm_sequence_values_update(nrfx_pwm_t const * const p_instance,
-                                                     uint8_t                  seq_id,
-                                                     nrf_pwm_values_t         values)
-{
-    nrf_pwm_seq_ptr_set(p_instance->p_registers, seq_id, values.p_raw);
-}
-
-__STATIC_INLINE void nrfx_pwm_sequence_length_update(nrfx_pwm_t const * const p_instance,
-                                                     uint8_t                  seq_id,
-                                                     uint16_t                 length)
-{
-    nrf_pwm_seq_cnt_set(p_instance->p_registers, seq_id, length);
-}
-
-__STATIC_INLINE void nrfx_pwm_sequence_repeats_update(nrfx_pwm_t const * const p_instance,
-                                                      uint8_t                  seq_id,
-                                                      uint32_t                 repeats)
-{
-    nrf_pwm_seq_refresh_set(p_instance->p_registers, seq_id, repeats);
-}
-
-__STATIC_INLINE void nrfx_pwm_sequence_end_delay_update(nrfx_pwm_t const * const p_instance,
-                                                        uint8_t                  seq_id,
-                                                        uint32_t                 end_delay)
-{
-    nrf_pwm_seq_end_delay_set(p_instance->p_registers, seq_id, end_delay);
-}
-
-__STATIC_INLINE uint32_t nrfx_pwm_task_address_get(nrfx_pwm_t const * const p_instance,
-                                                   nrf_pwm_task_t           task)
-{
-    return nrf_pwm_task_address_get(p_instance->p_registers, task);
-}
-
-__STATIC_INLINE uint32_t nrfx_pwm_event_address_get(nrfx_pwm_t const * const p_instance,
-                                                    nrf_pwm_event_t          event)
-{
-    return nrf_pwm_event_address_get(p_instance->p_registers, event);
-}
-
-#endif // SUPPRESS_INLINE_IMPLEMENTATION
-
-
-void nrfx_pwm_0_irq_handler(void);
-void nrfx_pwm_1_irq_handler(void);
-void nrfx_pwm_2_irq_handler(void);
-void nrfx_pwm_3_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_PWM_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_PWM_H__
+#define NRFX_PWM_H__
+
+#include <nrfx.h>
+#include <hal/nrf_pwm.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_pwm PWM driver
+ * @{
+ * @ingroup nrf_pwm
+ * @brief   Pulse Width Modulation (PWM) peripheral driver.
+ */
+
+/**
+ * @brief PWM driver instance data structure.
+ */
+typedef struct
+{
+    NRF_PWM_Type * p_registers;  ///< Pointer to the structure with PWM peripheral instance registers.
+    uint8_t        drv_inst_idx; ///< Driver instance index.
+} nrfx_pwm_t;
+
+/**
+ * @brief Macro for creating a PWM driver instance.
+ */
+#define NRFX_PWM_INSTANCE(id)                               \
+{                                                           \
+    .p_registers  = NRFX_CONCAT_2(NRF_PWM, id),             \
+    .drv_inst_idx = NRFX_CONCAT_3(NRFX_PWM, id, _INST_IDX), \
+}
+
+enum {
+#if NRFX_CHECK(NRFX_PWM0_ENABLED)
+    NRFX_PWM0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_PWM1_ENABLED)
+    NRFX_PWM1_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_PWM2_ENABLED)
+    NRFX_PWM2_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_PWM3_ENABLED)
+    NRFX_PWM3_INST_IDX,
+#endif
+    NRFX_PWM_ENABLED_COUNT
+};
+
+/**
+ * @brief This value can be provided instead of a pin number for any channel
+ *        to specify that its output is not used and therefore does not need
+ *        to be connected to a pin.
+ */
+#define NRFX_PWM_PIN_NOT_USED    0xFF
+
+/**
+ * @brief This value can be added to a pin number to inverse its polarity
+ *        (set idle state = 1).
+ */
+#define NRFX_PWM_PIN_INVERTED    0x80
+
+/**
+ * @brief PWM driver configuration structure.
+ */
+typedef struct
+{
+    uint8_t output_pins[NRF_PWM_CHANNEL_COUNT]; ///< Pin numbers for individual output channels (optional).
+                                                /**< Use @ref NRFX_PWM_PIN_NOT_USED
+                                                 *   if a given output channel is not needed. */
+    uint8_t            irq_priority; ///< Interrupt priority.
+    nrf_pwm_clk_t      base_clock;   ///< Base clock frequency.
+    nrf_pwm_mode_t     count_mode;   ///< Operating mode of the pulse generator counter.
+    uint16_t           top_value;    ///< Value up to which the pulse generator counter counts.
+    nrf_pwm_dec_load_t load_mode;    ///< Mode of loading sequence data from RAM.
+    nrf_pwm_dec_step_t step_mode;    ///< Mode of advancing the active sequence.
+} nrfx_pwm_config_t;
+
+/**
+ * @brief PWM driver default configuration.
+ */
+#define NRFX_PWM_DEFAULT_CONFIG                                            \
+{                                                                          \
+    .output_pins  = { NRFX_PWM_DEFAULT_CONFIG_OUT0_PIN,                    \
+                      NRFX_PWM_DEFAULT_CONFIG_OUT1_PIN,                    \
+                      NRFX_PWM_DEFAULT_CONFIG_OUT2_PIN,                    \
+                      NRFX_PWM_DEFAULT_CONFIG_OUT3_PIN },                  \
+    .irq_priority = NRFX_PWM_DEFAULT_CONFIG_IRQ_PRIORITY,                  \
+    .base_clock   = (nrf_pwm_clk_t)NRFX_PWM_DEFAULT_CONFIG_BASE_CLOCK,     \
+    .count_mode   = (nrf_pwm_mode_t)NRFX_PWM_DEFAULT_CONFIG_COUNT_MODE,    \
+    .top_value    = NRFX_PWM_DEFAULT_CONFIG_TOP_VALUE,                     \
+    .load_mode    = (nrf_pwm_dec_load_t)NRFX_PWM_DEFAULT_CONFIG_LOAD_MODE, \
+    .step_mode    = (nrf_pwm_dec_step_t)NRFX_PWM_DEFAULT_CONFIG_STEP_MODE, \
+}
+
+
+/**
+ * @brief PWM flags providing additional playback options.
+ */
+typedef enum
+{
+    NRFX_PWM_FLAG_STOP = 0x01, /**< When the requested playback is finished,
+                                    the peripheral should be stopped.
+                                    @note The STOP task is triggered when
+                                    the last value of the final sequence is
+                                    loaded from RAM, and the peripheral stops
+                                    at the end of the current PWM period.
+                                    For sequences with configured repeating
+                                    of duty cycle values, this might result in
+                                    less than the requested number of repeats
+                                    of the last value. */
+    NRFX_PWM_FLAG_LOOP = 0x02, /**< When the requested playback is finished,
+                                    it should be started from the beginning.
+                                    This flag is ignored if used together
+                                    with @ref NRFX_PWM_FLAG_STOP.
+                                    @note The playback restart is done via a
+                                    shortcut configured in the PWM peripheral.
+                                    This shortcut triggers the proper starting
+                                    task when the final value of previous
+                                    playback is read from RAM and applied to
+                                    the pulse generator counter.
+                                    When this mechanism is used together with
+                                    the @ref NRF_PWM_STEP_TRIGGERED mode,
+                                    the playback restart will occur right
+                                    after switching to the final value (this
+                                    final value will be played only once). */
+    NRFX_PWM_FLAG_SIGNAL_END_SEQ0 = 0x04, /**< The event handler should be
+                                               called when the last value
+                                               from sequence 0 is loaded. */
+    NRFX_PWM_FLAG_SIGNAL_END_SEQ1 = 0x08, /**< The event handler should be
+                                               called when the last value
+                                               from sequence 1 is loaded. */
+    NRFX_PWM_FLAG_NO_EVT_FINISHED = 0x10, /**< The playback finished event
+                                               (enabled by default) should be
+                                               suppressed. */
+    NRFX_PWM_FLAG_START_VIA_TASK = 0x80, /**< The playback should not be
+                                              started directly by the called
+                                              function. Instead, the function
+                                              should only prepare it and
+                                              return the address of the task
+                                              to be triggered to start the
+                                              playback. */
+} nrfx_pwm_flag_t;
+
+
+/**
+ * @brief PWM driver event type.
+ */
+typedef enum
+{
+    NRFX_PWM_EVT_FINISHED, ///< Sequence playback finished.
+    NRFX_PWM_EVT_END_SEQ0, /**< End of sequence 0 reached. Its data can be
+                                safely modified now. */
+    NRFX_PWM_EVT_END_SEQ1, /**< End of sequence 1 reached. Its data can be
+                                safely modified now. */
+    NRFX_PWM_EVT_STOPPED,  ///< The PWM peripheral has been stopped.
+} nrfx_pwm_evt_type_t;
+
+/**
+ * @brief PWM driver event handler type.
+ */
+typedef void (* nrfx_pwm_handler_t)(nrfx_pwm_evt_type_t event_type);
+
+
+/**
+ * @brief Function for initializing the PWM driver.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] p_config   Pointer to the structure with initial configuration.
+ *
+ * @param[in] handler    Event handler provided by the user. If NULL is passed
+ *                       instead, event notifications are not done and PWM
+ *                       interrupts are disabled.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
+ */
+nrfx_err_t nrfx_pwm_init(nrfx_pwm_t const * const  p_instance,
+                         nrfx_pwm_config_t const * p_config,
+                         nrfx_pwm_handler_t        handler);
+
+/**
+ * @brief Function for uninitializing the PWM driver.
+ *
+ * If any sequence playback is in progress, it is stopped immediately.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_pwm_uninit(nrfx_pwm_t const * const p_instance);
+
+/**
+ * @brief Function for starting a single sequence playback.
+ *
+ * To take advantage of the looping mechanism in the PWM peripheral, both
+ * sequences must be used (single sequence can be played back only once by
+ * the peripheral). Therefore, the provided sequence is internally set and
+ * played back as both sequence 0 and sequence 1. Consequently, if end of
+ * sequence notifications are required, events for both sequences should be
+ * used (that means that both the @ref NRFX_PWM_FLAG_SIGNAL_END_SEQ0 flag
+ * and the @ref NRFX_PWM_FLAG_SIGNAL_END_SEQ1 flag should be specified and
+ * the @ref NRFX_PWM_EVT_END_SEQ0 event and the @ref NRFX_PWM_EVT_END_SEQ1
+ * event should be handled in the same way).
+ *
+ * Use the @ref NRFX_PWM_FLAG_START_VIA_TASK flag if you want the playback
+ * to be only prepared by this function, and you want to start it later by
+ * triggering a task (using PPI for instance). The function will then return
+ * the address of the task to be triggered.
+ *
+ * @note The array containing the duty cycle values for the specified sequence
+ *       must be in RAM and cannot be allocated on stack.
+ *       For detailed information, see @ref nrf_pwm_sequence_t.
+ *
+ * @param[in] p_instance     Pointer to the driver instance structure.
+ * @param[in] p_sequence     Sequence to be played back.
+ * @param[in] playback_count Number of playbacks to be performed (must not be 0).
+ * @param[in] flags          Additional options. Pass any combination of
+ *                           @ref nrfx_pwm_flag_t "playback flags", or 0
+ *                           for default settings.
+ *
+ * @return Address of the task to be triggered to start the playback if the @ref
+ *         NRFX_PWM_FLAG_START_VIA_TASK flag was used, 0 otherwise.
+ */
+uint32_t nrfx_pwm_simple_playback(nrfx_pwm_t const * const   p_instance,
+                                  nrf_pwm_sequence_t const * p_sequence,
+                                  uint16_t                   playback_count,
+                                  uint32_t                   flags);
+
+/**
+ * @brief Function for starting a two-sequence playback.
+ *
+ * Use the @ref NRFX_PWM_FLAG_START_VIA_TASK flag if you want the playback
+ * to be only prepared by this function, and you want to start it later by
+ * triggering a task (using PPI for instance). The function will then return
+ * the address of the task to be triggered.
+ *
+ * @note The array containing the duty cycle values for the specified sequence
+ *       must be in RAM and cannot be allocated on stack.
+ *       For detailed information, see @ref nrf_pwm_sequence_t.
+ *
+ * @param[in] p_instance     Pointer to the driver instance structure.
+ * @param[in] p_sequence_0   First sequence to be played back.
+ * @param[in] p_sequence_1   Second sequence to be played back.
+ * @param[in] playback_count Number of playbacks to be performed (must not be 0).
+ * @param[in] flags          Additional options. Pass any combination of
+ *                           @ref nrfx_pwm_flag_t "playback flags", or 0
+ *                           for default settings.
+ *
+ * @return Address of the task to be triggered to start the playback if the @ref
+ *         NRFX_PWM_FLAG_START_VIA_TASK flag was used, 0 otherwise.
+ */
+uint32_t nrfx_pwm_complex_playback(nrfx_pwm_t const * const   p_instance,
+                                   nrf_pwm_sequence_t const * p_sequence_0,
+                                   nrf_pwm_sequence_t const * p_sequence_1,
+                                   uint16_t                   playback_count,
+                                   uint32_t                   flags);
+
+/**
+ * @brief Function for advancing the active sequence.
+ *
+ * This function only applies to @ref NRF_PWM_STEP_TRIGGERED mode.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+__STATIC_INLINE void nrfx_pwm_step(nrfx_pwm_t const * const p_instance);
+
+/**
+ * @brief Function for stopping the sequence playback.
+ *
+ * The playback is stopped at the end of the current PWM period.
+ * This means that if the active sequence is configured to repeat each duty
+ * cycle value for a certain number of PWM periods, the last played value
+ * might appear on the output less times than requested.
+ *
+ * @note This function can be instructed to wait until the playback is stopped
+ *       (by setting @p wait_until_stopped to true). Note that, depending on
+ *       the length of the PMW period, this might take a significant amount of
+ *       time. Alternatively, the @ref nrfx_pwm_is_stopped function can be
+ *       used to poll the status, or the @ref NRFX_PWM_EVT_STOPPED event can
+ *       be used to get the notification when the playback is stopped, provided
+ *       the event handler is defined.
+ *
+ * @param[in] p_instance         Pointer to the driver instance structure.
+ * @param[in] wait_until_stopped If true, the function will not return until
+ *                               the playback is stopped.
+ *
+ * @retval true  If the PWM peripheral is stopped.
+ * @retval false If the PWM peripheral is not stopped.
+ */
+bool nrfx_pwm_stop(nrfx_pwm_t const * const p_instance,
+                   bool wait_until_stopped);
+
+/**
+ * @brief Function for checking the status of the PWM peripheral.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  If the PWM peripheral is stopped.
+ * @retval false If the PWM peripheral is not stopped.
+ */
+bool nrfx_pwm_is_stopped(nrfx_pwm_t const * const p_instance);
+
+/**
+ * @brief Function for updating the sequence data during playback.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] seq_id     Identifier of the sequence (0 or 1).
+ * @param[in] p_sequence Pointer to the new sequence definition.
+ */
+__STATIC_INLINE void nrfx_pwm_sequence_update(
+                                        nrfx_pwm_t const * const   p_instance,
+                                        uint8_t                    seq_id,
+                                        nrf_pwm_sequence_t const * p_sequence);
+
+/**
+ * @brief Function for updating the pointer to the duty cycle values
+ *        in the specified sequence during playback.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] seq_id     Identifier of the sequence (0 or 1).
+ * @param[in] values     New pointer to the duty cycle values.
+ */
+__STATIC_INLINE void nrfx_pwm_sequence_values_update(nrfx_pwm_t const * const p_instance,
+                                                     uint8_t                  seq_id,
+                                                     nrf_pwm_values_t         values);
+
+/**
+ * @brief Function for updating the number of duty cycle values
+ *        in the specified sequence during playback.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] seq_id     Identifier of the sequence (0 or 1).
+ * @param[in] length     New number of the duty cycle values.
+ */
+__STATIC_INLINE void nrfx_pwm_sequence_length_update(nrfx_pwm_t const * const p_instance,
+                                                     uint8_t                  seq_id,
+                                                     uint16_t                 length);
+
+/**
+ * @brief Function for updating the number of repeats for duty cycle values
+ *        in specified sequence during playback.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] seq_id     Identifier of the sequence (0 or 1).
+ * @param[in] repeats    New number of repeats.
+ */
+__STATIC_INLINE void nrfx_pwm_sequence_repeats_update(nrfx_pwm_t const * const p_instance,
+                                                      uint8_t                  seq_id,
+                                                      uint32_t                 repeats);
+
+/**
+ * @brief Function for updating the additional delay after the specified
+ *        sequence during playback.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] seq_id     Identifier of the sequence (0 or 1).
+ * @param[in] end_delay  New end delay value (in PWM periods).
+ */
+__STATIC_INLINE void nrfx_pwm_sequence_end_delay_update(nrfx_pwm_t const * const p_instance,
+                                                        uint8_t                  seq_id,
+                                                        uint32_t                 end_delay);
+
+/**
+ * @brief Function for returning the address of a specified PWM task that can
+ *        be used in PPI module.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] task       Requested task.
+ *
+ * @return Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_pwm_task_address_get(nrfx_pwm_t const * const p_instance,
+                                                   nrf_pwm_task_t           task);
+
+/**@brief Function for returning the address of a specified PWM event that can
+ *        be used in PPI module.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] event      Requested event.
+ *
+ * @return Event address.
+ */
+__STATIC_INLINE uint32_t nrfx_pwm_event_address_get(nrfx_pwm_t const * const p_instance,
+                                                    nrf_pwm_event_t          event);
+
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+
+__STATIC_INLINE void nrfx_pwm_step(nrfx_pwm_t const * const p_instance)
+{
+    nrf_pwm_task_trigger(p_instance->p_registers, NRF_PWM_TASK_NEXTSTEP);
+}
+
+__STATIC_INLINE void nrfx_pwm_sequence_update(nrfx_pwm_t const * const   p_instance,
+                                              uint8_t                    seq_id,
+                                              nrf_pwm_sequence_t const * p_sequence)
+{
+    nrf_pwm_sequence_set(p_instance->p_registers, seq_id, p_sequence);
+}
+
+__STATIC_INLINE void nrfx_pwm_sequence_values_update(nrfx_pwm_t const * const p_instance,
+                                                     uint8_t                  seq_id,
+                                                     nrf_pwm_values_t         values)
+{
+    nrf_pwm_seq_ptr_set(p_instance->p_registers, seq_id, values.p_raw);
+}
+
+__STATIC_INLINE void nrfx_pwm_sequence_length_update(nrfx_pwm_t const * const p_instance,
+                                                     uint8_t                  seq_id,
+                                                     uint16_t                 length)
+{
+    nrf_pwm_seq_cnt_set(p_instance->p_registers, seq_id, length);
+}
+
+__STATIC_INLINE void nrfx_pwm_sequence_repeats_update(nrfx_pwm_t const * const p_instance,
+                                                      uint8_t                  seq_id,
+                                                      uint32_t                 repeats)
+{
+    nrf_pwm_seq_refresh_set(p_instance->p_registers, seq_id, repeats);
+}
+
+__STATIC_INLINE void nrfx_pwm_sequence_end_delay_update(nrfx_pwm_t const * const p_instance,
+                                                        uint8_t                  seq_id,
+                                                        uint32_t                 end_delay)
+{
+    nrf_pwm_seq_end_delay_set(p_instance->p_registers, seq_id, end_delay);
+}
+
+__STATIC_INLINE uint32_t nrfx_pwm_task_address_get(nrfx_pwm_t const * const p_instance,
+                                                   nrf_pwm_task_t           task)
+{
+    return nrf_pwm_task_address_get(p_instance->p_registers, task);
+}
+
+__STATIC_INLINE uint32_t nrfx_pwm_event_address_get(nrfx_pwm_t const * const p_instance,
+                                                    nrf_pwm_event_t          event)
+{
+    return nrf_pwm_event_address_get(p_instance->p_registers, event);
+}
+
+#endif // SUPPRESS_INLINE_IMPLEMENTATION
+
+
+void nrfx_pwm_0_irq_handler(void);
+void nrfx_pwm_1_irq_handler(void);
+void nrfx_pwm_2_irq_handler(void);
+void nrfx_pwm_3_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_PWM_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_qdec.h

@@ -1,186 +1,177 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_QDEC_H__
-#define NRFX_QDEC_H__
-
-#include <nrfx.h>
-#include <hal/nrf_qdec.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_qdec QDEC driver
- * @{
- * @ingroup nrf_qdec
- * @brief   Quadrature Decoder (QDEC) peripheral driver.
- */
-
-/**@brief QDEC configuration structure.*/
-typedef struct
-{
-    nrf_qdec_reportper_t reportper;          /**< Report period in samples. */
-    nrf_qdec_sampleper_t sampleper;          /**< Sampling period in microseconds. */
-    uint32_t             psela;              /**< Pin number for A input. */
-    uint32_t             pselb;              /**< Pin number for B input. */
-    uint32_t             pselled;            /**< Pin number for LED output. */
-    uint32_t             ledpre;             /**< Time (in microseconds) how long LED is switched on before sampling. */
-    nrf_qdec_ledpol_t    ledpol;             /**< Active LED polarity. */
-    bool                 dbfen;              /**< State of debouncing filter. */
-    bool                 sample_inten;       /**< Enabling sample ready interrupt. */
-    uint8_t              interrupt_priority; /**< QDEC interrupt priority. */
-} nrfx_qdec_config_t;
-
-/**@brief QDEC default configuration. */
-#define NRFX_QDEC_DEFAULT_CONFIG                                                \
-    {                                                                           \
-        .reportper          = (nrf_qdec_reportper_t)NRFX_QDEC_CONFIG_REPORTPER, \
-        .sampleper          = (nrf_qdec_sampleper_t)NRFX_QDEC_CONFIG_SAMPLEPER, \
-        .psela              = NRFX_QDEC_CONFIG_PIO_A,                           \
-        .pselb              = NRFX_QDEC_CONFIG_PIO_B,                           \
-        .pselled            = NRFX_QDEC_CONFIG_PIO_LED,                         \
-        .ledpre             = NRFX_QDEC_CONFIG_LEDPRE,                          \
-        .ledpol             = (nrf_qdec_ledpol_t)NRFX_QDEC_CONFIG_LEDPOL,       \
-        .interrupt_priority = NRFX_QDEC_CONFIG_IRQ_PRIORITY,                    \
-        .dbfen              = NRFX_QDEC_CONFIG_DBFEN,                           \
-        .sample_inten       = NRFX_QDEC_CONFIG_SAMPLE_INTEN                     \
-    }
-
-/**@brief QDEC sample event data.*/
-typedef struct
-{
-    int8_t value; /**< Sample value. */
-} nrfx_qdec_sample_data_evt_t;
-
-/**@brief QDEC report event data.*/
-typedef struct
-{
-    int16_t acc;     /**< Accumulated transitions. */
-    uint16_t accdbl;  /**< Accumulated double transitions. */
-} nrfx_qdec_report_data_evt_t;
-
-/**@brief QDEC event handler structure. */
-typedef struct
-{
-    nrf_qdec_event_t  type;
-    union
-    {
-        nrfx_qdec_sample_data_evt_t sample; /**< Sample event data. */
-        nrfx_qdec_report_data_evt_t report; /**< Report event data. */
-    } data;
-} nrfx_qdec_event_t;
-
-/**@brief QDEC event handler.
- * @param[in] event  QDEC event structure.
- */
-typedef void (*nrfx_qdec_event_handler_t)(nrfx_qdec_event_t event);
-
-/**@brief Function for initializing QDEC.
- *
- * @param[in] p_config      Pointer to the structure with initial configuration.
- * @param[in] event_handler Event handler provided by the user.
- *                          Must not be NULL.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If QDEC was already initialized.
- */
-nrfx_err_t nrfx_qdec_init(nrfx_qdec_config_t const * p_config,
-                          nrfx_qdec_event_handler_t  event_handler);
-
-/**@brief Function for uninitializing QDEC.
- * @note  Function asserts if module is uninitialized.
- */
-void nrfx_qdec_uninit(void);
-
-/**@brief Function for enabling QDEC.
- * @note  Function asserts if module is uninitialized or enabled.
- */
-void nrfx_qdec_enable(void);
-
-/**@brief Function for disabling QDEC.
- * @note  Function asserts if module is uninitialized or disabled.
- */
-void nrfx_qdec_disable(void);
-
-/**@brief Function for reading accumulated transitions QDEC.
- * @note  Function asserts if module is not enabled.
- * @note  Accumulators are cleared after reading.
- *
- * @param[out] p_acc      Pointer to store accumulated transitions.
- * @param[out] p_accdbl   Pointer to store accumulated double transitions.
- */
-void nrfx_qdec_accumulators_read(int16_t * p_acc, int16_t * p_accdbl);
-
-/**
- * @brief Function for returning the address of a specific QDEC task.
- *
- * @param   task    QDEC task.
- *
- * @return  Task address.
- */
-__STATIC_INLINE uint32_t nrfx_qdec_task_address_get(nrf_qdec_task_t task)
-{
-    return (uint32_t)nrf_qdec_task_address_get(task);
-}
-
-/**
- * @brief Function for returning the address of a specific QDEC event.
- *
- * @param   event   QDEC event.
- *
- * @return  Event address.
- */
-__STATIC_INLINE uint32_t nrfx_qdec_event_address_get(nrf_qdec_event_t event)
-{
-    return (uint32_t)nrf_qdec_event_address_get(event);
-}
-
-
-void nrfx_qdec_irq_handler(void);
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_QDEC_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_QDEC_H__
+#define NRFX_QDEC_H__
+
+#include <nrfx.h>
+#include <hal/nrf_qdec.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_qdec QDEC driver
+ * @{
+ * @ingroup nrf_qdec
+ * @brief   Quadrature Decoder (QDEC) peripheral driver.
+ */
+
+/**@brief QDEC configuration structure.*/
+typedef struct
+{
+    nrf_qdec_reportper_t reportper;          /**< Report period in samples. */
+    nrf_qdec_sampleper_t sampleper;          /**< Sampling period in microseconds. */
+    uint32_t             psela;              /**< Pin number for A input. */
+    uint32_t             pselb;              /**< Pin number for B input. */
+    uint32_t             pselled;            /**< Pin number for LED output. */
+    uint32_t             ledpre;             /**< Time (in microseconds) how long LED is switched on before sampling. */
+    nrf_qdec_ledpol_t    ledpol;             /**< Active LED polarity. */
+    bool                 dbfen;              /**< State of debouncing filter. */
+    bool                 sample_inten;       /**< Enabling sample ready interrupt. */
+    uint8_t              interrupt_priority; /**< QDEC interrupt priority. */
+} nrfx_qdec_config_t;
+
+/**@brief QDEC default configuration. */
+#define NRFX_QDEC_DEFAULT_CONFIG                                                \
+    {                                                                           \
+        .reportper          = (nrf_qdec_reportper_t)NRFX_QDEC_CONFIG_REPORTPER, \
+        .sampleper          = (nrf_qdec_sampleper_t)NRFX_QDEC_CONFIG_SAMPLEPER, \
+        .psela              = NRFX_QDEC_CONFIG_PIO_A,                           \
+        .pselb              = NRFX_QDEC_CONFIG_PIO_B,                           \
+        .pselled            = NRFX_QDEC_CONFIG_PIO_LED,                         \
+        .ledpre             = NRFX_QDEC_CONFIG_LEDPRE,                          \
+        .ledpol             = (nrf_qdec_ledpol_t)NRFX_QDEC_CONFIG_LEDPOL,       \
+        .interrupt_priority = NRFX_QDEC_CONFIG_IRQ_PRIORITY,                    \
+        .dbfen              = NRFX_QDEC_CONFIG_DBFEN,                           \
+        .sample_inten       = NRFX_QDEC_CONFIG_SAMPLE_INTEN                     \
+    }
+
+/**@brief QDEC sample event data.*/
+typedef struct
+{
+    int8_t value; /**< Sample value. */
+} nrfx_qdec_sample_data_evt_t;
+
+/**@brief QDEC report event data.*/
+typedef struct
+{
+    int16_t acc;     /**< Accumulated transitions. */
+    uint16_t accdbl;  /**< Accumulated double transitions. */
+} nrfx_qdec_report_data_evt_t;
+
+/**@brief QDEC event handler structure. */
+typedef struct
+{
+    nrf_qdec_event_t  type;
+    union
+    {
+        nrfx_qdec_sample_data_evt_t sample; /**< Sample event data. */
+        nrfx_qdec_report_data_evt_t report; /**< Report event data. */
+    } data;
+} nrfx_qdec_event_t;
+
+/**@brief QDEC event handler.
+ * @param[in] event  QDEC event structure.
+ */
+typedef void (*nrfx_qdec_event_handler_t)(nrfx_qdec_event_t event);
+
+/**@brief Function for initializing QDEC.
+ *
+ * @param[in] p_config      Pointer to the structure with initial configuration.
+ * @param[in] event_handler Event handler provided by the user.
+ *                          Must not be NULL.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If QDEC was already initialized.
+ */
+nrfx_err_t nrfx_qdec_init(nrfx_qdec_config_t const * p_config,
+                          nrfx_qdec_event_handler_t  event_handler);
+
+/**@brief Function for uninitializing QDEC.
+ * @note  Function asserts if module is uninitialized.
+ */
+void nrfx_qdec_uninit(void);
+
+/**@brief Function for enabling QDEC.
+ * @note  Function asserts if module is uninitialized or enabled.
+ */
+void nrfx_qdec_enable(void);
+
+/**@brief Function for disabling QDEC.
+ * @note  Function asserts if module is uninitialized or disabled.
+ */
+void nrfx_qdec_disable(void);
+
+/**@brief Function for reading accumulated transitions QDEC.
+ * @note  Function asserts if module is not enabled.
+ * @note  Accumulators are cleared after reading.
+ *
+ * @param[out] p_acc      Pointer to store accumulated transitions.
+ * @param[out] p_accdbl   Pointer to store accumulated double transitions.
+ */
+void nrfx_qdec_accumulators_read(int16_t * p_acc, int16_t * p_accdbl);
+
+/**
+ * @brief Function for returning the address of a specific QDEC task.
+ *
+ * @param   task    QDEC task.
+ *
+ * @return  Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_qdec_task_address_get(nrf_qdec_task_t task)
+{
+    return (uint32_t)nrf_qdec_task_address_get(task);
+}
+
+/**
+ * @brief Function for returning the address of a specific QDEC event.
+ *
+ * @param   event   QDEC event.
+ *
+ * @return  Event address.
+ */
+__STATIC_INLINE uint32_t nrfx_qdec_event_address_get(nrf_qdec_event_t event)
+{
+    return (uint32_t)nrf_qdec_event_address_get(event);
+}
+
+
+void nrfx_qdec_irq_handler(void);
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_QDEC_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_qspi.h

@@ -1,297 +1,288 @@
-/**
- * Copyright (c) 2016 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_QSPI_H__
-#define NRFX_QSPI_H__
-
-#include <nrfx.h>
-#include <hal/nrf_qspi.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_qspi QSPI driver
- * @{
- * @ingroup nrf_qspi
- * @brief   Quad Serial Peripheral Interface (QSPI) peripheral driver.
- */
-
-/**
- * @brief QSPI driver instance configuration structure.
- */
-typedef struct
-{
-    uint32_t             xip_offset;   /**< Address offset into the external memory for Execute in Place operation. */
-    nrf_qspi_pins_t      pins;         /**< Pins configuration structure. */
-    nrf_qspi_prot_conf_t prot_if;      /**< Protocol layer interface configuration structure. */
-    nrf_qspi_phy_conf_t  phy_if;       /**< Physical layer interface configuration structure. */
-    uint8_t              irq_priority; /**< Interrupt priority. */
-} nrfx_qspi_config_t;
-
-/**
- * @brief QSPI instance default configuration.
- */
-#define NRFX_QSPI_DEFAULT_CONFIG                                        \
-{                                                                       \
-    .xip_offset  = NRFX_QSPI_CONFIG_XIP_OFFSET,                         \
-    .pins = {                                                           \
-       .sck_pin     = NRFX_QSPI_PIN_SCK,                                \
-       .csn_pin     = NRFX_QSPI_PIN_CSN,                                \
-       .io0_pin     = NRFX_QSPI_PIN_IO0,                                \
-       .io1_pin     = NRFX_QSPI_PIN_IO1,                                \
-       .io2_pin     = NRFX_QSPI_PIN_IO2,                                \
-       .io3_pin     = NRFX_QSPI_PIN_IO3,                                \
-    },                                                                  \
-    .irq_priority   = (uint8_t)NRFX_QSPI_CONFIG_IRQ_PRIORITY,           \
-    .prot_if = {                                                        \
-        .readoc     = (nrf_qspi_readoc_t)NRFX_QSPI_CONFIG_READOC,       \
-        .writeoc    = (nrf_qspi_writeoc_t)NRFX_QSPI_CONFIG_WRITEOC,     \
-        .addrmode   = (nrf_qspi_addrmode_t)NRFX_QSPI_CONFIG_ADDRMODE,   \
-        .dpmconfig  = false,                                            \
-    },                                                                  \
-    .phy_if = {                                                         \
-        .sck_freq   = (nrf_qspi_frequency_t)NRFX_QSPI_CONFIG_FREQUENCY, \
-        .sck_delay  = (uint8_t)NRFX_QSPI_CONFIG_SCK_DELAY,              \
-        .spi_mode   = (nrf_qspi_spi_mode_t)NRFX_QSPI_CONFIG_MODE,       \
-        .dpmen      = false                                             \
-    },                                                                  \
-}
-
-/**
- * @brief QSPI custom instruction helper with default configuration.
- */
-#define NRFX_QSPI_DEFAULT_CINSTR(opc, len) \
-{                                          \
-    .opcode    = (opc),                    \
-    .length    = (len),                    \
-    .io2_level = false,                    \
-    .io3_level = false,                    \
-    .wipwait   = false,                    \
-    .wren      = false                     \
-}
-
-/**
- * @brief QSPI master driver event types, passed to the handler routine provided
- *        during initialization.
- */
-typedef enum
-{
-    NRFX_QSPI_EVENT_DONE, /**< Transfer done. */
-} nrfx_qspi_evt_t;
-
-/**
- * @brief QSPI driver event handler type.
- */
-typedef void (*nrfx_qspi_handler_t)(nrfx_qspi_evt_t event, void * p_context);
-
-/**
- * @brief Function for initializing the QSPI driver instance.
- *
- * This function configures the peripheral and its interrupts and activates it. During the 
- * activation process, the internal clocks are started and the QSPI peripheral tries to read 
- * the status byte to read the busy bit. Reading the status byte is done in a simple poll and wait
- * mechanism.
- * If the busy bit is 1, this indicates issues with the external memory device. As a result,
- * @ref nrfx_qspi_init returns NRFX_ERROR_TIMEOUT.
- *
- * In case of issues:
- * - Check the connection.
- * - Make sure that the memory device does not perform other operations like erasing or writing.
- * - Check if there is a short circuit.
- *
- * @param[in] p_config   Pointer to the structure with initial configuration.
- * @param[in] handler    Event handler provided by the user. If NULL, transfers
- *                       will be performed in blocking mode.
- * @param[in] p_context  Pointer to context. Use in interrupt handler.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_TIMEOUT       If the peripheral cannot connect with external memory.
- * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
- * @retval NRFX_ERROR_INVALID_PARAM If the pin configuration was incorrect.
- */
-nrfx_err_t nrfx_qspi_init(nrfx_qspi_config_t const * p_config,
-                          nrfx_qspi_handler_t        handler,
-                          void *                     p_context);
-
-/**
- * @brief Function for uninitializing the QSPI driver instance.
- */
-void nrfx_qspi_uninit(void);
-
-/**
- * @brief Function for reading data from QSPI memory.
- *
- * Write, read, and erase operations check memory device busy state before starting the operation.
- * If the memory is busy, the resulting action depends on the mode in which the read operation is used:
- *  - blocking mode (without handler) - a delay occurs until the last operation still runs and
- *    until operation data is still being read.
- *  - interrupt mode (with handler) - event emission occurs after the last operation
- *    and reading of data are finished.
- *
- * @param[out] p_rx_buffer      Pointer to the receive buffer.
- * @param[in]  rx_buffer_length Size of the data to read.
- * @param[in]  src_address      Address in memory to read from.
- *
- * @retval NRFX_SUCCESS            If the operation was successful (blocking mode) or operation
- *                                 was commissioned (handler mode).
- * @retval NRFX_ERROR_BUSY         If the driver currently handles another operation.
- * @retval NRFX_ERROR_INVALID_ADDR If the provided buffer is not placed in the Data RAM region.
- */
-nrfx_err_t nrfx_qspi_read(void *   p_rx_buffer,
-                          size_t   rx_buffer_length,
-                          uint32_t src_address);
-
-/**
- * @brief Function for writing data to QSPI memory.
- *
- * Write, read, and erase operations check memory device busy state before starting the operation.
- * If the memory is busy, the resulting action depends on the mode in which the write operation is used:
- *  - blocking mode (without handler) - a delay occurs until the last operation still runs and
- *    until operation data is still being sent.
- *  - interrupt mode (with handler) - event emission occurs after the last operation
- *    and sending of operation data are finished.
- * To manually control operation execution in the memory device, use @ref nrfx_qspi_mem_busy_check
- * after executing the write function.
- * Remember that an incoming event signalizes only that data was sent to the memory device and the periheral
- * before the write operation checked if memory was busy.
- *
- * @param[in] p_tx_buffer      Pointer to the writing buffer.
- * @param[in] tx_buffer_length Size of the data to write.
- * @param[in] dst_address      Address in memory to write to.
- *
- * @retval NRFX_SUCCESS            If the operation was successful (blocking mode) or operation
- *                                 was commissioned (handler mode).
- * @retval NRFX_ERROR_BUSY         If the driver currently handles other operation.
- * @retval NRFX_ERROR_INVALID_ADDR If the provided buffer is not placed in the Data RAM region.
- */
-nrfx_err_t nrfx_qspi_write(void const * p_tx_buffer,
-                           size_t       tx_buffer_length,
-                           uint32_t     dst_address);
-
-/**
- * @brief Function for starting erasing of one memory block - 4KB, 64KB, or the whole chip.
- *
- * Write, read, and erase operations check memory device busy state before starting the operation.
- * If the memory is busy, the resulting action depends on the mode in which the erase operation is used:
- *  - blocking mode (without handler) - a delay occurs until the last operation still runs and
- *    until operation data is still being sent.
- *  - interrupt mode (with handler) - event emission occurs after the last operation
- *    and sending of operation data are finished.
- * To manually control operation execution in the memory device, use @ref nrfx_qspi_mem_busy_check
- * after executing the erase function.
- * Remember that an incoming event signalizes only that data was sent to the memory device and the periheral
- * before the erase operation checked if memory was busy.
- *
- * @param[in] length        Size of data to erase. See @ref nrf_qspi_erase_len_t.
- * @param[in] start_address Memory address to start erasing. If chip erase is performed, address
- *                          field is ommited.
- *
- * @retval NRFX_SUCCESS    If the operation was successful (blocking mode) or operation
- *                         was commissioned (handler mode).
- * @retval NRFX_ERROR_BUSY If the driver currently handles another operation.
- */
-nrfx_err_t nrfx_qspi_erase(nrf_qspi_erase_len_t length,
-                           uint32_t             start_address);
-
-/**
- * @brief Function for starting an erase operation of the whole chip.
- *
- * @retval NRFX_SUCCESS    If the operation was successful (blocking mode) or operation
- *                         was commissioned (handler mode).
- * @retval NRFX_ERROR_BUSY If the driver currently handles another operation.
- */
-nrfx_err_t nrfx_qspi_chip_erase(void);
-
-/**
- * @brief Function for getting the current driver status and status byte of memory device with
- *        testing WIP (write in progress) bit.
- *
- * @retval NRFX_SUCCESS    If the driver and memory are ready to handle a new operation.
- * @retval NRFX_ERROR_BUSY If the driver or memory currently handle another operation.
- */
-nrfx_err_t nrfx_qspi_mem_busy_check(void);
-
-/**
- * @brief Function for sending operation code, sending data, and receiving data from the memory device.
- *
- * Use this function to transfer configuration data to memory and to receive data from memory.
- * Pointers can be addresses from flash memory.
- * This function is a synchronous function and should be used only if necessary.
- *
- * @param[in]  p_config    Pointer to the structure with opcode and transfer configuration.
- * @param[in]  p_tx_buffer Pointer to the array with data to send. Can be NULL if only opcode is transmitted.
- * @param[out] p_rx_buffer Pointer to the array for data to receive. Can be NULL if there is nothing to receive.
- *
- * @retval NRFX_SUCCESS            If the operation was successful.
- * @retval NRFX_ERROR_TIMEOUT      If the external memory is busy or there are connection issues.
- * @retval NRFX_ERROR_BUSY         If the driver currently handles other operation.
- */
-nrfx_err_t nrfx_qspi_cinstr_xfer(nrf_qspi_cinstr_conf_t const * p_config,
-                                 void const *                   p_tx_buffer,
-                                 void *                         p_rx_buffer);
-/**
- * @brief Function for sending operation code and data to the memory device with simpler configuration.
- *
- * Use this function to transfer configuration data to memory and to receive data from memory.
- * This function is a synchronous function and should be used only if necessary.
- *
- * @param[in] opcode      Operation code. Sending first.
- * @param[in] length      Length of the data to send and opcode. See @ref nrf_qspi_cinstr_len_t.
- * @param[in] p_tx_buffer Pointer to input data array.
- *
- * @retval NRFX_SUCCESS            If the operation was successful.
- * @retval NRFX_ERROR_BUSY         If the driver currently handles another operation.
- */
-nrfx_err_t nrfx_qspi_cinstr_quick_send(uint8_t               opcode,
-                                       nrf_qspi_cinstr_len_t length,
-                                       void const *          p_tx_buffer);
-
-
-void nrfx_qspi_irq_handler(void);
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_QSPI_H__
+/*
+ * Copyright (c) 2016 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_QSPI_H__
+#define NRFX_QSPI_H__
+
+#include <nrfx.h>
+#include <hal/nrf_qspi.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_qspi QSPI driver
+ * @{
+ * @ingroup nrf_qspi
+ * @brief   Quad Serial Peripheral Interface (QSPI) peripheral driver.
+ */
+
+/**
+ * @brief QSPI driver instance configuration structure.
+ */
+typedef struct
+{
+    uint32_t             xip_offset;   /**< Address offset into the external memory for Execute in Place operation. */
+    nrf_qspi_pins_t      pins;         /**< Pins configuration structure. */
+    nrf_qspi_prot_conf_t prot_if;      /**< Protocol layer interface configuration structure. */
+    nrf_qspi_phy_conf_t  phy_if;       /**< Physical layer interface configuration structure. */
+    uint8_t              irq_priority; /**< Interrupt priority. */
+} nrfx_qspi_config_t;
+
+/**
+ * @brief QSPI instance default configuration.
+ */
+#define NRFX_QSPI_DEFAULT_CONFIG                                        \
+{                                                                       \
+    .xip_offset  = NRFX_QSPI_CONFIG_XIP_OFFSET,                         \
+    .pins = {                                                           \
+       .sck_pin     = NRFX_QSPI_PIN_SCK,                                \
+       .csn_pin     = NRFX_QSPI_PIN_CSN,                                \
+       .io0_pin     = NRFX_QSPI_PIN_IO0,                                \
+       .io1_pin     = NRFX_QSPI_PIN_IO1,                                \
+       .io2_pin     = NRFX_QSPI_PIN_IO2,                                \
+       .io3_pin     = NRFX_QSPI_PIN_IO3,                                \
+    },                                                                  \
+    .irq_priority   = (uint8_t)NRFX_QSPI_CONFIG_IRQ_PRIORITY,           \
+    .prot_if = {                                                        \
+        .readoc     = (nrf_qspi_readoc_t)NRFX_QSPI_CONFIG_READOC,       \
+        .writeoc    = (nrf_qspi_writeoc_t)NRFX_QSPI_CONFIG_WRITEOC,     \
+        .addrmode   = (nrf_qspi_addrmode_t)NRFX_QSPI_CONFIG_ADDRMODE,   \
+        .dpmconfig  = false,                                            \
+    },                                                                  \
+    .phy_if = {                                                         \
+        .sck_freq   = (nrf_qspi_frequency_t)NRFX_QSPI_CONFIG_FREQUENCY, \
+        .sck_delay  = (uint8_t)NRFX_QSPI_CONFIG_SCK_DELAY,              \
+        .spi_mode   = (nrf_qspi_spi_mode_t)NRFX_QSPI_CONFIG_MODE,       \
+        .dpmen      = false                                             \
+    },                                                                  \
+}
+
+/**
+ * @brief QSPI custom instruction helper with default configuration.
+ */
+#define NRFX_QSPI_DEFAULT_CINSTR(opc, len) \
+{                                          \
+    .opcode    = (opc),                    \
+    .length    = (len),                    \
+    .io2_level = false,                    \
+    .io3_level = false,                    \
+    .wipwait   = false,                    \
+    .wren      = false                     \
+}
+
+/**
+ * @brief QSPI master driver event types, passed to the handler routine provided
+ *        during initialization.
+ */
+typedef enum
+{
+    NRFX_QSPI_EVENT_DONE, /**< Transfer done. */
+} nrfx_qspi_evt_t;
+
+/**
+ * @brief QSPI driver event handler type.
+ */
+typedef void (*nrfx_qspi_handler_t)(nrfx_qspi_evt_t event, void * p_context);
+
+/**
+ * @brief Function for initializing the QSPI driver instance.
+ *
+ * This function configures the peripheral and its interrupts and activates it. During the 
+ * activation process, the internal clocks are started and the QSPI peripheral tries to read 
+ * the status byte to read the busy bit. Reading the status byte is done in a simple poll and wait
+ * mechanism.
+ * If the busy bit is 1, this indicates issues with the external memory device. As a result,
+ * @ref nrfx_qspi_init returns NRFX_ERROR_TIMEOUT.
+ *
+ * In case of issues:
+ * - Check the connection.
+ * - Make sure that the memory device does not perform other operations like erasing or writing.
+ * - Check if there is a short circuit.
+ *
+ * @param[in] p_config   Pointer to the structure with initial configuration.
+ * @param[in] handler    Event handler provided by the user. If NULL, transfers
+ *                       will be performed in blocking mode.
+ * @param[in] p_context  Pointer to context. Use in interrupt handler.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_TIMEOUT       If the peripheral cannot connect with external memory.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
+ * @retval NRFX_ERROR_INVALID_PARAM If the pin configuration was incorrect.
+ */
+nrfx_err_t nrfx_qspi_init(nrfx_qspi_config_t const * p_config,
+                          nrfx_qspi_handler_t        handler,
+                          void *                     p_context);
+
+/**
+ * @brief Function for uninitializing the QSPI driver instance.
+ */
+void nrfx_qspi_uninit(void);
+
+/**
+ * @brief Function for reading data from QSPI memory.
+ *
+ * Write, read, and erase operations check memory device busy state before starting the operation.
+ * If the memory is busy, the resulting action depends on the mode in which the read operation is used:
+ *  - blocking mode (without handler) - a delay occurs until the last operation still runs and
+ *    until operation data is still being read.
+ *  - interrupt mode (with handler) - event emission occurs after the last operation
+ *    and reading of data are finished.
+ *
+ * @param[out] p_rx_buffer      Pointer to the receive buffer.
+ * @param[in]  rx_buffer_length Size of the data to read.
+ * @param[in]  src_address      Address in memory to read from.
+ *
+ * @retval NRFX_SUCCESS            If the operation was successful (blocking mode) or operation
+ *                                 was commissioned (handler mode).
+ * @retval NRFX_ERROR_BUSY         If the driver currently handles another operation.
+ * @retval NRFX_ERROR_INVALID_ADDR If the provided buffer is not placed in the Data RAM region.
+ */
+nrfx_err_t nrfx_qspi_read(void *   p_rx_buffer,
+                          size_t   rx_buffer_length,
+                          uint32_t src_address);
+
+/**
+ * @brief Function for writing data to QSPI memory.
+ *
+ * Write, read, and erase operations check memory device busy state before starting the operation.
+ * If the memory is busy, the resulting action depends on the mode in which the write operation is used:
+ *  - blocking mode (without handler) - a delay occurs until the last operation still runs and
+ *    until operation data is still being sent.
+ *  - interrupt mode (with handler) - event emission occurs after the last operation
+ *    and sending of operation data are finished.
+ * To manually control operation execution in the memory device, use @ref nrfx_qspi_mem_busy_check
+ * after executing the write function.
+ * Remember that an incoming event signalizes only that data was sent to the memory device and the periheral
+ * before the write operation checked if memory was busy.
+ *
+ * @param[in] p_tx_buffer      Pointer to the writing buffer.
+ * @param[in] tx_buffer_length Size of the data to write.
+ * @param[in] dst_address      Address in memory to write to.
+ *
+ * @retval NRFX_SUCCESS            If the operation was successful (blocking mode) or operation
+ *                                 was commissioned (handler mode).
+ * @retval NRFX_ERROR_BUSY         If the driver currently handles other operation.
+ * @retval NRFX_ERROR_INVALID_ADDR If the provided buffer is not placed in the Data RAM region.
+ */
+nrfx_err_t nrfx_qspi_write(void const * p_tx_buffer,
+                           size_t       tx_buffer_length,
+                           uint32_t     dst_address);
+
+/**
+ * @brief Function for starting erasing of one memory block - 4KB, 64KB, or the whole chip.
+ *
+ * Write, read, and erase operations check memory device busy state before starting the operation.
+ * If the memory is busy, the resulting action depends on the mode in which the erase operation is used:
+ *  - blocking mode (without handler) - a delay occurs until the last operation still runs and
+ *    until operation data is still being sent.
+ *  - interrupt mode (with handler) - event emission occurs after the last operation
+ *    and sending of operation data are finished.
+ * To manually control operation execution in the memory device, use @ref nrfx_qspi_mem_busy_check
+ * after executing the erase function.
+ * Remember that an incoming event signalizes only that data was sent to the memory device and the periheral
+ * before the erase operation checked if memory was busy.
+ *
+ * @param[in] length        Size of data to erase. See @ref nrf_qspi_erase_len_t.
+ * @param[in] start_address Memory address to start erasing. If chip erase is performed, address
+ *                          field is ommited.
+ *
+ * @retval NRFX_SUCCESS    If the operation was successful (blocking mode) or operation
+ *                         was commissioned (handler mode).
+ * @retval NRFX_ERROR_BUSY If the driver currently handles another operation.
+ */
+nrfx_err_t nrfx_qspi_erase(nrf_qspi_erase_len_t length,
+                           uint32_t             start_address);
+
+/**
+ * @brief Function for starting an erase operation of the whole chip.
+ *
+ * @retval NRFX_SUCCESS    If the operation was successful (blocking mode) or operation
+ *                         was commissioned (handler mode).
+ * @retval NRFX_ERROR_BUSY If the driver currently handles another operation.
+ */
+nrfx_err_t nrfx_qspi_chip_erase(void);
+
+/**
+ * @brief Function for getting the current driver status and status byte of memory device with
+ *        testing WIP (write in progress) bit.
+ *
+ * @retval NRFX_SUCCESS    If the driver and memory are ready to handle a new operation.
+ * @retval NRFX_ERROR_BUSY If the driver or memory currently handle another operation.
+ */
+nrfx_err_t nrfx_qspi_mem_busy_check(void);
+
+/**
+ * @brief Function for sending operation code, sending data, and receiving data from the memory device.
+ *
+ * Use this function to transfer configuration data to memory and to receive data from memory.
+ * Pointers can be addresses from flash memory.
+ * This function is a synchronous function and should be used only if necessary.
+ *
+ * @param[in]  p_config    Pointer to the structure with opcode and transfer configuration.
+ * @param[in]  p_tx_buffer Pointer to the array with data to send. Can be NULL if only opcode is transmitted.
+ * @param[out] p_rx_buffer Pointer to the array for data to receive. Can be NULL if there is nothing to receive.
+ *
+ * @retval NRFX_SUCCESS            If the operation was successful.
+ * @retval NRFX_ERROR_TIMEOUT      If the external memory is busy or there are connection issues.
+ * @retval NRFX_ERROR_BUSY         If the driver currently handles other operation.
+ */
+nrfx_err_t nrfx_qspi_cinstr_xfer(nrf_qspi_cinstr_conf_t const * p_config,
+                                 void const *                   p_tx_buffer,
+                                 void *                         p_rx_buffer);
+/**
+ * @brief Function for sending operation code and data to the memory device with simpler configuration.
+ *
+ * Use this function to transfer configuration data to memory and to receive data from memory.
+ * This function is a synchronous function and should be used only if necessary.
+ *
+ * @param[in] opcode      Operation code. Sending first.
+ * @param[in] length      Length of the data to send and opcode. See @ref nrf_qspi_cinstr_len_t.
+ * @param[in] p_tx_buffer Pointer to input data array.
+ *
+ * @retval NRFX_SUCCESS            If the operation was successful.
+ * @retval NRFX_ERROR_BUSY         If the driver currently handles another operation.
+ */
+nrfx_err_t nrfx_qspi_cinstr_quick_send(uint8_t               opcode,
+                                       nrf_qspi_cinstr_len_t length,
+                                       void const *          p_tx_buffer);
+
+
+void nrfx_qspi_irq_handler(void);
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_QSPI_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_rng.h

@@ -1,126 +1,117 @@
-/**
- * Copyright (c) 2016 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-#ifndef NRFX_RNG_H__
-#define NRFX_RNG_H__
-
-#include <nrfx.h>
-#include <hal/nrf_rng.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_rng RNG driver
- * @{
- * @ingroup nrf_rng
- * @brief   Random Number Generator (RNG) peripheral driver.
- */
-
-/**
- * @brief Struct for RNG configuration.
- */
-typedef struct
-{
-    bool     error_correction : 1;  /**< Error correction flag. */
-    uint8_t  interrupt_priority;    /**< interrupt priority */
-} nrfx_rng_config_t;
-
-/**
- * @brief RNG default configuration.
- *        Basic usage:
- *        @code
- *            nrfx_rng_config_t config = NRFX_RNG_DEFAULT_CONFIG;
- *            if (nrfx_rng_init(&config, handler)
- *            { ...
- *        @endcode
- */
-#define NRFX_RNG_DEFAULT_CONFIG                                 \
-    {                                                           \
-        .error_correction   = NRFX_RNG_CONFIG_ERROR_CORRECTION, \
-        .interrupt_priority = NRFX_RNG_CONFIG_IRQ_PRIORITY,     \
-    }
-
-/**
- * @brief RNG driver event handler type.
- */
-typedef void (* nrfx_rng_evt_handler_t)(uint8_t rng_data);
-
-/**
- * @brief Function for initializing the nrfx_rng module.
- *
- * @param[in]  p_config Pointer to the structure with initial configuration.
- * @param[in]  handler  Event handler provided by the user. Must not be NULL.
- *
- * @retval  NRFX_SUCCESS                   Driver was successfully initialized.
- * @retval  NRFX_ERROR_ALREADY_INITIALIZED Driver was already initialized.
- */
-nrfx_err_t nrfx_rng_init(nrfx_rng_config_t const * p_config, nrfx_rng_evt_handler_t handler);
-
-/**
- * @brief Function for starting the random value generation.
- *
- * Function enables interrupts in perihperal and start them.
- */
-void nrfx_rng_start(void);
-
-/**
- * @brief Function for stoping the random value generation.
- *
- * Function disables interrupts in perihperal and stop generation of new random values.
- */
-void nrfx_rng_stop(void);
-
-/**
- * @brief Function for uninitializing the nrfx_rng module.
- */
-void nrfx_rng_uninit(void);
-
-
-void nrfx_rng_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_RNG_H__
+/*
+ * Copyright (c) 2016 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+#ifndef NRFX_RNG_H__
+#define NRFX_RNG_H__
+
+#include <nrfx.h>
+#include <hal/nrf_rng.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_rng RNG driver
+ * @{
+ * @ingroup nrf_rng
+ * @brief   Random Number Generator (RNG) peripheral driver.
+ */
+
+/**
+ * @brief Struct for RNG configuration.
+ */
+typedef struct
+{
+    bool     error_correction : 1;  /**< Error correction flag. */
+    uint8_t  interrupt_priority;    /**< interrupt priority */
+} nrfx_rng_config_t;
+
+/**
+ * @brief RNG default configuration.
+ *        Basic usage:
+ *        @code
+ *            nrfx_rng_config_t config = NRFX_RNG_DEFAULT_CONFIG;
+ *            if (nrfx_rng_init(&config, handler)
+ *            { ...
+ *        @endcode
+ */
+#define NRFX_RNG_DEFAULT_CONFIG                                 \
+    {                                                           \
+        .error_correction   = NRFX_RNG_CONFIG_ERROR_CORRECTION, \
+        .interrupt_priority = NRFX_RNG_CONFIG_IRQ_PRIORITY,     \
+    }
+
+/**
+ * @brief RNG driver event handler type.
+ */
+typedef void (* nrfx_rng_evt_handler_t)(uint8_t rng_data);
+
+/**
+ * @brief Function for initializing the nrfx_rng module.
+ *
+ * @param[in]  p_config Pointer to the structure with initial configuration.
+ * @param[in]  handler  Event handler provided by the user. Must not be NULL.
+ *
+ * @retval  NRFX_SUCCESS                   Driver was successfully initialized.
+ * @retval  NRFX_ERROR_ALREADY_INITIALIZED Driver was already initialized.
+ */
+nrfx_err_t nrfx_rng_init(nrfx_rng_config_t const * p_config, nrfx_rng_evt_handler_t handler);
+
+/**
+ * @brief Function for starting the random value generation.
+ *
+ * Function enables interrupts in perihperal and start them.
+ */
+void nrfx_rng_start(void);
+
+/**
+ * @brief Function for stoping the random value generation.
+ *
+ * Function disables interrupts in perihperal and stop generation of new random values.
+ */
+void nrfx_rng_stop(void);
+
+/**
+ * @brief Function for uninitializing the nrfx_rng module.
+ */
+void nrfx_rng_uninit(void);
+
+
+void nrfx_rng_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_RNG_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_rtc.h

@@ -1,369 +1,360 @@
-/**
- * Copyright (c) 2014 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_RTC_H__
-#define NRFX_RTC_H__
-
-#include <nrfx.h>
-#include <hal/nrf_rtc.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_rtc RTC driver
- * @{
- * @ingroup nrf_rtc
- * @brief   Real Timer Counter (RTC) peripheral driver.
- */
-
-/**@brief Macro to convert microseconds into ticks. */
-#define NRFX_RTC_US_TO_TICKS(us,freq) (((us) * (freq)) / 1000000U)
-
-/**@brief RTC driver interrupt types. */
-typedef enum
-{
-    NRFX_RTC_INT_COMPARE0 = 0, /**< Interrupt from COMPARE0 event. */
-    NRFX_RTC_INT_COMPARE1 = 1, /**< Interrupt from COMPARE1 event. */
-    NRFX_RTC_INT_COMPARE2 = 2, /**< Interrupt from COMPARE2 event. */
-    NRFX_RTC_INT_COMPARE3 = 3, /**< Interrupt from COMPARE3 event. */
-    NRFX_RTC_INT_TICK     = 4, /**< Interrupt from TICK event. */
-    NRFX_RTC_INT_OVERFLOW = 5  /**< Interrupt from OVERFLOW event. */
-} nrfx_rtc_int_type_t;
-
-/**@brief RTC driver instance  structure. */
-typedef struct
-{
-    NRF_RTC_Type  * p_reg;            /**< Pointer to instance register set. */
-    IRQn_Type       irq;              /**< Instance IRQ ID. */
-    uint8_t         instance_id;      /**< Instance index. */
-    uint8_t         cc_channel_count; /**< Number of capture/compare channels. */
-} nrfx_rtc_t;
-
-/**@brief Macro for creating RTC driver instance.*/
-#define NRFX_RTC_INSTANCE(id)                                   \
-{                                                               \
-    .p_reg            = NRFX_CONCAT_2(NRF_RTC, id),             \
-    .irq              = NRFX_CONCAT_3(RTC, id, _IRQn),          \
-    .instance_id      = NRFX_CONCAT_3(NRFX_RTC, id, _INST_IDX), \
-    .cc_channel_count = NRF_RTC_CC_CHANNEL_COUNT(id),           \
-}
-
-enum {
-#if NRFX_CHECK(NRFX_RTC0_ENABLED)
-    NRFX_RTC0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_RTC1_ENABLED)
-    NRFX_RTC1_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_RTC2_ENABLED)
-    NRFX_RTC2_INST_IDX,
-#endif
-    NRFX_RTC_ENABLED_COUNT
-};
-
-/**@brief RTC driver instance configuration structure. */
-typedef struct
-{
-    uint16_t prescaler;          /**< Prescaler. */
-    uint8_t  interrupt_priority; /**< Interrupt priority. */
-    uint8_t  tick_latency;       /**< Maximum length of interrupt handler in ticks (max 7.7 ms). */
-    bool     reliable;           /**< Reliable mode flag. */
-} nrfx_rtc_config_t;
-
-/**@brief RTC instance default configuration. */
-#define NRFX_RTC_DEFAULT_CONFIG                                                     \
-{                                                                                   \
-    .prescaler          = RTC_FREQ_TO_PRESCALER(NRFX_RTC_DEFAULT_CONFIG_FREQUENCY), \
-    .interrupt_priority = NRFX_RTC_DEFAULT_CONFIG_IRQ_PRIORITY,                     \
-    .reliable           = NRFX_RTC_DEFAULT_CONFIG_RELIABLE,                         \
-    .tick_latency       = NRFX_RTC_US_TO_TICKS(NRFX_RTC_MAXIMUM_LATENCY_US,         \
-                                               NRFX_RTC_DEFAULT_CONFIG_FREQUENCY),  \
-}
-
-/**@brief RTC driver instance handler type. */
-typedef void (*nrfx_rtc_handler_t)(nrfx_rtc_int_type_t int_type);
-
-/**@brief Function for initializing the RTC driver instance.
- *
- * After initialization, the instance is in power off state.
- *
- * @param[in]  p_instance   Pointer to the driver instance structure.
- * @param[in]  p_config     Pointer to the structure with initial configuration.
- * @param[in]  handler      Event handler provided by the user.
- *                          Must not be NULL.
- *
- * @retval     NRFX_SUCCESS             If successfully initialized.
- * @retval     NRFX_ERROR_INVALID_STATE If the instance is already initialized.
- */
-nrfx_err_t nrfx_rtc_init(nrfx_rtc_t const * const  p_instance,
-                         nrfx_rtc_config_t const * p_config,
-                         nrfx_rtc_handler_t        handler);
-
-/**@brief Function for uninitializing the RTC driver instance.
- *
- * After uninitialization, the instance is in idle state. The hardware should return to the state
- *       before initialization. The function asserts if the instance is in idle state.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- */
-void nrfx_rtc_uninit(nrfx_rtc_t const * const p_instance);
-
-/**@brief Function for enabling the RTC driver instance.
- *
- * @note Function asserts if instance is enabled.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- */
-void nrfx_rtc_enable(nrfx_rtc_t const * const p_instance);
-
-/**@brief Function for disabling the RTC driver instance.
- *
- * @note Function asserts if instance is disabled.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- */
-void nrfx_rtc_disable(nrfx_rtc_t const * const p_instance);
-
-/**@brief Function for setting a compare channel.
- *
- * The function asserts if the instance is not initialized or if the channel parameter is
- *       wrong. The function powers on the instance if the instance was in power off state.
- *
- * The driver is not entering a critical section when configuring RTC, which means that it can be
- *       preempted for a certain amount of time. When the driver was preempted and the value to be set
- *       is short in time, there is a risk that the driver sets a compare value that is
- *       behind. If RTCn_CONFIG_RELIABLE is 1 for the given instance, the Reliable mode handles that case.
- *       However, to detect if the requested value is behind, this mode makes the following assumptions:
- *        -  The maximum preemption time in ticks (8 - bit value) is known and is less than 7.7 ms
- *         (for prescaler = 0, RTC frequency 32 kHz).
- *        -  The requested absolute compare value is not bigger than (0x00FFFFFF) - tick_latency. It is
- *         the user's responsibility to ensure that.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- * @param[in]  channel            One of the instance's channels.
- * @param[in]  val                Absolute value to be set in the compare register.
- * @param[in]  enable_irq         True to enable the interrupt. False to disable the interrupt.
- *
- * @retval     NRFX_SUCCESS         If the procedure was successful.
- * @retval     NRFX_ERROR_TIMEOUT   If the compare was not set because the request value is behind the current counter
- *                                  value. This error can only be reported if RTCn_CONFIG_RELIABLE = 1.
- */
-nrfx_err_t nrfx_rtc_cc_set(nrfx_rtc_t const * const p_instance,
-                           uint32_t                 channel,
-                           uint32_t                 val,
-                           bool                     enable_irq);
-
-/**@brief Function for disabling a channel.
- *
- * This function disables channel events and channel interrupts. The function asserts if the instance is not
- *       initialized or if the channel parameter is wrong.
- *
- * @param[in]  p_instance          Pointer to the driver instance structure.
- * @param[in]  channel             One of the instance's channels.
- *
- * @retval     NRFX_SUCCESS         If the procedure was successful.
- * @retval     NRFX_ERROR_TIMEOUT   If an interrupt was pending on the requested channel.
- */
-nrfx_err_t nrfx_rtc_cc_disable(nrfx_rtc_t const * const p_instance, uint32_t channel);
-
-/**@brief Function for enabling tick.
- *
- * This function enables the tick event and optionally the interrupt. The function asserts if the instance is not
- *       powered on.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- * @param[in]  enable_irq         True to enable the interrupt. False to disable the interrupt.
- */
-void nrfx_rtc_tick_enable(nrfx_rtc_t const * const p_instance, bool enable_irq);
-
-/**@brief Function for disabling tick.
- *
- * This function disables the tick event and interrupt.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- */
-void nrfx_rtc_tick_disable(nrfx_rtc_t const * const p_instance);
-
-/**@brief Function for enabling overflow.
- *
- * This function enables the overflow event and optionally the interrupt. The function asserts if the instance is
- *       not powered on.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- * @param[in]  enable_irq         True to enable the interrupt. False to disable the interrupt.
- */
-void nrfx_rtc_overflow_enable(nrfx_rtc_t const * const p_instance, bool enable_irq);
-
-/**@brief Function for disabling overflow.
- *
- * This function disables the overflow event and interrupt.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- */
-void nrfx_rtc_overflow_disable(nrfx_rtc_t const * const p_instance);
-
-/**@brief Function for getting the maximum relative ticks value that can be set in the compare channel.
- *
- * When a stack (for example SoftDevice) is used and it occupies high priority interrupts,
- * the application code can be interrupted at any moment for a certain period of time.
- * If Reliable mode is enabled, the provided maximum latency is taken into account
- * and the return value is smaller than the RTC counter resolution.
- * If Reliable mode is disabled, the return value equals the counter resolution.
- *
- * @param[in]  p_instance  Pointer to the driver instance structure.
- *
- * @retval     ticks         Maximum ticks value.
- */
-uint32_t nrfx_rtc_max_ticks_get(nrfx_rtc_t const * const p_instance);
-
-/**@brief Function for disabling all instance interrupts.
-  *
- * @param[in]  p_instance          Pointer to the driver instance structure.
- * @param[in]  p_mask              Pointer to the location where the mask is filled.
- */
-__STATIC_INLINE void nrfx_rtc_int_disable(nrfx_rtc_t const * const p_instance,
-                                          uint32_t               * p_mask);
-
-/**@brief Function for enabling instance interrupts.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- * @param[in]  mask               Mask of interrupts to enable.
- */
-__STATIC_INLINE void nrfx_rtc_int_enable(nrfx_rtc_t const * const p_instance, uint32_t mask);
-
-/**@brief Function for retrieving the current counter value.
- *
- * This function asserts if the instance is not powered on or if p_val is NULL.
- *
- * @param[in]  p_instance    Pointer to the driver instance structure.
- *
- * @retval     value         Counter value.
- */
-__STATIC_INLINE uint32_t nrfx_rtc_counter_get(nrfx_rtc_t const * const p_instance);
-
-/**@brief Function for clearing the counter value.
- *
- * This function asserts if the instance is not powered on.
- *
- * @param[in]  p_instance         Pointer to the driver instance structure.
- */
-__STATIC_INLINE void nrfx_rtc_counter_clear(nrfx_rtc_t const * const p_instance);
-
-/**@brief Function for returning a requested task address for the RTC driver instance.
- *
- * This function asserts if the output pointer is NULL. The task address can be used by the PPI module.
- *
- * @param[in]  p_instance         Pointer to the instance.
- * @param[in]  task                One of the peripheral tasks.
- *
- * @retval     Address of task register.
- */
-__STATIC_INLINE uint32_t nrfx_rtc_task_address_get(nrfx_rtc_t const * const p_instance,
-                                                   nrf_rtc_task_t           task);
-
-/**@brief Function for returning a requested event address for the RTC driver instance.
- *
- * This function asserts if the output pointer is NULL. The event address can be used by the PPI module.
- *
- * @param[in]  p_instance          Pointer to the driver instance structure.
- * @param[in]  event               One of the peripheral events.
- *
- * @retval     Address of event register.
- */
-__STATIC_INLINE uint32_t nrfx_rtc_event_address_get(nrfx_rtc_t const * const p_instance,
-                                                    nrf_rtc_event_t          event);
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-
-__STATIC_INLINE void nrfx_rtc_int_disable(nrfx_rtc_t const * const p_instance,
-                                          uint32_t               * p_mask)
-{
-    *p_mask = nrf_rtc_int_get(p_instance->p_reg);
-    nrf_rtc_int_disable(p_instance->p_reg, NRF_RTC_INT_TICK_MASK |
-                                           NRF_RTC_INT_OVERFLOW_MASK |
-                                           NRF_RTC_INT_COMPARE0_MASK |
-                                           NRF_RTC_INT_COMPARE1_MASK |
-                                           NRF_RTC_INT_COMPARE2_MASK |
-                                           NRF_RTC_INT_COMPARE3_MASK);
-}
-
-__STATIC_INLINE void nrfx_rtc_int_enable(nrfx_rtc_t const * const p_instance, uint32_t mask)
-{
-    nrf_rtc_int_enable(p_instance->p_reg, mask);
-}
-
-__STATIC_INLINE uint32_t nrfx_rtc_counter_get(nrfx_rtc_t const * const p_instance)
-{
-    return nrf_rtc_counter_get(p_instance->p_reg);
-}
-
-__STATIC_INLINE void nrfx_rtc_counter_clear(nrfx_rtc_t const * const p_instance)
-{
-    nrf_rtc_task_trigger(p_instance->p_reg, NRF_RTC_TASK_CLEAR);
-}
-
-__STATIC_INLINE uint32_t nrfx_rtc_task_address_get(nrfx_rtc_t const * const p_instance,
-                                                   nrf_rtc_task_t           task)
-{
-    return nrf_rtc_task_address_get(p_instance->p_reg, task);
-}
-
-__STATIC_INLINE uint32_t nrfx_rtc_event_address_get(nrfx_rtc_t const * const p_instance,
-                                                    nrf_rtc_event_t          event)
-{
-    return nrf_rtc_event_address_get(p_instance->p_reg, event);
-}
-#endif // SUPPRESS_INLINE_IMPLEMENTATION
-
-
-void nrfx_rtc_0_irq_handler(void);
-void nrfx_rtc_1_irq_handler(void);
-void nrfx_rtc_2_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_RTC_H__
+/*
+ * Copyright (c) 2014 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_RTC_H__
+#define NRFX_RTC_H__
+
+#include <nrfx.h>
+#include <hal/nrf_rtc.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_rtc RTC driver
+ * @{
+ * @ingroup nrf_rtc
+ * @brief   Real Timer Counter (RTC) peripheral driver.
+ */
+
+/**@brief Macro to convert microseconds into ticks. */
+#define NRFX_RTC_US_TO_TICKS(us,freq) (((us) * (freq)) / 1000000U)
+
+/**@brief RTC driver interrupt types. */
+typedef enum
+{
+    NRFX_RTC_INT_COMPARE0 = 0, /**< Interrupt from COMPARE0 event. */
+    NRFX_RTC_INT_COMPARE1 = 1, /**< Interrupt from COMPARE1 event. */
+    NRFX_RTC_INT_COMPARE2 = 2, /**< Interrupt from COMPARE2 event. */
+    NRFX_RTC_INT_COMPARE3 = 3, /**< Interrupt from COMPARE3 event. */
+    NRFX_RTC_INT_TICK     = 4, /**< Interrupt from TICK event. */
+    NRFX_RTC_INT_OVERFLOW = 5  /**< Interrupt from OVERFLOW event. */
+} nrfx_rtc_int_type_t;
+
+/**@brief RTC driver instance  structure. */
+typedef struct
+{
+    NRF_RTC_Type  * p_reg;            /**< Pointer to instance register set. */
+    IRQn_Type       irq;              /**< Instance IRQ ID. */
+    uint8_t         instance_id;      /**< Instance index. */
+    uint8_t         cc_channel_count; /**< Number of capture/compare channels. */
+} nrfx_rtc_t;
+
+/**@brief Macro for creating RTC driver instance.*/
+#define NRFX_RTC_INSTANCE(id)                                   \
+{                                                               \
+    .p_reg            = NRFX_CONCAT_2(NRF_RTC, id),             \
+    .irq              = NRFX_CONCAT_3(RTC, id, _IRQn),          \
+    .instance_id      = NRFX_CONCAT_3(NRFX_RTC, id, _INST_IDX), \
+    .cc_channel_count = NRF_RTC_CC_CHANNEL_COUNT(id),           \
+}
+
+enum {
+#if NRFX_CHECK(NRFX_RTC0_ENABLED)
+    NRFX_RTC0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_RTC1_ENABLED)
+    NRFX_RTC1_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_RTC2_ENABLED)
+    NRFX_RTC2_INST_IDX,
+#endif
+    NRFX_RTC_ENABLED_COUNT
+};
+
+/**@brief RTC driver instance configuration structure. */
+typedef struct
+{
+    uint16_t prescaler;          /**< Prescaler. */
+    uint8_t  interrupt_priority; /**< Interrupt priority. */
+    uint8_t  tick_latency;       /**< Maximum length of interrupt handler in ticks (max 7.7 ms). */
+    bool     reliable;           /**< Reliable mode flag. */
+} nrfx_rtc_config_t;
+
+/**@brief RTC instance default configuration. */
+#define NRFX_RTC_DEFAULT_CONFIG                                                     \
+{                                                                                   \
+    .prescaler          = RTC_FREQ_TO_PRESCALER(NRFX_RTC_DEFAULT_CONFIG_FREQUENCY), \
+    .interrupt_priority = NRFX_RTC_DEFAULT_CONFIG_IRQ_PRIORITY,                     \
+    .reliable           = NRFX_RTC_DEFAULT_CONFIG_RELIABLE,                         \
+    .tick_latency       = NRFX_RTC_US_TO_TICKS(NRFX_RTC_MAXIMUM_LATENCY_US,         \
+                                               NRFX_RTC_DEFAULT_CONFIG_FREQUENCY),  \
+}
+
+/**@brief RTC driver instance handler type. */
+typedef void (*nrfx_rtc_handler_t)(nrfx_rtc_int_type_t int_type);
+
+/**@brief Function for initializing the RTC driver instance.
+ *
+ * After initialization, the instance is in power off state.
+ *
+ * @param[in]  p_instance   Pointer to the driver instance structure.
+ * @param[in]  p_config     Pointer to the structure with initial configuration.
+ * @param[in]  handler      Event handler provided by the user.
+ *                          Must not be NULL.
+ *
+ * @retval     NRFX_SUCCESS             If successfully initialized.
+ * @retval     NRFX_ERROR_INVALID_STATE If the instance is already initialized.
+ */
+nrfx_err_t nrfx_rtc_init(nrfx_rtc_t const * const  p_instance,
+                         nrfx_rtc_config_t const * p_config,
+                         nrfx_rtc_handler_t        handler);
+
+/**@brief Function for uninitializing the RTC driver instance.
+ *
+ * After uninitialization, the instance is in idle state. The hardware should return to the state
+ *       before initialization. The function asserts if the instance is in idle state.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ */
+void nrfx_rtc_uninit(nrfx_rtc_t const * const p_instance);
+
+/**@brief Function for enabling the RTC driver instance.
+ *
+ * @note Function asserts if instance is enabled.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ */
+void nrfx_rtc_enable(nrfx_rtc_t const * const p_instance);
+
+/**@brief Function for disabling the RTC driver instance.
+ *
+ * @note Function asserts if instance is disabled.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ */
+void nrfx_rtc_disable(nrfx_rtc_t const * const p_instance);
+
+/**@brief Function for setting a compare channel.
+ *
+ * The function asserts if the instance is not initialized or if the channel parameter is
+ *       wrong. The function powers on the instance if the instance was in power off state.
+ *
+ * The driver is not entering a critical section when configuring RTC, which means that it can be
+ *       preempted for a certain amount of time. When the driver was preempted and the value to be set
+ *       is short in time, there is a risk that the driver sets a compare value that is
+ *       behind. If RTCn_CONFIG_RELIABLE is 1 for the given instance, the Reliable mode handles that case.
+ *       However, to detect if the requested value is behind, this mode makes the following assumptions:
+ *        -  The maximum preemption time in ticks (8 - bit value) is known and is less than 7.7 ms
+ *         (for prescaler = 0, RTC frequency 32 kHz).
+ *        -  The requested absolute compare value is not bigger than (0x00FFFFFF) - tick_latency. It is
+ *         the user's responsibility to ensure that.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ * @param[in]  channel            One of the instance's channels.
+ * @param[in]  val                Absolute value to be set in the compare register.
+ * @param[in]  enable_irq         True to enable the interrupt. False to disable the interrupt.
+ *
+ * @retval     NRFX_SUCCESS         If the procedure was successful.
+ * @retval     NRFX_ERROR_TIMEOUT   If the compare was not set because the request value is behind the current counter
+ *                                  value. This error can only be reported if RTCn_CONFIG_RELIABLE = 1.
+ */
+nrfx_err_t nrfx_rtc_cc_set(nrfx_rtc_t const * const p_instance,
+                           uint32_t                 channel,
+                           uint32_t                 val,
+                           bool                     enable_irq);
+
+/**@brief Function for disabling a channel.
+ *
+ * This function disables channel events and channel interrupts. The function asserts if the instance is not
+ *       initialized or if the channel parameter is wrong.
+ *
+ * @param[in]  p_instance          Pointer to the driver instance structure.
+ * @param[in]  channel             One of the instance's channels.
+ *
+ * @retval     NRFX_SUCCESS         If the procedure was successful.
+ * @retval     NRFX_ERROR_TIMEOUT   If an interrupt was pending on the requested channel.
+ */
+nrfx_err_t nrfx_rtc_cc_disable(nrfx_rtc_t const * const p_instance, uint32_t channel);
+
+/**@brief Function for enabling tick.
+ *
+ * This function enables the tick event and optionally the interrupt. The function asserts if the instance is not
+ *       powered on.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ * @param[in]  enable_irq         True to enable the interrupt. False to disable the interrupt.
+ */
+void nrfx_rtc_tick_enable(nrfx_rtc_t const * const p_instance, bool enable_irq);
+
+/**@brief Function for disabling tick.
+ *
+ * This function disables the tick event and interrupt.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ */
+void nrfx_rtc_tick_disable(nrfx_rtc_t const * const p_instance);
+
+/**@brief Function for enabling overflow.
+ *
+ * This function enables the overflow event and optionally the interrupt. The function asserts if the instance is
+ *       not powered on.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ * @param[in]  enable_irq         True to enable the interrupt. False to disable the interrupt.
+ */
+void nrfx_rtc_overflow_enable(nrfx_rtc_t const * const p_instance, bool enable_irq);
+
+/**@brief Function for disabling overflow.
+ *
+ * This function disables the overflow event and interrupt.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ */
+void nrfx_rtc_overflow_disable(nrfx_rtc_t const * const p_instance);
+
+/**@brief Function for getting the maximum relative ticks value that can be set in the compare channel.
+ *
+ * When a stack (for example SoftDevice) is used and it occupies high priority interrupts,
+ * the application code can be interrupted at any moment for a certain period of time.
+ * If Reliable mode is enabled, the provided maximum latency is taken into account
+ * and the return value is smaller than the RTC counter resolution.
+ * If Reliable mode is disabled, the return value equals the counter resolution.
+ *
+ * @param[in]  p_instance  Pointer to the driver instance structure.
+ *
+ * @retval     ticks         Maximum ticks value.
+ */
+uint32_t nrfx_rtc_max_ticks_get(nrfx_rtc_t const * const p_instance);
+
+/**@brief Function for disabling all instance interrupts.
+  *
+ * @param[in]  p_instance          Pointer to the driver instance structure.
+ * @param[in]  p_mask              Pointer to the location where the mask is filled.
+ */
+__STATIC_INLINE void nrfx_rtc_int_disable(nrfx_rtc_t const * const p_instance,
+                                          uint32_t               * p_mask);
+
+/**@brief Function for enabling instance interrupts.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ * @param[in]  mask               Mask of interrupts to enable.
+ */
+__STATIC_INLINE void nrfx_rtc_int_enable(nrfx_rtc_t const * const p_instance, uint32_t mask);
+
+/**@brief Function for retrieving the current counter value.
+ *
+ * This function asserts if the instance is not powered on or if p_val is NULL.
+ *
+ * @param[in]  p_instance    Pointer to the driver instance structure.
+ *
+ * @retval     value         Counter value.
+ */
+__STATIC_INLINE uint32_t nrfx_rtc_counter_get(nrfx_rtc_t const * const p_instance);
+
+/**@brief Function for clearing the counter value.
+ *
+ * This function asserts if the instance is not powered on.
+ *
+ * @param[in]  p_instance         Pointer to the driver instance structure.
+ */
+__STATIC_INLINE void nrfx_rtc_counter_clear(nrfx_rtc_t const * const p_instance);
+
+/**@brief Function for returning a requested task address for the RTC driver instance.
+ *
+ * This function asserts if the output pointer is NULL. The task address can be used by the PPI module.
+ *
+ * @param[in]  p_instance         Pointer to the instance.
+ * @param[in]  task                One of the peripheral tasks.
+ *
+ * @retval     Address of task register.
+ */
+__STATIC_INLINE uint32_t nrfx_rtc_task_address_get(nrfx_rtc_t const * const p_instance,
+                                                   nrf_rtc_task_t           task);
+
+/**@brief Function for returning a requested event address for the RTC driver instance.
+ *
+ * This function asserts if the output pointer is NULL. The event address can be used by the PPI module.
+ *
+ * @param[in]  p_instance          Pointer to the driver instance structure.
+ * @param[in]  event               One of the peripheral events.
+ *
+ * @retval     Address of event register.
+ */
+__STATIC_INLINE uint32_t nrfx_rtc_event_address_get(nrfx_rtc_t const * const p_instance,
+                                                    nrf_rtc_event_t          event);
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+
+__STATIC_INLINE void nrfx_rtc_int_disable(nrfx_rtc_t const * const p_instance,
+                                          uint32_t               * p_mask)
+{
+    *p_mask = nrf_rtc_int_get(p_instance->p_reg);
+    nrf_rtc_int_disable(p_instance->p_reg, NRF_RTC_INT_TICK_MASK |
+                                           NRF_RTC_INT_OVERFLOW_MASK |
+                                           NRF_RTC_INT_COMPARE0_MASK |
+                                           NRF_RTC_INT_COMPARE1_MASK |
+                                           NRF_RTC_INT_COMPARE2_MASK |
+                                           NRF_RTC_INT_COMPARE3_MASK);
+}
+
+__STATIC_INLINE void nrfx_rtc_int_enable(nrfx_rtc_t const * const p_instance, uint32_t mask)
+{
+    nrf_rtc_int_enable(p_instance->p_reg, mask);
+}
+
+__STATIC_INLINE uint32_t nrfx_rtc_counter_get(nrfx_rtc_t const * const p_instance)
+{
+    return nrf_rtc_counter_get(p_instance->p_reg);
+}
+
+__STATIC_INLINE void nrfx_rtc_counter_clear(nrfx_rtc_t const * const p_instance)
+{
+    nrf_rtc_task_trigger(p_instance->p_reg, NRF_RTC_TASK_CLEAR);
+}
+
+__STATIC_INLINE uint32_t nrfx_rtc_task_address_get(nrfx_rtc_t const * const p_instance,
+                                                   nrf_rtc_task_t           task)
+{
+    return nrf_rtc_task_address_get(p_instance->p_reg, task);
+}
+
+__STATIC_INLINE uint32_t nrfx_rtc_event_address_get(nrfx_rtc_t const * const p_instance,
+                                                    nrf_rtc_event_t          event)
+{
+    return nrf_rtc_event_address_get(p_instance->p_reg, event);
+}
+#endif // SUPPRESS_INLINE_IMPLEMENTATION
+
+
+void nrfx_rtc_0_irq_handler(void);
+void nrfx_rtc_1_irq_handler(void);
+void nrfx_rtc_2_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_RTC_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_saadc.h

@@ -1,326 +1,317 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_SAADC_H__
-#define NRFX_SAADC_H__
-
-#include <nrfx.h>
-#include <hal/nrf_saadc.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_saadc SAADC driver
- * @{
- * @ingroup nrf_saadc
- * @brief   Successive Approximation Analog-to-Digital Converter (SAADC) peripheral driver.
- */
-
-/**
- * @brief Value that should be set as high limit to disable limit detection.
- */
-#define NRFX_SAADC_LIMITH_DISABLED (2047)
-/**
- * @brief Value that should be set as low limit to disable limit detection.
- */
-#define NRFX_SAADC_LIMITL_DISABLED (-2048)
-
-/**
- * @brief Macro for setting @ref nrfx_saadc_config_t to default settings.
- */
-#define NRFX_SAADC_DEFAULT_CONFIG                                               \
-{                                                                               \
-    .resolution         = (nrf_saadc_resolution_t)NRFX_SAADC_CONFIG_RESOLUTION, \
-    .oversample         = (nrf_saadc_oversample_t)NRFX_SAADC_CONFIG_OVERSAMPLE, \
-    .interrupt_priority = NRFX_SAADC_CONFIG_IRQ_PRIORITY,                       \
-    .low_power_mode     = NRFX_SAADC_CONFIG_LP_MODE                             \
-}
-
-/**
- * @brief Macro for setting @ref nrf_saadc_channel_config_t to default settings
- *        in single ended mode.
- *
- * @param PIN_P Analog input.
- */
-#define NRFX_SAADC_DEFAULT_CHANNEL_CONFIG_SE(PIN_P) \
-{                                                   \
-    .resistor_p = NRF_SAADC_RESISTOR_DISABLED,      \
-    .resistor_n = NRF_SAADC_RESISTOR_DISABLED,      \
-    .gain       = NRF_SAADC_GAIN1_6,                \
-    .reference  = NRF_SAADC_REFERENCE_INTERNAL,     \
-    .acq_time   = NRF_SAADC_ACQTIME_10US,           \
-    .mode       = NRF_SAADC_MODE_SINGLE_ENDED,      \
-    .burst      = NRF_SAADC_BURST_DISABLED,         \
-    .pin_p      = (nrf_saadc_input_t)(PIN_P),       \
-    .pin_n      = NRF_SAADC_INPUT_DISABLED          \
-}
-
-/**
- * @brief Macro for setting @ref nrf_saadc_channel_config_t to default settings
- *        in differential mode.
- *
- * @param PIN_P Positive analog input.
- * @param PIN_N Negative analog input.
- */
-#define NRFX_SAADC_DEFAULT_CHANNEL_CONFIG_DIFFERENTIAL(PIN_P, PIN_N) \
-{                                                                    \
-    .resistor_p = NRF_SAADC_RESISTOR_DISABLED,                       \
-    .resistor_n = NRF_SAADC_RESISTOR_DISABLED,                       \
-    .gain       = NRF_SAADC_GAIN1_6,                                 \
-    .reference  = NRF_SAADC_REFERENCE_INTERNAL,                      \
-    .acq_time   = NRF_SAADC_ACQTIME_10US,                            \
-    .mode       = NRF_SAADC_MODE_DIFFERENTIAL,                       \
-    .pin_p      = (nrf_saadc_input_t)(PIN_P),                        \
-    .pin_n      = (nrf_saadc_input_t)(PIN_N)                         \
-}
-
-/**
- * @brief Analog-to-digital converter driver configuration structure.
- */
-typedef struct
-{
-    nrf_saadc_resolution_t resolution;         ///< Resolution configuration.
-    nrf_saadc_oversample_t oversample;         ///< Oversampling configuration.
-    uint8_t                interrupt_priority; ///< Interrupt priority.
-    bool                   low_power_mode;     ///< Indicates if low power mode is active.
-} nrfx_saadc_config_t;
-
-/**
- * @brief Driver event types.
- */
-typedef enum
-{
-    NRFX_SAADC_EVT_DONE,         ///< Event generated when the buffer is filled with samples.
-    NRFX_SAADC_EVT_LIMIT,        ///< Event generated after one of the limits is reached.
-    NRFX_SAADC_EVT_CALIBRATEDONE ///< Event generated when the calibration is complete.
-} nrfx_saadc_evt_type_t;
-
-/**
- * @brief Analog-to-digital converter driver done event data.
- */
-typedef struct
-{
-    nrf_saadc_value_t * p_buffer; ///< Pointer to buffer with converted samples.
-    uint16_t            size;     ///< Number of samples in the buffer.
-} nrfx_saadc_done_evt_t;
-
-/**
- * @brief Analog-to-digital converter driver limit event data.
- */
-typedef struct
-{
-    uint8_t           channel;    ///< Channel on which the limit was detected.
-    nrf_saadc_limit_t limit_type; ///< Type of limit detected.
-} nrfx_saadc_limit_evt_t;
-
-/**
- * @brief Analog-to-digital converter driver event structure.
- */
-typedef struct
-{
-    nrfx_saadc_evt_type_t type; ///< Event type.
-    union
-    {
-        nrfx_saadc_done_evt_t  done;  ///< Data for @ref NRFX_SAADC_EVT_DONE event.
-        nrfx_saadc_limit_evt_t limit; ///< Data for @ref NRFX_SAADC_EVT_LIMIT event.
-    } data;
-} nrfx_saadc_evt_t;
-
-/**
- * @brief ADC event handler.
- *
- * @param[in] p_event     Pointer to an ADC event. The event structure is allocated on
- *                        the stack, so it is valid only within the context of
- *                        the event handler.
- */
-typedef void (* nrfx_saadc_event_handler_t)(nrfx_saadc_evt_t const * p_event);
-
-/**
- * @brief Function for initializing the SAADC.
- *
- * @param[in] p_config      Pointer to the structure with initial configuration.
- * @param[in] event_handler Event handler provided by the user.
- *                          Must not be NULL.
- *
- * @retval    NRFX_SUCCESS              If initialization was successful.
- * @retval    NRFX_ERROR_INVALID_STATE  If the driver is already initialized.
- */
-nrfx_err_t nrfx_saadc_init(nrfx_saadc_config_t const * p_config,
-                           nrfx_saadc_event_handler_t  event_handler);
-
-/**
- * @brief Function for uninitializing the SAADC.
- *
- * This function stops all ongoing conversions and disables all channels.
- */
-void nrfx_saadc_uninit(void);
-
-
-/**
- * @brief Function for getting the address of a SAMPLE SAADC task.
- *
- * @return     Task address.
- */
-uint32_t nrfx_saadc_sample_task_get(void);
-
-/**
- * @brief Function for initializing an SAADC channel.
- *
- * This function configures and enables the channel.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the ADC was not initialized.
- * @retval NRFX_ERROR_NO_MEM        If the specified channel was already allocated.
- */
-nrfx_err_t nrfx_saadc_channel_init(uint8_t                                  channel,
-                                   nrf_saadc_channel_config_t const * const p_config);
-
-
-/**
- * @brief Function for uninitializing an SAADC channel.
- *
- * @retval NRFX_SUCCESS    If uninitialization was successful.
- * @retval NRFX_ERROR_BUSY If the ADC is busy.
- */
-nrfx_err_t nrfx_saadc_channel_uninit(uint8_t channel);
-
-/**
- * @brief Function for starting SAADC sampling.
- *
- * @retval NRFX_SUCCESS             If ADC sampling was triggered.
- * @retval NRFX_ERROR_INVALID_STATE If ADC is in idle state.
- */
-nrfx_err_t nrfx_saadc_sample(void);
-
-/**
- * @brief Blocking function for executing a single ADC conversion.
- *
- * This function selects the desired input, starts a single conversion,
- * waits for it to finish, and returns the result.
- *
- * The function will fail if ADC is busy.
- *
- * @param[in]  channel Channel.
- * @param[out] p_value Pointer to the location where the result should be placed.
- *
- * @retval NRFX_SUCCESS    If conversion was successful.
- * @retval NRFX_ERROR_BUSY If the ADC driver is busy.
- */
-nrfx_err_t nrfx_saadc_sample_convert(uint8_t channel, nrf_saadc_value_t * p_value);
-
-/**
- * @brief Function for issuing conversion of data to the buffer.
- *
- * This function is non-blocking. The application is notified about filling the buffer by the event
- * handler. Conversion will be done on all enabled channels. If the ADC is in idle state, the
- * function will set up Easy DMA for the conversion. The ADC will be ready for sampling and wait for
- * the SAMPLE task. It can be triggered manually by the @ref nrfx_saadc_sample function or by PPI
- * using the @ref NRF_SAADC_TASK_SAMPLE task. If one buffer is already set and the conversion is
- * ongoing, calling this function will result in queuing the given buffer. The driver will start
- * filling the issued buffer when the first one is completed. If the function is called again before
- * the first buffer is filled or calibration is in progress, it will return with error.
- *
- * @param[in] buffer Result buffer.
- * @param[in] size   Buffer size in words.
- *
- * @retval NRFX_SUCCESS    If conversion was successful.
- * @retval NRFX_ERROR_BUSY If the driver already has two buffers set or calibration is in progress.
- */
-nrfx_err_t nrfx_saadc_buffer_convert(nrf_saadc_value_t * buffer, uint16_t size);
-
-/**
- * @brief Function for triggering the ADC offset calibration.
- *
- * This function is non-blocking. The application is notified about completion by the event handler.
- * Calibration will also trigger DONE and RESULTDONE events.
- *
- * The function will fail if ADC is busy or calibration is already in progress.
- *
- * @retval NRFX_SUCCESS    If calibration was started successfully.
- * @retval NRFX_ERROR_BUSY If the ADC driver is busy.
- */
-nrfx_err_t nrfx_saadc_calibrate_offset(void);
-
-/**
- * @brief Function for retrieving the SAADC state.
- *
- * @retval true  If the ADC is busy.
- * @retval false If the ADC is ready.
- */
-bool nrfx_saadc_is_busy(void);
-
-/**
- * @brief Function for aborting ongoing and buffered conversions.
- * @note @ref NRFX_SAADC_EVT_DONE event will be generated if there is a conversion in progress.
- *       Event will contain number of words in the sample buffer.
- */
-void nrfx_saadc_abort(void);
-
-/**
- * @brief Function for setting the SAADC channel limits.
- *        When limits are enabled and the result exceeds the defined bounds, the limit handler
- *        function is called.
- *
- * @param[in] channel    SAADC channel number.
- * @param[in] limit_low  Lower limit (valid values from @ref NRFX_SAADC_LIMITL_DISABLED to
- *                       @ref NRFX_SAADC_LIMITH_DISABLED). Conversion results below this value will
- *                       trigger the handler function. Set to @ref NRFX_SAADC_LIMITL_DISABLED
- *                       to disable this limit.
- * @param[in] limit_high Upper limit (valid values from @ref NRFX_SAADC_LIMITL_DISABLED to
- *                       @ref NRFX_SAADC_LIMITH_DISABLED). Conversion results above this value will
- *                       trigger the handler function. Set to @ref NRFX_SAADC_LIMITH_DISABLED
- *                       to disable this limit.
- */
-void nrfx_saadc_limits_set(uint8_t channel, int16_t limit_low, int16_t limit_high);
-
-
-void nrfx_saadc_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_SAADC_H__
-
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_SAADC_H__
+#define NRFX_SAADC_H__
+
+#include <nrfx.h>
+#include <hal/nrf_saadc.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_saadc SAADC driver
+ * @{
+ * @ingroup nrf_saadc
+ * @brief   Successive Approximation Analog-to-Digital Converter (SAADC) peripheral driver.
+ */
+
+/**
+ * @brief Value that should be set as high limit to disable limit detection.
+ */
+#define NRFX_SAADC_LIMITH_DISABLED (2047)
+/**
+ * @brief Value that should be set as low limit to disable limit detection.
+ */
+#define NRFX_SAADC_LIMITL_DISABLED (-2048)
+
+/**
+ * @brief Macro for setting @ref nrfx_saadc_config_t to default settings.
+ */
+#define NRFX_SAADC_DEFAULT_CONFIG                                               \
+{                                                                               \
+    .resolution         = (nrf_saadc_resolution_t)NRFX_SAADC_CONFIG_RESOLUTION, \
+    .oversample         = (nrf_saadc_oversample_t)NRFX_SAADC_CONFIG_OVERSAMPLE, \
+    .interrupt_priority = NRFX_SAADC_CONFIG_IRQ_PRIORITY,                       \
+    .low_power_mode     = NRFX_SAADC_CONFIG_LP_MODE                             \
+}
+
+/**
+ * @brief Macro for setting @ref nrf_saadc_channel_config_t to default settings
+ *        in single ended mode.
+ *
+ * @param PIN_P Analog input.
+ */
+#define NRFX_SAADC_DEFAULT_CHANNEL_CONFIG_SE(PIN_P) \
+{                                                   \
+    .resistor_p = NRF_SAADC_RESISTOR_DISABLED,      \
+    .resistor_n = NRF_SAADC_RESISTOR_DISABLED,      \
+    .gain       = NRF_SAADC_GAIN1_6,                \
+    .reference  = NRF_SAADC_REFERENCE_INTERNAL,     \
+    .acq_time   = NRF_SAADC_ACQTIME_10US,           \
+    .mode       = NRF_SAADC_MODE_SINGLE_ENDED,      \
+    .burst      = NRF_SAADC_BURST_DISABLED,         \
+    .pin_p      = (nrf_saadc_input_t)(PIN_P),       \
+    .pin_n      = NRF_SAADC_INPUT_DISABLED          \
+}
+
+/**
+ * @brief Macro for setting @ref nrf_saadc_channel_config_t to default settings
+ *        in differential mode.
+ *
+ * @param PIN_P Positive analog input.
+ * @param PIN_N Negative analog input.
+ */
+#define NRFX_SAADC_DEFAULT_CHANNEL_CONFIG_DIFFERENTIAL(PIN_P, PIN_N) \
+{                                                                    \
+    .resistor_p = NRF_SAADC_RESISTOR_DISABLED,                       \
+    .resistor_n = NRF_SAADC_RESISTOR_DISABLED,                       \
+    .gain       = NRF_SAADC_GAIN1_6,                                 \
+    .reference  = NRF_SAADC_REFERENCE_INTERNAL,                      \
+    .acq_time   = NRF_SAADC_ACQTIME_10US,                            \
+    .mode       = NRF_SAADC_MODE_DIFFERENTIAL,                       \
+    .pin_p      = (nrf_saadc_input_t)(PIN_P),                        \
+    .pin_n      = (nrf_saadc_input_t)(PIN_N)                         \
+}
+
+/**
+ * @brief Analog-to-digital converter driver configuration structure.
+ */
+typedef struct
+{
+    nrf_saadc_resolution_t resolution;         ///< Resolution configuration.
+    nrf_saadc_oversample_t oversample;         ///< Oversampling configuration.
+    uint8_t                interrupt_priority; ///< Interrupt priority.
+    bool                   low_power_mode;     ///< Indicates if low power mode is active.
+} nrfx_saadc_config_t;
+
+/**
+ * @brief Driver event types.
+ */
+typedef enum
+{
+    NRFX_SAADC_EVT_DONE,         ///< Event generated when the buffer is filled with samples.
+    NRFX_SAADC_EVT_LIMIT,        ///< Event generated after one of the limits is reached.
+    NRFX_SAADC_EVT_CALIBRATEDONE ///< Event generated when the calibration is complete.
+} nrfx_saadc_evt_type_t;
+
+/**
+ * @brief Analog-to-digital converter driver done event data.
+ */
+typedef struct
+{
+    nrf_saadc_value_t * p_buffer; ///< Pointer to buffer with converted samples.
+    uint16_t            size;     ///< Number of samples in the buffer.
+} nrfx_saadc_done_evt_t;
+
+/**
+ * @brief Analog-to-digital converter driver limit event data.
+ */
+typedef struct
+{
+    uint8_t           channel;    ///< Channel on which the limit was detected.
+    nrf_saadc_limit_t limit_type; ///< Type of limit detected.
+} nrfx_saadc_limit_evt_t;
+
+/**
+ * @brief Analog-to-digital converter driver event structure.
+ */
+typedef struct
+{
+    nrfx_saadc_evt_type_t type; ///< Event type.
+    union
+    {
+        nrfx_saadc_done_evt_t  done;  ///< Data for @ref NRFX_SAADC_EVT_DONE event.
+        nrfx_saadc_limit_evt_t limit; ///< Data for @ref NRFX_SAADC_EVT_LIMIT event.
+    } data;
+} nrfx_saadc_evt_t;
+
+/**
+ * @brief ADC event handler.
+ *
+ * @param[in] p_event     Pointer to an ADC event. The event structure is allocated on
+ *                        the stack, so it is valid only within the context of
+ *                        the event handler.
+ */
+typedef void (* nrfx_saadc_event_handler_t)(nrfx_saadc_evt_t const * p_event);
+
+/**
+ * @brief Function for initializing the SAADC.
+ *
+ * @param[in] p_config      Pointer to the structure with initial configuration.
+ * @param[in] event_handler Event handler provided by the user.
+ *                          Must not be NULL.
+ *
+ * @retval    NRFX_SUCCESS              If initialization was successful.
+ * @retval    NRFX_ERROR_INVALID_STATE  If the driver is already initialized.
+ */
+nrfx_err_t nrfx_saadc_init(nrfx_saadc_config_t const * p_config,
+                           nrfx_saadc_event_handler_t  event_handler);
+
+/**
+ * @brief Function for uninitializing the SAADC.
+ *
+ * This function stops all ongoing conversions and disables all channels.
+ */
+void nrfx_saadc_uninit(void);
+
+
+/**
+ * @brief Function for getting the address of a SAMPLE SAADC task.
+ *
+ * @return     Task address.
+ */
+uint32_t nrfx_saadc_sample_task_get(void);
+
+/**
+ * @brief Function for initializing an SAADC channel.
+ *
+ * This function configures and enables the channel.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the ADC was not initialized.
+ * @retval NRFX_ERROR_NO_MEM        If the specified channel was already allocated.
+ */
+nrfx_err_t nrfx_saadc_channel_init(uint8_t                                  channel,
+                                   nrf_saadc_channel_config_t const * const p_config);
+
+
+/**
+ * @brief Function for uninitializing an SAADC channel.
+ *
+ * @retval NRFX_SUCCESS    If uninitialization was successful.
+ * @retval NRFX_ERROR_BUSY If the ADC is busy.
+ */
+nrfx_err_t nrfx_saadc_channel_uninit(uint8_t channel);
+
+/**
+ * @brief Function for starting SAADC sampling.
+ *
+ * @retval NRFX_SUCCESS             If ADC sampling was triggered.
+ * @retval NRFX_ERROR_INVALID_STATE If ADC is in idle state.
+ */
+nrfx_err_t nrfx_saadc_sample(void);
+
+/**
+ * @brief Blocking function for executing a single ADC conversion.
+ *
+ * This function selects the desired input, starts a single conversion,
+ * waits for it to finish, and returns the result.
+ *
+ * The function will fail if ADC is busy.
+ *
+ * @param[in]  channel Channel.
+ * @param[out] p_value Pointer to the location where the result should be placed.
+ *
+ * @retval NRFX_SUCCESS    If conversion was successful.
+ * @retval NRFX_ERROR_BUSY If the ADC driver is busy.
+ */
+nrfx_err_t nrfx_saadc_sample_convert(uint8_t channel, nrf_saadc_value_t * p_value);
+
+/**
+ * @brief Function for issuing conversion of data to the buffer.
+ *
+ * This function is non-blocking. The application is notified about filling the buffer by the event
+ * handler. Conversion will be done on all enabled channels. If the ADC is in idle state, the
+ * function will set up Easy DMA for the conversion. The ADC will be ready for sampling and wait for
+ * the SAMPLE task. It can be triggered manually by the @ref nrfx_saadc_sample function or by PPI
+ * using the @ref NRF_SAADC_TASK_SAMPLE task. If one buffer is already set and the conversion is
+ * ongoing, calling this function will result in queuing the given buffer. The driver will start
+ * filling the issued buffer when the first one is completed. If the function is called again before
+ * the first buffer is filled or calibration is in progress, it will return with error.
+ *
+ * @param[in] buffer Result buffer.
+ * @param[in] size   Buffer size in words.
+ *
+ * @retval NRFX_SUCCESS    If conversion was successful.
+ * @retval NRFX_ERROR_BUSY If the driver already has two buffers set or calibration is in progress.
+ */
+nrfx_err_t nrfx_saadc_buffer_convert(nrf_saadc_value_t * buffer, uint16_t size);
+
+/**
+ * @brief Function for triggering the ADC offset calibration.
+ *
+ * This function is non-blocking. The application is notified about completion by the event handler.
+ * Calibration will also trigger DONE and RESULTDONE events.
+ *
+ * The function will fail if ADC is busy or calibration is already in progress.
+ *
+ * @retval NRFX_SUCCESS    If calibration was started successfully.
+ * @retval NRFX_ERROR_BUSY If the ADC driver is busy.
+ */
+nrfx_err_t nrfx_saadc_calibrate_offset(void);
+
+/**
+ * @brief Function for retrieving the SAADC state.
+ *
+ * @retval true  If the ADC is busy.
+ * @retval false If the ADC is ready.
+ */
+bool nrfx_saadc_is_busy(void);
+
+/**
+ * @brief Function for aborting ongoing and buffered conversions.
+ * @note @ref NRFX_SAADC_EVT_DONE event will be generated if there is a conversion in progress.
+ *       Event will contain number of words in the sample buffer.
+ */
+void nrfx_saadc_abort(void);
+
+/**
+ * @brief Function for setting the SAADC channel limits.
+ *        When limits are enabled and the result exceeds the defined bounds, the limit handler
+ *        function is called.
+ *
+ * @param[in] channel    SAADC channel number.
+ * @param[in] limit_low  Lower limit (valid values from @ref NRFX_SAADC_LIMITL_DISABLED to
+ *                       @ref NRFX_SAADC_LIMITH_DISABLED). Conversion results below this value will
+ *                       trigger the handler function. Set to @ref NRFX_SAADC_LIMITL_DISABLED
+ *                       to disable this limit.
+ * @param[in] limit_high Upper limit (valid values from @ref NRFX_SAADC_LIMITL_DISABLED to
+ *                       @ref NRFX_SAADC_LIMITH_DISABLED). Conversion results above this value will
+ *                       trigger the handler function. Set to @ref NRFX_SAADC_LIMITH_DISABLED
+ *                       to disable this limit.
+ */
+void nrfx_saadc_limits_set(uint8_t channel, int16_t limit_low, int16_t limit_high);
+
+
+void nrfx_saadc_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_SAADC_H__
+

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_spi.h

@@ -1,273 +1,264 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_SPI_H__
-#define NRFX_SPI_H__
-
-#include <nrfx.h>
-#include <hal/nrf_spi.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_spi SPI driver
- * @{
- * @ingroup nrf_spi
- * @brief   SPI peripheral driver.
- */
-
-/**
- * @brief SPI master driver instance data structure.
- */
-typedef struct
-{
-    NRF_SPI_Type * p_reg;        ///< Pointer to a structure with SPI registers.
-    uint8_t        drv_inst_idx; ///< Driver instance index.
-} nrfx_spi_t;
-
-enum {
-#if NRFX_CHECK(NRFX_SPI0_ENABLED)
-    NRFX_SPI0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_SPI1_ENABLED)
-    NRFX_SPI1_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_SPI2_ENABLED)
-    NRFX_SPI2_INST_IDX,
-#endif
-    NRFX_SPI_ENABLED_COUNT
-};
-
-/**
- * @brief Macro for creating an SPI master driver instance.
- */
-#define NRFX_SPI_INSTANCE(id)                               \
-{                                                           \
-    .p_reg        = NRFX_CONCAT_2(NRF_SPI, id),             \
-    .drv_inst_idx = NRFX_CONCAT_3(NRFX_SPI, id, _INST_IDX), \
-}
-
-/**
- * @brief This value can be provided instead of a pin number for signals MOSI,
- *        MISO, and Slave Select to specify that the given signal is not used and
- *        therefore does not need to be connected to a pin.
- */
-#define NRFX_SPI_PIN_NOT_USED  0xFF
-
-/**
- * @brief SPI master driver instance configuration structure.
- */
-typedef struct
-{
-    uint8_t sck_pin;                ///< SCK pin number.
-    uint8_t mosi_pin;               ///< MOSI pin number (optional).
-                                    /**< Set to @ref NRFX_SPI_PIN_NOT_USED
-                                     *   if this signal is not needed. */
-    uint8_t miso_pin;               ///< MISO pin number (optional).
-                                    /**< Set to @ref NRFX_SPI_PIN_NOT_USED
-                                     *   if this signal is not needed. */
-    uint8_t ss_pin;                 ///< Slave Select pin number (optional).
-                                    /**< Set to @ref NRFX_SPI_PIN_NOT_USED
-                                     *   if this signal is not needed. The driver
-                                     *   supports only active low for this signal.
-                                     *   If the signal should be active high,
-                                     *   it must be controlled externally. */
-    uint8_t irq_priority;           ///< Interrupt priority.
-    uint8_t orc;                    ///< Over-run character.
-                                    /**< This character is used when all bytes from the TX buffer are sent,
-                                         but the transfer continues due to RX. */
-    nrf_spi_frequency_t frequency;  ///< SPI frequency.
-    nrf_spi_mode_t      mode;       ///< SPI mode.
-    nrf_spi_bit_order_t bit_order;  ///< SPI bit order.
-} nrfx_spi_config_t;
-
-/**
- * @brief SPI master instance default configuration.
- */
-#define NRFX_SPI_DEFAULT_CONFIG                           \
-{                                                         \
-    .sck_pin      = NRFX_SPI_PIN_NOT_USED,                \
-    .mosi_pin     = NRFX_SPI_PIN_NOT_USED,                \
-    .miso_pin     = NRFX_SPI_PIN_NOT_USED,                \
-    .ss_pin       = NRFX_SPI_PIN_NOT_USED,                \
-    .irq_priority = NRFX_SPI_DEFAULT_CONFIG_IRQ_PRIORITY, \
-    .orc          = 0xFF,                                 \
-    .frequency    = NRF_SPI_FREQ_4M,                      \
-    .mode         = NRF_SPI_MODE_0,                       \
-    .bit_order    = NRF_SPI_BIT_ORDER_MSB_FIRST,          \
-}
-
-/**
- * @brief Single transfer descriptor structure.
- */
-typedef struct
-{
-    uint8_t const * p_tx_buffer; ///< Pointer to TX buffer.
-    size_t          tx_length;   ///< TX buffer length.
-    uint8_t       * p_rx_buffer; ///< Pointer to RX buffer.
-    size_t          rx_length;   ///< RX buffer length.
-} nrfx_spi_xfer_desc_t;
-
-/**
- * @brief Macro for setting up single transfer descriptor.
- *
- * This macro is for internal use only.
- */
-#define NRFX_SPI_SINGLE_XFER(p_tx, tx_len, p_rx, rx_len)  \
-    {                                                     \
-    .p_tx_buffer = (uint8_t const *)(p_tx),               \
-    .tx_length = (tx_len),                                \
-    .p_rx_buffer = (p_rx),                                \
-    .rx_length = (rx_len),                                \
-    }
-
-/**
- * @brief Macro for setting duplex TX RX transfer.
- */
-#define NRFX_SPI_XFER_TRX(p_tx_buf, tx_length, p_rx_buf, rx_length) \
-        NRFX_SPI_SINGLE_XFER(p_tx_buf, tx_length, p_rx_buf, rx_length)
-
-/**
- * @brief Macro for setting TX transfer.
- */
-#define NRFX_SPI_XFER_TX(p_buf, length) \
-        NRFX_SPI_SINGLE_XFER(p_buf, length, NULL, 0)
-
-/**
- * @brief Macro for setting RX transfer.
- */
-#define NRFX_SPI_XFER_RX(p_buf, length) \
-        NRFX_SPI_SINGLE_XFER(NULL, 0, p_buf, length)
-
-/**
- * @brief SPI master driver event types, passed to the handler routine provided
- *        during initialization.
- */
-typedef enum
-{
-    NRFX_SPI_EVENT_DONE, ///< Transfer done.
-} nrfx_spi_evt_type_t;
-
-typedef struct
-{
-    nrfx_spi_evt_type_t  type;      ///< Event type.
-    nrfx_spi_xfer_desc_t xfer_desc; ///< Transfer details.
-} nrfx_spi_evt_t;
-
-/**
- * @brief SPI master driver event handler type.
- */
-typedef void (* nrfx_spi_evt_handler_t)(nrfx_spi_evt_t const * p_event,
-                                        void *                 p_context);
-
-/**
- * @brief Function for initializing the SPI master driver instance.
- *
- * This function configures and enables the specified peripheral.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] p_config   Pointer to the structure with initial configuration.
- *
- * @param     handler    Event handler provided by the user. If NULL, transfers
- *                       will be performed in blocking mode.
- * @param     p_context  Context passed to event handler.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
- * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
- *                                  instance ID is already in use. This is
- *                                  possible only if @ref nrfx_prs module
- *                                  is enabled.
- */
-nrfx_err_t nrfx_spi_init(nrfx_spi_t const * const  p_instance,
-                         nrfx_spi_config_t const * p_config,
-                         nrfx_spi_evt_handler_t    handler,
-                         void *                    p_context);
-
-/**
- * @brief Function for uninitializing the SPI master driver instance.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void       nrfx_spi_uninit(nrfx_spi_t const * const p_instance);
-
-/**
- * @brief Function for starting the SPI data transfer.
- *
- * If an event handler was provided in the @ref nrfx_spi_init call, this function
- * returns immediately and the handler is called when the transfer is done.
- * Otherwise, the transfer is performed in blocking mode, which means that this function
- * returns when the transfer is finished.
- *
- * @param p_instance  Pointer to the driver instance structure.
- * @param p_xfer_desc Pointer to the transfer descriptor.
- * @param flags       Transfer options (0 for default settings).
- *                    Currently, no additional flags are available.
- *
- * @retval NRFX_SUCCESS             If the procedure was successful.
- * @retval NRFX_ERROR_BUSY          If the driver is not ready for a new transfer.
- * @retval NRFX_ERROR_NOT_SUPPORTED If the provided parameters are not supported.
- */
-nrfx_err_t nrfx_spi_xfer(nrfx_spi_t const * const     p_instance,
-                         nrfx_spi_xfer_desc_t const * p_xfer_desc,
-                         uint32_t                     flags);
-
-/**
- * @brief Function for aborting ongoing transfer.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_spi_abort(nrfx_spi_t const * p_instance);
-
-
-void nrfx_spi_0_irq_handler(void);
-void nrfx_spi_1_irq_handler(void);
-void nrfx_spi_2_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_SPI_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_SPI_H__
+#define NRFX_SPI_H__
+
+#include <nrfx.h>
+#include <hal/nrf_spi.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_spi SPI driver
+ * @{
+ * @ingroup nrf_spi
+ * @brief   SPI peripheral driver.
+ */
+
+/**
+ * @brief SPI master driver instance data structure.
+ */
+typedef struct
+{
+    NRF_SPI_Type * p_reg;        ///< Pointer to a structure with SPI registers.
+    uint8_t        drv_inst_idx; ///< Driver instance index.
+} nrfx_spi_t;
+
+enum {
+#if NRFX_CHECK(NRFX_SPI0_ENABLED)
+    NRFX_SPI0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_SPI1_ENABLED)
+    NRFX_SPI1_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_SPI2_ENABLED)
+    NRFX_SPI2_INST_IDX,
+#endif
+    NRFX_SPI_ENABLED_COUNT
+};
+
+/**
+ * @brief Macro for creating an SPI master driver instance.
+ */
+#define NRFX_SPI_INSTANCE(id)                               \
+{                                                           \
+    .p_reg        = NRFX_CONCAT_2(NRF_SPI, id),             \
+    .drv_inst_idx = NRFX_CONCAT_3(NRFX_SPI, id, _INST_IDX), \
+}
+
+/**
+ * @brief This value can be provided instead of a pin number for signals MOSI,
+ *        MISO, and Slave Select to specify that the given signal is not used and
+ *        therefore does not need to be connected to a pin.
+ */
+#define NRFX_SPI_PIN_NOT_USED  0xFF
+
+/**
+ * @brief SPI master driver instance configuration structure.
+ */
+typedef struct
+{
+    uint8_t sck_pin;                ///< SCK pin number.
+    uint8_t mosi_pin;               ///< MOSI pin number (optional).
+                                    /**< Set to @ref NRFX_SPI_PIN_NOT_USED
+                                     *   if this signal is not needed. */
+    uint8_t miso_pin;               ///< MISO pin number (optional).
+                                    /**< Set to @ref NRFX_SPI_PIN_NOT_USED
+                                     *   if this signal is not needed. */
+    uint8_t ss_pin;                 ///< Slave Select pin number (optional).
+                                    /**< Set to @ref NRFX_SPI_PIN_NOT_USED
+                                     *   if this signal is not needed. The driver
+                                     *   supports only active low for this signal.
+                                     *   If the signal should be active high,
+                                     *   it must be controlled externally. */
+    uint8_t irq_priority;           ///< Interrupt priority.
+    uint8_t orc;                    ///< Over-run character.
+                                    /**< This character is used when all bytes from the TX buffer are sent,
+                                         but the transfer continues due to RX. */
+    nrf_spi_frequency_t frequency;  ///< SPI frequency.
+    nrf_spi_mode_t      mode;       ///< SPI mode.
+    nrf_spi_bit_order_t bit_order;  ///< SPI bit order.
+} nrfx_spi_config_t;
+
+/**
+ * @brief SPI master instance default configuration.
+ */
+#define NRFX_SPI_DEFAULT_CONFIG                           \
+{                                                         \
+    .sck_pin      = NRFX_SPI_PIN_NOT_USED,                \
+    .mosi_pin     = NRFX_SPI_PIN_NOT_USED,                \
+    .miso_pin     = NRFX_SPI_PIN_NOT_USED,                \
+    .ss_pin       = NRFX_SPI_PIN_NOT_USED,                \
+    .irq_priority = NRFX_SPI_DEFAULT_CONFIG_IRQ_PRIORITY, \
+    .orc          = 0xFF,                                 \
+    .frequency    = NRF_SPI_FREQ_4M,                      \
+    .mode         = NRF_SPI_MODE_0,                       \
+    .bit_order    = NRF_SPI_BIT_ORDER_MSB_FIRST,          \
+}
+
+/**
+ * @brief Single transfer descriptor structure.
+ */
+typedef struct
+{
+    uint8_t const * p_tx_buffer; ///< Pointer to TX buffer.
+    size_t          tx_length;   ///< TX buffer length.
+    uint8_t       * p_rx_buffer; ///< Pointer to RX buffer.
+    size_t          rx_length;   ///< RX buffer length.
+} nrfx_spi_xfer_desc_t;
+
+/**
+ * @brief Macro for setting up single transfer descriptor.
+ *
+ * This macro is for internal use only.
+ */
+#define NRFX_SPI_SINGLE_XFER(p_tx, tx_len, p_rx, rx_len)  \
+    {                                                     \
+    .p_tx_buffer = (uint8_t const *)(p_tx),               \
+    .tx_length = (tx_len),                                \
+    .p_rx_buffer = (p_rx),                                \
+    .rx_length = (rx_len),                                \
+    }
+
+/**
+ * @brief Macro for setting duplex TX RX transfer.
+ */
+#define NRFX_SPI_XFER_TRX(p_tx_buf, tx_length, p_rx_buf, rx_length) \
+        NRFX_SPI_SINGLE_XFER(p_tx_buf, tx_length, p_rx_buf, rx_length)
+
+/**
+ * @brief Macro for setting TX transfer.
+ */
+#define NRFX_SPI_XFER_TX(p_buf, length) \
+        NRFX_SPI_SINGLE_XFER(p_buf, length, NULL, 0)
+
+/**
+ * @brief Macro for setting RX transfer.
+ */
+#define NRFX_SPI_XFER_RX(p_buf, length) \
+        NRFX_SPI_SINGLE_XFER(NULL, 0, p_buf, length)
+
+/**
+ * @brief SPI master driver event types, passed to the handler routine provided
+ *        during initialization.
+ */
+typedef enum
+{
+    NRFX_SPI_EVENT_DONE, ///< Transfer done.
+} nrfx_spi_evt_type_t;
+
+typedef struct
+{
+    nrfx_spi_evt_type_t  type;      ///< Event type.
+    nrfx_spi_xfer_desc_t xfer_desc; ///< Transfer details.
+} nrfx_spi_evt_t;
+
+/**
+ * @brief SPI master driver event handler type.
+ */
+typedef void (* nrfx_spi_evt_handler_t)(nrfx_spi_evt_t const * p_event,
+                                        void *                 p_context);
+
+/**
+ * @brief Function for initializing the SPI master driver instance.
+ *
+ * This function configures and enables the specified peripheral.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] p_config   Pointer to the structure with initial configuration.
+ *
+ * @param     handler    Event handler provided by the user. If NULL, transfers
+ *                       will be performed in blocking mode.
+ * @param     p_context  Context passed to event handler.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
+ * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
+ *                                  instance ID is already in use. This is
+ *                                  possible only if @ref nrfx_prs module
+ *                                  is enabled.
+ */
+nrfx_err_t nrfx_spi_init(nrfx_spi_t const * const  p_instance,
+                         nrfx_spi_config_t const * p_config,
+                         nrfx_spi_evt_handler_t    handler,
+                         void *                    p_context);
+
+/**
+ * @brief Function for uninitializing the SPI master driver instance.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void       nrfx_spi_uninit(nrfx_spi_t const * const p_instance);
+
+/**
+ * @brief Function for starting the SPI data transfer.
+ *
+ * If an event handler was provided in the @ref nrfx_spi_init call, this function
+ * returns immediately and the handler is called when the transfer is done.
+ * Otherwise, the transfer is performed in blocking mode, which means that this function
+ * returns when the transfer is finished.
+ *
+ * @param p_instance  Pointer to the driver instance structure.
+ * @param p_xfer_desc Pointer to the transfer descriptor.
+ * @param flags       Transfer options (0 for default settings).
+ *                    Currently, no additional flags are available.
+ *
+ * @retval NRFX_SUCCESS             If the procedure was successful.
+ * @retval NRFX_ERROR_BUSY          If the driver is not ready for a new transfer.
+ * @retval NRFX_ERROR_NOT_SUPPORTED If the provided parameters are not supported.
+ */
+nrfx_err_t nrfx_spi_xfer(nrfx_spi_t const * const     p_instance,
+                         nrfx_spi_xfer_desc_t const * p_xfer_desc,
+                         uint32_t                     flags);
+
+/**
+ * @brief Function for aborting ongoing transfer.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_spi_abort(nrfx_spi_t const * p_instance);
+
+
+void nrfx_spi_0_irq_handler(void);
+void nrfx_spi_1_irq_handler(void);
+void nrfx_spi_2_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_SPI_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_spim.h

@@ -1,396 +1,387 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_SPIM_H__
-#define NRFX_SPIM_H__
-
-#include <nrfx.h>
-#include <hal/nrf_spim.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_spim SPIM driver
- * @{
- * @ingroup nrf_spim
- * @brief   SPIM peripheral driver.
- */
-
-/**
- * @brief SPIM master driver instance data structure.
- */
-typedef struct
-{
-    NRF_SPIM_Type * p_reg;        ///< Pointer to a structure with SPIM registers.
-    uint8_t         drv_inst_idx; ///< Driver instance index.
-} nrfx_spim_t;
-
-enum {
-#if NRFX_CHECK(NRFX_SPIM0_ENABLED)
-    NRFX_SPIM0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_SPIM1_ENABLED)
-    NRFX_SPIM1_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_SPIM2_ENABLED)
-    NRFX_SPIM2_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_SPIM3_ENABLED)
-    NRFX_SPIM3_INST_IDX,
-#endif
-    NRFX_SPIM_ENABLED_COUNT
-};
-
-/**
- * @brief Macro for creating an SPIM master driver instance.
- */
-#define NRFX_SPIM_INSTANCE(id)                               \
-{                                                            \
-    .p_reg        = NRFX_CONCAT_2(NRF_SPIM, id),             \
-    .drv_inst_idx = NRFX_CONCAT_3(NRFX_SPIM, id, _INST_IDX), \
-}
-
-/**
- * @brief This value can be provided instead of a pin number for signals MOSI,
- *        MISO, and Slave Select to specify that the given signal is not used and
- *        therefore does not need to be connected to a pin.
- */
-#define NRFX_SPIM_PIN_NOT_USED  0xFF
-
-/**
- * @brief SPIM master driver instance configuration structure.
- */
-typedef struct
-{
-    uint8_t sck_pin;      ///< SCK pin number.
-    uint8_t mosi_pin;     ///< MOSI pin number (optional).
-                          /**< Set to @ref NRFX_SPIM_PIN_NOT_USED
-                           *   if this signal is not needed. */
-    uint8_t miso_pin;     ///< MISO pin number (optional).
-                          /**< Set to @ref NRFX_SPIM_PIN_NOT_USED
-                           *   if this signal is not needed. */
-    uint8_t ss_pin;       ///< Slave Select pin number (optional).
-                          /**< Set to @ref NRFX_SPIM_PIN_NOT_USED
-                           *   if this signal is not needed. */
-    bool ss_active_high;  ///< Polarity of the Slave Select pin during transmission.
-    uint8_t irq_priority; ///< Interrupt priority.
-    uint8_t orc;          ///< Over-run character.
-                          /**< This character is used when all bytes from the TX buffer are sent,
-                               but the transfer continues due to RX. */
-    nrf_spim_frequency_t frequency; ///< SPI frequency.
-    nrf_spim_mode_t      mode;      ///< SPI mode.
-    nrf_spim_bit_order_t bit_order; ///< SPI bit order.
-#if NRFX_CHECK(NRFX_SPIM_EXTENDED_ENABLED) || defined(__NRFX_DOXYGEN__)
-    uint8_t              dcx_pin;     ///< D/CX pin number (optional).
-    uint8_t              rx_delay;    ///< Sample delay for input serial data on MISO.
-                                      /**< The value specifies the delay, in number of 64 MHz clock cycles
-                                       *   (15.625 ns), from the the sampling edge of SCK (leading edge for
-                                       *   CONFIG.CPHA = 0, trailing edge for CONFIG.CPHA = 1) until
-                                       *   the input serial data is sampled.*/
-    bool                 use_hw_ss;   ///< Indication to use software or hardware controlled Slave Select pin.
-    uint8_t              ss_duration; ///< Slave Select duration before and after transmission.
-                                      /**< Minimum duration between the edge of CSN and the edge of SCK and minimum
-                                       *   duration of CSN must stay inactive between transactions.
-                                       *   The value is specified in number of 64 MHz clock cycles (15.625 ns).
-                                       *   Supported only for hardware controlled Slave Select.*/
-#endif
-} nrfx_spim_config_t;
-
-#if NRFX_CHECK(NRFX_SPIM_EXTENDED_ENABLED) || defined(__NRFX_DOXYGEN__)
-/**
- * @brief SPIM master instance extended default configuration.
- */
-    #define NRFX_SPIM_DEFAULT_EXTENDED_CONFIG   \
-        .dcx_pin      = NRFX_SPIM_PIN_NOT_USED, \
-        .rx_delay     = 0x02,                   \
-        .ss_duration  = 0x02,                   \
-        .use_hw_ss    = false,
-#else
-    #define NRFX_SPIM_DEFAULT_EXTENDED_CONFIG
-#endif
-
-/**
- * @brief SPIM master instance default configuration.
- */
-#define NRFX_SPIM_DEFAULT_CONFIG                             \
-{                                                            \
-    .sck_pin        = NRFX_SPIM_PIN_NOT_USED,                \
-    .mosi_pin       = NRFX_SPIM_PIN_NOT_USED,                \
-    .miso_pin       = NRFX_SPIM_PIN_NOT_USED,                \
-    .ss_pin         = NRFX_SPIM_PIN_NOT_USED,                \
-    .ss_active_high = false,                                 \
-    .irq_priority   = NRFX_SPIM_DEFAULT_CONFIG_IRQ_PRIORITY, \
-    .orc            = 0xFF,                                  \
-    .frequency      = NRF_SPIM_FREQ_4M,                      \
-    .mode           = NRF_SPIM_MODE_0,                       \
-    .bit_order      = NRF_SPIM_BIT_ORDER_MSB_FIRST,          \
-    NRFX_SPIM_DEFAULT_EXTENDED_CONFIG                        \
-}
-
-#define NRFX_SPIM_FLAG_TX_POSTINC          (1UL << 0) /**< TX buffer address incremented after transfer. */
-#define NRFX_SPIM_FLAG_RX_POSTINC          (1UL << 1) /**< RX buffer address incremented after transfer. */
-#define NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER (1UL << 2) /**< Interrupt after each transfer is suppressed, and the event handler is not called. */
-#define NRFX_SPIM_FLAG_HOLD_XFER           (1UL << 3) /**< Set up the transfer but do not start it. */
-#define NRFX_SPIM_FLAG_REPEATED_XFER       (1UL << 4) /**< Flag indicating that the transfer will be executed multiple times. */
-
-/**
- * @brief Single transfer descriptor structure.
- */
-typedef struct
-{
-    uint8_t const * p_tx_buffer; ///< Pointer to TX buffer.
-    size_t          tx_length;   ///< TX buffer length.
-    uint8_t       * p_rx_buffer; ///< Pointer to RX buffer.
-    size_t          rx_length;   ///< RX buffer length.
-} nrfx_spim_xfer_desc_t;
-
-/**
- * @brief Macro for setting up single transfer descriptor.
- *
- * This macro is for internal use only.
- */
-#define NRFX_SPIM_SINGLE_XFER(p_tx, tx_len, p_rx, rx_len)    \
-    {                                                        \
-    .p_tx_buffer = (uint8_t const *)(p_tx),                  \
-    .tx_length = (tx_len),                                   \
-    .p_rx_buffer = (p_rx),                                   \
-    .rx_length = (rx_len),                                   \
-    }
-
-/**
- * @brief Macro for setting duplex TX RX transfer.
- */
-#define NRFX_SPIM_XFER_TRX(p_tx_buf, tx_length, p_rx_buf, rx_length)                    \
-        NRFX_SPIM_SINGLE_XFER(p_tx_buf, tx_length, p_rx_buf, rx_length)
-
-/**
- * @brief Macro for setting TX transfer.
- */
-#define NRFX_SPIM_XFER_TX(p_buf, length) \
-        NRFX_SPIM_SINGLE_XFER(p_buf, length, NULL, 0)
-
-/**
- * @brief Macro for setting RX transfer.
- */
-#define NRFX_SPIM_XFER_RX(p_buf, length) \
-        NRFX_SPIM_SINGLE_XFER(NULL, 0, p_buf, length)
-
-/**
- * @brief SPIM master driver event types, passed to the handler routine provided
- *        during initialization.
- */
-typedef enum
-{
-    NRFX_SPIM_EVENT_DONE, ///< Transfer done.
-} nrfx_spim_evt_type_t;
-
-typedef struct
-{
-    nrfx_spim_evt_type_t  type;      ///< Event type.
-    nrfx_spim_xfer_desc_t xfer_desc; ///< Transfer details.
-} nrfx_spim_evt_t;
-
-/**
- * @brief SPIM master driver event handler type.
- */
-typedef void (* nrfx_spim_evt_handler_t)(nrfx_spim_evt_t const * p_event,
-                                         void *                  p_context);
-
-/**
- * @brief Function for initializing the SPI master driver instance.
- *
- * This function configures and enables the specified peripheral.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] p_config   Pointer to the structure with initial configuration.
- *
- * @param     handler    Event handler provided by the user. If NULL, transfers
- *                       will be performed in blocking mode.
- * @param     p_context  Context passed to event handler.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
- * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
- *                                  instance ID is already in use. This is
- *                                  possible only if @ref nrfx_prs module
- *                                  is enabled.
- * @retval NRFX_ERROR_NOT_SUPPORTED If requested configuration is not supported
- *                                  by the SPIM instance.
- */
-nrfx_err_t nrfx_spim_init(nrfx_spim_t const * const  p_instance,
-                          nrfx_spim_config_t const * p_config,
-                          nrfx_spim_evt_handler_t    handler,
-                          void *                     p_context);
-
-/**
- * @brief Function for uninitializing the SPI master driver instance.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void       nrfx_spim_uninit(nrfx_spim_t const * const p_instance);
-
-/**
- * @brief Function for starting the SPI data transfer.
- *
- * Additional options are provided using the @c flags parameter:
- *
- * - @ref NRFX_SPIM_FLAG_TX_POSTINC and @ref NRFX_SPIM_FLAG_RX_POSTINC<span></span>:
- *   Post-incrementation of buffer addresses. Supported only by SPIM.
- * - @ref NRFX_SPIM_FLAG_HOLD_XFER<span></span>: Driver is not starting the transfer. Use this
- *   flag if the transfer is triggered externally by PPI. Supported only by SPIM. Use
- *   @ref nrfx_spim_start_task_get to get the address of the start task.
- * - @ref NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER<span></span>: No user event handler after transfer
- *   completion. This also means no interrupt at the end of the transfer. Supported only by SPIM.
- *   If @ref NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER is used, the driver does not set the instance into
- *   busy state, so you must ensure that the next transfers are set up when SPIM is not active.
- *   @ref nrfx_spim_end_event_get function can be used to detect end of transfer. Option can be used
- *   together with @ref NRFX_SPIM_FLAG_REPEATED_XFER to prepare a sequence of SPI transfers
- *   without interruptions.
- * - @ref NRFX_SPIM_FLAG_REPEATED_XFER<span></span>: Prepare for repeated transfers. You can set
- *   up a number of transfers that will be triggered externally (for example by PPI). An example is
- *   a TXRX transfer with the options @ref NRFX_SPIM_FLAG_RX_POSTINC,
- *   @ref NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER, and @ref NRFX_SPIM_FLAG_REPEATED_XFER. After the
- *   transfer is set up, a set of transfers can be triggered by PPI that will read, for example,
- *   the same register of an external component and put it into a RAM buffer without any interrupts.
- *   @ref nrfx_spim_end_event_get can be used to get the address of the END event, which can be
- *   used to count the number of transfers. If @ref NRFX_SPIM_FLAG_REPEATED_XFER is used,
- *   the driver does not set the instance into busy state, so you must ensure that the next
- *   transfers are set up when SPIM is not active. Supported only by SPIM.
- *
- * @note Peripherals using EasyDMA (including SPIM) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param p_instance  Pointer to the driver instance structure.
- * @param p_xfer_desc Pointer to the transfer descriptor.
- * @param flags       Transfer options (0 for default settings).
- *
- * @retval NRFX_SUCCESS             If the procedure was successful.
- * @retval NRFX_ERROR_BUSY          If the driver is not ready for a new transfer.
- * @retval NRFX_ERROR_NOT_SUPPORTED If the provided parameters are not supported.
- * @retval NRFX_ERROR_INVALID_ADDR  If the provided buffers are not placed in the Data
- *                                  RAM region.
- */
-nrfx_err_t nrfx_spim_xfer(nrfx_spim_t const * const     p_instance,
-                          nrfx_spim_xfer_desc_t const * p_xfer_desc,
-                          uint32_t                      flags);
-
-#if NRFX_CHECK(NRFX_SPIM_EXTENDED_ENABLED) || defined(__NRFX_DOXYGEN__)
-/**
- * @brief Function for starting the SPI data transfer with DCX control.
- *
- * See @ref nrfx_spim_xfer for description of additional options of transfer
- * provided by the @c flags parameter.
- *
- * @note Peripherals that use EasyDMA (including SPIM) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param p_instance  Pointer to the driver instance structure.
- * @param p_xfer_desc Pointer to the transfer descriptor.
- * @param flags       Transfer options (0 for default settings).
- * @param cmd_length  Length of the command bytes preceding the data
- *                    bytes. The DCX line will be low during transmission
- *                    of command bytes and high during transmission of data bytes.
- *                    Maximum value available for dividing the transmitted bytes
- *                    into command bytes and data bytes is @ref NRF_SPIM_DCX_CNT_ALL_CMD - 1.
- *                    The @ref NRF_SPIM_DCX_CNT_ALL_CMD value passed as the
- *                    @c cmd_length parameter causes all transmitted bytes
- *                    to be marked as command bytes.
- *
- * @retval NRFX_SUCCESS              If the procedure was successful.
- * @retval NRFX_ERROR_BUSY           If the driver is not ready for a new transfer.
- * @retval NRFX_ERROR_NOT_SUPPORTED  If the provided parameters are not supported.
- * @retval NRFX_ERROR_INVALID_ADDR   If the provided buffers are not placed in the Data
- *                                   RAM region.
- */
-nrfx_err_t nrfx_spim_xfer_dcx(nrfx_spim_t const * const     p_instance,
-                              nrfx_spim_xfer_desc_t const * p_xfer_desc,
-                              uint32_t                      flags,
-                              uint8_t                       cmd_length);
-#endif
-
-/**
- * @brief Function for returning the address of a SPIM start task.
- *
- * This function should be used if @ref nrfx_spim_xfer was called with the flag @ref NRFX_SPIM_FLAG_HOLD_XFER.
- * In that case, the transfer is not started by the driver, but it must be started externally by PPI.
- *
- * @param[in]  p_instance Pointer to the driver instance structure.
- *
- * @return     Start task address.
- */
-uint32_t nrfx_spim_start_task_get(nrfx_spim_t const * p_instance);
-
-/**
- * @brief Function for returning the address of a END SPIM event.
- *
- * The END event can be used to detect the end of a transfer
- * if the @ref NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER option is used.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @return END event address.
- */
-uint32_t nrfx_spim_end_event_get(nrfx_spim_t const * p_instance);
-
-/**
- * @brief Function for aborting ongoing transfer.
- *
- * @param[in]  p_instance Pointer to the driver instance structure.
- */
-void nrfx_spim_abort(nrfx_spim_t const * p_instance);
-
-
-void nrfx_spim_0_irq_handler(void);
-void nrfx_spim_1_irq_handler(void);
-void nrfx_spim_2_irq_handler(void);
-void nrfx_spim_3_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_SPIM_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_SPIM_H__
+#define NRFX_SPIM_H__
+
+#include <nrfx.h>
+#include <hal/nrf_spim.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_spim SPIM driver
+ * @{
+ * @ingroup nrf_spim
+ * @brief   SPIM peripheral driver.
+ */
+
+/**
+ * @brief SPIM master driver instance data structure.
+ */
+typedef struct
+{
+    NRF_SPIM_Type * p_reg;        ///< Pointer to a structure with SPIM registers.
+    uint8_t         drv_inst_idx; ///< Driver instance index.
+} nrfx_spim_t;
+
+enum {
+#if NRFX_CHECK(NRFX_SPIM0_ENABLED)
+    NRFX_SPIM0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_SPIM1_ENABLED)
+    NRFX_SPIM1_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_SPIM2_ENABLED)
+    NRFX_SPIM2_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_SPIM3_ENABLED)
+    NRFX_SPIM3_INST_IDX,
+#endif
+    NRFX_SPIM_ENABLED_COUNT
+};
+
+/**
+ * @brief Macro for creating an SPIM master driver instance.
+ */
+#define NRFX_SPIM_INSTANCE(id)                               \
+{                                                            \
+    .p_reg        = NRFX_CONCAT_2(NRF_SPIM, id),             \
+    .drv_inst_idx = NRFX_CONCAT_3(NRFX_SPIM, id, _INST_IDX), \
+}
+
+/**
+ * @brief This value can be provided instead of a pin number for signals MOSI,
+ *        MISO, and Slave Select to specify that the given signal is not used and
+ *        therefore does not need to be connected to a pin.
+ */
+#define NRFX_SPIM_PIN_NOT_USED  0xFF
+
+/**
+ * @brief SPIM master driver instance configuration structure.
+ */
+typedef struct
+{
+    uint8_t sck_pin;      ///< SCK pin number.
+    uint8_t mosi_pin;     ///< MOSI pin number (optional).
+                          /**< Set to @ref NRFX_SPIM_PIN_NOT_USED
+                           *   if this signal is not needed. */
+    uint8_t miso_pin;     ///< MISO pin number (optional).
+                          /**< Set to @ref NRFX_SPIM_PIN_NOT_USED
+                           *   if this signal is not needed. */
+    uint8_t ss_pin;       ///< Slave Select pin number (optional).
+                          /**< Set to @ref NRFX_SPIM_PIN_NOT_USED
+                           *   if this signal is not needed. */
+    bool ss_active_high;  ///< Polarity of the Slave Select pin during transmission.
+    uint8_t irq_priority; ///< Interrupt priority.
+    uint8_t orc;          ///< Over-run character.
+                          /**< This character is used when all bytes from the TX buffer are sent,
+                               but the transfer continues due to RX. */
+    nrf_spim_frequency_t frequency; ///< SPI frequency.
+    nrf_spim_mode_t      mode;      ///< SPI mode.
+    nrf_spim_bit_order_t bit_order; ///< SPI bit order.
+#if NRFX_CHECK(NRFX_SPIM_EXTENDED_ENABLED) || defined(__NRFX_DOXYGEN__)
+    uint8_t              dcx_pin;     ///< D/CX pin number (optional).
+    uint8_t              rx_delay;    ///< Sample delay for input serial data on MISO.
+                                      /**< The value specifies the delay, in number of 64 MHz clock cycles
+                                       *   (15.625 ns), from the the sampling edge of SCK (leading edge for
+                                       *   CONFIG.CPHA = 0, trailing edge for CONFIG.CPHA = 1) until
+                                       *   the input serial data is sampled.*/
+    bool                 use_hw_ss;   ///< Indication to use software or hardware controlled Slave Select pin.
+    uint8_t              ss_duration; ///< Slave Select duration before and after transmission.
+                                      /**< Minimum duration between the edge of CSN and the edge of SCK and minimum
+                                       *   duration of CSN must stay inactive between transactions.
+                                       *   The value is specified in number of 64 MHz clock cycles (15.625 ns).
+                                       *   Supported only for hardware controlled Slave Select.*/
+#endif
+} nrfx_spim_config_t;
+
+#if NRFX_CHECK(NRFX_SPIM_EXTENDED_ENABLED) || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief SPIM master instance extended default configuration.
+ */
+    #define NRFX_SPIM_DEFAULT_EXTENDED_CONFIG   \
+        .dcx_pin      = NRFX_SPIM_PIN_NOT_USED, \
+        .rx_delay     = 0x02,                   \
+        .ss_duration  = 0x02,                   \
+        .use_hw_ss    = false,
+#else
+    #define NRFX_SPIM_DEFAULT_EXTENDED_CONFIG
+#endif
+
+/**
+ * @brief SPIM master instance default configuration.
+ */
+#define NRFX_SPIM_DEFAULT_CONFIG                             \
+{                                                            \
+    .sck_pin        = NRFX_SPIM_PIN_NOT_USED,                \
+    .mosi_pin       = NRFX_SPIM_PIN_NOT_USED,                \
+    .miso_pin       = NRFX_SPIM_PIN_NOT_USED,                \
+    .ss_pin         = NRFX_SPIM_PIN_NOT_USED,                \
+    .ss_active_high = false,                                 \
+    .irq_priority   = NRFX_SPIM_DEFAULT_CONFIG_IRQ_PRIORITY, \
+    .orc            = 0xFF,                                  \
+    .frequency      = NRF_SPIM_FREQ_4M,                      \
+    .mode           = NRF_SPIM_MODE_0,                       \
+    .bit_order      = NRF_SPIM_BIT_ORDER_MSB_FIRST,          \
+    NRFX_SPIM_DEFAULT_EXTENDED_CONFIG                        \
+}
+
+#define NRFX_SPIM_FLAG_TX_POSTINC          (1UL << 0) /**< TX buffer address incremented after transfer. */
+#define NRFX_SPIM_FLAG_RX_POSTINC          (1UL << 1) /**< RX buffer address incremented after transfer. */
+#define NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER (1UL << 2) /**< Interrupt after each transfer is suppressed, and the event handler is not called. */
+#define NRFX_SPIM_FLAG_HOLD_XFER           (1UL << 3) /**< Set up the transfer but do not start it. */
+#define NRFX_SPIM_FLAG_REPEATED_XFER       (1UL << 4) /**< Flag indicating that the transfer will be executed multiple times. */
+
+/**
+ * @brief Single transfer descriptor structure.
+ */
+typedef struct
+{
+    uint8_t const * p_tx_buffer; ///< Pointer to TX buffer.
+    size_t          tx_length;   ///< TX buffer length.
+    uint8_t       * p_rx_buffer; ///< Pointer to RX buffer.
+    size_t          rx_length;   ///< RX buffer length.
+} nrfx_spim_xfer_desc_t;
+
+/**
+ * @brief Macro for setting up single transfer descriptor.
+ *
+ * This macro is for internal use only.
+ */
+#define NRFX_SPIM_SINGLE_XFER(p_tx, tx_len, p_rx, rx_len)    \
+    {                                                        \
+    .p_tx_buffer = (uint8_t const *)(p_tx),                  \
+    .tx_length = (tx_len),                                   \
+    .p_rx_buffer = (p_rx),                                   \
+    .rx_length = (rx_len),                                   \
+    }
+
+/**
+ * @brief Macro for setting duplex TX RX transfer.
+ */
+#define NRFX_SPIM_XFER_TRX(p_tx_buf, tx_length, p_rx_buf, rx_length)                    \
+        NRFX_SPIM_SINGLE_XFER(p_tx_buf, tx_length, p_rx_buf, rx_length)
+
+/**
+ * @brief Macro for setting TX transfer.
+ */
+#define NRFX_SPIM_XFER_TX(p_buf, length) \
+        NRFX_SPIM_SINGLE_XFER(p_buf, length, NULL, 0)
+
+/**
+ * @brief Macro for setting RX transfer.
+ */
+#define NRFX_SPIM_XFER_RX(p_buf, length) \
+        NRFX_SPIM_SINGLE_XFER(NULL, 0, p_buf, length)
+
+/**
+ * @brief SPIM master driver event types, passed to the handler routine provided
+ *        during initialization.
+ */
+typedef enum
+{
+    NRFX_SPIM_EVENT_DONE, ///< Transfer done.
+} nrfx_spim_evt_type_t;
+
+typedef struct
+{
+    nrfx_spim_evt_type_t  type;      ///< Event type.
+    nrfx_spim_xfer_desc_t xfer_desc; ///< Transfer details.
+} nrfx_spim_evt_t;
+
+/**
+ * @brief SPIM master driver event handler type.
+ */
+typedef void (* nrfx_spim_evt_handler_t)(nrfx_spim_evt_t const * p_event,
+                                         void *                  p_context);
+
+/**
+ * @brief Function for initializing the SPI master driver instance.
+ *
+ * This function configures and enables the specified peripheral.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] p_config   Pointer to the structure with initial configuration.
+ *
+ * @param     handler    Event handler provided by the user. If NULL, transfers
+ *                       will be performed in blocking mode.
+ * @param     p_context  Context passed to event handler.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver was already initialized.
+ * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
+ *                                  instance ID is already in use. This is
+ *                                  possible only if @ref nrfx_prs module
+ *                                  is enabled.
+ * @retval NRFX_ERROR_NOT_SUPPORTED If requested configuration is not supported
+ *                                  by the SPIM instance.
+ */
+nrfx_err_t nrfx_spim_init(nrfx_spim_t const * const  p_instance,
+                          nrfx_spim_config_t const * p_config,
+                          nrfx_spim_evt_handler_t    handler,
+                          void *                     p_context);
+
+/**
+ * @brief Function for uninitializing the SPI master driver instance.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void       nrfx_spim_uninit(nrfx_spim_t const * const p_instance);
+
+/**
+ * @brief Function for starting the SPI data transfer.
+ *
+ * Additional options are provided using the @c flags parameter:
+ *
+ * - @ref NRFX_SPIM_FLAG_TX_POSTINC and @ref NRFX_SPIM_FLAG_RX_POSTINC<span></span>:
+ *   Post-incrementation of buffer addresses. Supported only by SPIM.
+ * - @ref NRFX_SPIM_FLAG_HOLD_XFER<span></span>: Driver is not starting the transfer. Use this
+ *   flag if the transfer is triggered externally by PPI. Supported only by SPIM. Use
+ *   @ref nrfx_spim_start_task_get to get the address of the start task.
+ * - @ref NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER<span></span>: No user event handler after transfer
+ *   completion. This also means no interrupt at the end of the transfer. Supported only by SPIM.
+ *   If @ref NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER is used, the driver does not set the instance into
+ *   busy state, so you must ensure that the next transfers are set up when SPIM is not active.
+ *   @ref nrfx_spim_end_event_get function can be used to detect end of transfer. Option can be used
+ *   together with @ref NRFX_SPIM_FLAG_REPEATED_XFER to prepare a sequence of SPI transfers
+ *   without interruptions.
+ * - @ref NRFX_SPIM_FLAG_REPEATED_XFER<span></span>: Prepare for repeated transfers. You can set
+ *   up a number of transfers that will be triggered externally (for example by PPI). An example is
+ *   a TXRX transfer with the options @ref NRFX_SPIM_FLAG_RX_POSTINC,
+ *   @ref NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER, and @ref NRFX_SPIM_FLAG_REPEATED_XFER. After the
+ *   transfer is set up, a set of transfers can be triggered by PPI that will read, for example,
+ *   the same register of an external component and put it into a RAM buffer without any interrupts.
+ *   @ref nrfx_spim_end_event_get can be used to get the address of the END event, which can be
+ *   used to count the number of transfers. If @ref NRFX_SPIM_FLAG_REPEATED_XFER is used,
+ *   the driver does not set the instance into busy state, so you must ensure that the next
+ *   transfers are set up when SPIM is not active. Supported only by SPIM.
+ *
+ * @note Peripherals using EasyDMA (including SPIM) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param p_instance  Pointer to the driver instance structure.
+ * @param p_xfer_desc Pointer to the transfer descriptor.
+ * @param flags       Transfer options (0 for default settings).
+ *
+ * @retval NRFX_SUCCESS             If the procedure was successful.
+ * @retval NRFX_ERROR_BUSY          If the driver is not ready for a new transfer.
+ * @retval NRFX_ERROR_NOT_SUPPORTED If the provided parameters are not supported.
+ * @retval NRFX_ERROR_INVALID_ADDR  If the provided buffers are not placed in the Data
+ *                                  RAM region.
+ */
+nrfx_err_t nrfx_spim_xfer(nrfx_spim_t const * const     p_instance,
+                          nrfx_spim_xfer_desc_t const * p_xfer_desc,
+                          uint32_t                      flags);
+
+#if NRFX_CHECK(NRFX_SPIM_EXTENDED_ENABLED) || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief Function for starting the SPI data transfer with DCX control.
+ *
+ * See @ref nrfx_spim_xfer for description of additional options of transfer
+ * provided by the @c flags parameter.
+ *
+ * @note Peripherals that use EasyDMA (including SPIM) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param p_instance  Pointer to the driver instance structure.
+ * @param p_xfer_desc Pointer to the transfer descriptor.
+ * @param flags       Transfer options (0 for default settings).
+ * @param cmd_length  Length of the command bytes preceding the data
+ *                    bytes. The DCX line will be low during transmission
+ *                    of command bytes and high during transmission of data bytes.
+ *                    Maximum value available for dividing the transmitted bytes
+ *                    into command bytes and data bytes is @ref NRF_SPIM_DCX_CNT_ALL_CMD - 1.
+ *                    The @ref NRF_SPIM_DCX_CNT_ALL_CMD value passed as the
+ *                    @c cmd_length parameter causes all transmitted bytes
+ *                    to be marked as command bytes.
+ *
+ * @retval NRFX_SUCCESS              If the procedure was successful.
+ * @retval NRFX_ERROR_BUSY           If the driver is not ready for a new transfer.
+ * @retval NRFX_ERROR_NOT_SUPPORTED  If the provided parameters are not supported.
+ * @retval NRFX_ERROR_INVALID_ADDR   If the provided buffers are not placed in the Data
+ *                                   RAM region.
+ */
+nrfx_err_t nrfx_spim_xfer_dcx(nrfx_spim_t const * const     p_instance,
+                              nrfx_spim_xfer_desc_t const * p_xfer_desc,
+                              uint32_t                      flags,
+                              uint8_t                       cmd_length);
+#endif
+
+/**
+ * @brief Function for returning the address of a SPIM start task.
+ *
+ * This function should be used if @ref nrfx_spim_xfer was called with the flag @ref NRFX_SPIM_FLAG_HOLD_XFER.
+ * In that case, the transfer is not started by the driver, but it must be started externally by PPI.
+ *
+ * @param[in]  p_instance Pointer to the driver instance structure.
+ *
+ * @return     Start task address.
+ */
+uint32_t nrfx_spim_start_task_get(nrfx_spim_t const * p_instance);
+
+/**
+ * @brief Function for returning the address of a END SPIM event.
+ *
+ * The END event can be used to detect the end of a transfer
+ * if the @ref NRFX_SPIM_FLAG_NO_XFER_EVT_HANDLER option is used.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @return END event address.
+ */
+uint32_t nrfx_spim_end_event_get(nrfx_spim_t const * p_instance);
+
+/**
+ * @brief Function for aborting ongoing transfer.
+ *
+ * @param[in]  p_instance Pointer to the driver instance structure.
+ */
+void nrfx_spim_abort(nrfx_spim_t const * p_instance);
+
+
+void nrfx_spim_0_irq_handler(void);
+void nrfx_spim_1_irq_handler(void);
+void nrfx_spim_2_irq_handler(void);
+void nrfx_spim_3_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_SPIM_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_spis.h

@@ -1,250 +1,245 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_SPIS_H__
-#define NRFX_SPIS_H__
-
-#include <nrfx.h>
-#include <hal/nrf_spis.h>
-#include <hal/nrf_gpio.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_spis SPI slave driver
- * @{
- * @ingroup nrf_spis
- * @brief   SPI Slave peripheral driver.
- */
-
-/** @brief SPI slave driver instance data structure. */
-typedef struct
-{
-    NRF_SPIS_Type * p_reg;          //!< Pointer to a structure with SPIS registers.
-    uint8_t         drv_inst_idx;   //!< Driver instance index.
-} nrfx_spis_t;
-
-enum {
-#if NRFX_CHECK(NRFX_SPIS0_ENABLED)
-    NRFX_SPIS0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_SPIS1_ENABLED)
-    NRFX_SPIS1_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_SPIS2_ENABLED)
-    NRFX_SPIS2_INST_IDX,
-#endif
-    NRFX_SPIS_ENABLED_COUNT
-};
-
-/** @brief Macro for creating an SPI slave driver instance. */
-#define NRFX_SPIS_INSTANCE(id)                               \
-{                                                            \
-    .p_reg        = NRFX_CONCAT_2(NRF_SPIS, id),             \
-    .drv_inst_idx = NRFX_CONCAT_3(NRFX_SPIS, id, _INST_IDX), \
-}
-
-/**
- * @brief This value can be provided instead of a pin number for the signals MOSI
- *        and MISO to specify that the given signal is not used and therefore
- *        does not need to be connected to a pin.
- */
-#define NRFX_SPIS_PIN_NOT_USED  0xFF
-
-/** @brief Default pull-up configuration of the SPI CS. */
-#define NRFX_SPIS_DEFAULT_CSN_PULLUP  NRF_GPIO_PIN_NOPULL
-/** @brief Default drive configuration of the SPI MISO. */
-#define NRFX_SPIS_DEFAULT_MISO_DRIVE  NRF_GPIO_PIN_S0S1
-
-/** @brief SPI slave driver event types. */
-typedef enum
-{
-    NRFX_SPIS_BUFFERS_SET_DONE, //!< Memory buffer set event. Memory buffers have been set successfully to the SPI slave device, and SPI transaction can be done.
-    NRFX_SPIS_XFER_DONE,        //!< SPI transaction event. SPI transaction has been completed.
-    NRFX_SPIS_EVT_TYPE_MAX      //!< Enumeration upper bound.
-} nrfx_spis_evt_type_t;
-
-/** @brief SPI slave driver event structure. */
-typedef struct
-{
-    nrfx_spis_evt_type_t evt_type;  //!< Type of the event.
-    size_t               rx_amount; //!< Number of bytes received in the last transaction. This parameter is only valid for @ref NRFX_SPIS_XFER_DONE events.
-    size_t               tx_amount; //!< Number of bytes transmitted in the last transaction. This parameter is only valid for @ref NRFX_SPIS_XFER_DONE events.
-} nrfx_spis_evt_t;
-
-/** @brief SPI slave instance default configuration. */
-#define NRFX_SPIS_DEFAULT_CONFIG                           \
-{                                                          \
-    .sck_pin      = NRFX_SPIS_PIN_NOT_USED,                \
-    .mosi_pin     = NRFX_SPIS_PIN_NOT_USED,                \
-    .miso_pin     = NRFX_SPIS_PIN_NOT_USED,                \
-    .csn_pin      = NRFX_SPIS_PIN_NOT_USED,                \
-    .mode         = NRF_SPIS_MODE_0,                       \
-    .bit_order    = NRF_SPIS_BIT_ORDER_MSB_FIRST,          \
-    .csn_pullup   = NRFX_SPIS_DEFAULT_CSN_PULLUP,          \
-    .miso_drive   = NRFX_SPIS_DEFAULT_MISO_DRIVE,          \
-    .def          = NRFX_SPIS_DEFAULT_DEF,                 \
-    .orc          = NRFX_SPIS_DEFAULT_ORC,                 \
-    .irq_priority = NRFX_SPIS_DEFAULT_CONFIG_IRQ_PRIORITY, \
-}
-
-/** @brief SPI peripheral device configuration data. */
-typedef struct
-{
-    uint32_t             miso_pin;      //!< SPI MISO pin (optional).
-                                        /**< Set @ref NRFX_SPIS_PIN_NOT_USED
-                                         *   if this signal is not needed. */
-    uint32_t             mosi_pin;      //!< SPI MOSI pin (optional).
-                                        /**< Set @ref NRFX_SPIS_PIN_NOT_USED
-                                         *   if this signal is not needed. */
-    uint32_t             sck_pin;       //!< SPI SCK pin.
-    uint32_t             csn_pin;       //!< SPI CSN pin.
-    nrf_spis_mode_t      mode;          //!< SPI mode.
-    nrf_spis_bit_order_t bit_order;     //!< SPI transaction bit order.
-    nrf_gpio_pin_pull_t  csn_pullup;    //!< CSN pin pull-up configuration.
-    nrf_gpio_pin_drive_t miso_drive;    //!< MISO pin drive configuration.
-    uint8_t              def;           //!< Character clocked out in case of an ignored transaction.
-    uint8_t              orc;           //!< Character clocked out after an over-read of the transmit buffer.
-    uint8_t              irq_priority;  //!< Interrupt priority.
-} nrfx_spis_config_t;
-
-
-/**
- * @brief SPI slave driver event handler type.
- *
- * @param[in] p_event    Pointer to the event structure. The structure is
- *                       allocated on the stack so it is valid only until
- *                       the event handler returns.
- * @param[in] p_context  Context set on initialization.
- */
-typedef void (*nrfx_spis_event_handler_t)(nrfx_spis_evt_t const * p_event,
-                                          void *                  p_context);
-
-/**
- * @brief Function for initializing the SPI slave driver instance.
- *
- * @note When the nRF52 Anomaly 109 workaround for SPIS is enabled, this function
- *       initializes the GPIOTE driver as well, and uses one of GPIOTE channels
- *       to detect falling edges on CSN pin.
- *
- * @param[in] p_instance    Pointer to the driver instance structure.
- * @param[in] p_config      Pointer to the structure with initial configuration.
- * @param[in] event_handler Function to be called by the SPI slave driver upon event.
- *                          Must not be NULL.
- * @param[in] p_context     Context passed to the event handler.
- *
- * @retval NRFX_SUCCESS             If the initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the instance is already initialized.
- * @retval NRFX_ERROR_INVALID_PARAM If an invalid parameter is supplied.
- * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
- *                                  instance ID is already in use. This is
- *                                  possible only if @ref nrfx_prs module
- *                                  is enabled.
- * @retval NRFX_ERROR_INTERNAL      GPIOTE channel for detecting falling edges
- *                                  on CSN pin cannot be initialized. Possible
- *                                  only when using nRF52 Anomaly 109 workaround.
- */
-nrfx_err_t nrfx_spis_init(nrfx_spis_t const * const  p_instance,
-                          nrfx_spis_config_t const * p_config,
-                          nrfx_spis_event_handler_t  event_handler,
-                          void *                     p_context);
-
-/**
- * @brief Function for uninitializing the SPI slave driver instance.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_spis_uninit(nrfx_spis_t const * const p_instance);
-
-/**
- * @brief Function for preparing the SPI slave instance for a single SPI transaction.
- *
- * This function prepares the SPI slave device to be ready for a single SPI transaction. It configures
- * the SPI slave device to use the memory supplied with the function call in SPI transactions.
- *
- * When either the memory buffer configuration or the SPI transaction has been
- * completed, the event callback function will be called with the appropriate event
- * @ref nrfx_spis_evt_type_t. Note that the callback function can be called before returning from
- * this function, because it is called from the SPI slave interrupt context.
- *
- * @note This function can be called from the callback function context.
- *
- * @note Client applications must call this function after every @ref NRFX_SPIS_XFER_DONE event if
- * the SPI slave driver should be prepared for a possible new SPI transaction.
- *
- * @note Peripherals using EasyDMA (including SPIS) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param[in] p_instance            Pointer to the driver instance structure.
- * @param[in] p_tx_buffer           Pointer to the TX buffer. Can be NULL when the buffer length is zero.
- * @param[in] p_rx_buffer           Pointer to the RX buffer. Can be NULL when the buffer length is zero.
- * @param[in] tx_buffer_length      Length of the TX buffer in bytes.
- * @param[in] rx_buffer_length      Length of the RX buffer in bytes.
- *
- * @retval NRFX_SUCCESS              If the operation was successful.
- * @retval NRFX_ERROR_INVALID_STATE  If the operation failed because the SPI slave device is in an incorrect state.
- * @retval NRFX_ERROR_INVALID_ADDR   If the provided buffers are not placed in the Data
- *                                   RAM region.
- * @retval NRFX_ERROR_INVALID_LENGTH If provided lengths exceed the EasyDMA limits for the peripheral.
- * @retval NRFX_ERROR_INTERNAL       If the operation failed because of an internal error.
- */
-nrfx_err_t nrfx_spis_buffers_set(nrfx_spis_t const * const p_instance,
-                                 uint8_t const *           p_tx_buffer,
-                                 size_t                    tx_buffer_length,
-                                 uint8_t *                 p_rx_buffer,
-                                 size_t                    rx_buffer_length);
-
-
-void nrfx_spis_0_irq_handler(void);
-void nrfx_spis_1_irq_handler(void);
-void nrfx_spis_2_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_SPIS_H__
-
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_SPIS_H__
+#define NRFX_SPIS_H__
+
+#include <nrfx.h>
+#include <hal/nrf_spis.h>
+#include <hal/nrf_gpio.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_spis SPI slave driver
+ * @{
+ * @ingroup nrf_spis
+ * @brief   SPI Slave peripheral driver.
+ */
+
+/** @brief SPI slave driver instance data structure. */
+typedef struct
+{
+    NRF_SPIS_Type * p_reg;          //!< Pointer to a structure with SPIS registers.
+    uint8_t         drv_inst_idx;   //!< Driver instance index.
+} nrfx_spis_t;
+
+enum {
+#if NRFX_CHECK(NRFX_SPIS0_ENABLED)
+    NRFX_SPIS0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_SPIS1_ENABLED)
+    NRFX_SPIS1_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_SPIS2_ENABLED)
+    NRFX_SPIS2_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_SPIS3_ENABLED)
+    NRFX_SPIS3_INST_IDX,
+#endif
+    NRFX_SPIS_ENABLED_COUNT
+};
+
+/** @brief Macro for creating an SPI slave driver instance. */
+#define NRFX_SPIS_INSTANCE(id)                               \
+{                                                            \
+    .p_reg        = NRFX_CONCAT_2(NRF_SPIS, id),             \
+    .drv_inst_idx = NRFX_CONCAT_3(NRFX_SPIS, id, _INST_IDX), \
+}
+
+/**
+ * @brief This value can be provided instead of a pin number for the signals MOSI
+ *        and MISO to specify that the given signal is not used and therefore
+ *        does not need to be connected to a pin.
+ */
+#define NRFX_SPIS_PIN_NOT_USED  0xFF
+
+/** @brief Default pull-up configuration of the SPI CS. */
+#define NRFX_SPIS_DEFAULT_CSN_PULLUP  NRF_GPIO_PIN_NOPULL
+/** @brief Default drive configuration of the SPI MISO. */
+#define NRFX_SPIS_DEFAULT_MISO_DRIVE  NRF_GPIO_PIN_S0S1
+
+/** @brief SPI slave driver event types. */
+typedef enum
+{
+    NRFX_SPIS_BUFFERS_SET_DONE, //!< Memory buffer set event. Memory buffers have been set successfully to the SPI slave device, and SPI transaction can be done.
+    NRFX_SPIS_XFER_DONE,        //!< SPI transaction event. SPI transaction has been completed.
+    NRFX_SPIS_EVT_TYPE_MAX      //!< Enumeration upper bound.
+} nrfx_spis_evt_type_t;
+
+/** @brief SPI slave driver event structure. */
+typedef struct
+{
+    nrfx_spis_evt_type_t evt_type;  //!< Type of the event.
+    size_t               rx_amount; //!< Number of bytes received in the last transaction. This parameter is only valid for @ref NRFX_SPIS_XFER_DONE events.
+    size_t               tx_amount; //!< Number of bytes transmitted in the last transaction. This parameter is only valid for @ref NRFX_SPIS_XFER_DONE events.
+} nrfx_spis_evt_t;
+
+/** @brief SPI slave instance default configuration. */
+#define NRFX_SPIS_DEFAULT_CONFIG                           \
+{                                                          \
+    .sck_pin      = NRFX_SPIS_PIN_NOT_USED,                \
+    .mosi_pin     = NRFX_SPIS_PIN_NOT_USED,                \
+    .miso_pin     = NRFX_SPIS_PIN_NOT_USED,                \
+    .csn_pin      = NRFX_SPIS_PIN_NOT_USED,                \
+    .mode         = NRF_SPIS_MODE_0,                       \
+    .bit_order    = NRF_SPIS_BIT_ORDER_MSB_FIRST,          \
+    .csn_pullup   = NRFX_SPIS_DEFAULT_CSN_PULLUP,          \
+    .miso_drive   = NRFX_SPIS_DEFAULT_MISO_DRIVE,          \
+    .def          = NRFX_SPIS_DEFAULT_DEF,                 \
+    .orc          = NRFX_SPIS_DEFAULT_ORC,                 \
+    .irq_priority = NRFX_SPIS_DEFAULT_CONFIG_IRQ_PRIORITY, \
+}
+
+/** @brief SPI peripheral device configuration data. */
+typedef struct
+{
+    uint32_t             miso_pin;      //!< SPI MISO pin (optional).
+                                        /**< Set @ref NRFX_SPIS_PIN_NOT_USED
+                                         *   if this signal is not needed. */
+    uint32_t             mosi_pin;      //!< SPI MOSI pin (optional).
+                                        /**< Set @ref NRFX_SPIS_PIN_NOT_USED
+                                         *   if this signal is not needed. */
+    uint32_t             sck_pin;       //!< SPI SCK pin.
+    uint32_t             csn_pin;       //!< SPI CSN pin.
+    nrf_spis_mode_t      mode;          //!< SPI mode.
+    nrf_spis_bit_order_t bit_order;     //!< SPI transaction bit order.
+    nrf_gpio_pin_pull_t  csn_pullup;    //!< CSN pin pull-up configuration.
+    nrf_gpio_pin_drive_t miso_drive;    //!< MISO pin drive configuration.
+    uint8_t              def;           //!< Character clocked out in case of an ignored transaction.
+    uint8_t              orc;           //!< Character clocked out after an over-read of the transmit buffer.
+    uint8_t              irq_priority;  //!< Interrupt priority.
+} nrfx_spis_config_t;
+
+
+/**
+ * @brief SPI slave driver event handler type.
+ *
+ * @param[in] p_event    Pointer to the event structure. The structure is
+ *                       allocated on the stack so it is valid only until
+ *                       the event handler returns.
+ * @param[in] p_context  Context set on initialization.
+ */
+typedef void (*nrfx_spis_event_handler_t)(nrfx_spis_evt_t const * p_event,
+                                          void *                  p_context);
+
+/**
+ * @brief Function for initializing the SPI slave driver instance.
+ *
+ * @note When the nRF52 Anomaly 109 workaround for SPIS is enabled, this function
+ *       initializes the GPIOTE driver as well, and uses one of GPIOTE channels
+ *       to detect falling edges on CSN pin.
+ *
+ * @param[in] p_instance    Pointer to the driver instance structure.
+ * @param[in] p_config      Pointer to the structure with initial configuration.
+ * @param[in] event_handler Function to be called by the SPI slave driver upon event.
+ *                          Must not be NULL.
+ * @param[in] p_context     Context passed to the event handler.
+ *
+ * @retval NRFX_SUCCESS             If the initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the instance is already initialized.
+ * @retval NRFX_ERROR_INVALID_PARAM If an invalid parameter is supplied.
+ * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
+ *                                  instance ID is already in use. This is
+ *                                  possible only if @ref nrfx_prs module
+ *                                  is enabled.
+ * @retval NRFX_ERROR_INTERNAL      GPIOTE channel for detecting falling edges
+ *                                  on CSN pin cannot be initialized. Possible
+ *                                  only when using nRF52 Anomaly 109 workaround.
+ */
+nrfx_err_t nrfx_spis_init(nrfx_spis_t const * const  p_instance,
+                          nrfx_spis_config_t const * p_config,
+                          nrfx_spis_event_handler_t  event_handler,
+                          void *                     p_context);
+
+/**
+ * @brief Function for uninitializing the SPI slave driver instance.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_spis_uninit(nrfx_spis_t const * const p_instance);
+
+/**
+ * @brief Function for preparing the SPI slave instance for a single SPI transaction.
+ *
+ * This function prepares the SPI slave device to be ready for a single SPI transaction. It configures
+ * the SPI slave device to use the memory supplied with the function call in SPI transactions.
+ *
+ * When either the memory buffer configuration or the SPI transaction has been
+ * completed, the event callback function will be called with the appropriate event
+ * @ref nrfx_spis_evt_type_t. Note that the callback function can be called before returning from
+ * this function, because it is called from the SPI slave interrupt context.
+ *
+ * @note This function can be called from the callback function context.
+ *
+ * @note Client applications must call this function after every @ref NRFX_SPIS_XFER_DONE event if
+ * the SPI slave driver should be prepared for a possible new SPI transaction.
+ *
+ * @note Peripherals using EasyDMA (including SPIS) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param[in] p_instance            Pointer to the driver instance structure.
+ * @param[in] p_tx_buffer           Pointer to the TX buffer. Can be NULL when the buffer length is zero.
+ * @param[in] p_rx_buffer           Pointer to the RX buffer. Can be NULL when the buffer length is zero.
+ * @param[in] tx_buffer_length      Length of the TX buffer in bytes.
+ * @param[in] rx_buffer_length      Length of the RX buffer in bytes.
+ *
+ * @retval NRFX_SUCCESS              If the operation was successful.
+ * @retval NRFX_ERROR_INVALID_STATE  If the operation failed because the SPI slave device is in an incorrect state.
+ * @retval NRFX_ERROR_INVALID_ADDR   If the provided buffers are not placed in the Data
+ *                                   RAM region.
+ * @retval NRFX_ERROR_INVALID_LENGTH If provided lengths exceed the EasyDMA limits for the peripheral.
+ * @retval NRFX_ERROR_INTERNAL       If the operation failed because of an internal error.
+ */
+nrfx_err_t nrfx_spis_buffers_set(nrfx_spis_t const * const p_instance,
+                                 uint8_t const *           p_tx_buffer,
+                                 size_t                    tx_buffer_length,
+                                 uint8_t *                 p_rx_buffer,
+                                 size_t                    rx_buffer_length);
+
+
+void nrfx_spis_0_irq_handler(void);
+void nrfx_spis_1_irq_handler(void);
+void nrfx_spis_2_irq_handler(void);
+void nrfx_spis_3_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_SPIS_H__
+

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_swi.h

@@ -1,222 +1,236 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_SWI_H__
-#define NRFX_SWI_H__
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_EGU_ENABLED)
-#include <hal/nrf_egu.h>
-#endif
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_swi SWI driver
- * @{
- * @ingroup  nrf_swi_egu
- *
- * @brief    Driver for managing software interrupts (SWI).
- */
-
-/** @brief SWI instance. */
-typedef uint8_t nrfx_swi_t;
-
-/**
- * @brief SWI user flags.
- *
- * User flags are set during the SWI trigger and passed to the callback function as an argument.
- */
-typedef uint16_t nrfx_swi_flags_t;
-
-/** @brief Unallocated instance value. */
-#define NRFX_SWI_UNALLOCATED  ((nrfx_swi_t)0xFFuL)
-
-/** @brief Default SWI priority. */
-#define NRFX_SWI_DEFAULT_PRIORITY  APP_IRQ_PRIORITY_LOWEST
-
-/**
- * @brief SWI handler function.
- *
- * @param swi   SWI instance.
- * @param flags User flags.
- */
-typedef void (*nrfx_swi_handler_t)(nrfx_swi_t swi, nrfx_swi_flags_t flags);
-
-
-/**
- * @brief Function for allocating the first unused SWI instance and setting a handler.
- *
- * @param[out] p_swi          Points to a place where the allocated SWI instance
- *                            number is to be stored.
- * @param[in]  event_handler  Event handler function.
- *                            If NULL, no interrupt will be enabled.
- *                            It can be NULL only if the EGU driver is enabled.
- *                            For classic SWI, it must be a valid handler pointer.
- * @param[in]  irq_priority   Interrupt priority.
- *
- * @retval NRFX_SUCCESS       If the SWI was successfully allocated.
- * @retval NRFX_ERROR_NO_MEM  If there is no available SWI to be used.
- */
-nrfx_err_t nrfx_swi_alloc(nrfx_swi_t *       p_swi,
-                          nrfx_swi_handler_t event_handler,
-                          uint32_t           irq_priority);
-
-/**
- * @brief Function for freeing a previously allocated SWI.
- *
- * @param[in,out] p_swi  SWI instance to free. The value is changed to
- *                       @ref NRFX_SWI_UNALLOCATED on success.
- */
-void nrfx_swi_free(nrfx_swi_t * p_swi);
-
-/** @brief Function for freeing all allocated SWIs. */
-void nrfx_swi_all_free(void);
-
-/**
- * @brief Function for triggering the SWI.
- *
- * @param[in] swi          SWI to trigger.
- * @param[in] flag_number  Number of user flag to trigger.
- */
-void nrfx_swi_trigger(nrfx_swi_t swi,
-                      uint8_t    flag_number);
-
-/**
- * @brief Function for checking if the specified SWI is currently allocated.
- *
- * @param[in] swi  SWI instance.
- *
- * @retval true  If the SWI instance is allocated.
- * @retval false Otherwise.
- */
-bool nrfx_swi_is_allocated(nrfx_swi_t swi);
-
-#if NRFX_CHECK(NRFX_EGU_ENABLED) || defined(__NRFX_DOXYGEN__)
-
-/**
- * @brief Function for returning the base address of the EGU peripheral
- *        associated with the specified SWI instance.
- *
- * @param[in] swi  SWI instance.
- *
- * @returns EGU base address or NULL if the specified SWI instance number
- *          is too high.
- */
-__STATIC_INLINE NRF_EGU_Type * nrfx_swi_egu_instance_get(nrfx_swi_t swi)
-{
-#if (EGU_COUNT < SWI_COUNT)
-    if (swi >= EGU_COUNT)
-    {
-        return NULL;
-    }
-#endif
-    uint32_t offset = ((uint32_t)swi) * (NRF_EGU1_BASE - NRF_EGU0_BASE);
-    return (NRF_EGU_Type *)(NRF_EGU0_BASE + offset);
-}
-
-/**
- * @brief Function for returning the EGU trigger task address.
- *
- * @param[in] swi      SWI instance.
- * @param[in] channel  Number of the EGU channel.
- *
- * @returns Address of EGU trigger task.
- */
-__STATIC_INLINE uint32_t nrfx_swi_task_trigger_address_get(nrfx_swi_t swi,
-                                                           uint8_t    channel)
-{
-    NRFX_ASSERT(nrfx_swi_is_allocated(swi));
-
-    NRF_EGU_Type * p_egu = nrfx_swi_egu_instance_get(swi);
-#if (EGU_COUNT < SWI_COUNT)
-    if (p_egu == NULL)
-    {
-        return 0;
-    }
-#endif
-
-    return (uint32_t)nrf_egu_task_trigger_address_get(p_egu, channel);
-}
-
-/**
- * @brief Function for returning the EGU triggered event address.
- *
- * @param[in] swi      SWI instance.
- * @param[in] channel  Number of the EGU channel.
- *
- * @returns Address of EGU triggered event.
- */
-__STATIC_INLINE uint32_t nrfx_swi_event_triggered_address_get(nrfx_swi_t swi,
-                                                              uint8_t    channel)
-{
-    NRFX_ASSERT(nrfx_swi_is_allocated(swi));
-
-    NRF_EGU_Type * p_egu = nrfx_swi_egu_instance_get(swi);
-#if (EGU_COUNT < SWI_COUNT)
-    if (p_egu == NULL)
-    {
-        return 0;
-    }
-#endif
-
-    return (uint32_t)nrf_egu_event_triggered_address_get(p_egu, channel);
-}
-
-#endif // NRFX_CHECK(NRFX_EGU_ENABLED) || defined(__NRFX_DOXYGEN__)
-
-
-void nrfx_swi_0_irq_handler(void);
-void nrfx_swi_1_irq_handler(void);
-void nrfx_swi_2_irq_handler(void);
-void nrfx_swi_3_irq_handler(void);
-void nrfx_swi_4_irq_handler(void);
-void nrfx_swi_5_irq_handler(void);
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_SWI_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_SWI_H__
+#define NRFX_SWI_H__
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_EGU_ENABLED)
+#include <hal/nrf_egu.h>
+#endif
+
+#ifndef SWI_COUNT
+#define SWI_COUNT EGU_COUNT
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_swi SWI driver
+ * @{
+ * @ingroup  nrf_swi_egu
+ *
+ * @brief    Driver for managing software interrupts (SWI).
+ */
+
+/** @brief SWI instance. */
+typedef uint8_t nrfx_swi_t;
+
+/**
+ * @brief SWI user flags.
+ *
+ * User flags are set during the SWI trigger and passed to the callback function as an argument.
+ */
+typedef uint16_t nrfx_swi_flags_t;
+
+/** @brief Unallocated instance value. */
+#define NRFX_SWI_UNALLOCATED  ((nrfx_swi_t)0xFFuL)
+
+/** @brief Default SWI priority. */
+#define NRFX_SWI_DEFAULT_PRIORITY  APP_IRQ_PRIORITY_LOWEST
+
+/**
+ * @brief SWI handler function.
+ *
+ * @param swi   SWI instance.
+ * @param flags User flags.
+ */
+typedef void (*nrfx_swi_handler_t)(nrfx_swi_t swi, nrfx_swi_flags_t flags);
+
+
+/**
+ * @brief Function for allocating the first unused SWI instance and setting a handler.
+ *
+ * If provided handler is not NULL, an allocated SWI has its interrupt enabled by default.
+ * The interrupt can be disabled by @ref nrfx_swi_int_disable.
+ *
+ * @param[out] p_swi          Points to a place where the allocated SWI instance
+ *                            number is to be stored.
+ * @param[in]  event_handler  Event handler function.
+ *                            If NULL, no interrupt will be enabled.
+ *                            It can be NULL only if the EGU driver is enabled.
+ *                            For classic SWI, it must be a valid handler pointer.
+ * @param[in]  irq_priority   Interrupt priority.
+ *
+ * @retval NRFX_SUCCESS       If the SWI was successfully allocated.
+ * @retval NRFX_ERROR_NO_MEM  If there is no available SWI to be used.
+ */
+nrfx_err_t nrfx_swi_alloc(nrfx_swi_t *       p_swi,
+                          nrfx_swi_handler_t event_handler,
+                          uint32_t           irq_priority);
+
+/**
+ * @brief Function for disabling an allocated SWI interrupt.
+ *
+ * Use @ref nrfx_swi_int_enable to re-enable the interrupt.
+ *
+ * @param[in] swi  SWI instance.
+ */
+void nrfx_swi_int_disable(nrfx_swi_t swi);
+
+/**
+ * @brief Function for enabling an allocated SWI interrupt.
+ *
+ * @param[in] swi  SWI instance.
+ */
+void nrfx_swi_int_enable(nrfx_swi_t swi);
+
+/**
+ * @brief Function for freeing a previously allocated SWI.
+ *
+ * @param[in,out] p_swi  SWI instance to free. The value is changed to
+ *                       @ref NRFX_SWI_UNALLOCATED on success.
+ */
+void nrfx_swi_free(nrfx_swi_t * p_swi);
+
+/** @brief Function for freeing all allocated SWIs. */
+void nrfx_swi_all_free(void);
+
+/**
+ * @brief Function for triggering the SWI.
+ *
+ * @param[in] swi          SWI to trigger.
+ * @param[in] flag_number  Number of user flag to trigger.
+ */
+void nrfx_swi_trigger(nrfx_swi_t swi,
+                      uint8_t    flag_number);
+
+/**
+ * @brief Function for checking if the specified SWI is currently allocated.
+ *
+ * @param[in] swi  SWI instance.
+ *
+ * @retval true  If the SWI instance is allocated.
+ * @retval false Otherwise.
+ */
+bool nrfx_swi_is_allocated(nrfx_swi_t swi);
+
+#if NRFX_CHECK(NRFX_EGU_ENABLED) || defined(__NRFX_DOXYGEN__)
+
+/**
+ * @brief Function for returning the base address of the EGU peripheral
+ *        associated with the specified SWI instance.
+ *
+ * @param[in] swi  SWI instance.
+ *
+ * @returns EGU base address or NULL if the specified SWI instance number
+ *          is too high.
+ */
+__STATIC_INLINE NRF_EGU_Type * nrfx_swi_egu_instance_get(nrfx_swi_t swi)
+{
+#if (EGU_COUNT < SWI_COUNT)
+    if (swi >= EGU_COUNT)
+    {
+        return NULL;
+    }
+#endif
+    uint32_t offset = ((uint32_t)swi) * ((uint32_t)NRF_EGU1 - (uint32_t)NRF_EGU0);
+    return (NRF_EGU_Type *)((uint32_t)NRF_EGU0 + offset);
+}
+
+/**
+ * @brief Function for returning the EGU trigger task address.
+ *
+ * @param[in] swi      SWI instance.
+ * @param[in] channel  Number of the EGU channel.
+ *
+ * @returns Address of EGU trigger task.
+ */
+__STATIC_INLINE uint32_t nrfx_swi_task_trigger_address_get(nrfx_swi_t swi,
+                                                           uint8_t    channel)
+{
+    NRFX_ASSERT(nrfx_swi_is_allocated(swi));
+
+    NRF_EGU_Type * p_egu = nrfx_swi_egu_instance_get(swi);
+#if (EGU_COUNT < SWI_COUNT)
+    if (p_egu == NULL)
+    {
+        return 0;
+    }
+#endif
+
+    return (uint32_t)nrf_egu_task_trigger_address_get(p_egu, channel);
+}
+
+/**
+ * @brief Function for returning the EGU triggered event address.
+ *
+ * @param[in] swi      SWI instance.
+ * @param[in] channel  Number of the EGU channel.
+ *
+ * @returns Address of EGU triggered event.
+ */
+__STATIC_INLINE uint32_t nrfx_swi_event_triggered_address_get(nrfx_swi_t swi,
+                                                              uint8_t    channel)
+{
+    NRFX_ASSERT(nrfx_swi_is_allocated(swi));
+
+    NRF_EGU_Type * p_egu = nrfx_swi_egu_instance_get(swi);
+#if (EGU_COUNT < SWI_COUNT)
+    if (p_egu == NULL)
+    {
+        return 0;
+    }
+#endif
+
+    return (uint32_t)nrf_egu_event_triggered_address_get(p_egu, channel);
+}
+
+#endif // NRFX_CHECK(NRFX_EGU_ENABLED) || defined(__NRFX_DOXYGEN__)
+
+
+void nrfx_swi_0_irq_handler(void);
+void nrfx_swi_1_irq_handler(void);
+void nrfx_swi_2_irq_handler(void);
+void nrfx_swi_3_irq_handler(void);
+void nrfx_swi_4_irq_handler(void);
+void nrfx_swi_5_irq_handler(void);
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_SWI_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_systick.h

@@ -1,135 +1,126 @@
-/**
- * Copyright (c) 2016 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_SYSTICK_H__
-#define NRFX_SYSTICK_H__
-
-#include <nrfx.h>
-#include <hal/nrf_systick.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_systick ARM(R) SysTick driver
- * @{
- * @ingroup nrf_systick
- *
- * @brief   ARM(R) SysTick driver.
- *
- * This driver configures ARM(R) SysTick as a free-running timer.
- * This timer is used to generate delays and pool for timeouts.
- * Only relatively short timeouts are supported.
- * The SysTick works on 64MHz and is 24-bits wide.
- * It means that it overflows around 4 times per second and around 250&nbsp;ms
- * would be the highest supported time in the library.
- * But it would be really hard to detect if overflow was generated without
- * using interrupts. For safety we would limit the maximum delay range by half.
- */
-
-/**
- * @brief The value type that holds the SysTick state
- *
- * This variable is used to count the requested timeout.
- * @sa nrfx_systick_get
- */
-typedef struct {
-    uint32_t time; //!< Registered time value
-} nrfx_systick_state_t;
-
-/**
- * @brief Configure and start the timer
- *
- * Function configures SysTick as a free-running timer without interrupt.
- */
-void nrfx_systick_init(void);
-
-/**
- * @brief Get current SysTick state
- *
- * Function gets current state of the SysTick timer.
- * It can be used to check time-out by @ref nrfx_systick_test.
- *
- * @param[out] p_state The pointer to the state variable to be filled
- */
-void nrfx_systick_get(nrfx_systick_state_t * p_state);
-
-/**
- * @brief Test if specified time is up in relation to remembered state
- *
- * @param[in] p_state Remembered state set by @ref nrfx_systick_get
- * @param[in] us      Required time-out.
- *
- * @retval true  If current time is higher than specified state plus given time-out.
- * @retval false If current time is lower than specified state plus given time-out
- */
-bool nrfx_systick_test(nrfx_systick_state_t const * p_state, uint32_t us);
-
-/**
- * @brief Blocking delay in CPU ticks
- *
- * @param[in] ticks Number of CPU ticks to delay.
- */
-void nrfx_systick_delay_ticks(uint32_t ticks);
-
-/**
- * @brief Blocking delay in us
- *
- * @param[in] us Number of microseconds to delay.
- */
-void nrfx_systick_delay_us(uint32_t us);
-
-/**
- * @brief Blocking delay in ms
- *
- * This delay function removes the limits of the highest possible delay value.
- *
- * @param[in] ms Number of milliseconds to delay.
- */
-void nrfx_systick_delay_ms(uint32_t ms);
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* NRFX_SYSTICK_H__ */
+/*
+ * Copyright (c) 2016 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_SYSTICK_H__
+#define NRFX_SYSTICK_H__
+
+#include <nrfx.h>
+#include <hal/nrf_systick.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_systick ARM(R) SysTick driver
+ * @{
+ * @ingroup nrf_systick
+ *
+ * @brief   ARM(R) SysTick driver.
+ *
+ * This driver configures ARM(R) SysTick as a free-running timer.
+ * This timer is used to generate delays and pool for timeouts.
+ * Only relatively short timeouts are supported.
+ * The SysTick works on 64MHz and is 24-bits wide.
+ * It means that it overflows around 4 times per second and around 250&nbsp;ms
+ * would be the highest supported time in the library.
+ * But it would be really hard to detect if overflow was generated without
+ * using interrupts. For safety we would limit the maximum delay range by half.
+ */
+
+/**
+ * @brief The value type that holds the SysTick state
+ *
+ * This variable is used to count the requested timeout.
+ * @sa nrfx_systick_get
+ */
+typedef struct {
+    uint32_t time; //!< Registered time value
+} nrfx_systick_state_t;
+
+/**
+ * @brief Configure and start the timer
+ *
+ * Function configures SysTick as a free-running timer without interrupt.
+ */
+void nrfx_systick_init(void);
+
+/**
+ * @brief Get current SysTick state
+ *
+ * Function gets current state of the SysTick timer.
+ * It can be used to check time-out by @ref nrfx_systick_test.
+ *
+ * @param[out] p_state The pointer to the state variable to be filled
+ */
+void nrfx_systick_get(nrfx_systick_state_t * p_state);
+
+/**
+ * @brief Test if specified time is up in relation to remembered state
+ *
+ * @param[in] p_state Remembered state set by @ref nrfx_systick_get
+ * @param[in] us      Required time-out.
+ *
+ * @retval true  If current time is higher than specified state plus given time-out.
+ * @retval false If current time is lower than specified state plus given time-out
+ */
+bool nrfx_systick_test(nrfx_systick_state_t const * p_state, uint32_t us);
+
+/**
+ * @brief Blocking delay in CPU ticks
+ *
+ * @param[in] ticks Number of CPU ticks to delay.
+ */
+void nrfx_systick_delay_ticks(uint32_t ticks);
+
+/**
+ * @brief Blocking delay in us
+ *
+ * @param[in] us Number of microseconds to delay.
+ */
+void nrfx_systick_delay_us(uint32_t us);
+
+/**
+ * @brief Blocking delay in ms
+ *
+ * This delay function removes the limits of the highest possible delay value.
+ *
+ * @param[in] ms Number of milliseconds to delay.
+ */
+void nrfx_systick_delay_ms(uint32_t ms);
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* NRFX_SYSTICK_H__ */

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_timer.h

@@ -1,413 +1,404 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_TIMER_H__
-#define NRFX_TIMER_H__
-
-#include <nrfx.h>
-#include <hal/nrf_timer.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_timer Timer driver
- * @{
- * @ingroup nrf_timer
- * @brief   TIMER peripheral driver.
- */
-
-/**
- * @brief Timer driver instance data structure.
- */
-typedef struct
-{
-    NRF_TIMER_Type * p_reg;            ///< Pointer to the structure with TIMER peripheral instance registers.
-    uint8_t          instance_id;      ///< Driver instance index.
-    uint8_t          cc_channel_count; ///< Number of capture/compare channels.
-} nrfx_timer_t;
-
-/**
- * @brief Macro for creating a timer driver instance.
- */
-#define NRFX_TIMER_INSTANCE(id)                                   \
-{                                                                 \
-    .p_reg            = NRFX_CONCAT_2(NRF_TIMER, id),             \
-    .instance_id      = NRFX_CONCAT_3(NRFX_TIMER, id, _INST_IDX), \
-    .cc_channel_count = NRF_TIMER_CC_CHANNEL_COUNT(id),           \
-}
-
-enum {
-#if NRFX_CHECK(NRFX_TIMER0_ENABLED)
-    NRFX_TIMER0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_TIMER1_ENABLED)
-    NRFX_TIMER1_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_TIMER2_ENABLED)
-    NRFX_TIMER2_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_TIMER3_ENABLED)
-    NRFX_TIMER3_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_TIMER4_ENABLED)
-    NRFX_TIMER4_INST_IDX,
-#endif
-    NRFX_TIMER_ENABLED_COUNT
-};
-
-/**
- * @brief Timer driver instance configuration structure.
- */
-typedef struct
-{
-    nrf_timer_frequency_t frequency;          ///< Frequency.
-    nrf_timer_mode_t      mode;               ///< Mode of operation.
-    nrf_timer_bit_width_t bit_width;          ///< Bit width.
-    uint8_t               interrupt_priority; ///< Interrupt priority.
-    void *                p_context;          ///< Context passed to interrupt handler.
-} nrfx_timer_config_t;
-
-/**
- * @brief Timer driver instance default configuration.
- */
-#define NRFX_TIMER_DEFAULT_CONFIG                                                    \
-{                                                                                    \
-    .frequency          = (nrf_timer_frequency_t)NRFX_TIMER_DEFAULT_CONFIG_FREQUENCY,\
-    .mode               = (nrf_timer_mode_t)NRFX_TIMER_DEFAULT_CONFIG_MODE,          \
-    .bit_width          = (nrf_timer_bit_width_t)NRFX_TIMER_DEFAULT_CONFIG_BIT_WIDTH,\
-    .interrupt_priority = NRFX_TIMER_DEFAULT_CONFIG_IRQ_PRIORITY,                    \
-    .p_context          = NULL                                                       \
-}
-
-/**
- * @brief Timer driver event handler type.
- *
- * @param[in] event_type Timer event.
- * @param[in] p_context  General purpose parameter set during initialization of
- *                       the timer. This parameter can be used to pass
- *                       additional information to the handler function, for
- *                       example, the timer ID.
- */
-typedef void (* nrfx_timer_event_handler_t)(nrf_timer_event_t event_type,
-                                            void            * p_context);
-
-/**
- * @brief Function for initializing the timer.
- *
- * @param[in] p_instance          Pointer to the driver instance structure.
- * @param[in] p_config            Pointer to the structure with initial configuration.
- * @param[in] timer_event_handler Event handler provided by the user.
- *                                Must not be NULL.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the instance is already initialized.
- */
-nrfx_err_t nrfx_timer_init(nrfx_timer_t const * const  p_instance,
-                           nrfx_timer_config_t const * p_config,
-                           nrfx_timer_event_handler_t  timer_event_handler);
-
-/**
- * @brief Function for uninitializing the timer.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_timer_uninit(nrfx_timer_t const * const p_instance);
-
-/**
- * @brief Function for turning on the timer.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_timer_enable(nrfx_timer_t const * const p_instance);
-
-/**
- * @brief Function for turning off the timer.
- *
- * Note that the timer will allow to enter the lowest possible SYSTEM_ON state
- * only after this function is called.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_timer_disable(nrfx_timer_t const * const p_instance);
-
-/**
- * @brief Function for checking the timer state.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @return True if timer is enabled, false otherwise.
- */
-bool nrfx_timer_is_enabled(nrfx_timer_t const * const p_instance);
-
-/**
- * @brief Function for pausing the timer.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_timer_pause(nrfx_timer_t const * const p_instance);
-
-/**
- * @brief Function for resuming the timer.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_timer_resume(nrfx_timer_t const * const p_instance);
-
-/**
- * @brief Function for clearing the timer.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_timer_clear(nrfx_timer_t const * const p_instance);
-
-/**
- * @brief Function for incrementing the timer.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_timer_increment(nrfx_timer_t const * const p_instance);
-
-/**
- * @brief Function for returning the address of a specific timer task.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] timer_task Timer task.
- *
- * @return Task address.
- */
-__STATIC_INLINE uint32_t nrfx_timer_task_address_get(nrfx_timer_t const * const p_instance,
-                                                     nrf_timer_task_t           timer_task);
-
-/**
- * @brief Function for returning the address of a specific timer capture task.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] channel    Capture channel number.
- *
- * @return Task address.
- */
-__STATIC_INLINE uint32_t nrfx_timer_capture_task_address_get(nrfx_timer_t const * const p_instance,
-                                                             uint32_t                   channel);
-
-/**
- * @brief Function for returning the address of a specific timer event.
- *
- * @param[in] p_instance  Pointer to the driver instance structure.
- * @param[in] timer_event Timer event.
- *
- * @return Event address.
- */
-__STATIC_INLINE uint32_t nrfx_timer_event_address_get(nrfx_timer_t const * const p_instance,
-                                                      nrf_timer_event_t          timer_event);
-
-/**
- * @brief Function for returning the address of a specific timer compare event.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] channel    Compare channel number.
- *
- * @return Event address.
- */
-__STATIC_INLINE uint32_t nrfx_timer_compare_event_address_get(nrfx_timer_t const * const p_instance,
-                                                              uint32_t                   channel);
-
-/**
- * @brief Function for capturing the timer value.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] cc_channel Capture channel number.
- *
- * @return Captured value.
- */
-uint32_t nrfx_timer_capture(nrfx_timer_t const * const p_instance,
-                            nrf_timer_cc_channel_t     cc_channel);
-
-/**
- * @brief Function for returning the capture value from a specific channel.
- *
- * Use this function to read channel values when PPI is used for capturing.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] cc_channel Capture channel number.
- *
- * @return Captured value.
- */
-__STATIC_INLINE uint32_t nrfx_timer_capture_get(nrfx_timer_t const * const p_instance,
-                                                nrf_timer_cc_channel_t     cc_channel);
-
-/**
- * @brief Function for setting the timer channel in compare mode.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] cc_channel Compare channel number.
- * @param[in] cc_value   Compare value.
- * @param[in] enable_int Enable or disable the interrupt for the compare channel.
- */
-void nrfx_timer_compare(nrfx_timer_t const * const p_instance,
-                        nrf_timer_cc_channel_t     cc_channel,
-                        uint32_t                   cc_value,
-                        bool                       enable_int);
-
-/**
- * @brief Function for setting the timer channel in extended compare mode.
- *
- * @param[in] p_instance       Pointer to the driver instance structure.
- * @param[in] cc_channel       Compare channel number.
- * @param[in] cc_value         Compare value.
- * @param[in] timer_short_mask Shortcut between the compare event on the channel
- *                             and the timer task (STOP or CLEAR).
- * @param[in] enable_int       Enable or disable the interrupt for the compare
- *                             channel.
- */
-void nrfx_timer_extended_compare(nrfx_timer_t const * const p_instance,
-                                 nrf_timer_cc_channel_t     cc_channel,
-                                 uint32_t                   cc_value,
-                                 nrf_timer_short_mask_t     timer_short_mask,
-                                 bool                       enable_int);
-
-/**
- * @brief Function for converting time in microseconds to timer ticks.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] time_us    Time in microseconds.
- *
- * @return Number of ticks.
- */
-__STATIC_INLINE uint32_t nrfx_timer_us_to_ticks(nrfx_timer_t const * const p_instance,
-                                                uint32_t                   time_us);
-
-/**
- * @brief Function for converting time in milliseconds to timer ticks.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] time_ms    Time in milliseconds.
- *
- * @return Number of ticks.
- */
-__STATIC_INLINE uint32_t nrfx_timer_ms_to_ticks(nrfx_timer_t const * const p_instance,
-                                                uint32_t                   time_ms);
-
-/**
- * @brief Function for enabling timer compare interrupt.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] channel    Compare channel.
- */
-void nrfx_timer_compare_int_enable(nrfx_timer_t const * const p_instance,
-                                   uint32_t                   channel);
-
-/**
- * @brief Function for disabling timer compare interrupt.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] channel    Compare channel.
- */
-void nrfx_timer_compare_int_disable(nrfx_timer_t const * const p_instance,
-                                    uint32_t                   channel);
-
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-
-__STATIC_INLINE uint32_t nrfx_timer_task_address_get(nrfx_timer_t const * const p_instance,
-                                                     nrf_timer_task_t           timer_task)
-{
-    return (uint32_t)nrf_timer_task_address_get(p_instance->p_reg, timer_task);
-}
-
-__STATIC_INLINE uint32_t nrfx_timer_capture_task_address_get(nrfx_timer_t const * const p_instance,
-                                                             uint32_t                   channel)
-{
-    NRFX_ASSERT(channel < p_instance->cc_channel_count);
-    return (uint32_t)nrf_timer_task_address_get(p_instance->p_reg,
-                         nrf_timer_capture_task_get(channel));
-}
-
-__STATIC_INLINE uint32_t nrfx_timer_event_address_get(nrfx_timer_t const * const p_instance,
-                                                      nrf_timer_event_t          timer_event)
-{
-    return (uint32_t)nrf_timer_event_address_get(p_instance->p_reg, timer_event);
-}
-
-__STATIC_INLINE uint32_t nrfx_timer_compare_event_address_get(nrfx_timer_t const * const p_instance,
-                                                              uint32_t                   channel)
-{
-    NRFX_ASSERT(channel < p_instance->cc_channel_count);
-    return (uint32_t)nrf_timer_event_address_get(p_instance->p_reg,
-                         nrf_timer_compare_event_get(channel));
-}
-
-__STATIC_INLINE uint32_t nrfx_timer_capture_get(nrfx_timer_t const * const p_instance,
-                                                nrf_timer_cc_channel_t     cc_channel)
-{
-    return nrf_timer_cc_read(p_instance->p_reg, cc_channel);
-}
-
-__STATIC_INLINE uint32_t nrfx_timer_us_to_ticks(nrfx_timer_t const * const p_instance,
-                                                uint32_t                   timer_us)
-{
-    return nrf_timer_us_to_ticks(timer_us, nrf_timer_frequency_get(p_instance->p_reg));
-}
-
-__STATIC_INLINE uint32_t nrfx_timer_ms_to_ticks(nrfx_timer_t const * const p_instance,
-                                                uint32_t                   timer_ms)
-{
-    return nrf_timer_ms_to_ticks(timer_ms, nrf_timer_frequency_get(p_instance->p_reg));
-}
-
-#endif // SUPPRESS_INLINE_IMPLEMENTATION
-
-
-void nrfx_timer_0_irq_handler(void);
-void nrfx_timer_1_irq_handler(void);
-void nrfx_timer_2_irq_handler(void);
-void nrfx_timer_3_irq_handler(void);
-void nrfx_timer_4_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_TIMER_H__
-
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_TIMER_H__
+#define NRFX_TIMER_H__
+
+#include <nrfx.h>
+#include <hal/nrf_timer.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_timer Timer driver
+ * @{
+ * @ingroup nrf_timer
+ * @brief   TIMER peripheral driver.
+ */
+
+/**
+ * @brief Timer driver instance data structure.
+ */
+typedef struct
+{
+    NRF_TIMER_Type * p_reg;            ///< Pointer to the structure with TIMER peripheral instance registers.
+    uint8_t          instance_id;      ///< Driver instance index.
+    uint8_t          cc_channel_count; ///< Number of capture/compare channels.
+} nrfx_timer_t;
+
+/**
+ * @brief Macro for creating a timer driver instance.
+ */
+#define NRFX_TIMER_INSTANCE(id)                                   \
+{                                                                 \
+    .p_reg            = NRFX_CONCAT_2(NRF_TIMER, id),             \
+    .instance_id      = NRFX_CONCAT_3(NRFX_TIMER, id, _INST_IDX), \
+    .cc_channel_count = NRF_TIMER_CC_CHANNEL_COUNT(id),           \
+}
+
+enum {
+#if NRFX_CHECK(NRFX_TIMER0_ENABLED)
+    NRFX_TIMER0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TIMER1_ENABLED)
+    NRFX_TIMER1_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TIMER2_ENABLED)
+    NRFX_TIMER2_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TIMER3_ENABLED)
+    NRFX_TIMER3_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TIMER4_ENABLED)
+    NRFX_TIMER4_INST_IDX,
+#endif
+    NRFX_TIMER_ENABLED_COUNT
+};
+
+/**
+ * @brief Timer driver instance configuration structure.
+ */
+typedef struct
+{
+    nrf_timer_frequency_t frequency;          ///< Frequency.
+    nrf_timer_mode_t      mode;               ///< Mode of operation.
+    nrf_timer_bit_width_t bit_width;          ///< Bit width.
+    uint8_t               interrupt_priority; ///< Interrupt priority.
+    void *                p_context;          ///< Context passed to interrupt handler.
+} nrfx_timer_config_t;
+
+/**
+ * @brief Timer driver instance default configuration.
+ */
+#define NRFX_TIMER_DEFAULT_CONFIG                                                    \
+{                                                                                    \
+    .frequency          = (nrf_timer_frequency_t)NRFX_TIMER_DEFAULT_CONFIG_FREQUENCY,\
+    .mode               = (nrf_timer_mode_t)NRFX_TIMER_DEFAULT_CONFIG_MODE,          \
+    .bit_width          = (nrf_timer_bit_width_t)NRFX_TIMER_DEFAULT_CONFIG_BIT_WIDTH,\
+    .interrupt_priority = NRFX_TIMER_DEFAULT_CONFIG_IRQ_PRIORITY,                    \
+    .p_context          = NULL                                                       \
+}
+
+/**
+ * @brief Timer driver event handler type.
+ *
+ * @param[in] event_type Timer event.
+ * @param[in] p_context  General purpose parameter set during initialization of
+ *                       the timer. This parameter can be used to pass
+ *                       additional information to the handler function, for
+ *                       example, the timer ID.
+ */
+typedef void (* nrfx_timer_event_handler_t)(nrf_timer_event_t event_type,
+                                            void            * p_context);
+
+/**
+ * @brief Function for initializing the timer.
+ *
+ * @param[in] p_instance          Pointer to the driver instance structure.
+ * @param[in] p_config            Pointer to the structure with initial configuration.
+ * @param[in] timer_event_handler Event handler provided by the user.
+ *                                Must not be NULL.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the instance is already initialized.
+ */
+nrfx_err_t nrfx_timer_init(nrfx_timer_t const * const  p_instance,
+                           nrfx_timer_config_t const * p_config,
+                           nrfx_timer_event_handler_t  timer_event_handler);
+
+/**
+ * @brief Function for uninitializing the timer.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_timer_uninit(nrfx_timer_t const * const p_instance);
+
+/**
+ * @brief Function for turning on the timer.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_timer_enable(nrfx_timer_t const * const p_instance);
+
+/**
+ * @brief Function for turning off the timer.
+ *
+ * Note that the timer will allow to enter the lowest possible SYSTEM_ON state
+ * only after this function is called.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_timer_disable(nrfx_timer_t const * const p_instance);
+
+/**
+ * @brief Function for checking the timer state.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @return True if timer is enabled, false otherwise.
+ */
+bool nrfx_timer_is_enabled(nrfx_timer_t const * const p_instance);
+
+/**
+ * @brief Function for pausing the timer.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_timer_pause(nrfx_timer_t const * const p_instance);
+
+/**
+ * @brief Function for resuming the timer.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_timer_resume(nrfx_timer_t const * const p_instance);
+
+/**
+ * @brief Function for clearing the timer.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_timer_clear(nrfx_timer_t const * const p_instance);
+
+/**
+ * @brief Function for incrementing the timer.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_timer_increment(nrfx_timer_t const * const p_instance);
+
+/**
+ * @brief Function for returning the address of a specific timer task.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] timer_task Timer task.
+ *
+ * @return Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_timer_task_address_get(nrfx_timer_t const * const p_instance,
+                                                     nrf_timer_task_t           timer_task);
+
+/**
+ * @brief Function for returning the address of a specific timer capture task.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] channel    Capture channel number.
+ *
+ * @return Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_timer_capture_task_address_get(nrfx_timer_t const * const p_instance,
+                                                             uint32_t                   channel);
+
+/**
+ * @brief Function for returning the address of a specific timer event.
+ *
+ * @param[in] p_instance  Pointer to the driver instance structure.
+ * @param[in] timer_event Timer event.
+ *
+ * @return Event address.
+ */
+__STATIC_INLINE uint32_t nrfx_timer_event_address_get(nrfx_timer_t const * const p_instance,
+                                                      nrf_timer_event_t          timer_event);
+
+/**
+ * @brief Function for returning the address of a specific timer compare event.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] channel    Compare channel number.
+ *
+ * @return Event address.
+ */
+__STATIC_INLINE uint32_t nrfx_timer_compare_event_address_get(nrfx_timer_t const * const p_instance,
+                                                              uint32_t                   channel);
+
+/**
+ * @brief Function for capturing the timer value.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] cc_channel Capture channel number.
+ *
+ * @return Captured value.
+ */
+uint32_t nrfx_timer_capture(nrfx_timer_t const * const p_instance,
+                            nrf_timer_cc_channel_t     cc_channel);
+
+/**
+ * @brief Function for returning the capture value from a specific channel.
+ *
+ * Use this function to read channel values when PPI is used for capturing.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] cc_channel Capture channel number.
+ *
+ * @return Captured value.
+ */
+__STATIC_INLINE uint32_t nrfx_timer_capture_get(nrfx_timer_t const * const p_instance,
+                                                nrf_timer_cc_channel_t     cc_channel);
+
+/**
+ * @brief Function for setting the timer channel in compare mode.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] cc_channel Compare channel number.
+ * @param[in] cc_value   Compare value.
+ * @param[in] enable_int Enable or disable the interrupt for the compare channel.
+ */
+void nrfx_timer_compare(nrfx_timer_t const * const p_instance,
+                        nrf_timer_cc_channel_t     cc_channel,
+                        uint32_t                   cc_value,
+                        bool                       enable_int);
+
+/**
+ * @brief Function for setting the timer channel in extended compare mode.
+ *
+ * @param[in] p_instance       Pointer to the driver instance structure.
+ * @param[in] cc_channel       Compare channel number.
+ * @param[in] cc_value         Compare value.
+ * @param[in] timer_short_mask Shortcut between the compare event on the channel
+ *                             and the timer task (STOP or CLEAR).
+ * @param[in] enable_int       Enable or disable the interrupt for the compare
+ *                             channel.
+ */
+void nrfx_timer_extended_compare(nrfx_timer_t const * const p_instance,
+                                 nrf_timer_cc_channel_t     cc_channel,
+                                 uint32_t                   cc_value,
+                                 nrf_timer_short_mask_t     timer_short_mask,
+                                 bool                       enable_int);
+
+/**
+ * @brief Function for converting time in microseconds to timer ticks.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] time_us    Time in microseconds.
+ *
+ * @return Number of ticks.
+ */
+__STATIC_INLINE uint32_t nrfx_timer_us_to_ticks(nrfx_timer_t const * const p_instance,
+                                                uint32_t                   time_us);
+
+/**
+ * @brief Function for converting time in milliseconds to timer ticks.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] time_ms    Time in milliseconds.
+ *
+ * @return Number of ticks.
+ */
+__STATIC_INLINE uint32_t nrfx_timer_ms_to_ticks(nrfx_timer_t const * const p_instance,
+                                                uint32_t                   time_ms);
+
+/**
+ * @brief Function for enabling timer compare interrupt.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] channel    Compare channel.
+ */
+void nrfx_timer_compare_int_enable(nrfx_timer_t const * const p_instance,
+                                   uint32_t                   channel);
+
+/**
+ * @brief Function for disabling timer compare interrupt.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] channel    Compare channel.
+ */
+void nrfx_timer_compare_int_disable(nrfx_timer_t const * const p_instance,
+                                    uint32_t                   channel);
+
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+
+__STATIC_INLINE uint32_t nrfx_timer_task_address_get(nrfx_timer_t const * const p_instance,
+                                                     nrf_timer_task_t           timer_task)
+{
+    return (uint32_t)nrf_timer_task_address_get(p_instance->p_reg, timer_task);
+}
+
+__STATIC_INLINE uint32_t nrfx_timer_capture_task_address_get(nrfx_timer_t const * const p_instance,
+                                                             uint32_t                   channel)
+{
+    NRFX_ASSERT(channel < p_instance->cc_channel_count);
+    return (uint32_t)nrf_timer_task_address_get(p_instance->p_reg,
+                         nrf_timer_capture_task_get(channel));
+}
+
+__STATIC_INLINE uint32_t nrfx_timer_event_address_get(nrfx_timer_t const * const p_instance,
+                                                      nrf_timer_event_t          timer_event)
+{
+    return (uint32_t)nrf_timer_event_address_get(p_instance->p_reg, timer_event);
+}
+
+__STATIC_INLINE uint32_t nrfx_timer_compare_event_address_get(nrfx_timer_t const * const p_instance,
+                                                              uint32_t                   channel)
+{
+    NRFX_ASSERT(channel < p_instance->cc_channel_count);
+    return (uint32_t)nrf_timer_event_address_get(p_instance->p_reg,
+                         nrf_timer_compare_event_get(channel));
+}
+
+__STATIC_INLINE uint32_t nrfx_timer_capture_get(nrfx_timer_t const * const p_instance,
+                                                nrf_timer_cc_channel_t     cc_channel)
+{
+    return nrf_timer_cc_read(p_instance->p_reg, cc_channel);
+}
+
+__STATIC_INLINE uint32_t nrfx_timer_us_to_ticks(nrfx_timer_t const * const p_instance,
+                                                uint32_t                   timer_us)
+{
+    return nrf_timer_us_to_ticks(timer_us, nrf_timer_frequency_get(p_instance->p_reg));
+}
+
+__STATIC_INLINE uint32_t nrfx_timer_ms_to_ticks(nrfx_timer_t const * const p_instance,
+                                                uint32_t                   timer_ms)
+{
+    return nrf_timer_ms_to_ticks(timer_ms, nrf_timer_frequency_get(p_instance->p_reg));
+}
+
+#endif // SUPPRESS_INLINE_IMPLEMENTATION
+
+
+void nrfx_timer_0_irq_handler(void);
+void nrfx_timer_1_irq_handler(void);
+void nrfx_timer_2_irq_handler(void);
+void nrfx_timer_3_irq_handler(void);
+void nrfx_timer_4_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_TIMER_H__
+

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_twi.h

@@ -1,368 +1,359 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_TWI_H__
-#define NRFX_TWI_H__
-
-#include <nrfx.h>
-#include <hal/nrf_twi.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_twi TWI driver
- * @{
- * @ingroup nrf_twi
- * @brief   TWI peripheral driver.
- */
-
-/**
- * @brief Structure for the TWI master driver instance.
- */
-typedef struct
-{
-    NRF_TWI_Type * p_twi;        ///< Pointer to a structure with TWI registers.
-    uint8_t        drv_inst_idx; ///< Driver instance index.
-} nrfx_twi_t;
-
-/**
- * @brief Macro for creating a TWI master driver instance.
- */
-#define NRFX_TWI_INSTANCE(id)                               \
-{                                                           \
-    .p_twi        = NRFX_CONCAT_2(NRF_TWI, id),             \
-    .drv_inst_idx = NRFX_CONCAT_3(NRFX_TWI, id, _INST_IDX), \
-}
-
-enum {
-#if NRFX_CHECK(NRFX_TWI0_ENABLED)
-    NRFX_TWI0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_TWI1_ENABLED)
-    NRFX_TWI1_INST_IDX,
-#endif
-    NRFX_TWI_ENABLED_COUNT
-};
-
-/**
- * @brief Structure for the TWI master driver instance configuration.
- */
-typedef struct
-{
-    uint32_t            scl;                 ///< SCL pin number.
-    uint32_t            sda;                 ///< SDA pin number.
-    nrf_twi_frequency_t frequency;           ///< TWI frequency.
-    uint8_t             interrupt_priority;  ///< Interrupt priority.
-    bool                hold_bus_uninit;     ///< Hold pull up state on gpio pins after uninit.
-} nrfx_twi_config_t;
-
-/**
- * @brief TWI master driver instance default configuration.
- */
-#define NRFX_TWI_DEFAULT_CONFIG                                                   \
-{                                                                                 \
-    .frequency          = (nrf_twi_frequency_t)NRFX_TWI_DEFAULT_CONFIG_FREQUENCY, \
-    .scl                = 31,                                                     \
-    .sda                = 31,                                                     \
-    .interrupt_priority = NRFX_TWI_DEFAULT_CONFIG_IRQ_PRIORITY,                   \
-    .hold_bus_uninit    = NRFX_TWI_DEFAULT_CONFIG_HOLD_BUS_UNINIT,                \
-}
-
-#define NRFX_TWI_FLAG_NO_XFER_EVT_HANDLER (1UL << 2) /**< Interrupt after each transfer is suppressed, and the event handler is not called. */
-#define NRFX_TWI_FLAG_TX_NO_STOP          (1UL << 5) /**< Flag indicating that the TX transfer will not end with a stop condition. */
-
-/**
- * @brief TWI master driver event types.
- */
-typedef enum
-{
-    NRFX_TWI_EVT_DONE,         ///< Transfer completed event.
-    NRFX_TWI_EVT_ADDRESS_NACK, ///< Error event: NACK received after sending the address.
-    NRFX_TWI_EVT_DATA_NACK     ///< Error event: NACK received after sending a data byte.
-} nrfx_twi_evt_type_t;
-
-/**
- * @brief TWI master driver transfer types.
- */
-typedef enum
-{
-    NRFX_TWI_XFER_TX,          ///< TX transfer.
-    NRFX_TWI_XFER_RX,          ///< RX transfer.
-    NRFX_TWI_XFER_TXRX,        ///< TX transfer followed by RX transfer with repeated start.
-    NRFX_TWI_XFER_TXTX         ///< TX transfer followed by TX transfer with repeated start.
-} nrfx_twi_xfer_type_t;
-
-/**
- * @brief Structure for a TWI transfer descriptor.
- */
-typedef struct
-{
-    nrfx_twi_xfer_type_t    type;             ///< Type of transfer.
-    uint8_t                 address;          ///< Slave address.
-    size_t                  primary_length;   ///< Number of bytes transferred.
-    size_t                  secondary_length; ///< Number of bytes transferred.
-    uint8_t *               p_primary_buf;    ///< Pointer to transferred data.
-    uint8_t *               p_secondary_buf;  ///< Pointer to transferred data.
-} nrfx_twi_xfer_desc_t;
-
-
-/**@brief Macro for setting the TX transfer descriptor. */
-#define NRFX_TWI_XFER_DESC_TX(addr, p_data, length) \
-    {                                               \
-        .type = NRFX_TWI_XFER_TX,                   \
-        .address = addr,                            \
-        .primary_length = length,                   \
-        .p_primary_buf  = p_data,                   \
-    }
-
-/**@brief Macro for setting the RX transfer descriptor. */
-#define NRFX_TWI_XFER_DESC_RX(addr, p_data, length) \
-    {                                               \
-        .type = NRFX_TWI_XFER_RX,                   \
-        .address = addr,                            \
-        .primary_length = length,                   \
-        .p_primary_buf  = p_data,                   \
-    }
-
-/**@brief Macro for setting the TXRX transfer descriptor. */
-#define NRFX_TWI_XFER_DESC_TXRX(addr, p_tx, tx_len, p_rx, rx_len)   \
-    {                                                               \
-        .type = NRFX_TWI_XFER_TXRX,                                 \
-        .address = addr,                                            \
-        .primary_length   = tx_len,                                 \
-        .secondary_length = rx_len,                                 \
-        .p_primary_buf    = p_tx,                                   \
-        .p_secondary_buf  = p_rx,                                   \
-    }
-
-/**@brief Macro for setting the TXTX transfer descriptor. */
-#define NRFX_TWI_XFER_DESC_TXTX(addr, p_tx, tx_len, p_tx2, tx_len2) \
-    {                                                               \
-        .type = NRFX_TWI_XFER_TXTX,                                 \
-        .address = addr,                                            \
-        .primary_length   = tx_len,                                 \
-        .secondary_length = tx_len2,                                \
-        .p_primary_buf    = p_tx,                                   \
-        .p_secondary_buf  = p_tx2,                                  \
-    }
-
-/**
- * @brief Structure for a TWI event.
- */
-typedef struct
-{
-    nrfx_twi_evt_type_t  type;      ///< Event type.
-    nrfx_twi_xfer_desc_t xfer_desc; ///< Transfer details.
-} nrfx_twi_evt_t;
-
-/**
- * @brief TWI event handler prototype.
- */
-typedef void (* nrfx_twi_evt_handler_t)(nrfx_twi_evt_t const * p_event,
-                                        void *                 p_context);
-
-/**
- * @brief Function for initializing the TWI driver instance.
- *
- * @param[in] p_instance      Pointer to the driver instance structure.
- * @param[in] p_config        Pointer to the structure with initial configuration.
- * @param[in] event_handler   Event handler provided by the user. If NULL, blocking mode is enabled.
- * @param[in] p_context       Context passed to event handler.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver is in invalid state.
- * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
- *                                  instance ID is already in use. This is
- *                                  possible only if @ref nrfx_prs module
- *                                  is enabled.
- */
-nrfx_err_t nrfx_twi_init(nrfx_twi_t const *        p_instance,
-                         nrfx_twi_config_t const * p_config,
-                         nrfx_twi_evt_handler_t    event_handler,
-                         void *                    p_context);
-
-/**
- * @brief Function for uninitializing the TWI instance.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_twi_uninit(nrfx_twi_t const * p_instance);
-
-/**
- * @brief Function for enabling the TWI instance.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_twi_enable(nrfx_twi_t const * p_instance);
-
-/**
- * @brief Function for disabling the TWI instance.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_twi_disable(nrfx_twi_t const * p_instance);
-
-/**
- * @brief Function for sending data to a TWI slave.
- *
- * The transmission will be stopped when an error occurs. If a transfer is ongoing,
- * the function returns the error code @ref NRFX_ERROR_BUSY.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] address    Address of a specific slave device (only 7 LSB).
- * @param[in] p_data     Pointer to a transmit buffer.
- * @param[in] length     Number of bytes to send.
- * @param[in] no_stop    If set, the stop condition is not generated on the bus
- *                       after the transfer has completed successfully (allowing
- *                       for a repeated start in the next transfer).
- *
- * @retval NRFX_SUCCESS                  If the procedure was successful.
- * @retval NRFX_ERROR_BUSY               If the driver is not ready for a new transfer.
- * @retval NRFX_ERROR_INTERNAL           If an error was detected by hardware.
- * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK  If NACK received after sending the address in polling mode.
- * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK  If NACK received after sending a data byte in polling mode.
- */
-nrfx_err_t nrfx_twi_tx(nrfx_twi_t const * p_instance,
-                       uint8_t            address,
-                       uint8_t const *    p_data,
-                       size_t             length,
-                       bool               no_stop);
-
-/**
- * @brief Function for reading data from a TWI slave.
- *
- * The transmission will be stopped when an error occurs. If a transfer is ongoing,
- * the function returns the error code @ref NRFX_ERROR_BUSY.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] address    Address of a specific slave device (only 7 LSB).
- * @param[in] p_data     Pointer to a receive buffer.
- * @param[in] length     Number of bytes to be received.
- *
- * @retval NRFX_SUCCESS                    If the procedure was successful.
- * @retval NRFX_ERROR_BUSY                 If the driver is not ready for a new transfer.
- * @retval NRFX_ERROR_INTERNAL             If an error was detected by hardware.
- * @retval NRFX_ERROR_DRV_TWI_ERR_OVERRUN  If the unread data was replaced by new data
- * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK    If NACK received after sending the address in polling mode.
- * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK    If NACK received after sending a data byte in polling mode.
- */
-nrfx_err_t nrfx_twi_rx(nrfx_twi_t const * p_instance,
-                       uint8_t            address,
-                       uint8_t *          p_data,
-                       size_t             length);
-
-/**
- * @brief Function for preparing a TWI transfer.
- *
- * The following transfer types can be configured (@ref nrfx_twi_xfer_desc_t::type):
- * - @ref NRFX_TWI_XFER_TXRX<span></span>: Write operation followed by a read operation (without STOP condition in between).
- * - @ref NRFX_TWI_XFER_TXTX<span></span>: Write operation followed by a write operation (without STOP condition in between).
- * - @ref NRFX_TWI_XFER_TX<span></span>:   Write operation (with or without STOP condition).
- * - @ref NRFX_TWI_XFER_RX<span></span>:   Read operation  (with STOP condition).
- *
- * @note TXRX and TXTX transfers are supported only in non-blocking mode.
- *
- * Additional options are provided using the flags parameter:
- * - @ref NRFX_TWI_FLAG_NO_XFER_EVT_HANDLER<span></span>: No user event handler after transfer completion. In most cases, this also means no interrupt at the end of the transfer.
- * - @ref NRFX_TWI_FLAG_TX_NO_STOP<span></span>: No stop condition after TX transfer.
- *
- * @note
- * Some flag combinations are invalid:
- * - @ref NRFX_TWI_FLAG_TX_NO_STOP with @ref nrfx_twi_xfer_desc_t::type different than @ref NRFX_TWI_XFER_TX
- *
- * @param[in] p_instance        Pointer to the driver instance structure.
- * @param[in] p_xfer_desc       Pointer to the transfer descriptor.
- * @param[in] flags             Transfer options (0 for default settings).
- *
- * @retval NRFX_SUCCESS                    If the procedure was successful.
- * @retval NRFX_ERROR_BUSY                 If the driver is not ready for a new transfer.
- * @retval NRFX_ERROR_NOT_SUPPORTED        If the provided parameters are not supported.
- * @retval NRFX_ERROR_INTERNAL             If an error was detected by hardware.
- * @retval NRFX_ERROR_DRV_TWI_ERR_OVERRUN  If the unread data was replaced by new data (TXRX and RX)
- * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK    If NACK received after sending the address.
- * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK    If NACK received after sending a data byte.
- */
-nrfx_err_t nrfx_twi_xfer(nrfx_twi_t           const * p_instance,
-                         nrfx_twi_xfer_desc_t const * p_xfer_desc,
-                         uint32_t                     flags);
-
-/**
- * @brief Function for checking the TWI driver state.
- *
- * @param[in] p_instance TWI instance.
- *
- * @retval true  If the TWI driver is currently busy performing a transfer.
- * @retval false If the TWI driver is ready for a new transfer.
- */
-bool nrfx_twi_is_busy(nrfx_twi_t const * p_instance);
-
-/**
- * @brief Function for getting the transferred data count.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @return     Data count.
- */
-size_t nrfx_twi_data_count_get(nrfx_twi_t const * const p_instance);
-
-/**
- * @brief Function for returning the address of a STOPPED TWI event.
- *
- * A STOPPED event can be used to detect the end of a transfer if the @ref NRFX_TWI_FLAG_NO_XFER_EVT_HANDLER
- * option is used.
- *
- * @param[in]  p_instance Pointer to the driver instance structure.
- *
- * @return     STOPPED event address.
- */
-uint32_t nrfx_twi_stopped_event_get(nrfx_twi_t const * p_instance);
-
-void nrfx_twi_0_irq_handler(void);
-void nrfx_twi_1_irq_handler(void);
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_TWI_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_TWI_H__
+#define NRFX_TWI_H__
+
+#include <nrfx.h>
+#include <hal/nrf_twi.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_twi TWI driver
+ * @{
+ * @ingroup nrf_twi
+ * @brief   TWI peripheral driver.
+ */
+
+/**
+ * @brief Structure for the TWI master driver instance.
+ */
+typedef struct
+{
+    NRF_TWI_Type * p_twi;        ///< Pointer to a structure with TWI registers.
+    uint8_t        drv_inst_idx; ///< Driver instance index.
+} nrfx_twi_t;
+
+/**
+ * @brief Macro for creating a TWI master driver instance.
+ */
+#define NRFX_TWI_INSTANCE(id)                               \
+{                                                           \
+    .p_twi        = NRFX_CONCAT_2(NRF_TWI, id),             \
+    .drv_inst_idx = NRFX_CONCAT_3(NRFX_TWI, id, _INST_IDX), \
+}
+
+enum {
+#if NRFX_CHECK(NRFX_TWI0_ENABLED)
+    NRFX_TWI0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TWI1_ENABLED)
+    NRFX_TWI1_INST_IDX,
+#endif
+    NRFX_TWI_ENABLED_COUNT
+};
+
+/**
+ * @brief Structure for the TWI master driver instance configuration.
+ */
+typedef struct
+{
+    uint32_t            scl;                 ///< SCL pin number.
+    uint32_t            sda;                 ///< SDA pin number.
+    nrf_twi_frequency_t frequency;           ///< TWI frequency.
+    uint8_t             interrupt_priority;  ///< Interrupt priority.
+    bool                hold_bus_uninit;     ///< Hold pull up state on gpio pins after uninit.
+} nrfx_twi_config_t;
+
+/**
+ * @brief TWI master driver instance default configuration.
+ */
+#define NRFX_TWI_DEFAULT_CONFIG                                                   \
+{                                                                                 \
+    .frequency          = (nrf_twi_frequency_t)NRFX_TWI_DEFAULT_CONFIG_FREQUENCY, \
+    .scl                = 31,                                                     \
+    .sda                = 31,                                                     \
+    .interrupt_priority = NRFX_TWI_DEFAULT_CONFIG_IRQ_PRIORITY,                   \
+    .hold_bus_uninit    = NRFX_TWI_DEFAULT_CONFIG_HOLD_BUS_UNINIT,                \
+}
+
+#define NRFX_TWI_FLAG_NO_XFER_EVT_HANDLER (1UL << 2) /**< Interrupt after each transfer is suppressed, and the event handler is not called. */
+#define NRFX_TWI_FLAG_TX_NO_STOP          (1UL << 5) /**< Flag indicating that the TX transfer will not end with a stop condition. */
+
+/**
+ * @brief TWI master driver event types.
+ */
+typedef enum
+{
+    NRFX_TWI_EVT_DONE,         ///< Transfer completed event.
+    NRFX_TWI_EVT_ADDRESS_NACK, ///< Error event: NACK received after sending the address.
+    NRFX_TWI_EVT_DATA_NACK     ///< Error event: NACK received after sending a data byte.
+} nrfx_twi_evt_type_t;
+
+/**
+ * @brief TWI master driver transfer types.
+ */
+typedef enum
+{
+    NRFX_TWI_XFER_TX,          ///< TX transfer.
+    NRFX_TWI_XFER_RX,          ///< RX transfer.
+    NRFX_TWI_XFER_TXRX,        ///< TX transfer followed by RX transfer with repeated start.
+    NRFX_TWI_XFER_TXTX         ///< TX transfer followed by TX transfer with repeated start.
+} nrfx_twi_xfer_type_t;
+
+/**
+ * @brief Structure for a TWI transfer descriptor.
+ */
+typedef struct
+{
+    nrfx_twi_xfer_type_t    type;             ///< Type of transfer.
+    uint8_t                 address;          ///< Slave address.
+    size_t                  primary_length;   ///< Number of bytes transferred.
+    size_t                  secondary_length; ///< Number of bytes transferred.
+    uint8_t *               p_primary_buf;    ///< Pointer to transferred data.
+    uint8_t *               p_secondary_buf;  ///< Pointer to transferred data.
+} nrfx_twi_xfer_desc_t;
+
+
+/**@brief Macro for setting the TX transfer descriptor. */
+#define NRFX_TWI_XFER_DESC_TX(addr, p_data, length) \
+    {                                               \
+        .type = NRFX_TWI_XFER_TX,                   \
+        .address = addr,                            \
+        .primary_length = length,                   \
+        .p_primary_buf  = p_data,                   \
+    }
+
+/**@brief Macro for setting the RX transfer descriptor. */
+#define NRFX_TWI_XFER_DESC_RX(addr, p_data, length) \
+    {                                               \
+        .type = NRFX_TWI_XFER_RX,                   \
+        .address = addr,                            \
+        .primary_length = length,                   \
+        .p_primary_buf  = p_data,                   \
+    }
+
+/**@brief Macro for setting the TXRX transfer descriptor. */
+#define NRFX_TWI_XFER_DESC_TXRX(addr, p_tx, tx_len, p_rx, rx_len)   \
+    {                                                               \
+        .type = NRFX_TWI_XFER_TXRX,                                 \
+        .address = addr,                                            \
+        .primary_length   = tx_len,                                 \
+        .secondary_length = rx_len,                                 \
+        .p_primary_buf    = p_tx,                                   \
+        .p_secondary_buf  = p_rx,                                   \
+    }
+
+/**@brief Macro for setting the TXTX transfer descriptor. */
+#define NRFX_TWI_XFER_DESC_TXTX(addr, p_tx, tx_len, p_tx2, tx_len2) \
+    {                                                               \
+        .type = NRFX_TWI_XFER_TXTX,                                 \
+        .address = addr,                                            \
+        .primary_length   = tx_len,                                 \
+        .secondary_length = tx_len2,                                \
+        .p_primary_buf    = p_tx,                                   \
+        .p_secondary_buf  = p_tx2,                                  \
+    }
+
+/**
+ * @brief Structure for a TWI event.
+ */
+typedef struct
+{
+    nrfx_twi_evt_type_t  type;      ///< Event type.
+    nrfx_twi_xfer_desc_t xfer_desc; ///< Transfer details.
+} nrfx_twi_evt_t;
+
+/**
+ * @brief TWI event handler prototype.
+ */
+typedef void (* nrfx_twi_evt_handler_t)(nrfx_twi_evt_t const * p_event,
+                                        void *                 p_context);
+
+/**
+ * @brief Function for initializing the TWI driver instance.
+ *
+ * @param[in] p_instance      Pointer to the driver instance structure.
+ * @param[in] p_config        Pointer to the structure with initial configuration.
+ * @param[in] event_handler   Event handler provided by the user. If NULL, blocking mode is enabled.
+ * @param[in] p_context       Context passed to event handler.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver is in invalid state.
+ * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
+ *                                  instance ID is already in use. This is
+ *                                  possible only if @ref nrfx_prs module
+ *                                  is enabled.
+ */
+nrfx_err_t nrfx_twi_init(nrfx_twi_t const *        p_instance,
+                         nrfx_twi_config_t const * p_config,
+                         nrfx_twi_evt_handler_t    event_handler,
+                         void *                    p_context);
+
+/**
+ * @brief Function for uninitializing the TWI instance.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_twi_uninit(nrfx_twi_t const * p_instance);
+
+/**
+ * @brief Function for enabling the TWI instance.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_twi_enable(nrfx_twi_t const * p_instance);
+
+/**
+ * @brief Function for disabling the TWI instance.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_twi_disable(nrfx_twi_t const * p_instance);
+
+/**
+ * @brief Function for sending data to a TWI slave.
+ *
+ * The transmission will be stopped when an error occurs. If a transfer is ongoing,
+ * the function returns the error code @ref NRFX_ERROR_BUSY.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] address    Address of a specific slave device (only 7 LSB).
+ * @param[in] p_data     Pointer to a transmit buffer.
+ * @param[in] length     Number of bytes to send.
+ * @param[in] no_stop    If set, the stop condition is not generated on the bus
+ *                       after the transfer has completed successfully (allowing
+ *                       for a repeated start in the next transfer).
+ *
+ * @retval NRFX_SUCCESS                  If the procedure was successful.
+ * @retval NRFX_ERROR_BUSY               If the driver is not ready for a new transfer.
+ * @retval NRFX_ERROR_INTERNAL           If an error was detected by hardware.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK  If NACK received after sending the address in polling mode.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK  If NACK received after sending a data byte in polling mode.
+ */
+nrfx_err_t nrfx_twi_tx(nrfx_twi_t const * p_instance,
+                       uint8_t            address,
+                       uint8_t const *    p_data,
+                       size_t             length,
+                       bool               no_stop);
+
+/**
+ * @brief Function for reading data from a TWI slave.
+ *
+ * The transmission will be stopped when an error occurs. If a transfer is ongoing,
+ * the function returns the error code @ref NRFX_ERROR_BUSY.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] address    Address of a specific slave device (only 7 LSB).
+ * @param[in] p_data     Pointer to a receive buffer.
+ * @param[in] length     Number of bytes to be received.
+ *
+ * @retval NRFX_SUCCESS                    If the procedure was successful.
+ * @retval NRFX_ERROR_BUSY                 If the driver is not ready for a new transfer.
+ * @retval NRFX_ERROR_INTERNAL             If an error was detected by hardware.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_OVERRUN  If the unread data was replaced by new data
+ * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK    If NACK received after sending the address in polling mode.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK    If NACK received after sending a data byte in polling mode.
+ */
+nrfx_err_t nrfx_twi_rx(nrfx_twi_t const * p_instance,
+                       uint8_t            address,
+                       uint8_t *          p_data,
+                       size_t             length);
+
+/**
+ * @brief Function for preparing a TWI transfer.
+ *
+ * The following transfer types can be configured (@ref nrfx_twi_xfer_desc_t::type):
+ * - @ref NRFX_TWI_XFER_TXRX<span></span>: Write operation followed by a read operation (without STOP condition in between).
+ * - @ref NRFX_TWI_XFER_TXTX<span></span>: Write operation followed by a write operation (without STOP condition in between).
+ * - @ref NRFX_TWI_XFER_TX<span></span>:   Write operation (with or without STOP condition).
+ * - @ref NRFX_TWI_XFER_RX<span></span>:   Read operation  (with STOP condition).
+ *
+ * @note TXRX and TXTX transfers are supported only in non-blocking mode.
+ *
+ * Additional options are provided using the flags parameter:
+ * - @ref NRFX_TWI_FLAG_NO_XFER_EVT_HANDLER<span></span>: No user event handler after transfer completion. In most cases, this also means no interrupt at the end of the transfer.
+ * - @ref NRFX_TWI_FLAG_TX_NO_STOP<span></span>: No stop condition after TX transfer.
+ *
+ * @note
+ * Some flag combinations are invalid:
+ * - @ref NRFX_TWI_FLAG_TX_NO_STOP with @ref nrfx_twi_xfer_desc_t::type different than @ref NRFX_TWI_XFER_TX
+ *
+ * @param[in] p_instance        Pointer to the driver instance structure.
+ * @param[in] p_xfer_desc       Pointer to the transfer descriptor.
+ * @param[in] flags             Transfer options (0 for default settings).
+ *
+ * @retval NRFX_SUCCESS                    If the procedure was successful.
+ * @retval NRFX_ERROR_BUSY                 If the driver is not ready for a new transfer.
+ * @retval NRFX_ERROR_NOT_SUPPORTED        If the provided parameters are not supported.
+ * @retval NRFX_ERROR_INTERNAL             If an error was detected by hardware.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_OVERRUN  If the unread data was replaced by new data (TXRX and RX)
+ * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK    If NACK received after sending the address.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK    If NACK received after sending a data byte.
+ */
+nrfx_err_t nrfx_twi_xfer(nrfx_twi_t           const * p_instance,
+                         nrfx_twi_xfer_desc_t const * p_xfer_desc,
+                         uint32_t                     flags);
+
+/**
+ * @brief Function for checking the TWI driver state.
+ *
+ * @param[in] p_instance TWI instance.
+ *
+ * @retval true  If the TWI driver is currently busy performing a transfer.
+ * @retval false If the TWI driver is ready for a new transfer.
+ */
+bool nrfx_twi_is_busy(nrfx_twi_t const * p_instance);
+
+/**
+ * @brief Function for getting the transferred data count.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @return     Data count.
+ */
+size_t nrfx_twi_data_count_get(nrfx_twi_t const * const p_instance);
+
+/**
+ * @brief Function for returning the address of a STOPPED TWI event.
+ *
+ * A STOPPED event can be used to detect the end of a transfer if the @ref NRFX_TWI_FLAG_NO_XFER_EVT_HANDLER
+ * option is used.
+ *
+ * @param[in]  p_instance Pointer to the driver instance structure.
+ *
+ * @return     STOPPED event address.
+ */
+uint32_t nrfx_twi_stopped_event_get(nrfx_twi_t const * p_instance);
+
+void nrfx_twi_0_irq_handler(void);
+void nrfx_twi_1_irq_handler(void);
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_TWI_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_twim.h

@@ -1,408 +1,407 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_TWIM_H__
-#define NRFX_TWIM_H__
-
-#include <nrfx.h>
-#include <hal/nrf_twim.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_twim TWIM driver
- * @{
- * @ingroup nrf_twim
- * @brief   TWIM peripheral driver.
- */
-
-/**
- * @brief Structure for the TWI master driver instance.
- */
-typedef struct
-{
-    NRF_TWIM_Type * p_twim;       ///< Pointer to a structure with TWIM registers.
-    uint8_t         drv_inst_idx; ///< Driver instance index.
-} nrfx_twim_t;
-
-/**
- * @brief Macro for creating a TWI master driver instance.
- */
-#define NRFX_TWIM_INSTANCE(id)                               \
-{                                                            \
-    .p_twim       = NRFX_CONCAT_2(NRF_TWIM, id),             \
-    .drv_inst_idx = NRFX_CONCAT_3(NRFX_TWIM, id, _INST_IDX), \
-}
-
-enum {
-#if NRFX_CHECK(NRFX_TWIM0_ENABLED)
-    NRFX_TWIM0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_TWIM1_ENABLED)
-    NRFX_TWIM1_INST_IDX,
-#endif
-    NRFX_TWIM_ENABLED_COUNT
-};
-
-/**
- * @brief Structure for the TWI master driver instance configuration.
- */
-typedef struct
-{
-    uint32_t             scl;                 ///< SCL pin number.
-    uint32_t             sda;                 ///< SDA pin number.
-    nrf_twim_frequency_t frequency;           ///< TWIM frequency.
-    uint8_t              interrupt_priority;  ///< Interrupt priority.
-    bool                 hold_bus_uninit;     ///< Hold pull up state on gpio pins after uninit.
-} nrfx_twim_config_t;
-
-/**
- * @brief TWI master driver instance default configuration.
- */
-#define NRFX_TWIM_DEFAULT_CONFIG                                                    \
-{                                                                                   \
-    .frequency          = (nrf_twim_frequency_t)NRFX_TWIM_DEFAULT_CONFIG_FREQUENCY, \
-    .scl                = 31,                                                       \
-    .sda                = 31,                                                       \
-    .interrupt_priority = NRFX_TWIM_DEFAULT_CONFIG_IRQ_PRIORITY,                    \
-    .hold_bus_uninit    = NRFX_TWIM_DEFAULT_CONFIG_HOLD_BUS_UNINIT,                 \
-}
-
-#define NRFX_TWIM_FLAG_TX_POSTINC          (1UL << 0) /**< TX buffer address incremented after transfer. */
-#define NRFX_TWIM_FLAG_RX_POSTINC          (1UL << 1) /**< RX buffer address incremented after transfer. */
-#define NRFX_TWIM_FLAG_NO_XFER_EVT_HANDLER (1UL << 2) /**< Interrupt after each transfer is suppressed, and the event handler is not called. */
-#define NRFX_TWIM_FLAG_HOLD_XFER           (1UL << 3) /**< Set up the transfer but do not start it. */
-#define NRFX_TWIM_FLAG_REPEATED_XFER       (1UL << 4) /**< Flag indicating that the transfer will be executed multiple times. */
-#define NRFX_TWIM_FLAG_TX_NO_STOP          (1UL << 5) /**< Flag indicating that the TX transfer will not end with a stop condition. */
-
-/**
- * @brief TWI master driver event types.
- */
-typedef enum
-{
-    NRFX_TWIM_EVT_DONE,         ///< Transfer completed event.
-    NRFX_TWIM_EVT_ADDRESS_NACK, ///< Error event: NACK received after sending the address.
-    NRFX_TWIM_EVT_DATA_NACK     ///< Error event: NACK received after sending a data byte.
-} nrfx_twim_evt_type_t;
-
-/**
- * @brief TWI master driver transfer types.
- */
-typedef enum
-{
-    NRFX_TWIM_XFER_TX,          ///< TX transfer.
-    NRFX_TWIM_XFER_RX,          ///< RX transfer.
-    NRFX_TWIM_XFER_TXRX,        ///< TX transfer followed by RX transfer with repeated start.
-    NRFX_TWIM_XFER_TXTX         ///< TX transfer followed by TX transfer with repeated start.
-} nrfx_twim_xfer_type_t;
-
-/**
- * @brief Structure for a TWI transfer descriptor.
- */
-typedef struct
-{
-    nrfx_twim_xfer_type_t   type;             ///< Type of transfer.
-    uint8_t                 address;          ///< Slave address.
-    size_t                  primary_length;   ///< Number of bytes transferred.
-    size_t                  secondary_length; ///< Number of bytes transferred.
-    uint8_t *               p_primary_buf;    ///< Pointer to transferred data.
-    uint8_t *               p_secondary_buf;  ///< Pointer to transferred data.
-} nrfx_twim_xfer_desc_t;
-
-
-/**@brief Macro for setting the TX transfer descriptor. */
-#define NRFX_TWIM_XFER_DESC_TX(addr, p_data, length) \
-    {                                                \
-        .type = NRFX_TWIM_XFER_TX,                   \
-        .address = addr,                             \
-        .primary_length = length,                    \
-        .p_primary_buf  = p_data,                    \
-    }
-
-/**@brief Macro for setting the RX transfer descriptor. */
-#define NRFX_TWIM_XFER_DESC_RX(addr, p_data, length) \
-    {                                                \
-        .type           = NRFX_TWIM_XFER_RX,         \
-        .address        = addr,                      \
-        .primary_length = length,                    \
-        .p_primary_buf  = p_data,                    \
-    }
-
-/**@brief Macro for setting the TXRX transfer descriptor. */
-#define NRFX_TWIM_XFER_DESC_TXRX(addr, p_tx, tx_len, p_rx, rx_len) \
-    {                                                              \
-        .type             = NRFX_TWIM_XFER_TXRX,                   \
-        .address          = addr,                                  \
-        .primary_length   = tx_len,                                \
-        .secondary_length = rx_len,                                \
-        .p_primary_buf    = p_tx,                                  \
-        .p_secondary_buf  = p_rx,                                  \
-    }
-
-/**@brief Macro for setting the TXTX transfer descriptor. */
-#define NRFX_TWIM_XFER_DESC_TXTX(addr, p_tx, tx_len, p_tx2, tx_len2) \
-    {                                                                \
-        .type             = NRFX_TWIM_XFER_TXTX,                     \
-        .address          = addr,                                    \
-        .primary_length   = tx_len,                                  \
-        .secondary_length = tx_len2,                                 \
-        .p_primary_buf    = p_tx,                                    \
-        .p_secondary_buf  = p_tx2,                                   \
-    }
-
-/**
- * @brief Structure for a TWI event.
- */
-typedef struct
-{
-    nrfx_twim_evt_type_t  type;      ///< Event type.
-    nrfx_twim_xfer_desc_t xfer_desc; ///< Transfer details.
-} nrfx_twim_evt_t;
-
-/**
- * @brief TWI event handler prototype.
- */
-typedef void (* nrfx_twim_evt_handler_t)(nrfx_twim_evt_t const * p_event,
-                                         void *                  p_context);
-
-/**
- * @brief Function for initializing the TWI driver instance.
- *
- * @param[in] p_instance      Pointer to the driver instance structure.
- * @param[in] p_config        Pointer to the structure with initial configuration.
- * @param[in] event_handler   Event handler provided by the user. If NULL, blocking mode is enabled.
- * @param[in] p_context       Context passed to event handler.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver is in invalid state.
- * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
- *                                  instance ID is already in use. This is
- *                                  possible only if @ref nrfx_prs module
- *                                  is enabled.
- */
-nrfx_err_t nrfx_twim_init(nrfx_twim_t const *        p_instance,
-                          nrfx_twim_config_t const * p_config,
-                          nrfx_twim_evt_handler_t    event_handler,
-                          void *                     p_context);
-
-/**
- * @brief Function for uninitializing the TWI instance.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_twim_uninit(nrfx_twim_t const * p_instance);
-
-/**
- * @brief Function for enabling the TWI instance.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_twim_enable(nrfx_twim_t const * p_instance);
-
-/**
- * @brief Function for disabling the TWI instance.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_twim_disable(nrfx_twim_t const * p_instance);
-
-/**
- * @brief Function for sending data to a TWI slave.
- *
- * The transmission will be stopped when an error occurs. If a transfer is ongoing,
- * the function returns the error code @ref NRFX_ERROR_BUSY.
- *
- * @note Peripherals using EasyDMA (including TWIM) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] address    Address of a specific slave device (only 7 LSB).
- * @param[in] p_data     Pointer to a transmit buffer.
- * @param[in] length     Number of bytes to send. Maximum possible length is
- *                       dependent on the used SoC (see the MAXCNT register
- *                       description in the Product Specification). The driver
- *                       checks it with assertion.
- * @param[in] no_stop    If set, the stop condition is not generated on the bus
- *                       after the transfer has completed successfully (allowing
- *                       for a repeated start in the next transfer).
- *
- * @retval NRFX_SUCCESS                  If the procedure was successful.
- * @retval NRFX_ERROR_BUSY               If the driver is not ready for a new transfer.
- * @retval NRFX_ERROR_INTERNAL           If an error was detected by hardware.
- * @retval NRFX_ERROR_INVALID_ADDR       If the provided buffer is not placed in the Data RAM region.
- * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK  If NACK received after sending the address in polling mode.
- * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK  If NACK received after sending a data byte in polling mode.
- */
-nrfx_err_t nrfx_twim_tx(nrfx_twim_t const * p_instance,
-                        uint8_t             address,
-                        uint8_t const *     p_data,
-                        size_t              length,
-                        bool                no_stop);
-
-/**
- * @brief Function for reading data from a TWI slave.
- *
- * The transmission will be stopped when an error occurs. If a transfer is ongoing,
- * the function returns the error code @ref NRFX_ERROR_BUSY.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] address    Address of a specific slave device (only 7 LSB).
- * @param[in] p_data     Pointer to a receive buffer.
- * @param[in] length     Number of bytes to be received. Maximum possible length
- *                       is dependent on the used SoC (see the MAXCNT register
- *                       description in the Product Specification). The driver
- *                       checks it with assertion.
- *
- * @retval NRFX_SUCCESS                    If the procedure was successful.
- * @retval NRFX_ERROR_BUSY                 If the driver is not ready for a new transfer.
- * @retval NRFX_ERROR_INTERNAL             If an error was detected by hardware.
- * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK    If NACK received after sending the address in polling mode.
- * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK    If NACK received after sending a data byte in polling mode.
- */
-nrfx_err_t nrfx_twim_rx(nrfx_twim_t const * p_instance,
-                        uint8_t             address,
-                        uint8_t *           p_data,
-                        size_t              length);
-
-/**
- * @brief Function for preparing a TWI transfer.
- *
- * The following transfer types can be configured (@ref nrfx_twim_xfer_desc_t::type):
- * - @ref NRFX_TWIM_XFER_TXRX<span></span>: Write operation followed by a read operation (without STOP condition in between).
- * - @ref NRFX_TWIM_XFER_TXTX<span></span>: Write operation followed by a write operation (without STOP condition in between).
- * - @ref NRFX_TWIM_XFER_TX<span></span>:   Write operation (with or without STOP condition).
- * - @ref NRFX_TWIM_XFER_RX<span></span>:   Read operation  (with STOP condition).
- *
- * @note TXRX and TXTX transfers are supported only in non-blocking mode.
- *
- * Additional options are provided using the flags parameter:
- * - @ref NRFX_TWIM_FLAG_TX_POSTINC and @ref NRFX_TWIM_FLAG_RX_POSTINC<span></span>: Post-incrementation of buffer addresses. Supported only by TWIM.
- * - @ref NRFX_TWIM_FLAG_NO_XFER_EVT_HANDLER<span></span>: No user event handler after transfer completion. In most cases, this also means no interrupt at the end of the transfer.
- * - @ref NRFX_TWIM_FLAG_HOLD_XFER<span></span>: Driver is not starting the transfer. Use this flag if the transfer is triggered externally by PPI. Supported only by TWIM.
- *   Use @ref nrfx_twim_start_task_get to get the address of the start task.
- * - @ref NRFX_TWIM_FLAG_REPEATED_XFER<span></span>: Prepare for repeated transfers. You can set up a number of transfers that will be triggered externally (for example by PPI).
- *   An example is a TXRX transfer with the options @ref NRFX_TWIM_FLAG_RX_POSTINC, @ref NRFX_TWIM_FLAG_NO_XFER_EVT_HANDLER, and @ref NRFX_TWIM_FLAG_REPEATED_XFER.
- *   After the transfer is set up, a set of transfers can be triggered by PPI that will read, for example, the same register of an
- *   external component and put it into a RAM buffer without any interrupts. @ref nrfx_twim_stopped_event_get can be used to get the
- *   address of the STOPPED event, which can be used to count the number of transfers. If @ref NRFX_TWIM_FLAG_REPEATED_XFER is used,
- *   the driver does not set the driver instance into busy state, so you must ensure that the next transfers are set up
- *   when TWIM is not active. Supported only by TWIM.
- * - @ref NRFX_TWIM_FLAG_TX_NO_STOP<span></span>: No stop condition after TX transfer.
- *
- * @note
- * Some flag combinations are invalid:
- * - @ref NRFX_TWIM_FLAG_TX_NO_STOP with @ref nrfx_twim_xfer_desc_t::type different than @ref NRFX_TWIM_XFER_TX
- * - @ref NRFX_TWIM_FLAG_REPEATED_XFER with @ref nrfx_twim_xfer_desc_t::type set to @ref NRFX_TWIM_XFER_TXTX
- *
- * If @ref nrfx_twim_xfer_desc_t::type is set to @ref NRFX_TWIM_XFER_TX and the @ref NRFX_TWIM_FLAG_TX_NO_STOP and @ref NRFX_TWIM_FLAG_REPEATED_XFER
- * flags are set, two tasks must be used to trigger a transfer: TASKS_RESUME followed by TASKS_STARTTX. If no stop condition is generated,
- * TWIM is in SUSPENDED state. Therefore, it must be resumed before the transfer can be started.
- *
- * @note Peripherals using EasyDMA (including TWIM) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param[in] p_instance        Pointer to the driver instance structure.
- * @param[in] p_xfer_desc       Pointer to the transfer descriptor.
- * @param[in] flags             Transfer options (0 for default settings).
- *
- * @retval NRFX_SUCCESS                    If the procedure was successful.
- * @retval NRFX_ERROR_BUSY                 If the driver is not ready for a new transfer.
- * @retval NRFX_ERROR_NOT_SUPPORTED        If the provided parameters are not supported.
- * @retval NRFX_ERROR_INTERNAL             If an error was detected by hardware.
- * @retval NRFX_ERROR_INVALID_ADDR         If the provided buffers are not placed in the Data RAM region.
- * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK    If NACK received after sending the address.
- * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK    If NACK received after sending a data byte.
- */
-nrfx_err_t nrfx_twim_xfer(nrfx_twim_t           const * p_instance,
-                          nrfx_twim_xfer_desc_t const * p_xfer_desc,
-                          uint32_t                      flags);
-
-/**
- * @brief Function for checking the TWI driver state.
- *
- * @param[in] p_instance TWI instance.
- *
- * @retval true  If the TWI driver is currently busy performing a transfer.
- * @retval false If the TWI driver is ready for a new transfer.
- */
-bool nrfx_twim_is_busy(nrfx_twim_t const * p_instance);
-
-
-/**
- * @brief Function for returning the address of a TWIM start task.
- *
- * This function should be used if @ref nrfx_twim_xfer was called with the flag @ref NRFX_TWIM_FLAG_HOLD_XFER.
- * In that case, the transfer is not started by the driver, but it must be started externally by PPI.
- *
- * @param[in]  p_instance Pointer to the driver instance structure.
- * @param[in]  xfer_type  Transfer type used in the last call of the @ref nrfx_twim_xfer function.
- *
- * @return     Start task address (TX or RX) depending on the value of xfer_type.
- */
-uint32_t nrfx_twim_start_task_get(nrfx_twim_t const * p_instance, nrfx_twim_xfer_type_t xfer_type);
-
-/**
- * @brief Function for returning the address of a STOPPED TWIM event.
- *
- * A STOPPED event can be used to detect the end of a transfer if the @ref NRFX_TWIM_FLAG_NO_XFER_EVT_HANDLER
- * option is used.
- *
- * @param[in]  p_instance Pointer to the driver instance structure.
- *
- * @return     STOPPED event address.
- */
-uint32_t nrfx_twim_stopped_event_get(nrfx_twim_t const * p_instance);
-
-
-void nrfx_twim_0_irq_handler(void);
-void nrfx_twim_1_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_TWIM_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_TWIM_H__
+#define NRFX_TWIM_H__
+
+#include <nrfx.h>
+#include <hal/nrf_twim.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_twim TWIM driver
+ * @{
+ * @ingroup nrf_twim
+ * @brief   TWIM peripheral driver.
+ */
+
+/**
+ * @brief Structure for the TWI master driver instance.
+ */
+typedef struct
+{
+    NRF_TWIM_Type * p_twim;       ///< Pointer to a structure with TWIM registers.
+    uint8_t         drv_inst_idx; ///< Driver instance index.
+} nrfx_twim_t;
+
+/**
+ * @brief Macro for creating a TWI master driver instance.
+ */
+#define NRFX_TWIM_INSTANCE(id)                               \
+{                                                            \
+    .p_twim       = NRFX_CONCAT_2(NRF_TWIM, id),             \
+    .drv_inst_idx = NRFX_CONCAT_3(NRFX_TWIM, id, _INST_IDX), \
+}
+
+enum {
+#if NRFX_CHECK(NRFX_TWIM0_ENABLED)
+    NRFX_TWIM0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TWIM1_ENABLED)
+    NRFX_TWIM1_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TWIM2_ENABLED)
+    NRFX_TWIM2_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TWIM3_ENABLED)
+    NRFX_TWIM3_INST_IDX,
+#endif
+    NRFX_TWIM_ENABLED_COUNT
+};
+
+/**
+ * @brief Structure for the TWI master driver instance configuration.
+ */
+typedef struct
+{
+    uint32_t             scl;                 ///< SCL pin number.
+    uint32_t             sda;                 ///< SDA pin number.
+    nrf_twim_frequency_t frequency;           ///< TWIM frequency.
+    uint8_t              interrupt_priority;  ///< Interrupt priority.
+    bool                 hold_bus_uninit;     ///< Hold pull up state on gpio pins after uninit.
+} nrfx_twim_config_t;
+
+/**
+ * @brief TWI master driver instance default configuration.
+ */
+#define NRFX_TWIM_DEFAULT_CONFIG                                                    \
+{                                                                                   \
+    .frequency          = (nrf_twim_frequency_t)NRFX_TWIM_DEFAULT_CONFIG_FREQUENCY, \
+    .scl                = 31,                                                       \
+    .sda                = 31,                                                       \
+    .interrupt_priority = NRFX_TWIM_DEFAULT_CONFIG_IRQ_PRIORITY,                    \
+    .hold_bus_uninit    = NRFX_TWIM_DEFAULT_CONFIG_HOLD_BUS_UNINIT,                 \
+}
+
+#define NRFX_TWIM_FLAG_TX_POSTINC          (1UL << 0) /**< TX buffer address incremented after transfer. */
+#define NRFX_TWIM_FLAG_RX_POSTINC          (1UL << 1) /**< RX buffer address incremented after transfer. */
+#define NRFX_TWIM_FLAG_NO_XFER_EVT_HANDLER (1UL << 2) /**< Interrupt after each transfer is suppressed, and the event handler is not called. */
+#define NRFX_TWIM_FLAG_HOLD_XFER           (1UL << 3) /**< Set up the transfer but do not start it. */
+#define NRFX_TWIM_FLAG_REPEATED_XFER       (1UL << 4) /**< Flag indicating that the transfer will be executed multiple times. */
+#define NRFX_TWIM_FLAG_TX_NO_STOP          (1UL << 5) /**< Flag indicating that the TX transfer will not end with a stop condition. */
+
+/**
+ * @brief TWI master driver event types.
+ */
+typedef enum
+{
+    NRFX_TWIM_EVT_DONE,         ///< Transfer completed event.
+    NRFX_TWIM_EVT_ADDRESS_NACK, ///< Error event: NACK received after sending the address.
+    NRFX_TWIM_EVT_DATA_NACK     ///< Error event: NACK received after sending a data byte.
+} nrfx_twim_evt_type_t;
+
+/**
+ * @brief TWI master driver transfer types.
+ */
+typedef enum
+{
+    NRFX_TWIM_XFER_TX,          ///< TX transfer.
+    NRFX_TWIM_XFER_RX,          ///< RX transfer.
+    NRFX_TWIM_XFER_TXRX,        ///< TX transfer followed by RX transfer with repeated start.
+    NRFX_TWIM_XFER_TXTX         ///< TX transfer followed by TX transfer with repeated start.
+} nrfx_twim_xfer_type_t;
+
+/**
+ * @brief Structure for a TWI transfer descriptor.
+ */
+typedef struct
+{
+    nrfx_twim_xfer_type_t   type;             ///< Type of transfer.
+    uint8_t                 address;          ///< Slave address.
+    size_t                  primary_length;   ///< Number of bytes transferred.
+    size_t                  secondary_length; ///< Number of bytes transferred.
+    uint8_t *               p_primary_buf;    ///< Pointer to transferred data.
+    uint8_t *               p_secondary_buf;  ///< Pointer to transferred data.
+} nrfx_twim_xfer_desc_t;
+
+
+/**@brief Macro for setting the TX transfer descriptor. */
+#define NRFX_TWIM_XFER_DESC_TX(addr, p_data, length) \
+    {                                                \
+        .type = NRFX_TWIM_XFER_TX,                   \
+        .address = addr,                             \
+        .primary_length = length,                    \
+        .p_primary_buf  = p_data,                    \
+    }
+
+/**@brief Macro for setting the RX transfer descriptor. */
+#define NRFX_TWIM_XFER_DESC_RX(addr, p_data, length) \
+    {                                                \
+        .type           = NRFX_TWIM_XFER_RX,         \
+        .address        = addr,                      \
+        .primary_length = length,                    \
+        .p_primary_buf  = p_data,                    \
+    }
+
+/**@brief Macro for setting the TXRX transfer descriptor. */
+#define NRFX_TWIM_XFER_DESC_TXRX(addr, p_tx, tx_len, p_rx, rx_len) \
+    {                                                              \
+        .type             = NRFX_TWIM_XFER_TXRX,                   \
+        .address          = addr,                                  \
+        .primary_length   = tx_len,                                \
+        .secondary_length = rx_len,                                \
+        .p_primary_buf    = p_tx,                                  \
+        .p_secondary_buf  = p_rx,                                  \
+    }
+
+/**@brief Macro for setting the TXTX transfer descriptor. */
+#define NRFX_TWIM_XFER_DESC_TXTX(addr, p_tx, tx_len, p_tx2, tx_len2) \
+    {                                                                \
+        .type             = NRFX_TWIM_XFER_TXTX,                     \
+        .address          = addr,                                    \
+        .primary_length   = tx_len,                                  \
+        .secondary_length = tx_len2,                                 \
+        .p_primary_buf    = p_tx,                                    \
+        .p_secondary_buf  = p_tx2,                                   \
+    }
+
+/**
+ * @brief Structure for a TWI event.
+ */
+typedef struct
+{
+    nrfx_twim_evt_type_t  type;      ///< Event type.
+    nrfx_twim_xfer_desc_t xfer_desc; ///< Transfer details.
+} nrfx_twim_evt_t;
+
+/**
+ * @brief TWI event handler prototype.
+ */
+typedef void (* nrfx_twim_evt_handler_t)(nrfx_twim_evt_t const * p_event,
+                                         void *                  p_context);
+
+/**
+ * @brief Function for initializing the TWI driver instance.
+ *
+ * @param[in] p_instance      Pointer to the driver instance structure.
+ * @param[in] p_config        Pointer to the structure with initial configuration.
+ * @param[in] event_handler   Event handler provided by the user. If NULL, blocking mode is enabled.
+ * @param[in] p_context       Context passed to event handler.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver is in invalid state.
+ * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
+ *                                  instance ID is already in use. This is
+ *                                  possible only if @ref nrfx_prs module
+ *                                  is enabled.
+ */
+nrfx_err_t nrfx_twim_init(nrfx_twim_t const *        p_instance,
+                          nrfx_twim_config_t const * p_config,
+                          nrfx_twim_evt_handler_t    event_handler,
+                          void *                     p_context);
+
+/**
+ * @brief Function for uninitializing the TWI instance.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_twim_uninit(nrfx_twim_t const * p_instance);
+
+/**
+ * @brief Function for enabling the TWI instance.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_twim_enable(nrfx_twim_t const * p_instance);
+
+/**
+ * @brief Function for disabling the TWI instance.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_twim_disable(nrfx_twim_t const * p_instance);
+
+/**
+ * @brief Function for sending data to a TWI slave.
+ *
+ * The transmission will be stopped when an error occurs. If a transfer is ongoing,
+ * the function returns the error code @ref NRFX_ERROR_BUSY.
+ *
+ * @note Peripherals using EasyDMA (including TWIM) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] address    Address of a specific slave device (only 7 LSB).
+ * @param[in] p_data     Pointer to a transmit buffer.
+ * @param[in] length     Number of bytes to send. Maximum possible length is
+ *                       dependent on the used SoC (see the MAXCNT register
+ *                       description in the Product Specification). The driver
+ *                       checks it with assertion.
+ * @param[in] no_stop    If set, the stop condition is not generated on the bus
+ *                       after the transfer has completed successfully (allowing
+ *                       for a repeated start in the next transfer).
+ *
+ * @retval NRFX_SUCCESS                  If the procedure was successful.
+ * @retval NRFX_ERROR_BUSY               If the driver is not ready for a new transfer.
+ * @retval NRFX_ERROR_INTERNAL           If an error was detected by hardware.
+ * @retval NRFX_ERROR_INVALID_ADDR       If the provided buffer is not placed in the Data RAM region.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK  If NACK received after sending the address in polling mode.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK  If NACK received after sending a data byte in polling mode.
+ */
+nrfx_err_t nrfx_twim_tx(nrfx_twim_t const * p_instance,
+                        uint8_t             address,
+                        uint8_t const *     p_data,
+                        size_t              length,
+                        bool                no_stop);
+
+/**
+ * @brief Function for reading data from a TWI slave.
+ *
+ * The transmission will be stopped when an error occurs. If a transfer is ongoing,
+ * the function returns the error code @ref NRFX_ERROR_BUSY.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] address    Address of a specific slave device (only 7 LSB).
+ * @param[in] p_data     Pointer to a receive buffer.
+ * @param[in] length     Number of bytes to be received. Maximum possible length
+ *                       is dependent on the used SoC (see the MAXCNT register
+ *                       description in the Product Specification). The driver
+ *                       checks it with assertion.
+ *
+ * @retval NRFX_SUCCESS                    If the procedure was successful.
+ * @retval NRFX_ERROR_BUSY                 If the driver is not ready for a new transfer.
+ * @retval NRFX_ERROR_INTERNAL             If an error was detected by hardware.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK    If NACK received after sending the address in polling mode.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK    If NACK received after sending a data byte in polling mode.
+ */
+nrfx_err_t nrfx_twim_rx(nrfx_twim_t const * p_instance,
+                        uint8_t             address,
+                        uint8_t *           p_data,
+                        size_t              length);
+
+/**
+ * @brief Function for preparing a TWI transfer.
+ *
+ * The following transfer types can be configured (@ref nrfx_twim_xfer_desc_t::type):
+ * - @ref NRFX_TWIM_XFER_TXRX<span></span>: Write operation followed by a read operation (without STOP condition in between).
+ * - @ref NRFX_TWIM_XFER_TXTX<span></span>: Write operation followed by a write operation (without STOP condition in between).
+ * - @ref NRFX_TWIM_XFER_TX<span></span>:   Write operation (with or without STOP condition).
+ * - @ref NRFX_TWIM_XFER_RX<span></span>:   Read operation  (with STOP condition).
+ *
+ * @note TXRX and TXTX transfers are supported only in non-blocking mode.
+ *
+ * Additional options are provided using the flags parameter:
+ * - @ref NRFX_TWIM_FLAG_TX_POSTINC and @ref NRFX_TWIM_FLAG_RX_POSTINC<span></span>: Post-incrementation of buffer addresses. Supported only by TWIM.
+ * - @ref NRFX_TWIM_FLAG_NO_XFER_EVT_HANDLER<span></span>: No user event handler after transfer completion. In most cases, this also means no interrupt at the end of the transfer.
+ * - @ref NRFX_TWIM_FLAG_HOLD_XFER<span></span>: Driver is not starting the transfer. Use this flag if the transfer is triggered externally by PPI. Supported only by TWIM.
+ *   Use @ref nrfx_twim_start_task_get to get the address of the start task.
+ * - @ref NRFX_TWIM_FLAG_REPEATED_XFER<span></span>: Prepare for repeated transfers. You can set up a number of transfers that will be triggered externally (for example by PPI).
+ *   An example is a TXRX transfer with the options @ref NRFX_TWIM_FLAG_RX_POSTINC, @ref NRFX_TWIM_FLAG_NO_XFER_EVT_HANDLER, and @ref NRFX_TWIM_FLAG_REPEATED_XFER.
+ *   After the transfer is set up, a set of transfers can be triggered by PPI that will read, for example, the same register of an
+ *   external component and put it into a RAM buffer without any interrupts. @ref nrfx_twim_stopped_event_get can be used to get the
+ *   address of the STOPPED event, which can be used to count the number of transfers. If @ref NRFX_TWIM_FLAG_REPEATED_XFER is used,
+ *   the driver does not set the driver instance into busy state, so you must ensure that the next transfers are set up
+ *   when TWIM is not active. Supported only by TWIM.
+ * - @ref NRFX_TWIM_FLAG_TX_NO_STOP<span></span>: No stop condition after TX transfer.
+ *
+ * @note
+ * Some flag combinations are invalid:
+ * - @ref NRFX_TWIM_FLAG_TX_NO_STOP with @ref nrfx_twim_xfer_desc_t::type different than @ref NRFX_TWIM_XFER_TX
+ * - @ref NRFX_TWIM_FLAG_REPEATED_XFER with @ref nrfx_twim_xfer_desc_t::type set to @ref NRFX_TWIM_XFER_TXTX
+ *
+ * If @ref nrfx_twim_xfer_desc_t::type is set to @ref NRFX_TWIM_XFER_TX and the @ref NRFX_TWIM_FLAG_TX_NO_STOP and @ref NRFX_TWIM_FLAG_REPEATED_XFER
+ * flags are set, two tasks must be used to trigger a transfer: TASKS_RESUME followed by TASKS_STARTTX. If no stop condition is generated,
+ * TWIM is in SUSPENDED state. Therefore, it must be resumed before the transfer can be started.
+ *
+ * @note Peripherals using EasyDMA (including TWIM) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param[in] p_instance        Pointer to the driver instance structure.
+ * @param[in] p_xfer_desc       Pointer to the transfer descriptor.
+ * @param[in] flags             Transfer options (0 for default settings).
+ *
+ * @retval NRFX_SUCCESS                    If the procedure was successful.
+ * @retval NRFX_ERROR_BUSY                 If the driver is not ready for a new transfer.
+ * @retval NRFX_ERROR_NOT_SUPPORTED        If the provided parameters are not supported.
+ * @retval NRFX_ERROR_INTERNAL             If an error was detected by hardware.
+ * @retval NRFX_ERROR_INVALID_ADDR         If the provided buffers are not placed in the Data RAM region.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_ANACK    If NACK received after sending the address.
+ * @retval NRFX_ERROR_DRV_TWI_ERR_DNACK    If NACK received after sending a data byte.
+ */
+nrfx_err_t nrfx_twim_xfer(nrfx_twim_t           const * p_instance,
+                          nrfx_twim_xfer_desc_t const * p_xfer_desc,
+                          uint32_t                      flags);
+
+/**
+ * @brief Function for checking the TWI driver state.
+ *
+ * @param[in] p_instance TWI instance.
+ *
+ * @retval true  If the TWI driver is currently busy performing a transfer.
+ * @retval false If the TWI driver is ready for a new transfer.
+ */
+bool nrfx_twim_is_busy(nrfx_twim_t const * p_instance);
+
+
+/**
+ * @brief Function for returning the address of a TWIM start task.
+ *
+ * This function should be used if @ref nrfx_twim_xfer was called with the flag @ref NRFX_TWIM_FLAG_HOLD_XFER.
+ * In that case, the transfer is not started by the driver, but it must be started externally by PPI.
+ *
+ * @param[in]  p_instance Pointer to the driver instance structure.
+ * @param[in]  xfer_type  Transfer type used in the last call of the @ref nrfx_twim_xfer function.
+ *
+ * @return     Start task address (TX or RX) depending on the value of xfer_type.
+ */
+uint32_t nrfx_twim_start_task_get(nrfx_twim_t const * p_instance, nrfx_twim_xfer_type_t xfer_type);
+
+/**
+ * @brief Function for returning the address of a STOPPED TWIM event.
+ *
+ * A STOPPED event can be used to detect the end of a transfer if the @ref NRFX_TWIM_FLAG_NO_XFER_EVT_HANDLER
+ * option is used.
+ *
+ * @param[in]  p_instance Pointer to the driver instance structure.
+ *
+ * @return     STOPPED event address.
+ */
+uint32_t nrfx_twim_stopped_event_get(nrfx_twim_t const * p_instance);
+
+
+void nrfx_twim_0_irq_handler(void);
+void nrfx_twim_1_irq_handler(void);
+void nrfx_twim_2_irq_handler(void);
+void nrfx_twim_3_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_TWIM_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_twis.h

@@ -1,405 +1,404 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_TWIS_H__
-#define NRFX_TWIS_H__
-
-#include <nrfx.h>
-#include <hal/nrf_twis.h>
-#include <hal/nrf_gpio.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_twis TWIS driver
- * @{
- * @ingroup nrf_twis
- * @brief   Two Wire Slave interface (TWIS) peripheral driver.
- */
-
-/**
- * @brief TWIS driver instance data structure.
- */
-typedef struct
-{
-    NRF_TWIS_Type * p_reg;        ///< Pointer to a structure with TWIS registers.
-    uint8_t         drv_inst_idx; ///< Driver instance index.
-} nrfx_twis_t;
-
-enum {
-#if NRFX_CHECK(NRFX_TWIS0_ENABLED)
-    NRFX_TWIS0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_TWIS1_ENABLED)
-    NRFX_TWIS1_INST_IDX,
-#endif
-    NRFX_TWIS_ENABLED_COUNT
-};
-
-/**
- * @brief Macro for creating a TWIS driver instance.
- */
-#define NRFX_TWIS_INSTANCE(id)                               \
-{                                                            \
-    .p_reg        = NRFX_CONCAT_2(NRF_TWIS, id),             \
-    .drv_inst_idx = NRFX_CONCAT_3(NRFX_TWIS, id, _INST_IDX), \
-}
-
-/**
- * @brief Event callback function event definitions.
- */
-typedef enum
-{
-    NRFX_TWIS_EVT_READ_REQ,     ///< Read request detected.
-                                /**< If there is no buffer prepared, buf_req flag in the even will be set.
-                                     Call then @ref nrfx_twis_tx_prepare to give parameters for buffer.
-                                     */
-    NRFX_TWIS_EVT_READ_DONE,    ///< Read request has finished - free any data.
-    NRFX_TWIS_EVT_READ_ERROR,   ///< Read request finished with error.
-    NRFX_TWIS_EVT_WRITE_REQ,    ///< Write request detected.
-                                /**< If there is no buffer prepared, buf_req flag in the even will be set.
-                                     Call then @ref nrfx_twis_rx_prepare to give parameters for buffer.
-                                     */
-    NRFX_TWIS_EVT_WRITE_DONE,   ///< Write request has finished - process data.
-    NRFX_TWIS_EVT_WRITE_ERROR,  ///< Write request finished with error.
-    NRFX_TWIS_EVT_GENERAL_ERROR ///< Error that happens not inside WRITE or READ transaction.
-} nrfx_twis_evt_type_t;
-
-/**
- * @brief Possible error sources.
- *
- * This is flag enum - values from this enum can be connected using logical or operator.
- * @note
- * We could use directly @ref nrf_twis_error_t. Error type enum is redefined here because
- * of possible future extension (eg. supporting timeouts and synchronous mode).
- */
-typedef enum
-{
-    NRFX_TWIS_ERROR_OVERFLOW         = NRF_TWIS_ERROR_OVERFLOW,  /**< RX buffer overflow detected, and prevented. */
-    NRFX_TWIS_ERROR_DATA_NACK        = NRF_TWIS_ERROR_DATA_NACK, /**< NACK sent after receiving a data byte. */
-    NRFX_TWIS_ERROR_OVERREAD         = NRF_TWIS_ERROR_OVERREAD,  /**< TX buffer over-read detected, and prevented. */
-    NRFX_TWIS_ERROR_UNEXPECTED_EVENT = 1 << 8                    /**< Unexpected event detected by state machine. */
-} nrfx_twis_error_t;
-
-/**
- * @brief TWIS driver event structure.
- */
-typedef struct
-{
-    nrfx_twis_evt_type_t type; ///< Event type.
-    union
-    {
-        bool buf_req;       ///< Flag for @ref NRFX_TWIS_EVT_READ_REQ and @ref NRFX_TWIS_EVT_WRITE_REQ.
-                            /**< Information if transmission buffer requires to be prepared. */
-        uint32_t tx_amount; ///< Data for @ref NRFX_TWIS_EVT_READ_DONE.
-        uint32_t rx_amount; ///< Data for @ref NRFX_TWIS_EVT_WRITE_DONE.
-        uint32_t error;     ///< Data for @ref NRFX_TWIS_EVT_GENERAL_ERROR.
-    } data;
-} nrfx_twis_evt_t;
-
-/**
- * @brief TWI slave event callback function type.
- *
- * @param[in] p_event Event information structure.
- */
-typedef void (*nrfx_twis_event_handler_t)(nrfx_twis_evt_t const * p_event);
-
-/**
- * @brief Structure for TWIS configuration.
- */
-typedef struct
-{
-    uint32_t            addr[2];            //!< Set addresses that this slave should respond. Set 0 to disable.
-    uint32_t            scl;                //!< SCL pin number.
-    uint32_t            sda;                //!< SDA pin number.
-    nrf_gpio_pin_pull_t scl_pull;           //!< SCL pin pull.
-    nrf_gpio_pin_pull_t sda_pull;           //!< SDA pin pull.
-    uint8_t             interrupt_priority; //!< The priority of interrupt for the module to set.
-} nrfx_twis_config_t;
-
-/**
- * @brief Generate default configuration for TWIS driver instance.
- */
-#define NRFX_TWIS_DEFAULT_CONFIG \
-{ \
-    .addr               = { NRFX_TWIS_DEFAULT_CONFIG_ADDR0,                       \
-                            NRFX_TWIS_DEFAULT_CONFIG_ADDR1 },                     \
-    .scl                = 31,                                                     \
-    .scl_pull           = (nrf_gpio_pin_pull_t)NRFX_TWIS_DEFAULT_CONFIG_SCL_PULL, \
-    .sda                = 31,                                                     \
-    .sda_pull           = (nrf_gpio_pin_pull_t)NRFX_TWIS_DEFAULT_CONFIG_SDA_PULL, \
-    .interrupt_priority = NRFX_TWIS_DEFAULT_CONFIG_IRQ_PRIORITY                   \
-}
-
-/**
- * @brief Function for initializing the TWIS driver instance.
- *
- * Function initializes and enables TWIS driver.
- * @attention After driver initialization enable it by @ref nrfx_twis_enable.
- *
- * @param[in] p_instance      Pointer to the driver instance structure.
- * @attention                 @em p_instance has to be global object.
- *                            It would be used by interrupts so make it sure that object
- *                            would not be destroyed when function is leaving.
- * @param[in] p_config        Pointer to the structure with initial configuration.
- * @param[in] event_handler   Event handler provided by the user.
- *
- * @retval NRFX_SUCCESS             If initialization was successful.
- * @retval NRFX_ERROR_INVALID_STATE If the driver is already initialized.
- * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
- *                                  instance ID is already in use. This is
- *                                  possible only if NRFX_PRS_ENABLED
- *                                  is set to a value other than zero.
- */
-nrfx_err_t nrfx_twis_init(nrfx_twis_t const *        p_instance,
-                          nrfx_twis_config_t const * p_config,
-                          nrfx_twis_event_handler_t  event_handler);
-
-/**
- * @brief Function for uninitializing the TWIS driver instance.
- *
- * Function initializes the peripheral and resets all registers to default values.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @note
- * It is safe to call nrfx_twis_uninit even before initialization.
- * Actually @ref nrfx_twis_init function calls this function to
- * make sure that TWIS state is known.
- * @note
- * If TWIS driver was in uninitialized state before calling this function,
- * selected pins would not be reset to default configuration.
- */
-void nrfx_twis_uninit(nrfx_twis_t const * p_instance);
-
-/**
- * @brief Enable TWIS instance.
- *
- * This function enables TWIS instance.
- * Function defined if there is needs for dynamically enabling and disabling the peripheral.
- * Use @ref nrfx_twis_enable and @ref nrfx_twis_disable functions.
- * They do not change any configuration registers.
- *
- * @param p_instance Pointer to the driver instance structure.
- */
-void nrfx_twis_enable(nrfx_twis_t const * p_instance);
-
-/**
- * @brief Disable TWIS instance.
- *
- * Disabling TWIS instance gives possibility to turn off the TWIS while
- * holding configuration done by @ref nrfx_twis_init.
- *
- * @param p_instance Pointer to the driver instance structure.
- */
-void nrfx_twis_disable(nrfx_twis_t const * p_instance);
-
-/**
- * @brief Get and clear last error flags.
- *
- * Function gets information about errors.
- * This is also the only possibility to exit from error substate of the internal state machine.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @return Error flags defined in @ref nrfx_twis_error_t.
- * @attention
- * This function clears error state and flags.
- */
-uint32_t nrfx_twis_error_get_and_clear(nrfx_twis_t const * p_instance);
-
-
-/**
- * @brief Prepare data for sending.
- *
- * This function should be used in response for @ref NRFX_TWIS_EVT_READ_REQ event.
- *
- * @note Peripherals using EasyDMA (including TWIS) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] p_buf      Transmission buffer.
- * @attention            Transmission buffer has to be placed in RAM.
- * @param     size       Maximum number of bytes that master may read from buffer given.
- *
- * @retval NRFX_SUCCESS              Preparation finished properly.
- * @retval NRFX_ERROR_INVALID_ADDR   Given @em p_buf is not placed inside the RAM.
- * @retval NRFX_ERROR_INVALID_LENGTH Wrong value in @em size parameter.
- * @retval NRFX_ERROR_INVALID_STATE  Module not initialized or not enabled.
- */
-nrfx_err_t nrfx_twis_tx_prepare(nrfx_twis_t const * p_instance,
-                                void const *        p_buf,
-                                size_t              size);
-
-/**
- * @brief Get number of transmitted bytes.
- *
- * Function returns number of bytes sent.
- * This function may be called after @ref NRFX_TWIS_EVT_READ_DONE or @ref NRFX_TWIS_EVT_READ_ERROR events.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @return Number of bytes sent.
- */
-__STATIC_INLINE size_t nrfx_twis_tx_amount(nrfx_twis_t const * p_instance);
-
-/**
- * @brief Prepare data for receiving
- *
- * This function should be used in response for @ref NRFX_TWIS_EVT_WRITE_REQ event.
- *
- * @note Peripherals using EasyDMA (including TWIS) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] p_buf      Buffer that would be filled with received data.
- * @attention            Receiving buffer has to be placed in RAM.
- * @param     size       Size of the buffer (maximum amount of data to receive).
- *
- * @retval NRFX_SUCCESS              Preparation finished properly.
- * @retval NRFX_ERROR_INVALID_ADDR   Given @em p_buf is not placed inside the RAM.
- * @retval NRFX_ERROR_INVALID_LENGTH Wrong value in @em size parameter.
- * @retval NRFX_ERROR_INVALID_STATE  Module not initialized or not enabled.
- */
-nrfx_err_t nrfx_twis_rx_prepare(nrfx_twis_t const * p_instance,
-                                void *              p_buf,
-                                size_t              size);
-
-/**
- * @brief Get number of received bytes.
- *
- * Function returns number of bytes received.
- * This function may be called after @ref NRFX_TWIS_EVT_WRITE_DONE or @ref NRFX_TWIS_EVT_WRITE_ERROR events.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @return Number of bytes received.
- */
-__STATIC_INLINE size_t nrfx_twis_rx_amount(nrfx_twis_t const * p_instance);
-
-/**
- * @brief Function checks if driver is busy right now.
- *
- * Actual driver substate is tested.
- * If driver is in any other state than IDLE or ERROR this function returns true.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  Driver is in state other than ERROR or IDLE.
- * @retval false There is no transmission pending.
- */
-bool nrfx_twis_is_busy(nrfx_twis_t const * p_instance);
-
-/**
- * @brief Function checks if driver is waiting for tx buffer.
- *
- * If this function returns true, it means that driver is stalled expecting
- * of the @ref nrfx_twis_tx_prepare function call.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  Driver waits for @ref nrfx_twis_tx_prepare.
- * @retval false Driver is not in the state where it waits for preparing tx buffer.
- */
-bool nrfx_twis_is_waiting_tx_buff(nrfx_twis_t const * p_instance);
-
-/**
- * @brief Function checks if driver is waiting for rx buffer.
- *
- * If this function returns true, it means that driver is staled expecting
- * of the @ref nrfx_twis_rx_prepare function call.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  Driver waits for @ref nrfx_twis_rx_prepare.
- * @retval false Driver is not in the state where it waits for preparing rx buffer.
- */
-bool nrfx_twis_is_waiting_rx_buff(nrfx_twis_t const * p_instance);
-
-/**
- * @brief Check if driver is sending data.
- *
- * If this function returns true, it means that there is ongoing output transmission.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  There is ongoing output transmission.
- * @retval false Driver is in other state.
- */
-bool nrfx_twis_is_pending_tx(nrfx_twis_t const * p_instance);
-
-/**
- * @brief Check if driver is receiving data.
- *
- * If this function returns true, it means that there is ongoing input transmission.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  There is ongoing input transmission.
- * @retval false Driver is in other state.
- */
-bool nrfx_twis_is_pending_rx(nrfx_twis_t const * p_instance);
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-__STATIC_INLINE size_t nrfx_twis_tx_amount(nrfx_twis_t const * p_instance)
-{
-    return nrf_twis_tx_amount_get(p_instance->p_reg);
-}
-
-__STATIC_INLINE size_t nrfx_twis_rx_amount(nrfx_twis_t const * p_instance)
-{
-    return nrf_twis_rx_amount_get(p_instance->p_reg);
-}
-#endif // SUPPRESS_INLINE_IMPLEMENTATION
-
-
-void nrfx_twis_0_irq_handler(void);
-void nrfx_twis_1_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_TWIS_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_TWIS_H__
+#define NRFX_TWIS_H__
+
+#include <nrfx.h>
+#include <hal/nrf_twis.h>
+#include <hal/nrf_gpio.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_twis TWIS driver
+ * @{
+ * @ingroup nrf_twis
+ * @brief   Two Wire Slave interface (TWIS) peripheral driver.
+ */
+
+/**
+ * @brief TWIS driver instance data structure.
+ */
+typedef struct
+{
+    NRF_TWIS_Type * p_reg;        ///< Pointer to a structure with TWIS registers.
+    uint8_t         drv_inst_idx; ///< Driver instance index.
+} nrfx_twis_t;
+
+enum {
+#if NRFX_CHECK(NRFX_TWIS0_ENABLED)
+    NRFX_TWIS0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TWIS1_ENABLED)
+    NRFX_TWIS1_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TWIS2_ENABLED)
+    NRFX_TWIS2_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_TWIS3_ENABLED)
+    NRFX_TWIS3_INST_IDX,
+#endif
+    NRFX_TWIS_ENABLED_COUNT
+};
+
+/**
+ * @brief Macro for creating a TWIS driver instance.
+ */
+#define NRFX_TWIS_INSTANCE(id)                               \
+{                                                            \
+    .p_reg        = NRFX_CONCAT_2(NRF_TWIS, id),             \
+    .drv_inst_idx = NRFX_CONCAT_3(NRFX_TWIS, id, _INST_IDX), \
+}
+
+/**
+ * @brief Event callback function event definitions.
+ */
+typedef enum
+{
+    NRFX_TWIS_EVT_READ_REQ,     ///< Read request detected.
+                                /**< If there is no buffer prepared, buf_req flag in the even will be set.
+                                     Call then @ref nrfx_twis_tx_prepare to give parameters for buffer.
+                                     */
+    NRFX_TWIS_EVT_READ_DONE,    ///< Read request has finished - free any data.
+    NRFX_TWIS_EVT_READ_ERROR,   ///< Read request finished with error.
+    NRFX_TWIS_EVT_WRITE_REQ,    ///< Write request detected.
+                                /**< If there is no buffer prepared, buf_req flag in the even will be set.
+                                     Call then @ref nrfx_twis_rx_prepare to give parameters for buffer.
+                                     */
+    NRFX_TWIS_EVT_WRITE_DONE,   ///< Write request has finished - process data.
+    NRFX_TWIS_EVT_WRITE_ERROR,  ///< Write request finished with error.
+    NRFX_TWIS_EVT_GENERAL_ERROR ///< Error that happens not inside WRITE or READ transaction.
+} nrfx_twis_evt_type_t;
+
+/**
+ * @brief Possible error sources.
+ *
+ * This is flag enum - values from this enum can be connected using logical or operator.
+ * @note
+ * We could use directly @ref nrf_twis_error_t. Error type enum is redefined here because
+ * of possible future extension (eg. supporting timeouts and synchronous mode).
+ */
+typedef enum
+{
+    NRFX_TWIS_ERROR_OVERFLOW         = NRF_TWIS_ERROR_OVERFLOW,  /**< RX buffer overflow detected, and prevented. */
+    NRFX_TWIS_ERROR_DATA_NACK        = NRF_TWIS_ERROR_DATA_NACK, /**< NACK sent after receiving a data byte. */
+    NRFX_TWIS_ERROR_OVERREAD         = NRF_TWIS_ERROR_OVERREAD,  /**< TX buffer over-read detected, and prevented. */
+    NRFX_TWIS_ERROR_UNEXPECTED_EVENT = 1 << 8                    /**< Unexpected event detected by state machine. */
+} nrfx_twis_error_t;
+
+/**
+ * @brief TWIS driver event structure.
+ */
+typedef struct
+{
+    nrfx_twis_evt_type_t type; ///< Event type.
+    union
+    {
+        bool buf_req;       ///< Flag for @ref NRFX_TWIS_EVT_READ_REQ and @ref NRFX_TWIS_EVT_WRITE_REQ.
+                            /**< Information if transmission buffer requires to be prepared. */
+        uint32_t tx_amount; ///< Data for @ref NRFX_TWIS_EVT_READ_DONE.
+        uint32_t rx_amount; ///< Data for @ref NRFX_TWIS_EVT_WRITE_DONE.
+        uint32_t error;     ///< Data for @ref NRFX_TWIS_EVT_GENERAL_ERROR.
+    } data;
+} nrfx_twis_evt_t;
+
+/**
+ * @brief TWI slave event callback function type.
+ *
+ * @param[in] p_event Event information structure.
+ */
+typedef void (*nrfx_twis_event_handler_t)(nrfx_twis_evt_t const * p_event);
+
+/**
+ * @brief Structure for TWIS configuration.
+ */
+typedef struct
+{
+    uint32_t            addr[2];            //!< Set addresses that this slave should respond. Set 0 to disable.
+    uint32_t            scl;                //!< SCL pin number.
+    uint32_t            sda;                //!< SDA pin number.
+    nrf_gpio_pin_pull_t scl_pull;           //!< SCL pin pull.
+    nrf_gpio_pin_pull_t sda_pull;           //!< SDA pin pull.
+    uint8_t             interrupt_priority; //!< The priority of interrupt for the module to set.
+} nrfx_twis_config_t;
+
+/**
+ * @brief Generate default configuration for TWIS driver instance.
+ */
+#define NRFX_TWIS_DEFAULT_CONFIG \
+{ \
+    .addr               = { NRFX_TWIS_DEFAULT_CONFIG_ADDR0,                       \
+                            NRFX_TWIS_DEFAULT_CONFIG_ADDR1 },                     \
+    .scl                = 31,                                                     \
+    .scl_pull           = (nrf_gpio_pin_pull_t)NRFX_TWIS_DEFAULT_CONFIG_SCL_PULL, \
+    .sda                = 31,                                                     \
+    .sda_pull           = (nrf_gpio_pin_pull_t)NRFX_TWIS_DEFAULT_CONFIG_SDA_PULL, \
+    .interrupt_priority = NRFX_TWIS_DEFAULT_CONFIG_IRQ_PRIORITY                   \
+}
+
+/**
+ * @brief Function for initializing the TWIS driver instance.
+ *
+ * Function initializes and enables TWIS driver.
+ * @attention After driver initialization enable it by @ref nrfx_twis_enable.
+ *
+ * @param[in] p_instance      Pointer to the driver instance structure.
+ * @attention                 @em p_instance has to be global object.
+ *                            It would be used by interrupts so make it sure that object
+ *                            would not be destroyed when function is leaving.
+ * @param[in] p_config        Pointer to the structure with initial configuration.
+ * @param[in] event_handler   Event handler provided by the user.
+ *
+ * @retval NRFX_SUCCESS             If initialization was successful.
+ * @retval NRFX_ERROR_INVALID_STATE If the driver is already initialized.
+ * @retval NRFX_ERROR_BUSY          If some other peripheral with the same
+ *                                  instance ID is already in use. This is
+ *                                  possible only if NRFX_PRS_ENABLED
+ *                                  is set to a value other than zero.
+ */
+nrfx_err_t nrfx_twis_init(nrfx_twis_t const *        p_instance,
+                          nrfx_twis_config_t const * p_config,
+                          nrfx_twis_event_handler_t  event_handler);
+
+/**
+ * @brief Function for uninitializing the TWIS driver instance.
+ *
+ * Function initializes the peripheral and resets all registers to default values.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @note
+ * It is safe to call nrfx_twis_uninit even before initialization.
+ * Actually @ref nrfx_twis_init function calls this function to
+ * make sure that TWIS state is known.
+ * @note
+ * If TWIS driver was in uninitialized state before calling this function,
+ * selected pins would not be reset to default configuration.
+ */
+void nrfx_twis_uninit(nrfx_twis_t const * p_instance);
+
+/**
+ * @brief Enable TWIS instance.
+ *
+ * This function enables TWIS instance.
+ * Function defined if there is needs for dynamically enabling and disabling the peripheral.
+ * Use @ref nrfx_twis_enable and @ref nrfx_twis_disable functions.
+ * They do not change any configuration registers.
+ *
+ * @param p_instance Pointer to the driver instance structure.
+ */
+void nrfx_twis_enable(nrfx_twis_t const * p_instance);
+
+/**
+ * @brief Disable TWIS instance.
+ *
+ * Disabling TWIS instance gives possibility to turn off the TWIS while
+ * holding configuration done by @ref nrfx_twis_init.
+ *
+ * @param p_instance Pointer to the driver instance structure.
+ */
+void nrfx_twis_disable(nrfx_twis_t const * p_instance);
+
+/**
+ * @brief Get and clear last error flags.
+ *
+ * Function gets information about errors.
+ * This is also the only possibility to exit from error substate of the internal state machine.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @return Error flags defined in @ref nrfx_twis_error_t.
+ * @attention
+ * This function clears error state and flags.
+ */
+uint32_t nrfx_twis_error_get_and_clear(nrfx_twis_t const * p_instance);
+
+
+/**
+ * @brief Prepare data for sending.
+ *
+ * This function should be used in response for @ref NRFX_TWIS_EVT_READ_REQ event.
+ *
+ * @note Peripherals using EasyDMA (including TWIS) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] p_buf      Transmission buffer.
+ * @attention            Transmission buffer has to be placed in RAM.
+ * @param     size       Maximum number of bytes that master may read from buffer given.
+ *
+ * @retval NRFX_SUCCESS              Preparation finished properly.
+ * @retval NRFX_ERROR_INVALID_ADDR   Given @em p_buf is not placed inside the RAM.
+ * @retval NRFX_ERROR_INVALID_LENGTH Wrong value in @em size parameter.
+ * @retval NRFX_ERROR_INVALID_STATE  Module not initialized or not enabled.
+ */
+nrfx_err_t nrfx_twis_tx_prepare(nrfx_twis_t const * p_instance,
+                                void const *        p_buf,
+                                size_t              size);
+
+/**
+ * @brief Get number of transmitted bytes.
+ *
+ * Function returns number of bytes sent.
+ * This function may be called after @ref NRFX_TWIS_EVT_READ_DONE or @ref NRFX_TWIS_EVT_READ_ERROR events.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @return Number of bytes sent.
+ */
+__STATIC_INLINE size_t nrfx_twis_tx_amount(nrfx_twis_t const * p_instance);
+
+/**
+ * @brief Prepare data for receiving
+ *
+ * This function should be used in response for @ref NRFX_TWIS_EVT_WRITE_REQ event.
+ *
+ * @note Peripherals using EasyDMA (including TWIS) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] p_buf      Buffer that would be filled with received data.
+ * @attention            Receiving buffer has to be placed in RAM.
+ * @param     size       Size of the buffer (maximum amount of data to receive).
+ *
+ * @retval NRFX_SUCCESS              Preparation finished properly.
+ * @retval NRFX_ERROR_INVALID_ADDR   Given @em p_buf is not placed inside the RAM.
+ * @retval NRFX_ERROR_INVALID_LENGTH Wrong value in @em size parameter.
+ * @retval NRFX_ERROR_INVALID_STATE  Module not initialized or not enabled.
+ */
+nrfx_err_t nrfx_twis_rx_prepare(nrfx_twis_t const * p_instance,
+                                void *              p_buf,
+                                size_t              size);
+
+/**
+ * @brief Get number of received bytes.
+ *
+ * Function returns number of bytes received.
+ * This function may be called after @ref NRFX_TWIS_EVT_WRITE_DONE or @ref NRFX_TWIS_EVT_WRITE_ERROR events.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @return Number of bytes received.
+ */
+__STATIC_INLINE size_t nrfx_twis_rx_amount(nrfx_twis_t const * p_instance);
+
+/**
+ * @brief Function checks if driver is busy right now.
+ *
+ * Actual driver substate is tested.
+ * If driver is in any other state than IDLE or ERROR this function returns true.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  Driver is in state other than ERROR or IDLE.
+ * @retval false There is no transmission pending.
+ */
+bool nrfx_twis_is_busy(nrfx_twis_t const * p_instance);
+
+/**
+ * @brief Function checks if driver is waiting for tx buffer.
+ *
+ * If this function returns true, it means that driver is stalled expecting
+ * of the @ref nrfx_twis_tx_prepare function call.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  Driver waits for @ref nrfx_twis_tx_prepare.
+ * @retval false Driver is not in the state where it waits for preparing tx buffer.
+ */
+bool nrfx_twis_is_waiting_tx_buff(nrfx_twis_t const * p_instance);
+
+/**
+ * @brief Function checks if driver is waiting for rx buffer.
+ *
+ * If this function returns true, it means that driver is staled expecting
+ * of the @ref nrfx_twis_rx_prepare function call.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  Driver waits for @ref nrfx_twis_rx_prepare.
+ * @retval false Driver is not in the state where it waits for preparing rx buffer.
+ */
+bool nrfx_twis_is_waiting_rx_buff(nrfx_twis_t const * p_instance);
+
+/**
+ * @brief Check if driver is sending data.
+ *
+ * If this function returns true, it means that there is ongoing output transmission.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  There is ongoing output transmission.
+ * @retval false Driver is in other state.
+ */
+bool nrfx_twis_is_pending_tx(nrfx_twis_t const * p_instance);
+
+/**
+ * @brief Check if driver is receiving data.
+ *
+ * If this function returns true, it means that there is ongoing input transmission.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  There is ongoing input transmission.
+ * @retval false Driver is in other state.
+ */
+bool nrfx_twis_is_pending_rx(nrfx_twis_t const * p_instance);
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+__STATIC_INLINE size_t nrfx_twis_tx_amount(nrfx_twis_t const * p_instance)
+{
+    return nrf_twis_tx_amount_get(p_instance->p_reg);
+}
+
+__STATIC_INLINE size_t nrfx_twis_rx_amount(nrfx_twis_t const * p_instance)
+{
+    return nrf_twis_rx_amount_get(p_instance->p_reg);
+}
+#endif // SUPPRESS_INLINE_IMPLEMENTATION
+
+
+void nrfx_twis_0_irq_handler(void);
+void nrfx_twis_1_irq_handler(void);
+void nrfx_twis_2_irq_handler(void);
+void nrfx_twis_3_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_TWIS_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_uart.h

@@ -1,365 +1,367 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_UART_H__
-#define NRFX_UART_H__
-
-#include <nrfx.h>
-#include <hal/nrf_uart.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_uart UART driver
- * @{
- * @ingroup nrf_uart
- * @brief   UART peripheral driver.
- */
-
-/**
- * @brief UART driver instance data structure.
- */
-typedef struct
-{
-    NRF_UART_Type * p_reg;        ///< Pointer to a structure with UART registers.
-    uint8_t         drv_inst_idx; ///< Driver instance index.
-} nrfx_uart_t;
-
-enum {
-#if NRFX_CHECK(NRFX_UART0_ENABLED)
-    NRFX_UART0_INST_IDX,
-#endif
-    NRFX_UART_ENABLED_COUNT
-};
-
-/**
- * @brief Macro for creating a UART driver instance.
- */
-#define NRFX_UART_INSTANCE(id)                               \
-{                                                            \
-    .p_reg        = NRFX_CONCAT_2(NRF_UART, id),             \
-    .drv_inst_idx = NRFX_CONCAT_3(NRFX_UART, id, _INST_IDX), \
-}
-
-/**
- * @brief Types of UART driver events.
- */
-typedef enum
-{
-    NRFX_UART_EVT_TX_DONE, ///< Requested TX transfer completed.
-    NRFX_UART_EVT_RX_DONE, ///< Requested RX transfer completed.
-    NRFX_UART_EVT_ERROR,   ///< Error reported by UART peripheral.
-} nrfx_uart_evt_type_t;
-
-/**
- * @brief Structure for UART configuration.
- */
-typedef struct
-{
-    uint32_t            pseltxd;            ///< TXD pin number.
-    uint32_t            pselrxd;            ///< RXD pin number.
-    uint32_t            pselcts;            ///< CTS pin number.
-    uint32_t            pselrts;            ///< RTS pin number.
-    void *              p_context;          ///< Context passed to interrupt handler.
-    nrf_uart_hwfc_t     hwfc;               ///< Flow control configuration.
-    nrf_uart_parity_t   parity;             ///< Parity configuration.
-    nrf_uart_baudrate_t baudrate;           ///< Baudrate.
-    uint8_t             interrupt_priority; ///< Interrupt priority.
-} nrfx_uart_config_t;
-
-/**
- * @brief UART default configuration.
- */
-#define NRFX_UART_DEFAULT_CONFIG                                                  \
-{                                                                                 \
-    .pseltxd            = NRF_UART_PSEL_DISCONNECTED,                             \
-    .pselrxd            = NRF_UART_PSEL_DISCONNECTED,                             \
-    .pselcts            = NRF_UART_PSEL_DISCONNECTED,                             \
-    .pselrts            = NRF_UART_PSEL_DISCONNECTED,                             \
-    .p_context          = NULL,                                                   \
-    .hwfc               = (nrf_uart_hwfc_t)NRFX_UART_DEFAULT_CONFIG_HWFC,         \
-    .parity             = (nrf_uart_parity_t)NRFX_UART_DEFAULT_CONFIG_PARITY,     \
-    .baudrate           = (nrf_uart_baudrate_t)NRFX_UART_DEFAULT_CONFIG_BAUDRATE, \
-    .interrupt_priority = NRFX_UART_DEFAULT_CONFIG_IRQ_PRIORITY,                  \
-}
-
-/**
- * @brief Structure for UART transfer completion event.
- */
-typedef struct
-{
-    uint8_t * p_data; ///< Pointer to memory used for transfer.
-    uint32_t  bytes;  ///< Number of bytes transfered.
-} nrfx_uart_xfer_evt_t;
-
-/**
- * @brief Structure for UART error event.
- */
-typedef struct
-{
-    nrfx_uart_xfer_evt_t rxtx;       ///< Transfer details includes number of bytes transferred.
-    uint32_t             error_mask; ///< Mask of error flags that generated the event.
-} nrfx_uart_error_evt_t;
-
-/**
- * @brief Structure for UART event.
- */
-typedef struct
-{
-    nrfx_uart_evt_type_t type; ///< Event type.
-    union
-    {
-        nrfx_uart_xfer_evt_t  rxtx;  ///< Data provided for transfer completion events.
-        nrfx_uart_error_evt_t error; ///< Data provided for error event.
-    } data;
-} nrfx_uart_event_t;
-
-/**
- * @brief UART interrupt event handler.
- *
- * @param[in] p_event    Pointer to event structure. Event is allocated on the stack so it is available
- *                       only within the context of the event handler.
- * @param[in] p_context  Context passed to interrupt handler, set on initialization.
- */
-typedef void (*nrfx_uart_event_handler_t)(nrfx_uart_event_t const * p_event,
-                                          void *                    p_context);
-
-/**
- * @brief Function for initializing the UART driver.
- *
- * This function configures and enables UART. After this function GPIO pins are controlled by UART.
- *
- * @param[in] p_instance    Pointer to the driver instance structure.
- * @param[in] p_config      Pointer to the structure with initial configuration.
- * @param[in] event_handler Event handler provided by the user. If not provided driver works in
- *                          blocking mode.
- *
- * @retval    NRFX_SUCCESS             If initialization was successful.
- * @retval    NRFX_ERROR_INVALID_STATE If driver is already initialized.
- * @retval    NRFX_ERROR_BUSY          If some other peripheral with the same
- *                                     instance ID is already in use. This is
- *                                     possible only if @ref nrfx_prs module
- *                                     is enabled.
- */
-nrfx_err_t nrfx_uart_init(nrfx_uart_t const *        p_instance,
-                          nrfx_uart_config_t const * p_config,
-                          nrfx_uart_event_handler_t  event_handler);
-
-/**
- * @brief Function for uninitializing  the UART driver.
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_uart_uninit(nrfx_uart_t const * p_instance);
-
-/**
- * @brief Function for getting the address of a specific UART task.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] task       Task.
- *
- * @return    Task address.
- */
-__STATIC_INLINE uint32_t nrfx_uart_task_address_get(nrfx_uart_t const * p_instance,
-                                                    nrf_uart_task_t     task);
-
-/**
- * @brief Function for getting the address of a specific UART event.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] event      Event.
- *
- * @return    Event address.
- */
-__STATIC_INLINE uint32_t nrfx_uart_event_address_get(nrfx_uart_t const * p_instance,
-                                                     nrf_uart_event_t    event);
-
-/**
- * @brief Function for sending data over UART.
- *
- * If an event handler was provided in nrfx_uart_init() call, this function
- * returns immediately and the handler is called when the transfer is done.
- * Otherwise, the transfer is performed in blocking mode, i.e. this function
- * returns when the transfer is finished. Blocking mode is not using interrupt
- * so there is no context switching inside the function.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] p_data     Pointer to data.
- * @param[in] length     Number of bytes to send.
- *
- * @retval    NRFX_SUCCESS            If initialization was successful.
- * @retval    NRFX_ERROR_BUSY         If driver is already transferring.
- * @retval    NRFX_ERROR_FORBIDDEN    If the transfer was aborted from a different context
- *                                    (blocking mode only).
- */
-nrfx_err_t nrfx_uart_tx(nrfx_uart_t const * p_instance,
-                        uint8_t const *     p_data,
-                        size_t              length);
-
-/**
- * @brief Function for checking if UART is currently transmitting.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  If UART is transmitting.
- * @retval false If UART is not transmitting.
- */
-bool nrfx_uart_tx_in_progress(nrfx_uart_t const * p_instance);
-
-/**
- * @brief Function for aborting any ongoing transmission.
- * @note @ref NRFX_UART_EVT_TX_DONE event will be generated in non-blocking mode.
- *       It will contain number of bytes sent until abort was called. The event
- *       handler will be called from the function context.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_uart_tx_abort(nrfx_uart_t const * p_instance);
-
-/**
- * @brief Function for receiving data over UART.
- *
- * If an event handler was provided in the nrfx_uart_init() call, this function
- * returns immediately and the handler is called when the transfer is done.
- * Otherwise, the transfer is performed in blocking mode, i.e. this function
- * returns when the transfer is finished. Blocking mode is not using interrupt so
- * there is no context switching inside the function.
- * The receive buffer pointer is double buffered in non-blocking mode. The secondary
- * buffer can be set immediately after starting the transfer and will be filled
- * when the primary buffer is full. The double buffering feature allows
- * receiving data continuously.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] p_data     Pointer to data.
- * @param[in] length     Number of bytes to receive.
- *
- * @retval    NRFX_SUCCESS If initialization was successful.
- * @retval    NRFX_ERROR_BUSY If the driver is already receiving
- *                            (and the secondary buffer has already been set
- *                            in non-blocking mode).
- * @retval    NRFX_ERROR_FORBIDDEN If the transfer was aborted from a different context
- *                                (blocking mode only, also see @ref nrfx_uart_rx_disable).
- * @retval    NRFX_ERROR_INTERNAL If UART peripheral reported an error.
- */
-nrfx_err_t nrfx_uart_rx(nrfx_uart_t const * p_instance,
-                        uint8_t *           p_data,
-                        size_t              length);
-
-
-
-/**
- * @brief Function for testing the receiver state in blocking mode.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  If the receiver has at least one byte of data to get.
- * @retval false If the receiver is empty.
- */
-bool nrfx_uart_rx_ready(nrfx_uart_t const * p_instance);
-
-/**
- * @brief Function for enabling the receiver.
- *
- * UART has a 6-byte-long RX FIFO and it is used to store incoming data. If a user does not call the
- * UART receive function before the FIFO is filled, an overrun error will appear. The receiver must be
- * explicitly closed by the user @sa nrfx_uart_rx_disable.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_uart_rx_enable(nrfx_uart_t const * p_instance);
-
-/**
- * @brief Function for disabling the receiver.
- *
- * This function must be called to close the receiver after it has been explicitly enabled by
- * @sa nrfx_uart_rx_enable.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_uart_rx_disable(nrfx_uart_t const * p_instance);
-
-/**
- * @brief Function for aborting any ongoing reception.
- * @note @ref NRFX_UART_EVT_TX_DONE event will be generated in non-blocking mode.
- *       It will contain number of bytes received until abort was called. The event
- *       handler will be called from the UART interrupt context.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_uart_rx_abort(nrfx_uart_t const * p_instance);
-
-/**
- * @brief Function for reading error source mask. Mask contains values from @ref nrf_uart_error_mask_t.
- * @note Function should be used in blocking mode only. In case of non-blocking mode, an error event is
- *       generated. Function clears error sources after reading.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval    Mask of reported errors.
- */
-uint32_t nrfx_uart_errorsrc_get(nrfx_uart_t const * p_instance);
-
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-__STATIC_INLINE uint32_t nrfx_uart_task_address_get(nrfx_uart_t const * p_instance,
-                                                    nrf_uart_task_t     task)
-{
-    return nrf_uart_task_address_get(p_instance->p_reg, task);
-}
-
-__STATIC_INLINE uint32_t nrfx_uart_event_address_get(nrfx_uart_t const * p_instance,
-                                                     nrf_uart_event_t    event)
-{
-    return nrf_uart_event_address_get(p_instance->p_reg, event);
-}
-#endif // SUPPRESS_INLINE_IMPLEMENTATION
-
-
-void nrfx_uart_0_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_UART_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_UART_H__
+#define NRFX_UART_H__
+
+#include <nrfx.h>
+#include <hal/nrf_uart.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_uart UART driver
+ * @{
+ * @ingroup nrf_uart
+ * @brief   UART peripheral driver.
+ */
+
+/**
+ * @brief UART driver instance data structure.
+ */
+typedef struct
+{
+    NRF_UART_Type * p_reg;        ///< Pointer to a structure with UART registers.
+    uint8_t         drv_inst_idx; ///< Driver instance index.
+} nrfx_uart_t;
+
+enum {
+#if NRFX_CHECK(NRFX_UART0_ENABLED)
+    NRFX_UART0_INST_IDX,
+#endif
+    NRFX_UART_ENABLED_COUNT
+};
+
+/**
+ * @brief Macro for creating a UART driver instance.
+ */
+#define NRFX_UART_INSTANCE(id)                               \
+{                                                            \
+    .p_reg        = NRFX_CONCAT_2(NRF_UART, id),             \
+    .drv_inst_idx = NRFX_CONCAT_3(NRFX_UART, id, _INST_IDX), \
+}
+
+/**
+ * @brief Types of UART driver events.
+ */
+typedef enum
+{
+    NRFX_UART_EVT_TX_DONE, ///< Requested TX transfer completed.
+    NRFX_UART_EVT_RX_DONE, ///< Requested RX transfer completed.
+    NRFX_UART_EVT_ERROR,   ///< Error reported by UART peripheral.
+} nrfx_uart_evt_type_t;
+
+/**
+ * @brief Structure for UART configuration.
+ */
+typedef struct
+{
+    uint32_t            pseltxd;            ///< TXD pin number.
+    uint32_t            pselrxd;            ///< RXD pin number.
+    uint32_t            pselcts;            ///< CTS pin number.
+    uint32_t            pselrts;            ///< RTS pin number.
+    void *              p_context;          ///< Context passed to interrupt handler.
+    nrf_uart_hwfc_t     hwfc;               ///< Flow control configuration.
+    nrf_uart_parity_t   parity;             ///< Parity configuration.
+    nrf_uart_baudrate_t baudrate;           ///< Baudrate.
+    uint8_t             interrupt_priority; ///< Interrupt priority.
+} nrfx_uart_config_t;
+
+/**
+ * @brief UART default configuration.
+ */
+#define NRFX_UART_DEFAULT_CONFIG                                                  \
+{                                                                                 \
+    .pseltxd            = NRF_UART_PSEL_DISCONNECTED,                             \
+    .pselrxd            = NRF_UART_PSEL_DISCONNECTED,                             \
+    .pselcts            = NRF_UART_PSEL_DISCONNECTED,                             \
+    .pselrts            = NRF_UART_PSEL_DISCONNECTED,                             \
+    .p_context          = NULL,                                                   \
+    .hwfc               = (nrf_uart_hwfc_t)NRFX_UART_DEFAULT_CONFIG_HWFC,         \
+    .parity             = (nrf_uart_parity_t)NRFX_UART_DEFAULT_CONFIG_PARITY,     \
+    .baudrate           = (nrf_uart_baudrate_t)NRFX_UART_DEFAULT_CONFIG_BAUDRATE, \
+    .interrupt_priority = NRFX_UART_DEFAULT_CONFIG_IRQ_PRIORITY,                  \
+}
+
+/**
+ * @brief Structure for UART transfer completion event.
+ */
+typedef struct
+{
+    uint8_t * p_data; ///< Pointer to memory used for transfer.
+    uint32_t  bytes;  ///< Number of bytes transfered.
+} nrfx_uart_xfer_evt_t;
+
+/**
+ * @brief Structure for UART error event.
+ */
+typedef struct
+{
+    nrfx_uart_xfer_evt_t rxtx;       ///< Transfer details includes number of bytes transferred.
+    uint32_t             error_mask; ///< Mask of error flags that generated the event.
+} nrfx_uart_error_evt_t;
+
+/**
+ * @brief Structure for UART event.
+ */
+typedef struct
+{
+    nrfx_uart_evt_type_t type; ///< Event type.
+    union
+    {
+        nrfx_uart_xfer_evt_t  rxtx;  ///< Data provided for transfer completion events.
+        nrfx_uart_error_evt_t error; ///< Data provided for error event.
+    } data;
+} nrfx_uart_event_t;
+
+/**
+ * @brief UART interrupt event handler.
+ *
+ * @param[in] p_event    Pointer to event structure. Event is allocated on the stack so it is available
+ *                       only within the context of the event handler.
+ * @param[in] p_context  Context passed to interrupt handler, set on initialization.
+ */
+typedef void (*nrfx_uart_event_handler_t)(nrfx_uart_event_t const * p_event,
+                                          void *                    p_context);
+
+/**
+ * @brief Function for initializing the UART driver.
+ *
+ * This function configures and enables UART. After this function GPIO pins are controlled by UART.
+ *
+ * @param[in] p_instance    Pointer to the driver instance structure.
+ * @param[in] p_config      Pointer to the structure with initial configuration.
+ * @param[in] event_handler Event handler provided by the user. If not provided driver works in
+ *                          blocking mode.
+ *
+ * @retval    NRFX_SUCCESS             If initialization was successful.
+ * @retval    NRFX_ERROR_INVALID_STATE If driver is already initialized.
+ * @retval    NRFX_ERROR_BUSY          If some other peripheral with the same
+ *                                     instance ID is already in use. This is
+ *                                     possible only if @ref nrfx_prs module
+ *                                     is enabled.
+ */
+nrfx_err_t nrfx_uart_init(nrfx_uart_t const *        p_instance,
+                          nrfx_uart_config_t const * p_config,
+                          nrfx_uart_event_handler_t  event_handler);
+
+/**
+ * @brief Function for uninitializing  the UART driver.
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_uart_uninit(nrfx_uart_t const * p_instance);
+
+/**
+ * @brief Function for getting the address of a specific UART task.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] task       Task.
+ *
+ * @return    Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_uart_task_address_get(nrfx_uart_t const * p_instance,
+                                                    nrf_uart_task_t     task);
+
+/**
+ * @brief Function for getting the address of a specific UART event.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] event      Event.
+ *
+ * @return    Event address.
+ */
+__STATIC_INLINE uint32_t nrfx_uart_event_address_get(nrfx_uart_t const * p_instance,
+                                                     nrf_uart_event_t    event);
+
+/**
+ * @brief Function for sending data over UART.
+ *
+ * If an event handler was provided in nrfx_uart_init() call, this function
+ * returns immediately and the handler is called when the transfer is done.
+ * Otherwise, the transfer is performed in blocking mode, i.e. this function
+ * returns when the transfer is finished. Blocking mode is not using interrupt
+ * so there is no context switching inside the function.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] p_data     Pointer to data.
+ * @param[in] length     Number of bytes to send.
+ *
+ * @retval    NRFX_SUCCESS            If initialization was successful.
+ * @retval    NRFX_ERROR_BUSY         If driver is already transferring.
+ * @retval    NRFX_ERROR_FORBIDDEN    If the transfer was aborted from a different context
+ *                                    (blocking mode only).
+ */
+nrfx_err_t nrfx_uart_tx(nrfx_uart_t const * p_instance,
+                        uint8_t const *     p_data,
+                        size_t              length);
+
+/**
+ * @brief Function for checking if UART is currently transmitting.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  If UART is transmitting.
+ * @retval false If UART is not transmitting.
+ */
+bool nrfx_uart_tx_in_progress(nrfx_uart_t const * p_instance);
+
+/**
+ * @brief Function for aborting any ongoing transmission.
+ * @note @ref NRFX_UART_EVT_TX_DONE event will be generated in non-blocking mode.
+ *       It will contain number of bytes sent until abort was called. The event
+ *       handler will be called from the function context.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_uart_tx_abort(nrfx_uart_t const * p_instance);
+
+/**
+ * @brief Function for receiving data over UART.
+ *
+ * If an event handler was provided in the nrfx_uart_init() call, this function
+ * returns immediately and the handler is called when the transfer is done.
+ * Otherwise, the transfer is performed in blocking mode, meaning that this function
+ * returns when the transfer is finished. Blocking mode is not using interrupt so
+ * there is no context switching inside the function.
+ *
+ * The receive buffer pointer is double buffered in non-blocking mode. The secondary
+ * buffer can be set immediately after starting the transfer and will be filled
+ * when the primary buffer is full. The double buffering feature allows
+ * receiving data continuously.
+ *
+ * If this function is used without a previous call to @ref nrfx_uart_rx_enable, the reception
+ * will be stopped on error or when the supplied buffer fills up. In both cases,
+ * RX FIFO gets disabled. This means that, in case of error, the bytes that follow are lost.
+ * If this nrfx_uart_rx() function is used with the previous call to @ref nrfx_uart_rx_enable,
+ * the reception is stopped in case of error, but FIFO is still ongoing. The receiver is still
+ * working, so after handling the error, an immediate repeated call to this nrfx_uart_rx()
+ * function with fresh data buffer will re-establish reception. To disable the receiver,
+ * you must call @ref nrfx_uart_rx_disable explicitly.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] p_data     Pointer to data.
+ * @param[in] length     Number of bytes to receive.
+ *
+ * @retval    NRFX_SUCCESS         If reception is complete (in case of blocking mode) or it is
+ *                                 successfully started (in case of non-blocking mode).
+ * @retval    NRFX_ERROR_BUSY      If the driver is already receiving
+ *                                 (and the secondary buffer has already been set
+ *                                 in non-blocking mode).
+ * @retval    NRFX_ERROR_FORBIDDEN If the transfer was aborted from a different context
+ *                                 (blocking mode only, also see @ref nrfx_uart_rx_disable).
+ * @retval    NRFX_ERROR_INTERNAL  If UART peripheral reported an error.
+ */
+nrfx_err_t nrfx_uart_rx(nrfx_uart_t const * p_instance,
+                        uint8_t *           p_data,
+                        size_t              length);
+
+
+
+/**
+ * @brief Function for testing the receiver state in blocking mode.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  If the receiver has at least one byte of data to get.
+ * @retval false If the receiver is empty.
+ */
+bool nrfx_uart_rx_ready(nrfx_uart_t const * p_instance);
+
+/**
+ * @brief Function for enabling the receiver.
+ *
+ * UART has a 6-byte-long RX FIFO and it is used to store incoming data. If a user does not call the
+ * UART receive function before the FIFO is filled, an overrun error will appear. The receiver must be
+ * explicitly closed by the user @sa nrfx_uart_rx_disable.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_uart_rx_enable(nrfx_uart_t const * p_instance);
+
+/**
+ * @brief Function for disabling the receiver.
+ *
+ * This function must be called to close the receiver after it has been explicitly enabled by
+ * @sa nrfx_uart_rx_enable.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_uart_rx_disable(nrfx_uart_t const * p_instance);
+
+/**
+ * @brief Function for aborting any ongoing reception.
+ * @note @ref NRFX_UART_EVT_TX_DONE event will be generated in non-blocking mode.
+ *       It will contain number of bytes received until abort was called. The event
+ *       handler will be called from the UART interrupt context.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_uart_rx_abort(nrfx_uart_t const * p_instance);
+
+/**
+ * @brief Function for reading error source mask. Mask contains values from @ref nrf_uart_error_mask_t.
+ * @note Function should be used in blocking mode only. In case of non-blocking mode, an error event is
+ *       generated. Function clears error sources after reading.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval    Mask of reported errors.
+ */
+uint32_t nrfx_uart_errorsrc_get(nrfx_uart_t const * p_instance);
+
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+__STATIC_INLINE uint32_t nrfx_uart_task_address_get(nrfx_uart_t const * p_instance,
+                                                    nrf_uart_task_t     task)
+{
+    return nrf_uart_task_address_get(p_instance->p_reg, task);
+}
+
+__STATIC_INLINE uint32_t nrfx_uart_event_address_get(nrfx_uart_t const * p_instance,
+                                                     nrf_uart_event_t    event)
+{
+    return nrf_uart_event_address_get(p_instance->p_reg, event);
+}
+#endif // SUPPRESS_INLINE_IMPLEMENTATION
+
+
+void nrfx_uart_0_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_UART_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_uarte.h

@@ -1,363 +1,362 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_UARTE_H__
-#define NRFX_UARTE_H__
-
-#include <nrfx.h>
-#include <hal/nrf_uarte.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_uarte UARTE driver
- * @{
- * @ingroup nrf_uarte
- * @brief   UARTE peripheral driver.
- */
-
-/**
- * @brief Structure for the UARTE driver instance.
- */
-typedef struct
-{
-    NRF_UARTE_Type * p_reg;        ///< Pointer to a structure with UARTE registers.
-    uint8_t          drv_inst_idx; ///< Driver instance index.
-} nrfx_uarte_t;
-
-enum {
-#if NRFX_CHECK(NRFX_UARTE0_ENABLED)
-    NRFX_UARTE0_INST_IDX,
-#endif
-#if NRFX_CHECK(NRFX_UARTE1_ENABLED)
-    NRFX_UARTE1_INST_IDX,
-#endif
-    NRFX_UARTE_ENABLED_COUNT
-};
-
-/**
- * @brief Macro for creating a UARTE driver instance.
- */
-#define NRFX_UARTE_INSTANCE(id)                               \
-{                                                             \
-    .p_reg        = NRFX_CONCAT_2(NRF_UARTE, id),             \
-    .drv_inst_idx = NRFX_CONCAT_3(NRFX_UARTE, id, _INST_IDX), \
-}
-
-/**
- * @brief Types of UARTE driver events.
- */
-typedef enum
-{
-    NRFX_UARTE_EVT_TX_DONE, ///< Requested TX transfer completed.
-    NRFX_UARTE_EVT_RX_DONE, ///< Requested RX transfer completed.
-    NRFX_UARTE_EVT_ERROR,   ///< Error reported by UART peripheral.
-} nrfx_uarte_evt_type_t;
-
-/**
- * @brief Structure for UARTE configuration.
- */
-typedef struct
-{
-    uint32_t             pseltxd;            ///< TXD pin number.
-    uint32_t             pselrxd;            ///< RXD pin number.
-    uint32_t             pselcts;            ///< CTS pin number.
-    uint32_t             pselrts;            ///< RTS pin number.
-    void *               p_context;          ///< Context passed to interrupt handler.
-    nrf_uarte_hwfc_t     hwfc;               ///< Flow control configuration.
-    nrf_uarte_parity_t   parity;             ///< Parity configuration.
-    nrf_uarte_baudrate_t baudrate;           ///< Baudrate.
-    uint8_t              interrupt_priority; ///< Interrupt priority.
-} nrfx_uarte_config_t;
-
-/**
- * @brief UARTE default configuration.
- */
-#define NRFX_UARTE_DEFAULT_CONFIG                                                   \
-{                                                                                   \
-    .pseltxd            = NRF_UARTE_PSEL_DISCONNECTED,                              \
-    .pselrxd            = NRF_UARTE_PSEL_DISCONNECTED,                              \
-    .pselcts            = NRF_UARTE_PSEL_DISCONNECTED,                              \
-    .pselrts            = NRF_UARTE_PSEL_DISCONNECTED,                              \
-    .p_context          = NULL,                                                     \
-    .hwfc               = (nrf_uarte_hwfc_t)NRFX_UARTE_DEFAULT_CONFIG_HWFC,         \
-    .parity             = (nrf_uarte_parity_t)NRFX_UARTE_DEFAULT_CONFIG_PARITY,     \
-    .baudrate           = (nrf_uarte_baudrate_t)NRFX_UARTE_DEFAULT_CONFIG_BAUDRATE, \
-    .interrupt_priority = NRFX_UARTE_DEFAULT_CONFIG_IRQ_PRIORITY,                   \
-}
-
-/**
- * @brief Structure for UARTE transfer completion event.
- */
-typedef struct
-{
-    uint8_t * p_data; ///< Pointer to memory used for transfer.
-    uint8_t   bytes;  ///< Number of bytes transfered.
-} nrfx_uarte_xfer_evt_t;
-
-/**
- * @brief Structure for UARTE error event.
- */
-typedef struct
-{
-    nrfx_uarte_xfer_evt_t rxtx;       ///< Transfer details includes number of bytes transferred.
-    uint32_t              error_mask; ///< Mask of error flags that generated the event.
-} nrfx_uarte_error_evt_t;
-
-/**
- * @brief Structure for UARTE event.
- */
-typedef struct
-{
-    nrfx_uarte_evt_type_t type; ///< Event type.
-    union
-    {
-        nrfx_uarte_xfer_evt_t  rxtx;  ///< Data provided for transfer completion events.
-        nrfx_uarte_error_evt_t error; ///< Data provided for error event.
-    } data;
-} nrfx_uarte_event_t;
-
-/**
- * @brief UARTE interrupt event handler.
- *
- * @param[in] p_event    Pointer to event structure. Event is allocated on the stack so it is available
- *                       only within the context of the event handler.
- * @param[in] p_context  Context passed to interrupt handler, set on initialization.
- */
-typedef void (*nrfx_uarte_event_handler_t)(nrfx_uarte_event_t const * p_event,
-                                           void *                     p_context);
-
-/**
- * @brief Function for initializing the UARTE driver.
- *
- * This function configures and enables UARTE. After this function GPIO pins are controlled by UARTE.
- *
- * @param[in] p_instance    Pointer to the driver instance structure.
- * @param[in] p_config      Pointer to the structure with initial configuration.
- * @param[in] event_handler Event handler provided by the user. If not provided driver works in
- *                          blocking mode.
- *
- * @retval    NRFX_SUCCESS             If initialization was successful.
- * @retval    NRFX_ERROR_INVALID_STATE If driver is already initialized.
- * @retval    NRFX_ERROR_BUSY          If some other peripheral with the same
- *                                     instance ID is already in use. This is
- *                                     possible only if @ref nrfx_prs module
- *                                     is enabled.
- */
-nrfx_err_t nrfx_uarte_init(nrfx_uarte_t const *        p_instance,
-                           nrfx_uarte_config_t const * p_config,
-                           nrfx_uarte_event_handler_t  event_handler);
-
-/**
- * @brief Function for uninitializing  the UARTE driver.
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_uarte_uninit(nrfx_uarte_t const * p_instance);
-
-/**
- * @brief Function for getting the address of a specific UARTE task.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] task       Task.
- *
- * @return    Task address.
- */
-__STATIC_INLINE uint32_t nrfx_uarte_task_address_get(nrfx_uarte_t const * p_instance,
-                                                     nrf_uarte_task_t     task);
-
-/**
- * @brief Function for getting the address of a specific UARTE event.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] event      Event.
- *
- * @return    Event address.
- */
-__STATIC_INLINE uint32_t nrfx_uarte_event_address_get(nrfx_uarte_t const * p_instance,
-                                                      nrf_uarte_event_t    event);
-
-/**
- * @brief Function for sending data over UARTE.
- *
- * If an event handler was provided in nrfx_uarte_init() call, this function
- * returns immediately and the handler is called when the transfer is done.
- * Otherwise, the transfer is performed in blocking mode, i.e. this function
- * returns when the transfer is finished. Blocking mode is not using interrupt
- * so there is no context switching inside the function.
- *
- * @note Peripherals using EasyDMA (including UARTE) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] p_data     Pointer to data.
- * @param[in] length     Number of bytes to send. Maximum possible length is
- *                       dependent on the used SoC (see the MAXCNT register
- *                       description in the Product Specification). The driver
- *                       checks it with assertion.
- *
- * @retval    NRFX_SUCCESS            If initialization was successful.
- * @retval    NRFX_ERROR_BUSY         If driver is already transferring.
- * @retval    NRFX_ERROR_FORBIDDEN    If the transfer was aborted from a different context
- *                                    (blocking mode only).
- * @retval    NRFX_ERROR_INVALID_ADDR If p_data does not point to RAM buffer.
- */
-nrfx_err_t nrfx_uarte_tx(nrfx_uarte_t const * p_instance,
-                         uint8_t const *      p_data,
-                         size_t               length);
-
-/**
- * @brief Function for checking if UARTE is currently transmitting.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  If UARTE is transmitting.
- * @retval false If UARTE is not transmitting.
- */
-bool nrfx_uarte_tx_in_progress(nrfx_uarte_t const * p_instance);
-
-/**
- * @brief Function for aborting any ongoing transmission.
- * @note @ref NRFX_UARTE_EVT_TX_DONE event will be generated in non-blocking mode.
- *       It will contain number of bytes sent until abort was called. The event
- *       handler will be called from UARTE interrupt context.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_uarte_tx_abort(nrfx_uarte_t const * p_instance);
-
-/**
- * @brief Function for receiving data over UARTE.
- *
- * If an event handler was provided in the nrfx_uarte_init() call, this function
- * returns immediately and the handler is called when the transfer is done.
- * Otherwise, the transfer is performed in blocking mode, i.e. this function
- * returns when the transfer is finished. Blocking mode is not using interrupt so
- * there is no context switching inside the function.
- * The receive buffer pointer is double buffered in non-blocking mode. The secondary
- * buffer can be set immediately after starting the transfer and will be filled
- * when the primary buffer is full. The double buffering feature allows
- * receiving data continuously.
- *
- * @note Peripherals using EasyDMA (including UARTE) require the transfer buffers
- *       to be placed in the Data RAM region. If this condition is not met,
- *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- * @param[in] p_data     Pointer to data.
- * @param[in] length     Number of bytes to receive. Maximum possible length is
- *                       dependent on the used SoC (see the MAXCNT register
- *                       description in the Product Specification). The driver
- *                       checks it with assertion.
- *
- * @retval    NRFX_SUCCESS            If initialization was successful.
- * @retval    NRFX_ERROR_BUSY         If the driver is already receiving
- *                                    (and the secondary buffer has already been set
- *                                    in non-blocking mode).
- * @retval    NRFX_ERROR_FORBIDDEN    If the transfer was aborted from a different context
- *                                    (blocking mode only).
- * @retval    NRFX_ERROR_INTERNAL     If UARTE peripheral reported an error.
- * @retval    NRFX_ERROR_INVALID_ADDR If p_data does not point to RAM buffer.
- */
-nrfx_err_t nrfx_uarte_rx(nrfx_uarte_t const * p_instance,
-                         uint8_t *            p_data,
-                         size_t               length);
-
-
-
-/**
- * @brief Function for testing the receiver state in blocking mode.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval true  If the receiver has at least one byte of data to get.
- * @retval false If the receiver is empty.
- */
-bool nrfx_uarte_rx_ready(nrfx_uarte_t const * p_instance);
-
-/**
- * @brief Function for aborting any ongoing reception.
- * @note @ref NRFX_UARTE_EVT_RX_DONE event will be generated in non-blocking mode.
- *       It will contain number of bytes received until abort was called. The event
- *       handler will be called from UARTE interrupt context.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- */
-void nrfx_uarte_rx_abort(nrfx_uarte_t const * p_instance);
-
-/**
- * @brief Function for reading error source mask. Mask contains values from @ref nrf_uarte_error_mask_t.
- * @note Function should be used in blocking mode only. In case of non-blocking mode, an error event is
- *       generated. Function clears error sources after reading.
- *
- * @param[in] p_instance Pointer to the driver instance structure.
- *
- * @retval    Mask of reported errors.
- */
-uint32_t nrfx_uarte_errorsrc_get(nrfx_uarte_t const * p_instance);
-
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-__STATIC_INLINE uint32_t nrfx_uarte_task_address_get(nrfx_uarte_t const * p_instance,
-                                                     nrf_uarte_task_t     task)
-{
-    return nrf_uarte_task_address_get(p_instance->p_reg, task);
-}
-
-__STATIC_INLINE uint32_t nrfx_uarte_event_address_get(nrfx_uarte_t const * p_instance,
-                                                      nrf_uarte_event_t    event)
-{
-    return nrf_uarte_event_address_get(p_instance->p_reg, event);
-}
-#endif // SUPPRESS_INLINE_IMPLEMENTATION
-
-
-void nrfx_uarte_0_irq_handler(void);
-void nrfx_uarte_1_irq_handler(void);
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_UARTE_H__
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_UARTE_H__
+#define NRFX_UARTE_H__
+
+#include <nrfx.h>
+#include <hal/nrf_uarte.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_uarte UARTE driver
+ * @{
+ * @ingroup nrf_uarte
+ * @brief   UARTE peripheral driver.
+ */
+
+/**
+ * @brief Structure for the UARTE driver instance.
+ */
+typedef struct
+{
+    NRF_UARTE_Type * p_reg;        ///< Pointer to a structure with UARTE registers.
+    uint8_t          drv_inst_idx; ///< Driver instance index.
+} nrfx_uarte_t;
+
+enum {
+#if NRFX_CHECK(NRFX_UARTE0_ENABLED)
+    NRFX_UARTE0_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_UARTE1_ENABLED)
+    NRFX_UARTE1_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_UARTE2_ENABLED)
+    NRFX_UARTE2_INST_IDX,
+#endif
+#if NRFX_CHECK(NRFX_UARTE3_ENABLED)
+    NRFX_UARTE3_INST_IDX,
+#endif
+    NRFX_UARTE_ENABLED_COUNT
+};
+
+/**
+ * @brief Macro for creating a UARTE driver instance.
+ */
+#define NRFX_UARTE_INSTANCE(id)                               \
+{                                                             \
+    .p_reg        = NRFX_CONCAT_2(NRF_UARTE, id),             \
+    .drv_inst_idx = NRFX_CONCAT_3(NRFX_UARTE, id, _INST_IDX), \
+}
+
+/**
+ * @brief Types of UARTE driver events.
+ */
+typedef enum
+{
+    NRFX_UARTE_EVT_TX_DONE, ///< Requested TX transfer completed.
+    NRFX_UARTE_EVT_RX_DONE, ///< Requested RX transfer completed.
+    NRFX_UARTE_EVT_ERROR,   ///< Error reported by UART peripheral.
+} nrfx_uarte_evt_type_t;
+
+/**
+ * @brief Structure for UARTE configuration.
+ */
+typedef struct
+{
+    uint32_t             pseltxd;            ///< TXD pin number.
+    uint32_t             pselrxd;            ///< RXD pin number.
+    uint32_t             pselcts;            ///< CTS pin number.
+    uint32_t             pselrts;            ///< RTS pin number.
+    void *               p_context;          ///< Context passed to interrupt handler.
+    nrf_uarte_hwfc_t     hwfc;               ///< Flow control configuration.
+    nrf_uarte_parity_t   parity;             ///< Parity configuration.
+    nrf_uarte_baudrate_t baudrate;           ///< Baudrate.
+    uint8_t              interrupt_priority; ///< Interrupt priority.
+} nrfx_uarte_config_t;
+
+/**
+ * @brief UARTE default configuration.
+ */
+#define NRFX_UARTE_DEFAULT_CONFIG                                                   \
+{                                                                                   \
+    .pseltxd            = NRF_UARTE_PSEL_DISCONNECTED,                              \
+    .pselrxd            = NRF_UARTE_PSEL_DISCONNECTED,                              \
+    .pselcts            = NRF_UARTE_PSEL_DISCONNECTED,                              \
+    .pselrts            = NRF_UARTE_PSEL_DISCONNECTED,                              \
+    .p_context          = NULL,                                                     \
+    .hwfc               = (nrf_uarte_hwfc_t)NRFX_UARTE_DEFAULT_CONFIG_HWFC,         \
+    .parity             = (nrf_uarte_parity_t)NRFX_UARTE_DEFAULT_CONFIG_PARITY,     \
+    .baudrate           = (nrf_uarte_baudrate_t)NRFX_UARTE_DEFAULT_CONFIG_BAUDRATE, \
+    .interrupt_priority = NRFX_UARTE_DEFAULT_CONFIG_IRQ_PRIORITY,                   \
+}
+
+/**
+ * @brief Structure for UARTE transfer completion event.
+ */
+typedef struct
+{
+    uint8_t * p_data; ///< Pointer to memory used for transfer.
+    size_t    bytes;  ///< Number of bytes transfered.
+} nrfx_uarte_xfer_evt_t;
+
+/**
+ * @brief Structure for UARTE error event.
+ */
+typedef struct
+{
+    nrfx_uarte_xfer_evt_t rxtx;       ///< Transfer details includes number of bytes transferred.
+    uint32_t              error_mask; ///< Mask of error flags that generated the event.
+} nrfx_uarte_error_evt_t;
+
+/**
+ * @brief Structure for UARTE event.
+ */
+typedef struct
+{
+    nrfx_uarte_evt_type_t type; ///< Event type.
+    union
+    {
+        nrfx_uarte_xfer_evt_t  rxtx;  ///< Data provided for transfer completion events.
+        nrfx_uarte_error_evt_t error; ///< Data provided for error event.
+    } data;
+} nrfx_uarte_event_t;
+
+/**
+ * @brief UARTE interrupt event handler.
+ *
+ * @param[in] p_event    Pointer to event structure. Event is allocated on the stack so it is available
+ *                       only within the context of the event handler.
+ * @param[in] p_context  Context passed to interrupt handler, set on initialization.
+ */
+typedef void (*nrfx_uarte_event_handler_t)(nrfx_uarte_event_t const * p_event,
+                                           void *                     p_context);
+
+/**
+ * @brief Function for initializing the UARTE driver.
+ *
+ * This function configures and enables UARTE. After this function GPIO pins are controlled by UARTE.
+ *
+ * @param[in] p_instance    Pointer to the driver instance structure.
+ * @param[in] p_config      Pointer to the structure with initial configuration.
+ * @param[in] event_handler Event handler provided by the user. If not provided driver works in
+ *                          blocking mode.
+ *
+ * @retval    NRFX_SUCCESS             If initialization was successful.
+ * @retval    NRFX_ERROR_INVALID_STATE If driver is already initialized.
+ * @retval    NRFX_ERROR_BUSY          If some other peripheral with the same
+ *                                     instance ID is already in use. This is
+ *                                     possible only if @ref nrfx_prs module
+ *                                     is enabled.
+ */
+nrfx_err_t nrfx_uarte_init(nrfx_uarte_t const *        p_instance,
+                           nrfx_uarte_config_t const * p_config,
+                           nrfx_uarte_event_handler_t  event_handler);
+
+/**
+ * @brief Function for uninitializing  the UARTE driver.
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_uarte_uninit(nrfx_uarte_t const * p_instance);
+
+/**
+ * @brief Function for getting the address of a specific UARTE task.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] task       Task.
+ *
+ * @return    Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_uarte_task_address_get(nrfx_uarte_t const * p_instance,
+                                                     nrf_uarte_task_t     task);
+
+/**
+ * @brief Function for getting the address of a specific UARTE event.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] event      Event.
+ *
+ * @return    Event address.
+ */
+__STATIC_INLINE uint32_t nrfx_uarte_event_address_get(nrfx_uarte_t const * p_instance,
+                                                      nrf_uarte_event_t    event);
+
+/**
+ * @brief Function for sending data over UARTE.
+ *
+ * If an event handler was provided in nrfx_uarte_init() call, this function
+ * returns immediately and the handler is called when the transfer is done.
+ * Otherwise, the transfer is performed in blocking mode, i.e. this function
+ * returns when the transfer is finished. Blocking mode is not using interrupt
+ * so there is no context switching inside the function.
+ *
+ * @note Peripherals using EasyDMA (including UARTE) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] p_data     Pointer to data.
+ * @param[in] length     Number of bytes to send. Maximum possible length is
+ *                       dependent on the used SoC (see the MAXCNT register
+ *                       description in the Product Specification). The driver
+ *                       checks it with assertion.
+ *
+ * @retval    NRFX_SUCCESS            If initialization was successful.
+ * @retval    NRFX_ERROR_BUSY         If driver is already transferring.
+ * @retval    NRFX_ERROR_FORBIDDEN    If the transfer was aborted from a different context
+ *                                    (blocking mode only).
+ * @retval    NRFX_ERROR_INVALID_ADDR If p_data does not point to RAM buffer.
+ */
+nrfx_err_t nrfx_uarte_tx(nrfx_uarte_t const * p_instance,
+                         uint8_t const *      p_data,
+                         size_t               length);
+
+/**
+ * @brief Function for checking if UARTE is currently transmitting.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  If UARTE is transmitting.
+ * @retval false If UARTE is not transmitting.
+ */
+bool nrfx_uarte_tx_in_progress(nrfx_uarte_t const * p_instance);
+
+/**
+ * @brief Function for aborting any ongoing transmission.
+ * @note @ref NRFX_UARTE_EVT_TX_DONE event will be generated in non-blocking mode.
+ *       It will contain number of bytes sent until abort was called. The event
+ *       handler will be called from UARTE interrupt context.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_uarte_tx_abort(nrfx_uarte_t const * p_instance);
+
+/**
+ * @brief Function for receiving data over UARTE.
+ *
+ * If an event handler was provided in the nrfx_uarte_init() call, this function
+ * returns immediately and the handler is called when the transfer is done.
+ * Otherwise, the transfer is performed in blocking mode, i.e. this function
+ * returns when the transfer is finished. Blocking mode is not using interrupt so
+ * there is no context switching inside the function.
+ * The receive buffer pointer is double buffered in non-blocking mode. The secondary
+ * buffer can be set immediately after starting the transfer and will be filled
+ * when the primary buffer is full. The double buffering feature allows
+ * receiving data continuously.
+ *
+ * @note Peripherals using EasyDMA (including UARTE) require the transfer buffers
+ *       to be placed in the Data RAM region. If this condition is not met,
+ *       this function will fail with the error code NRFX_ERROR_INVALID_ADDR.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ * @param[in] p_data     Pointer to data.
+ * @param[in] length     Number of bytes to receive. Maximum possible length is
+ *                       dependent on the used SoC (see the MAXCNT register
+ *                       description in the Product Specification). The driver
+ *                       checks it with assertion.
+ *
+ * @retval    NRFX_SUCCESS            If initialization was successful.
+ * @retval    NRFX_ERROR_BUSY         If the driver is already receiving
+ *                                    (and the secondary buffer has already been set
+ *                                    in non-blocking mode).
+ * @retval    NRFX_ERROR_FORBIDDEN    If the transfer was aborted from a different context
+ *                                    (blocking mode only).
+ * @retval    NRFX_ERROR_INTERNAL     If UARTE peripheral reported an error.
+ * @retval    NRFX_ERROR_INVALID_ADDR If p_data does not point to RAM buffer.
+ */
+nrfx_err_t nrfx_uarte_rx(nrfx_uarte_t const * p_instance,
+                         uint8_t *            p_data,
+                         size_t               length);
+
+
+
+/**
+ * @brief Function for testing the receiver state in blocking mode.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval true  If the receiver has at least one byte of data to get.
+ * @retval false If the receiver is empty.
+ */
+bool nrfx_uarte_rx_ready(nrfx_uarte_t const * p_instance);
+
+/**
+ * @brief Function for aborting any ongoing reception.
+ * @note @ref NRFX_UARTE_EVT_RX_DONE event will be generated in non-blocking mode.
+ *       It will contain number of bytes received until abort was called. The event
+ *       handler will be called from UARTE interrupt context.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ */
+void nrfx_uarte_rx_abort(nrfx_uarte_t const * p_instance);
+
+/**
+ * @brief Function for reading error source mask. Mask contains values from @ref nrf_uarte_error_mask_t.
+ * @note Function should be used in blocking mode only. In case of non-blocking mode, an error event is
+ *       generated. Function clears error sources after reading.
+ *
+ * @param[in] p_instance Pointer to the driver instance structure.
+ *
+ * @retval    Mask of reported errors.
+ */
+uint32_t nrfx_uarte_errorsrc_get(nrfx_uarte_t const * p_instance);
+
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+__STATIC_INLINE uint32_t nrfx_uarte_task_address_get(nrfx_uarte_t const * p_instance,
+                                                     nrf_uarte_task_t     task)
+{
+    return nrf_uarte_task_address_get(p_instance->p_reg, task);
+}
+
+__STATIC_INLINE uint32_t nrfx_uarte_event_address_get(nrfx_uarte_t const * p_instance,
+                                                      nrf_uarte_event_t    event)
+{
+    return nrf_uarte_event_address_get(p_instance->p_reg, event);
+}
+#endif // SUPPRESS_INLINE_IMPLEMENTATION
+
+
+void nrfx_uarte_0_irq_handler(void);
+void nrfx_uarte_1_irq_handler(void);
+void nrfx_uarte_2_irq_handler(void);
+void nrfx_uarte_3_irq_handler(void);
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_UARTE_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_usbd.h

@@ -0,0 +1,863 @@
+/*
+ * Copyright (c) 2016 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_USBD_H__
+#define NRFX_USBD_H__
+
+#include <nrfx.h>
+#include <hal/nrf_usbd.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_usbd USBD driver
+ * @{
+ * @ingroup nrf_usbd
+ * @brief   Universal Serial Bus Device (USBD) peripheral driver.
+ */
+
+/**
+ * @brief Number of bytes in the endpoint.
+ */
+#define NRFX_USBD_EPSIZE 64
+
+/**
+ * @brief Number of bytes for isochronous endpoints.
+ *
+ * Number of bytes for isochronous endpoints in total.
+ * This number would be shared between IN and OUT endpoint.
+ * It may be also assigned totaly to one endpoint.
+ * @sa nrf_usbd_isosplit_set
+ * @sa nrf_usbd_isosplit_get
+ */
+#define NRFX_USBD_ISOSIZE 1024
+
+/**
+ * @brief The size of internal feeder buffer.
+ *
+ * @sa nrfx_usbd_feeder_buffer_get
+ */
+#define NRFX_USBD_FEEDER_BUFFER_SIZE NRFX_USBD_EPSIZE
+
+/**
+ * @name Macros for creating endpoint identifiers.
+ *
+ * Auxiliary macros for creating endpoint identifiers compatible with the USB specification.
+ * @{
+ * @brief Create identifier for IN endpoint.
+ *
+ * Simple macro to create IN endpoint identifier for given endpoint number.
+ *
+ * @param[in] n Endpoint number.
+ *
+ * @return Endpoint identifier that connects endpoint number and endpoint direction.
+ */
+#define NRFX_USBD_EPIN(n)   ((nrfx_usbd_ep_t)NRF_USBD_EPIN(n))
+/**
+ * @brief Create identifier for OUT endpoint.
+ *
+ * Simple macro to create OUT endpoint identifier for given endpoint number.
+ *
+ * @param[in] n Endpoint number.
+ *
+ * @return Endpoint identifier that connects endpoint number and endpoint direction.
+ */
+#define NRFX_USBD_EPOUT(n)  ((nrfx_usbd_ep_t)NRF_USBD_EPOUT(n))
+/** @} */
+
+/**
+ * @brief Endpoint identifier.
+ *
+ * Endpoint identifier used in the driver.
+ * This endpoint number is consistent with USB 2.0 specification.
+ */
+typedef enum
+{
+    NRFX_USBD_EPOUT0 = NRF_USBD_EPOUT(0), /**< Endpoint OUT 0 */
+    NRFX_USBD_EPOUT1 = NRF_USBD_EPOUT(1), /**< Endpoint OUT 1 */
+    NRFX_USBD_EPOUT2 = NRF_USBD_EPOUT(2), /**< Endpoint OUT 2 */
+    NRFX_USBD_EPOUT3 = NRF_USBD_EPOUT(3), /**< Endpoint OUT 3 */
+    NRFX_USBD_EPOUT4 = NRF_USBD_EPOUT(4), /**< Endpoint OUT 4 */
+    NRFX_USBD_EPOUT5 = NRF_USBD_EPOUT(5), /**< Endpoint OUT 5 */
+    NRFX_USBD_EPOUT6 = NRF_USBD_EPOUT(6), /**< Endpoint OUT 6 */
+    NRFX_USBD_EPOUT7 = NRF_USBD_EPOUT(7), /**< Endpoint OUT 7 */
+    NRFX_USBD_EPOUT8 = NRF_USBD_EPOUT(8), /**< Endpoint OUT 8 */
+
+    NRFX_USBD_EPIN0  = NRF_USBD_EPIN(0), /**< Endpoint IN 0 */
+    NRFX_USBD_EPIN1  = NRF_USBD_EPIN(1), /**< Endpoint IN 1 */
+    NRFX_USBD_EPIN2  = NRF_USBD_EPIN(2), /**< Endpoint IN 2 */
+    NRFX_USBD_EPIN3  = NRF_USBD_EPIN(3), /**< Endpoint IN 3 */
+    NRFX_USBD_EPIN4  = NRF_USBD_EPIN(4), /**< Endpoint IN 4 */
+    NRFX_USBD_EPIN5  = NRF_USBD_EPIN(5), /**< Endpoint IN 5 */
+    NRFX_USBD_EPIN6  = NRF_USBD_EPIN(6), /**< Endpoint IN 6 */
+    NRFX_USBD_EPIN7  = NRF_USBD_EPIN(7), /**< Endpoint IN 7 */
+    NRFX_USBD_EPIN8  = NRF_USBD_EPIN(8), /**< Endpoint IN 8 */
+} nrfx_usbd_ep_t;
+
+/**
+ * @brief Events generated by the driver.
+ *
+ * Enumeration of possible events that may be generated by the driver.
+ */
+typedef enum
+{
+    NRFX_USBD_EVT_SOF,        /**< Start Of Frame event on USB bus detected. */
+    NRFX_USBD_EVT_RESET,      /**< Reset condition on USB bus detected. */
+    NRFX_USBD_EVT_SUSPEND,    /**< This device should go to suspend mode now. */
+    NRFX_USBD_EVT_RESUME,     /**< This device should resume from suspend now. */
+    NRFX_USBD_EVT_WUREQ,      /**< Wakeup request - the USBD peripheral is ready to generate
+	                               WAKEUP signal after exiting low power mode. */
+    NRFX_USBD_EVT_SETUP,      /**< Setup frame received and decoded. */
+    NRFX_USBD_EVT_EPTRANSFER, /**< For Rx (OUT: Host->Device):
+                               *   1. The packet has been received but there is no buffer prepared for transfer already.
+                               *   2. Whole transfer has been finished.
+                               *
+                               *   For Tx (IN: Device->Host):
+                               *   The last packet from requested transfer has been transfered over USB bus and acknowledged.
+                               */
+    NRFX_USBD_EVT_CNT         /**< Number of defined events. */
+} nrfx_usbd_event_type_t;
+
+/**
+ * @brief Endpoint status codes.
+ *
+ * Status codes that may be returned by @ref nrfx_usbd_ep_status_get or, except for
+ * @ref NRFX_USBD_EP_BUSY, reported together with @ref NRFX_USBD_EVT_EPTRANSFER.
+ */
+typedef enum
+{
+    NRFX_USBD_EP_OK,       /**< No error occured. */
+    NRFX_USBD_EP_WAITING,  /**< Data received, no buffer prepared already - waiting for configured transfer. */
+    NRFX_USBD_EP_OVERLOAD, /**< Received number of bytes cannot fit given buffer.
+                            *   This error would also be returned when next_transfer function has been defined
+                            *   but currently received data cannot fit completely in current buffer.
+                            *   No data split from single endpoint transmission is supported.
+                            *
+                            *   When this error is reported - data is left inside endpoint buffer.
+                            *   Clear endpoint or prepare new buffer and read it.
+                            */
+    NRFX_USBD_EP_ABORTED,  /**< EP0 transfer can be aborted when new setup comes.
+                            *   Any other transfer can be aborted by USB reset or driver stopping.
+                            */
+    NRFX_USBD_EP_BUSY,     /**< A transfer is in progress. */
+} nrfx_usbd_ep_status_t;
+
+/**
+ * @brief Event structure.
+ *
+ * Structure passed to event handler.
+ */
+typedef struct
+{
+    nrfx_usbd_event_type_t type;
+    union
+    {
+        struct {
+            uint16_t framecnt; /**< Current value of frame counter. */
+        } sof; /**< Data available for @ref NRFX_USBD_EVT_SOF. */
+        struct {
+            nrfx_usbd_ep_t        ep;     /**< Endpoint number. */
+        } isocrc;
+        struct {
+            nrfx_usbd_ep_t        ep;     /**< Endpoint number. */
+            nrfx_usbd_ep_status_t status; /**< Status for the endpoint. */
+        } eptransfer;
+    } data;
+} nrfx_usbd_evt_t;
+
+/**
+ * @brief USBD event callback function type.
+ *
+ * @param[in] p_event Event information structure.
+ */
+typedef void (*nrfx_usbd_event_handler_t)(nrfx_usbd_evt_t const * p_event);
+
+/**
+ * @brief Universal data pointer.
+ *
+ * Universal data pointer that can be used for any type of transfer.
+ */
+typedef union
+{
+    void const * tx; //!< Constant TX buffer pointer.
+    void * rx;       //!< Writable RX buffer pointer.
+    uint32_t addr;   //!< Numeric value used internally by the driver.
+} nrfx_usbd_data_ptr_t;
+
+/**
+ * @brief Structure to be filled with information about the next transfer.
+ *
+ * This is used mainly for transfer feeders and consumers.
+ * It describes a single endpoint transfer and therefore the size of the buffer
+ * can never be higher than the endpoint size.
+ */
+typedef struct
+{
+    nrfx_usbd_data_ptr_t p_data; //!< Union with available data pointers used by the driver.
+    size_t size;                 //!< Size of the requested transfer.
+} nrfx_usbd_ep_transfer_t;
+
+/**
+ * @brief Flags for the current transfer.
+ *
+ * Flags configured for the transfer that can be merged using the bitwise 'or' operator (|).
+ */
+typedef enum
+{
+    NRFX_USBD_TRANSFER_ZLP_FLAG = 1U << 0, //!< Add a zero-length packet.
+} nrfx_usbd_transfer_flags_t;
+
+/**
+ * @brief Total transfer configuration.
+ *
+ * This structure is used to configure total transfer information.
+ * It is used by internal built-in feeders and consumers.
+ */
+typedef struct
+{
+    nrfx_usbd_data_ptr_t p_data; //!< Union with available data pointers used by the driver.
+    size_t size;                 //!< Total size of the requested transfer.
+    uint32_t flags;              //!< Transfer flags.
+                                 /**< Use the @ref nrfx_usbd_transfer_flags_t values. */
+} nrfx_usbd_transfer_t;
+
+/**
+ * @brief Auxiliary macro for declaring IN transfer description with optional flags.
+ *
+ * The base macro for creating transfers with any configuration option.
+ *
+ * @param name     Instance name.
+ * @param tx_buff  Buffer to transfer.
+ * @param tx_size  Transfer size.
+ * @param tx_flags Flags for the transfer (see @ref nrfx_usbd_transfer_flags_t).
+ *
+ * @return Configured variable with total transfer description.
+ */
+#define NRFX_USBD_TRANSFER_IN(name, tx_buff, tx_size, tx_flags) \
+    const nrfx_usbd_transfer_t name = {                         \
+       .p_data = { .tx = (tx_buff)  },                          \
+       .size = (tx_size),                                       \
+       .flags = (tx_flags)                                      \
+    }
+
+/**
+ * @brief Helper macro for declaring OUT transfer item (@ref nrfx_usbd_transfer_t).
+ *
+ * @param name    Instance name.
+ * @param rx_buff Buffer to transfer.
+ * @param rx_size Transfer size.
+ * */
+#define NRFX_USBD_TRANSFER_OUT(name, rx_buff, rx_size) \
+    const nrfx_usbd_transfer_t name = {                \
+       .p_data = { .rx = (rx_buff)  },                 \
+       .size = (rx_size),                              \
+       .flags = 0                                      \
+    }
+
+/**
+ * @brief USBD transfer feeder.
+ *
+ * Pointer for a transfer feeder.
+ * Transfer feeder is a feedback function used to prepare a single
+ * TX (Device->Host) endpoint transfer.
+ *
+ * The transfers provided by the feeder must be simple:
+ * - The size of the transfer provided by this function is limited to a single endpoint buffer.
+ *   Bigger transfers are not handled automatically in this case.
+ * - Flash transfers are not automatically supported- you must copy them to the RAM buffer before.
+ *
+ * @note
+ * This function may use @ref nrfx_usbd_feeder_buffer_get to gain a temporary buffer
+ * that can be used to prepare transfer.
+ *
+ * @param[out]    p_next    Structure with the data for the next transfer to be filled.
+ *                          Required only if the function returns true.
+ * @param[in,out] p_context Context variable configured with the transfer.
+ * @param[in]     ep_size   The endpoint size.
+ *
+ * @retval false The current transfer is the last one - you do not need to call
+ *               the function again.
+ * @retval true  There is more data to be prepared and when the current transfer
+ *               finishes, the feeder function is expected to be called again.
+ */
+typedef bool (*nrfx_usbd_feeder_t)(nrfx_usbd_ep_transfer_t * p_next,
+                                   void * p_context,
+                                   size_t ep_size);
+
+/**
+ * @brief USBD transfer consumer.
+ *
+ * Pointer for a transfer consumer.
+ * Transfer consumer is a feedback function used to prepare a single
+ * RX (Host->Device) endpoint transfer.
+ *
+ * The transfer must provide a buffer big enough to fit the whole data from the endpoint.
+ * Otherwise, the NRFX_USBD_EP_OVERLOAD event is generated.
+ *
+ * @param[out]    p_next    Structure with the data for the next transfer to be filled.
+ *                          Required only if the function returns true.
+ * @param[in,out] p_context Context variable configured with the transfer.
+ * @param[in]     ep_size   The endpoint size.
+ * @param[in]     data_size Number of received bytes in the endpoint buffer.
+ *
+ * @retval false Current transfer is the last one - you do not need to call
+ *               the function again.
+ * @retval true  There is more data to be prepared and when current transfer
+ *               finishes, the feeder function is expected to be called again.
+ */
+typedef bool (*nrfx_usbd_consumer_t)(nrfx_usbd_ep_transfer_t * p_next,
+                                     void * p_context,
+                                     size_t ep_size,
+                                     size_t data_size);
+
+/**
+ * @brief Universal transfer handler.
+ *
+ * Union with feeder and consumer function pointer.
+ */
+typedef union
+{
+    nrfx_usbd_feeder_t   feeder;   //!< Feeder function pointer.
+    nrfx_usbd_consumer_t consumer; //!< Consumer function pointer.
+} nrfx_usbd_handler_t;
+
+/**
+ * @brief USBD transfer descriptor.
+ *
+ * Universal structure that may hold the setup for callback configuration for
+ * IN or OUT type of the transfer.
+ */
+typedef struct
+{
+    nrfx_usbd_handler_t handler;   //!< Handler for the current transfer, function pointer.
+    void *              p_context; //!< Context for the transfer handler.
+} nrfx_usbd_handler_desc_t;
+
+/**
+ * @brief Setup packet structure.
+ *
+ * Structure that contains interpreted SETUP packet as described in USB specification.
+ */
+typedef struct
+{
+    uint8_t  bmRequestType; //!< byte 0
+    uint8_t  bRequest;      //!< byte 1
+    uint16_t wValue;        //!< byte 2, 3
+    uint16_t wIndex;        //!< byte 4, 5
+    uint16_t wLength;       //!< byte 6, 7
+} nrfx_usbd_setup_t;
+
+/**
+ * @brief Driver initialization.
+ *
+ * @param[in] event_handler Event handler provided by the user. Cannot be null.
+ *
+ * @retval NRFX_SUCCESS             Initialization successful.
+ * @retval NRFX_ERROR_INVALID_STATE Driver was already initialized.
+ */
+nrfx_err_t nrfx_usbd_init(nrfx_usbd_event_handler_t event_handler);
+
+/**
+ * @brief Driver deinitialization.
+ */
+void nrfx_usbd_uninit(void);
+
+/**
+ * @brief Enable the USBD port.
+ *
+ * After calling this function USBD peripheral would be enabled.
+ * The USB LDO would be enabled.
+ * Enabled USBD peripheral would request HFCLK.
+ * This function does not enable external oscillator, so if it is not enabled by other part of the
+ * program after enabling USBD driver HFINT would be used for the USBD peripheral.
+ * It is perfectly fine until USBD is started. See @ref nrfx_usbd_start.
+ *
+ * In normal situation this function should be called in reaction to USBDETECTED
+ * event from POWER peripheral.
+ *
+ * Interrupts and USB pins pull-up would stay disabled until @ref nrfx_usbd_start
+ * function is called.
+ */
+void nrfx_usbd_enable(void);
+
+/**
+ * @brief Disable the USBD port.
+ *
+ * After calling this function USBD peripheral would be disabled.
+ * No events would be detected or processed by the driver.
+ * Clock for the peripheral would be disconnected.
+ */
+void nrfx_usbd_disable(void);
+
+/**
+ * @brief Start USB functionality.
+ *
+ * After calling this function USBD peripheral should be fully functional
+ * and all new incoming events / interrupts would be processed by the driver.
+ *
+ * Also only after calling this function host sees new connected device.
+ *
+ * Call this function when USBD power LDO regulator is ready - on USBPWRRDY event
+ * from POWER peripheral.
+ *
+ * Before USBD interrupts are enabled, external HFXO is requested.
+ *
+ * @param enable_sof The flag that is used to enable SOF processing.
+ *                   If it is false, SOF interrupt is left disabled and will not be generated.
+ *                   This improves power saving if SOF is not required.
+ *
+ * @note If the isochronous endpoints are going to be used,
+ *       it is required to enable the SOF.
+ *       In other case any isochronous endpoint would stay busy
+ *       after first transmission.
+ */
+void nrfx_usbd_start(bool enable_sof);
+
+/**
+ * @brief Stop USB functionality.
+ *
+ * This function disables USBD pull-up and interrupts.
+ *
+ * The HFXO request is released in this function.
+ *
+ * @note
+ * This function can also be used to logically disconnect USB from the HOST that
+ * would force it to enumerate device after calling @ref nrfx_usbd_start.
+ */
+void nrfx_usbd_stop(void);
+
+/**
+ * @brief Check if driver is initialized.
+ *
+ * @retval false Driver is not initialized.
+ * @retval true Driver is initialized.
+ */
+bool nrfx_usbd_is_initialized(void);
+
+/**
+ * @brief Check if driver is enabled.
+ *
+ * @retval false Driver is disabled.
+ * @retval true  Driver is enabled.
+ */
+bool nrfx_usbd_is_enabled(void);
+
+/**
+ * @brief Check if driver is started.
+ *
+ * @retval false Driver is not started.
+ * @retval true Driver is started (fully functional).
+ * @note The USBD peripheral interrupt state is checked.
+ */
+bool nrfx_usbd_is_started(void);
+
+/**
+ * @brief Suspend USBD operation.
+ *
+ * The USBD peripheral is forced to go into the low power mode.
+ * The function has to be called in the reaction to @ref NRFX_USBD_EVT_SUSPEND event
+ * when the firmware is ready.
+ *
+ * After successful call of this function most of the USBD registers would be unavailable.
+ *
+ * @note Check returned value for the feedback if suspending was successful.
+ *
+ * @retval true  USBD peripheral successfully suspended.
+ * @retval false USBD peripheral was not suspended due to resume detection.
+ */
+bool nrfx_usbd_suspend(void);
+
+/**
+ * @brief Start wake up procedure.
+ *
+ * The USBD peripheral is forced to quit the low power mode.
+ * After calling this function all the USBD registers would be available.
+ *
+ * The hardware starts measuring time when wake up is possible.
+ * This may take 0-5&nbsp;ms depending on how long the SUSPEND state was kept on the USB line.
+
+ * When NRFX_USBD_EVT_WUREQ event is generated it means that Wake Up signaling has just been
+ * started on the USB lines.
+ *
+ * @note Do not expect only @ref NRFX_USBD_EVT_WUREQ event.
+ *       There always may appear @ref NRFX_USBD_EVT_RESUME event.
+ * @note NRFX_USBD_EVT_WUREQ event means that Remote WakeUp signal
+ *       has just begun to be generated.
+ *       This may take up to 20&nbsp;ms for the bus to become active.
+ *
+ * @retval true WakeUp procedure started.
+ * @retval false No WakeUp procedure started - bus is already active.
+ */
+bool nrfx_usbd_wakeup_req(void);
+
+/**
+ * @brief Check if USBD is in SUSPEND mode.
+ *
+ * @note This is the information about peripheral itself, not about the bus state.
+ *
+ * @retval true  USBD peripheral is suspended.
+ * @retval false USBD peripheral is active.
+ */
+bool nrfx_usbd_suspend_check(void);
+
+/**
+ * @brief Enable only interrupts that should be processed in SUSPEND mode.
+ *
+ * Auxiliary function to help with SUSPEND mode integration.
+ * It enables only the interrupts that can be properly processed without stable HFCLK.
+ *
+ * Normally all the interrupts are enabled.
+ * Use this function to suspend interrupt processing that may require stable HFCLK until the
+ * clock is enabled.
+ *
+ * @sa nrfx_usbd_active_irq_config
+ */
+void nrfx_usbd_suspend_irq_config(void);
+
+/**
+ * @brief Default active interrupt configuration.
+ *
+ * Default interrupt configuration.
+ * Use in a pair with @ref nrfx_usbd_active_irq_config.
+ *
+ * @sa nrfx_usbd_suspend_irq_config
+ */
+void nrfx_usbd_active_irq_config(void);
+
+/**
+ * @brief Check the bus state.
+ *
+ * This function checks if the bus state is suspended.
+ *
+ * @note The value returned by this function changes on SUSPEND and RESUME event processing.
+ *
+ * @retval true  USBD bus is suspended.
+ * @retval false USBD bus is active.
+ */
+bool nrfx_usbd_bus_suspend_check(void);
+
+/**
+ * @brief Force the bus state to active
+ */
+void nrfx_usbd_force_bus_wakeup(void);
+
+/**
+ * @brief Configure packet size that should be supported by the endpoint.
+ *
+ * The real endpoint buffer size is always the same.
+ * This value sets max packet size that would be transmitted over the endpoint.
+ * This is required by the driver.
+ *
+ * @param[in] ep   Endpoint number.
+ * @param[in] size Required maximum packet size.
+ *
+ * @note Endpoint size is always set to @ref NRFX_USBD_EPSIZE or @ref NRFX_USBD_ISOSIZE / 2
+ *       when @ref nrfx_usbd_ep_enable function is called.
+ */
+void nrfx_usbd_ep_max_packet_size_set(nrfx_usbd_ep_t ep, uint16_t size);
+
+/**
+ * @brief Get configured endpoint packet size.
+ *
+ * Function to get configured endpoint size on the buffer.
+ *
+ * @param[in] ep Endpoint number.
+ *
+ * @return Maximum pocket size configured on selected endpoint.
+ */
+uint16_t nrfx_usbd_ep_max_packet_size_get(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Check if the selected endpoint is enabled.
+ *
+ * @param[in] ep Endpoint number to check.
+ *
+ * @retval true  Endpoint is enabled.
+ * @retval false Endpoint is disabled.
+ */
+bool nrfx_usbd_ep_enable_check(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Enable selected endpoint.
+ *
+ * This function enables endpoint itself and its interrupts.
+ *
+ * @param[in] ep Endpoint number to enable.
+ *
+ * @note
+ * Max packet size is set to endpoint default maximum value.
+ *
+ * @sa nrfx_usbd_ep_max_packet_size_set
+ */
+void nrfx_usbd_ep_enable(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Disable selected endpoint.
+ *
+ * This function disables endpoint itself and its interrupts.
+ *
+ * @param[in] ep Endpoint number to disable.
+ */
+void nrfx_usbd_ep_disable(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Disable all endpoints except for EP0.
+ *
+ * Disable all endpoints that can be disabled in USB device while it is still active.
+ */
+void nrfx_usbd_ep_default_config(void);
+
+/**
+ * @brief Start sending data over endpoint.
+ *
+ * Function initializes endpoint transmission.
+ * This is asynchronous function - it finishes immediately after configuration
+ * for transmission is prepared.
+ *
+ * @note Data buffer pointed by p_data have to be kept active till
+ *       @ref NRFX_USBD_EVT_EPTRANSFER event is generated.
+ *
+ * @param[in] ep         Endpoint number.
+ *                       For IN endpoint sending would be initiated.
+ *                       For OUT endpoint receiving would be initiated.
+ * @param[in] p_transfer Transfer parameters.
+ *
+ * @retval NRFX_SUCCESS             Transfer queued or started.
+ * @retval NRFX_ERROR_BUSY          Selected endpoint is pending.
+ * @retval NRFX_ERROR_INVALID_ADDR  Unexpected transfer on EPIN0 or EPOUT0.
+ */
+nrfx_err_t nrfx_usbd_ep_transfer(nrfx_usbd_ep_t ep,
+                                 nrfx_usbd_transfer_t const * p_transfer);
+
+/**
+ * @brief Start sending data over the endpoint using the transfer handler function.
+ *
+ * This function initializes an endpoint transmission.
+ * Just before data is transmitted, the transfer handler
+ * is called and it prepares a data chunk.
+ *
+ * @param[in] ep        Endpoint number.
+ *                      For an IN endpoint, sending is initiated.
+ *                      For an OUT endpoint, receiving is initiated.
+ * @param[in] p_handler Transfer handler - feeder for IN direction and consumer for
+ *                      OUT direction.
+ *
+ * @retval NRFX_SUCCESS             Transfer queued or started.
+ * @retval NRFX_ERROR_BUSY          Selected endpoint is pending.
+ * @retval NRFX_ERROR_INVALID_ADDR  Unexpected transfer on EPIN0 or EPOUT0.
+ */
+nrfx_err_t nrfx_usbd_ep_handled_transfer(nrfx_usbd_ep_t ep,
+                                         nrfx_usbd_handler_desc_t const * p_handler);
+
+/**
+ * @brief Get the temporary buffer to be used by the feeder.
+ *
+ * This buffer is used for TX transfers and it can be reused automatically
+ * when the transfer is finished.
+ * Use it for transfer preparation.
+ *
+ * May be used inside the feeder configured in @ref nrfx_usbd_ep_handled_transfer.
+ *
+ * @return Pointer to the buffer that can be used temporarily.
+ *
+ * @sa NRFX_USBD_FEEDER_BUFFER_SIZE
+ */
+void * nrfx_usbd_feeder_buffer_get(void);
+
+/**
+ * @brief Get the information about last finished or current transfer.
+ *
+ * Function returns the status of the last buffer set for transfer on selected endpoint.
+ * The status considers last buffer set by @ref nrfx_usbd_ep_transfer function or
+ * by transfer callback function.
+ *
+ * @param[in]  ep     Endpoint number.
+ * @param[out] p_size Information about the current/last transfer size.
+ *
+ * @return Endpoint status.
+ *
+ * @sa nrfx_usbd_ep_status_t
+ */
+nrfx_usbd_ep_status_t nrfx_usbd_ep_status_get(nrfx_usbd_ep_t ep, size_t * p_size);
+
+/**
+ * @brief Get number of received bytes.
+ *
+ * Get the number of received bytes.
+ * The function behavior is undefined when called on IN endpoint.
+ *
+ * @param[in] ep Endpoint number.
+ *
+ * @return Number of received bytes.
+ */
+size_t nrfx_usbd_epout_size_get(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Check if endpoint buffer is ready or is under USB IP control.
+ *
+ * Function to test if endpoint is busy.
+ * Endpoint that is busy cannot be accessed by MCU.
+ * It means that:
+ * - OUT (TX) endpoint: Last uploaded data is still in endpoint and is waiting
+ *                      to be received by the host.
+ * - IN  (RX) endpoint: Endpoint is ready to receive data from the host
+ *                      and the endpoint does not have any data.
+ * When endpoint is not busy:
+ * - OUT (TX) endpoint: New data can be uploaded.
+ * - IN  (RX) endpoint: New data can be downloaded using @ref nrfx_usbd_ep_transfer
+ *                      function.
+ *
+ * @param[in] ep Endpoint number.
+ *
+ * @retval false Endpoint is not busy.
+ * @retval true  Endpoint is busy.
+ */
+bool nrfx_usbd_ep_is_busy(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Stall endpoint
+ *
+ * Stall endpoit to send error information during next transfer request from
+ * the host.
+ *
+ * @note To stall endpoint it is safer to use @ref nrfx_usbd_setup_stall
+ * @note Stalled endpoint would not be cleared when DMA transfer finishes.
+ *
+ * @param[in] ep Endpoint number to stall.
+ */
+void nrfx_usbd_ep_stall(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Clear stall flag on endpoint.
+ *
+ * This function clears endpoint that is stalled.
+ * @note
+ * If it is OUT endpoint (receiving) it would be also prepared for reception.
+ * It means that busy flag would be set.
+ * @note
+ * In endpoint (transmitting) would not be cleared - it gives possibility to
+ * write new data before transmitting.
+ *
+ * @param[in] ep Endpoint number.
+ */
+void nrfx_usbd_ep_stall_clear(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Check if endpoint is stalled.
+ *
+ * This function gets stall state of selected endpoint.
+ *
+ * @param[in] ep Endpoint number to check.
+ *
+ * @retval false Endpoint is not stalled.
+ * @retval true  Endpoint is stalled.
+ */
+bool nrfx_usbd_ep_stall_check(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Clear current endpoint data toggle.
+ *
+ * @param[in] ep Endpoint number to clear.
+ */
+void nrfx_usbd_ep_dtoggle_clear(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Get parsed setup data.
+ *
+ * Function fills the parsed setup data structure.
+ *
+ * @param[out] p_setup Pointer to data structure that would be filled by
+ *                     parsed data.
+ */
+void nrfx_usbd_setup_get(nrfx_usbd_setup_t * p_setup);
+
+/**
+ * @brief Clear the control endpoint for packet reception during DATA stage.
+ *
+ * This function may be called if any more data in control write transfer is expected.
+ * Clears only OUT endpoint to be able to take another OUT data token.
+ * It does not allow STATUS stage.
+ * @sa nrfx_usbd_setup_clear
+ */
+void nrfx_usbd_setup_data_clear(void);
+
+/**
+ * @brief Clear setup endpoint.
+ *
+ * This function acknowledges setup when SETUP command was received and processed.
+ * It has to be called if no data respond for the SETUP command is sent.
+ */
+void nrfx_usbd_setup_clear(void);
+
+/**
+ * @brief Stall setup endpoint.
+ *
+ * Mark an error on setup endpoint.
+ */
+void nrfx_usbd_setup_stall(void);
+
+/**
+ * @brief Abort pending transfer on selected endpoint.
+ *
+ * @param[in] ep Endpoint number.
+ */
+void nrfx_usbd_ep_abort(nrfx_usbd_ep_t ep);
+
+/**
+ * @brief Get the information about expected transfer SETUP data direction.
+ *
+ * Function returns the information about last expected transfer direction.
+ *
+ * @retval NRFX_USBD_EPOUT0 Expecting OUT (Host->Device) direction or no data.
+ * @retval NRFX_USBD_EPIN0  Expecting IN (Device->Host) direction.
+ */
+nrfx_usbd_ep_t nrfx_usbd_last_setup_dir_get(void);
+
+/**
+ * @brief Drop transfer on OUT endpoint.
+ *
+ * @param[in] ep  OUT endpoint ID.
+ */
+void nrfx_usbd_transfer_out_drop(nrfx_usbd_ep_t ep);
+
+
+void nrfx_usbd_irq_handler(void);
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_USBD_H__

third_party/NordicSemiconductor/nrfx/drivers/include/nrfx_wdt.h

@@ -1,156 +1,160 @@
-/**
- * Copyright (c) 2014 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_WDT_H__
-#define NRFX_WDT_H__
-
-#include <nrfx.h>
-#include <hal/nrf_wdt.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_wdt WDT driver
- * @{
- * @ingroup nrf_wdt
- * @brief   Watchdog Timer (WDT) peripheral driver.
- */
-
-/**@brief Struct for WDT initialization. */
-typedef struct
-{
-    nrf_wdt_behaviour_t    behaviour;          /**< WDT behaviour when CPU in sleep/halt mode. */
-    uint32_t               reload_value;       /**< WDT reload value in ms. */
-    uint8_t                interrupt_priority; /**< WDT interrupt priority */
-} nrfx_wdt_config_t;
-
-/**@brief WDT event handler function type. */
-typedef void (*nrfx_wdt_event_handler_t)(void);
-
-/**@brief WDT channel id type. */
-typedef nrf_wdt_rr_register_t nrfx_wdt_channel_id;
-
-#define NRFX_WDT_DEAFULT_CONFIG                                               \
-    {                                                                         \
-        .behaviour          = (nrf_wdt_behaviour_t)NRFX_WDT_CONFIG_BEHAVIOUR, \
-        .reload_value       = NRFX_WDT_CONFIG_RELOAD_VALUE,                   \
-        .interrupt_priority = NRFX_WDT_CONFIG_IRQ_PRIORITY,                   \
-    }
-/**
- * @brief This function initializes watchdog.
- *
- * @param[in] p_config          Pointer to the structure with initial configuration.
- * @param[in] wdt_event_handler Event handler provided by the user.
- *                              Must not be NULL.
- *
- * @return    NRFX_SUCCESS on success, otherwise an error code.
- */
-nrfx_err_t nrfx_wdt_init(nrfx_wdt_config_t const * p_config,
-                         nrfx_wdt_event_handler_t  wdt_event_handler);
-
-/**
- * @brief This function allocate watchdog channel.
- *
- * @note This function can not be called after nrfx_wdt_start(void).
- *
- * @param[out] p_channel_id      ID of granted channel.
- *
- * @return    NRFX_SUCCESS on success, otherwise an error code.
- */
-nrfx_err_t nrfx_wdt_channel_alloc(nrfx_wdt_channel_id * p_channel_id);
-
-/**
- * @brief This function starts watchdog.
- *
- * @note After calling this function the watchdog is started, so the user needs to feed all allocated
- *       watchdog channels to avoid reset. At least one watchdog channel has to be allocated.
- */
-void nrfx_wdt_enable(void);
-
-/**
- * @brief This function feeds the watchdog.
- *
- * @details Function feeds all allocated watchdog channels.
- */
-void nrfx_wdt_feed(void);
-
-/**
- * @brief This function feeds the invidual watchdog channel.
- *
- * @param[in] channel_id      ID of watchdog channel.
- */
-void nrfx_wdt_channel_feed(nrfx_wdt_channel_id channel_id);
-
-/**@brief Function for returning a requested task address for the wdt driver module.
- *
- * @param[in]  task                One of the peripheral tasks.
- *
- * @retval     Task address.
- */
-__STATIC_INLINE uint32_t nrfx_wdt_ppi_task_addr(nrf_wdt_task_t task)
-{
-    return nrf_wdt_task_address_get(task);
-}
-
-/**@brief Function for returning a requested event address for the wdt driver module.
- *
- * @param[in]  event               One of the peripheral events.
- *
- * @retval     Event address
- */
-__STATIC_INLINE uint32_t nrfx_wdt_ppi_event_addr(nrf_wdt_event_t event)
-{
-    return nrf_wdt_event_address_get(event);
-}
-
-
-void nrfx_wdt_irq_handler(void);
-
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif
-
+/*
+ * Copyright (c) 2014 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_WDT_H__
+#define NRFX_WDT_H__
+
+#include <nrfx.h>
+#include <hal/nrf_wdt.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_wdt WDT driver
+ * @{
+ * @ingroup nrf_wdt
+ * @brief   Watchdog Timer (WDT) peripheral driver.
+ */
+
+#if !NRFX_CHECK(NRFX_WDT_CONFIG_NO_IRQ) || defined(__NRFX_DOXYGEN__)
+/**
+ * @brief WDT instance interrupt priority configuration.
+ */
+    #define NRFX_WDT_IRQ_CONFIG .interrupt_priority = NRFX_WDT_CONFIG_IRQ_PRIORITY
+#else
+    #define NRFX_WDT_IRQ_CONFIG
+#endif
+
+/**@brief Struct for WDT initialization. */
+typedef struct
+{
+    nrf_wdt_behaviour_t    behaviour;          /**< WDT behaviour when CPU in sleep/halt mode. */
+    uint32_t               reload_value;       /**< WDT reload value in ms. */
+#if !NRFX_CHECK(NRFX_WDT_CONFIG_NO_IRQ) || defined(__NRFX_DOXYGEN__)
+    uint8_t                interrupt_priority; /**< WDT interrupt priority */
+#endif
+} nrfx_wdt_config_t;
+
+/**@brief WDT event handler function type. */
+typedef void (*nrfx_wdt_event_handler_t)(void);
+
+/**@brief WDT channel id type. */
+typedef nrf_wdt_rr_register_t nrfx_wdt_channel_id;
+
+#define NRFX_WDT_DEAFULT_CONFIG                                               \
+    {                                                                         \
+        .behaviour          = (nrf_wdt_behaviour_t)NRFX_WDT_CONFIG_BEHAVIOUR, \
+        .reload_value       = NRFX_WDT_CONFIG_RELOAD_VALUE,                   \
+        NRFX_WDT_IRQ_CONFIG                                                   \
+    }
+/**
+ * @brief This function initializes watchdog.
+ *
+ * @param[in] p_config          Pointer to the structure with initial configuration.
+ * @param[in] wdt_event_handler Event handler provided by the user. Ignored when
+ *                              @ref NRFX_WDT_CONFIG_NO_IRQ option is enabled.
+ *
+ * @return    NRFX_SUCCESS on success, otherwise an error code.
+ */
+nrfx_err_t nrfx_wdt_init(nrfx_wdt_config_t const * p_config,
+                         nrfx_wdt_event_handler_t  wdt_event_handler);
+
+/**
+ * @brief This function allocate watchdog channel.
+ *
+ * @note This function can not be called after nrfx_wdt_start(void).
+ *
+ * @param[out] p_channel_id      ID of granted channel.
+ *
+ * @return    NRFX_SUCCESS on success, otherwise an error code.
+ */
+nrfx_err_t nrfx_wdt_channel_alloc(nrfx_wdt_channel_id * p_channel_id);
+
+/**
+ * @brief This function starts watchdog.
+ *
+ * @note After calling this function the watchdog is started, so the user needs to feed all allocated
+ *       watchdog channels to avoid reset. At least one watchdog channel has to be allocated.
+ */
+void nrfx_wdt_enable(void);
+
+/**
+ * @brief This function feeds the watchdog.
+ *
+ * @details Function feeds all allocated watchdog channels.
+ */
+void nrfx_wdt_feed(void);
+
+/**
+ * @brief This function feeds the invidual watchdog channel.
+ *
+ * @param[in] channel_id      ID of watchdog channel.
+ */
+void nrfx_wdt_channel_feed(nrfx_wdt_channel_id channel_id);
+
+/**@brief Function for returning a requested task address for the wdt driver module.
+ *
+ * @param[in]  task                One of the peripheral tasks.
+ *
+ * @retval     Task address.
+ */
+__STATIC_INLINE uint32_t nrfx_wdt_ppi_task_addr(nrf_wdt_task_t task)
+{
+    return nrf_wdt_task_address_get(task);
+}
+
+/**@brief Function for returning a requested event address for the wdt driver module.
+ *
+ * @param[in]  event               One of the peripheral events.
+ *
+ * @retval     Event address
+ */
+__STATIC_INLINE uint32_t nrfx_wdt_ppi_event_addr(nrf_wdt_event_t event)
+{
+    return nrf_wdt_event_address_get(event);
+}
+
+
+#if !NRFX_CHECK(NRFX_WDT_CONFIG_NO_IRQ)
+void nrfx_wdt_irq_handler(void);
+#endif
+
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
+

third_party/NordicSemiconductor/nrfx/drivers/nrfx_common.h

@@ -1,285 +1,328 @@
-/**
- * Copyright (c) 2017 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_COMMON_H__
-#define NRFX_COMMON_H__
-
-#include <stdint.h>
-#include <stddef.h>
-#include <stdbool.h>
-
-#include <nrf.h>
-#include <nrf_peripherals.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/**
- * @defgroup nrfx_common Common module
- * @{
- * @ingroup nrfx
- * @brief Common module.
- */
-
-/**
- * @brief Macro for checking if the specified identifier is defined and it has
- *        a non-zero value.
- *
- * Normally, preprocessors treat all undefined identifiers as having the value
- * zero. However, some tools, like static code analyzers, may issue a warning
- * when such identifier is evaluated. This macro gives the possibility to suppress
- * such warnings only in places where this macro is used for evaluation, not in
- * the whole analyzed code.
- */
-#define NRFX_CHECK(module_enabled)  (module_enabled)
-
-/**
- * @brief Macro for concatenating two tokens in macro expansion.
- *
- * @note This macro is expanded in two steps so that tokens given as macros
- *       themselves are fully expanded before they are merged.
- *
- * @param p1  First token.
- * @param p2  Second token.
- *
- * @return The two tokens merged into one, unless they cannot together form
- *         a valid token (in such case, the preprocessor issues a warning and
- *         does not perform the concatenation).
- *
- * @sa NRFX_CONCAT_3
- */
-#define NRFX_CONCAT_2(p1, p2)       NRFX_CONCAT_2_(p1, p2)
-/**
- * @brief Internal macro used by @ref NRFX_CONCAT_2 to perform the expansion
- *        in two steps.
- */
-#define NRFX_CONCAT_2_(p1, p2)      p1 ## p2
-
-/**
- * @brief Macro for concatenating three tokens in macro expansion.
- *
- * @note This macro is expanded in two steps so that tokens given as macros
- *       themselves are fully expanded before they are merged.
- *
- * @param p1  First token.
- * @param p2  Second token.
- * @param p3  Third token.
- *
- * @return The three tokens merged into one, unless they cannot together form
- *         a valid token (in such case, the preprocessor issues a warning and
- *         does not perform the concatenation).
- *
- * @sa NRFX_CONCAT_2
- */
-#define NRFX_CONCAT_3(p1, p2, p3)   NRFX_CONCAT_3_(p1, p2, p3)
-/**
- * @brief Internal macro used by @ref NRFX_CONCAT_3 to perform the expansion
- *        in two steps.
- */
-#define NRFX_CONCAT_3_(p1, p2, p3)  p1 ## p2 ## p3
-
-/**@brief Macro for performing rounded integer division (as opposed to
- *        truncating the result).
- *
- * @param a  Numerator.
- * @param b  Denominator.
- *
- * @return Rounded (integer) result of dividing @c a by @c b.
- */
-#define NRFX_ROUNDED_DIV(a, b)  (((a) + ((b) / 2)) / (b))
-
-/**@brief Macro for checking if given lengths of EasyDMA transfers do not exceed
- *        the limit of the specified peripheral.
- *
- * @param peripheral Peripheral to check the lengths against.
- * @param length1    First length to be checked.
- * @param length2    Second length to be checked (pass 0 if not needed).
- *
- * @return
- */
-#define NRFX_EASYDMA_LENGTH_VALIDATE(peripheral, length1, length2)            \
-    (((length1) < (1U << NRFX_CONCAT_2(peripheral, _EASYDMA_MAXCNT_SIZE))) && \
-     ((length2) < (1U << NRFX_CONCAT_2(peripheral, _EASYDMA_MAXCNT_SIZE))))
-
-/**@brief Macro for waiting until condition is met.
- *
- * @param[in]  condition Condition to meet.
- * @param[in]  attempts  Maximum number of condition checks. Must not be 0.
- * @param[in]  delay_us  Delay between consecutive checks, in microseconds.
- * @param[out] result    Boolean variable to store the result of the wait process.
- *                       Set to true if the condition is met or false otherwise.
- */
-#define NRFX_WAIT_FOR(condition, attempts, delay_us, result) \
-do {                                                         \
-    result =  false;                                         \
-    uint32_t remaining_attempts = (attempts);                \
-    do {                                                     \
-           if (condition)                                    \
-           {                                                 \
-               result =  true;                               \
-               break;                                        \
-           }                                                 \
-           NRFX_DELAY_US(delay_us);                          \
-    } while (--remaining_attempts);                          \
-} while(0)
-
-/**
- * @brief Macro for getting the interrupt number assigned to a specific
- *        peripheral.
- *
- * In Nordic SoCs the IRQ number assigned to a peripheral is equal to the ID
- * of this peripheral, and there is a direct relationship between this ID and
- * the peripheral base address, i.e. the address of a fixed block of 0x1000
- * bytes of address space assigned to this peripheral.
- * See the chapter "Peripheral interface" (sections "Peripheral ID" and
- * "Interrupts") in the product specification of a given SoC.
- *
- * @param[in] base_addr  Peripheral base address or pointer.
- *
- * @return Interrupt number associated with the specified peripheral.
- */
-#define NRFX_IRQ_NUMBER_GET(base_addr)  (uint8_t)((uint32_t)(base_addr) >> 12)
-
-/**
- * @brief IRQ handler type.
- */
-typedef void (* nrfx_irq_handler_t)(void);
-
-/**
- * @brief Driver state.
- */
-typedef enum
-{
-    NRFX_DRV_STATE_UNINITIALIZED, ///< Uninitialized.
-    NRFX_DRV_STATE_INITIALIZED,   ///< Initialized but powered off.
-    NRFX_DRV_STATE_POWERED_ON,    ///< Initialized and powered on.
-} nrfx_drv_state_t;
-
-
-/**
- * @brief Function for checking if an object is placed in the Data RAM region.
- *
- * Several peripherals (the ones using EasyDMA) require the transfer buffers
- * to be placed in the Data RAM region. This function can be used to check if
- * this condition is met.
- *
- * @param[in] p_object  Pointer to an object whose location is to be checked.
- *
- * @retval true  If the pointed object is located in the Data RAM region.
- * @retval false Otherwise.
- */
-__STATIC_INLINE bool nrfx_is_in_ram(void const * p_object);
-
-/**
- * @brief Function for getting the interrupt number for a specific peripheral.
- *
- * @param[in] p_reg  Peripheral base pointer.
- *
- * @return Interrupt number associated with the pointed peripheral.
- */
-__STATIC_INLINE IRQn_Type nrfx_get_irq_number(void const * p_reg);
-
-/**
- * @brief Function for converting an INTEN register bit position to the
- *        corresponding event identifier.
- *
- * The event identifier is the offset between the event register address and
- * the peripheral base address, and is equal (thus, can be directly cast) to
- * the corresponding value of the enumerated type from HAL (nrf_*_event_t).
-
- * @param bit  INTEN register bit position.
- *
- * @return Event identifier.
- *
- * @sa nrfx_event_to_bitpos
- */
-__STATIC_INLINE uint32_t nrfx_bitpos_to_event(uint32_t bit);
-
-/**
- * @brief Function for converting an event identifier to the corresponding
- *        INTEN register bit position.
- *
- * The event identifier is the offset between the event register address and
- * the peripheral base address, and is equal (thus, can be directly cast) to
- * the corresponding value of the enumerated type from HAL (nrf_*_event_t).
- *
- * @param event  Event identifier.
- *
- * @return INTEN register bit position.
- *
- * @sa nrfx_bitpos_to_event
- */
-__STATIC_INLINE uint32_t nrfx_event_to_bitpos(uint32_t event);
-
-
-#ifndef SUPPRESS_INLINE_IMPLEMENTATION
-
-__STATIC_INLINE bool nrfx_is_in_ram(void const * p_object)
-{
-    return ((((uint32_t)p_object) & 0xE0000000u) == 0x20000000u);
-}
-
-__STATIC_INLINE IRQn_Type nrfx_get_irq_number(void const * p_reg)
-{
-    return (IRQn_Type)NRFX_IRQ_NUMBER_GET(p_reg);
-}
-
-__STATIC_INLINE uint32_t nrfx_bitpos_to_event(uint32_t bit)
-{
-    static const uint32_t event_reg_offset = 0x100u;
-    return event_reg_offset + (bit * sizeof(uint32_t));
-}
-
-__STATIC_INLINE uint32_t nrfx_event_to_bitpos(uint32_t event)
-{
-    static const uint32_t event_reg_offset = 0x100u;
-    return (event - event_reg_offset) / sizeof(uint32_t);
-}
-
-#endif
-
-/** @} */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // NRFX_COMMON_H__
+/*
+ * Copyright (c) 2017 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_COMMON_H__
+#define NRFX_COMMON_H__
+
+#include <stdint.h>
+#include <stddef.h>
+#include <stdbool.h>
+
+#include <nrf.h>
+#include <nrf_peripherals.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup nrfx_common Common module
+ * @{
+ * @ingroup nrfx
+ * @brief Common module.
+ */
+
+/**
+ * @brief Macro for checking if the specified identifier is defined and it has
+ *        a non-zero value.
+ *
+ * Normally, preprocessors treat all undefined identifiers as having the value
+ * zero. However, some tools, like static code analyzers, may issue a warning
+ * when such identifier is evaluated. This macro gives the possibility to suppress
+ * such warnings only in places where this macro is used for evaluation, not in
+ * the whole analyzed code.
+ */
+#define NRFX_CHECK(module_enabled)  (module_enabled)
+
+/**
+ * @brief Macro for concatenating two tokens in macro expansion.
+ *
+ * @note This macro is expanded in two steps so that tokens given as macros
+ *       themselves are fully expanded before they are merged.
+ *
+ * @param p1  First token.
+ * @param p2  Second token.
+ *
+ * @return The two tokens merged into one, unless they cannot together form
+ *         a valid token (in such case, the preprocessor issues a warning and
+ *         does not perform the concatenation).
+ *
+ * @sa NRFX_CONCAT_3
+ */
+#define NRFX_CONCAT_2(p1, p2)       NRFX_CONCAT_2_(p1, p2)
+/**
+ * @brief Internal macro used by @ref NRFX_CONCAT_2 to perform the expansion
+ *        in two steps.
+ */
+#define NRFX_CONCAT_2_(p1, p2)      p1 ## p2
+
+/**
+ * @brief Macro for concatenating three tokens in macro expansion.
+ *
+ * @note This macro is expanded in two steps so that tokens given as macros
+ *       themselves are fully expanded before they are merged.
+ *
+ * @param p1  First token.
+ * @param p2  Second token.
+ * @param p3  Third token.
+ *
+ * @return The three tokens merged into one, unless they cannot together form
+ *         a valid token (in such case, the preprocessor issues a warning and
+ *         does not perform the concatenation).
+ *
+ * @sa NRFX_CONCAT_2
+ */
+#define NRFX_CONCAT_3(p1, p2, p3)   NRFX_CONCAT_3_(p1, p2, p3)
+/**
+ * @brief Internal macro used by @ref NRFX_CONCAT_3 to perform the expansion
+ *        in two steps.
+ */
+#define NRFX_CONCAT_3_(p1, p2, p3)  p1 ## p2 ## p3
+
+/**@brief Macro for performing rounded integer division (as opposed to
+ *        truncating the result).
+ *
+ * @param a  Numerator.
+ * @param b  Denominator.
+ *
+ * @return Rounded (integer) result of dividing @c a by @c b.
+ */
+#define NRFX_ROUNDED_DIV(a, b)  (((a) + ((b) / 2)) / (b))
+
+/**@brief Macro for performing integer division, making sure the result is rounded up.
+ *
+ * @details A typical use case for this macro is to compute the number of objects 
+ *          with size @c b required to hold @c a number of bytes.
+ *
+ * @param a  Numerator.
+ * @param b  Denominator.
+ *
+ * @return Integer result of dividing @c a by @c b, rounded up.
+ */
+#define NRFX_CEIL_DIV(a, b)  ((((a) - 1) / (b)) + 1)
+
+/**
+ * @brief Macro for getting the number of elements in an array.
+ *
+ * @param array  Name of the array.
+ *
+ * @return Array element count.
+ */
+#define NRFX_ARRAY_SIZE(array) (sizeof(array) / sizeof((array)[0]))
+
+/**@brief Macro for checking if given lengths of EasyDMA transfers do not exceed
+ *        the limit of the specified peripheral.
+ *
+ * @param peripheral Peripheral to check the lengths against.
+ * @param length1    First length to be checked.
+ * @param length2    Second length to be checked (pass 0 if not needed).
+ *
+ * @return
+ */
+#define NRFX_EASYDMA_LENGTH_VALIDATE(peripheral, length1, length2)            \
+    (((length1) < (1U << NRFX_CONCAT_2(peripheral, _EASYDMA_MAXCNT_SIZE))) && \
+     ((length2) < (1U << NRFX_CONCAT_2(peripheral, _EASYDMA_MAXCNT_SIZE))))
+
+/**@brief Macro for waiting until condition is met.
+ *
+ * @param[in]  condition Condition to meet.
+ * @param[in]  attempts  Maximum number of condition checks. Must not be 0.
+ * @param[in]  delay_us  Delay between consecutive checks, in microseconds.
+ * @param[out] result    Boolean variable to store the result of the wait process.
+ *                       Set to true if the condition is met or false otherwise.
+ */
+#define NRFX_WAIT_FOR(condition, attempts, delay_us, result) \
+do {                                                         \
+    result =  false;                                         \
+    uint32_t remaining_attempts = (attempts);                \
+    do {                                                     \
+           if (condition)                                    \
+           {                                                 \
+               result =  true;                               \
+               break;                                        \
+           }                                                 \
+           NRFX_DELAY_US(delay_us);                          \
+    } while (--remaining_attempts);                          \
+} while(0)
+
+/**
+ * @brief Macro for getting the ID number of the specified peripheral.
+ *
+ * For peripherals in Nordic SoCs, there is a direct relationship between their
+ * ID numbers and their base addresses. See the chapter "Peripheral interface"
+ * (section "Peripheral ID") in the Product Specification.
+ *
+ * @param[in] base_addr  Peripheral base address or pointer.
+ *
+ * @return ID number associated with the specified peripheral.
+ */
+#define NRFX_PERIPHERAL_ID_GET(base_addr)  (uint8_t)((uint32_t)(base_addr) >> 12)
+
+/**
+ * @brief Macro for getting the interrupt number assigned to a specific
+ *        peripheral.
+ *
+ * For peripherals in Nordic SoCs, the IRQ number assigned to a peripheral is
+ * equal to its ID number. See the chapter "Peripheral interface" (sections
+ * "Peripheral ID" and "Interrupts") in the Product Specification.
+ *
+ * @param[in] base_addr  Peripheral base address or pointer.
+ *
+ * @return Interrupt number associated with the specified peripheral.
+ */
+#define NRFX_IRQ_NUMBER_GET(base_addr)  NRFX_PERIPHERAL_ID_GET(base_addr)
+
+/**
+ * @brief IRQ handler type.
+ */
+typedef void (* nrfx_irq_handler_t)(void);
+
+/**
+ * @brief Driver state.
+ */
+typedef enum
+{
+    NRFX_DRV_STATE_UNINITIALIZED, ///< Uninitialized.
+    NRFX_DRV_STATE_INITIALIZED,   ///< Initialized but powered off.
+    NRFX_DRV_STATE_POWERED_ON,    ///< Initialized and powered on.
+} nrfx_drv_state_t;
+
+
+/**
+ * @brief Function for checking if an object is placed in the Data RAM region.
+ *
+ * Several peripherals (the ones using EasyDMA) require the transfer buffers
+ * to be placed in the Data RAM region. This function can be used to check if
+ * this condition is met.
+ *
+ * @param[in] p_object  Pointer to an object whose location is to be checked.
+ *
+ * @retval true  If the pointed object is located in the Data RAM region.
+ * @retval false Otherwise.
+ */
+__STATIC_INLINE bool nrfx_is_in_ram(void const * p_object);
+
+
+/**
+ * @brief Function for checking if an object is aligned to a 32-bit word
+ *
+ * Several peripherals (the ones using EasyDMA) require the transfer buffers
+ * to be aligned to a 32-bit word. This function can be used to check if
+ * this condition is met.
+ *
+ * @param[in] p_object  Pointer to an object whose location is to be checked.
+ *
+ * @retval true  if the pointed object is aligned to a 32-bit word.
+ * @retval false otherwise.
+ */
+__STATIC_INLINE bool nrfx_is_word_aligned(void const * p_object);
+
+
+/**
+ * @brief Function for getting the interrupt number for a specific peripheral.
+ *
+ * @param[in] p_reg  Peripheral base pointer.
+ *
+ * @return Interrupt number associated with the pointed peripheral.
+ */
+__STATIC_INLINE IRQn_Type nrfx_get_irq_number(void const * p_reg);
+
+/**
+ * @brief Function for converting an INTEN register bit position to the
+ *        corresponding event identifier.
+ *
+ * The event identifier is the offset between the event register address and
+ * the peripheral base address, and is equal (thus, can be directly cast) to
+ * the corresponding value of the enumerated type from HAL (nrf_*_event_t).
+
+ * @param bit  INTEN register bit position.
+ *
+ * @return Event identifier.
+ *
+ * @sa nrfx_event_to_bitpos
+ */
+__STATIC_INLINE uint32_t nrfx_bitpos_to_event(uint32_t bit);
+
+/**
+ * @brief Function for converting an event identifier to the corresponding
+ *        INTEN register bit position.
+ *
+ * The event identifier is the offset between the event register address and
+ * the peripheral base address, and is equal (thus, can be directly cast) to
+ * the corresponding value of the enumerated type from HAL (nrf_*_event_t).
+ *
+ * @param event  Event identifier.
+ *
+ * @return INTEN register bit position.
+ *
+ * @sa nrfx_bitpos_to_event
+ */
+__STATIC_INLINE uint32_t nrfx_event_to_bitpos(uint32_t event);
+
+
+#ifndef SUPPRESS_INLINE_IMPLEMENTATION
+
+__STATIC_INLINE bool nrfx_is_in_ram(void const * p_object)
+{
+    return ((((uint32_t)p_object) & 0xE0000000u) == 0x20000000u);
+}
+
+__STATIC_INLINE bool nrfx_is_word_aligned(void const * p_object)
+{
+    return ((((uint32_t)p_object) & 0x3u) == 0u);
+}
+
+__STATIC_INLINE IRQn_Type nrfx_get_irq_number(void const * p_reg)
+{
+    return (IRQn_Type)NRFX_IRQ_NUMBER_GET(p_reg);
+}
+
+__STATIC_INLINE uint32_t nrfx_bitpos_to_event(uint32_t bit)
+{
+    static const uint32_t event_reg_offset = 0x100u;
+    return event_reg_offset + (bit * sizeof(uint32_t));
+}
+
+__STATIC_INLINE uint32_t nrfx_event_to_bitpos(uint32_t event)
+{
+    static const uint32_t event_reg_offset = 0x100u;
+    return (event - event_reg_offset) / sizeof(uint32_t);
+}
+
+#endif
+
+/** @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NRFX_COMMON_H__

third_party/NordicSemiconductor/nrfx/drivers/nrfx_errors.h

@@ -1,82 +1,73 @@
-/**
- * Copyright (c) 2017 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#ifndef NRFX_ERRORS_H__
-#define NRFX_ERRORS_H__
-
-#if !NRFX_CHECK(NRFX_CUSTOM_ERROR_CODES)
-
-/**
- * @defgroup nrfx_error_codes Global Error Codes
- * @{
- * @ingroup nrfx
- *
- * @brief Global error codes definitions.
- */
-
-#define NRFX_ERROR_BASE_NUM         0x0BAD0000
-#define NRFX_ERROR_DRIVERS_BASE_NUM (NRFX_ERROR_BASE_NUM + 0x10000)
-
-/** @brief Enumerated type for error codes. */
-typedef enum {
-    NRFX_SUCCESS                    = (NRFX_ERROR_BASE_NUM + 0),  ///< Operation performed successfully.
-    NRFX_ERROR_INTERNAL             = (NRFX_ERROR_BASE_NUM + 1),  ///< Internal error.
-    NRFX_ERROR_NO_MEM               = (NRFX_ERROR_BASE_NUM + 2),  ///< No memory for operation.
-    NRFX_ERROR_NOT_SUPPORTED        = (NRFX_ERROR_BASE_NUM + 3),  ///< Not supported.
-    NRFX_ERROR_INVALID_PARAM        = (NRFX_ERROR_BASE_NUM + 4),  ///< Invalid parameter.
-    NRFX_ERROR_INVALID_STATE        = (NRFX_ERROR_BASE_NUM + 5),  ///< Invalid state, operation disallowed in this state.
-    NRFX_ERROR_INVALID_LENGTH       = (NRFX_ERROR_BASE_NUM + 6),  ///< Invalid length.
-    NRFX_ERROR_TIMEOUT              = (NRFX_ERROR_BASE_NUM + 7),  ///< Operation timed out.
-    NRFX_ERROR_FORBIDDEN            = (NRFX_ERROR_BASE_NUM + 8),  ///< Operation is forbidden.
-    NRFX_ERROR_NULL                 = (NRFX_ERROR_BASE_NUM + 9),  ///< Null pointer.
-    NRFX_ERROR_INVALID_ADDR         = (NRFX_ERROR_BASE_NUM + 10), ///< Bad memory address.
-    NRFX_ERROR_BUSY                 = (NRFX_ERROR_BASE_NUM + 11), ///< Busy.
-    NRFX_ERROR_ALREADY_INITIALIZED  = (NRFX_ERROR_BASE_NUM + 12), ///< Module already initialized.
-
-    NRFX_ERROR_DRV_TWI_ERR_OVERRUN  = (NRFX_ERROR_DRIVERS_BASE_NUM + 0), ///< TWI error: Overrun.
-    NRFX_ERROR_DRV_TWI_ERR_ANACK    = (NRFX_ERROR_DRIVERS_BASE_NUM + 1), ///< TWI error: Address not acknowledged.
-    NRFX_ERROR_DRV_TWI_ERR_DNACK    = (NRFX_ERROR_DRIVERS_BASE_NUM + 2)  ///< TWI error: Data not acknowledged.
-} nrfx_err_t;
-
-/** @} */
-
-#endif // !NRFX_CHECK(NRFX_CUSTOM_ERROR_CODES)
-
-#endif // NRFX_ERRORS_H__
+/*
+ * Copyright (c) 2017 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef NRFX_ERRORS_H__
+#define NRFX_ERRORS_H__
+
+#if !NRFX_CHECK(NRFX_CUSTOM_ERROR_CODES)
+
+/**
+ * @defgroup nrfx_error_codes Global Error Codes
+ * @{
+ * @ingroup nrfx
+ *
+ * @brief Global error codes definitions.
+ */
+
+#define NRFX_ERROR_BASE_NUM         0x0BAD0000
+#define NRFX_ERROR_DRIVERS_BASE_NUM (NRFX_ERROR_BASE_NUM + 0x10000)
+
+/** @brief Enumerated type for error codes. */
+typedef enum {
+    NRFX_SUCCESS                    = (NRFX_ERROR_BASE_NUM + 0),  ///< Operation performed successfully.
+    NRFX_ERROR_INTERNAL             = (NRFX_ERROR_BASE_NUM + 1),  ///< Internal error.
+    NRFX_ERROR_NO_MEM               = (NRFX_ERROR_BASE_NUM + 2),  ///< No memory for operation.
+    NRFX_ERROR_NOT_SUPPORTED        = (NRFX_ERROR_BASE_NUM + 3),  ///< Not supported.
+    NRFX_ERROR_INVALID_PARAM        = (NRFX_ERROR_BASE_NUM + 4),  ///< Invalid parameter.
+    NRFX_ERROR_INVALID_STATE        = (NRFX_ERROR_BASE_NUM + 5),  ///< Invalid state, operation disallowed in this state.
+    NRFX_ERROR_INVALID_LENGTH       = (NRFX_ERROR_BASE_NUM + 6),  ///< Invalid length.
+    NRFX_ERROR_TIMEOUT              = (NRFX_ERROR_BASE_NUM + 7),  ///< Operation timed out.
+    NRFX_ERROR_FORBIDDEN            = (NRFX_ERROR_BASE_NUM + 8),  ///< Operation is forbidden.
+    NRFX_ERROR_NULL                 = (NRFX_ERROR_BASE_NUM + 9),  ///< Null pointer.
+    NRFX_ERROR_INVALID_ADDR         = (NRFX_ERROR_BASE_NUM + 10), ///< Bad memory address.
+    NRFX_ERROR_BUSY                 = (NRFX_ERROR_BASE_NUM + 11), ///< Busy.
+    NRFX_ERROR_ALREADY_INITIALIZED  = (NRFX_ERROR_BASE_NUM + 12), ///< Module already initialized.
+
+    NRFX_ERROR_DRV_TWI_ERR_OVERRUN  = (NRFX_ERROR_DRIVERS_BASE_NUM + 0), ///< TWI error: Overrun.
+    NRFX_ERROR_DRV_TWI_ERR_ANACK    = (NRFX_ERROR_DRIVERS_BASE_NUM + 1), ///< TWI error: Address not acknowledged.
+    NRFX_ERROR_DRV_TWI_ERR_DNACK    = (NRFX_ERROR_DRIVERS_BASE_NUM + 2)  ///< TWI error: Data not acknowledged.
+} nrfx_err_t;
+
+/** @} */
+
+#endif // !NRFX_CHECK(NRFX_CUSTOM_ERROR_CODES)
+
+#endif // NRFX_ERRORS_H__

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_adc.c

@@ -1,340 +1,331 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_ADC_ENABLED)
-
-#include <nrfx_adc.h>
-
-#define NRFX_LOG_MODULE ADC
-#include <nrfx_log.h>
-
-#define EVT_TO_STR(event)   (event == NRF_ADC_EVENT_END ? "NRF_ADC_EVENT_END" : "UNKNOWN EVENT")
-
-typedef struct
-{
-    nrfx_adc_event_handler_t event_handler;
-    nrfx_adc_channel_t     * p_head;
-    nrfx_adc_channel_t     * p_current_conv;
-    nrf_adc_value_t        * p_buffer;
-    uint16_t                 size;
-    uint16_t                 idx;
-    nrfx_drv_state_t         state;
-} adc_cb_t;
-
-static adc_cb_t m_cb;
-
-nrfx_err_t nrfx_adc_init(nrfx_adc_config_t const * p_config,
-                         nrfx_adc_event_handler_t  event_handler)
-{
-    NRFX_ASSERT(p_config);
-    nrfx_err_t err_code;
-
-    if (m_cb.state != NRFX_DRV_STATE_UNINITIALIZED)
-    {
-        err_code = NRFX_ERROR_INVALID_STATE;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    nrf_adc_event_clear(NRF_ADC_EVENT_END);
-    if (event_handler)
-    {
-        NRFX_IRQ_PRIORITY_SET(ADC_IRQn, p_config->interrupt_priority);
-        NRFX_IRQ_ENABLE(ADC_IRQn);
-    }
-    m_cb.event_handler = event_handler;
-    m_cb.state = NRFX_DRV_STATE_INITIALIZED;
-
-    err_code = NRFX_SUCCESS;
-    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
-    return err_code;
-}
-
-void nrfx_adc_uninit(void)
-{
-    NRFX_IRQ_DISABLE(ADC_IRQn);
-    nrf_adc_int_disable(NRF_ADC_INT_END_MASK);
-    nrf_adc_task_trigger(NRF_ADC_TASK_STOP);
-
-    // Disable all channels. This must be done after the interrupt is disabled
-    // because adc_sample_process() dereferences this pointer when it needs to
-    // switch back to the first channel in the list (when the number of samples
-    // to read is bigger than the number of enabled channels).
-    m_cb.p_head = NULL;
-
-    m_cb.state = NRFX_DRV_STATE_UNINITIALIZED;
-}
-
-void nrfx_adc_channel_enable(nrfx_adc_channel_t * const p_channel)
-{
-    NRFX_ASSERT(!nrfx_adc_is_busy());
-
-    p_channel->p_next = NULL;
-    if (m_cb.p_head == NULL)
-    {
-        m_cb.p_head = p_channel;
-    }
-    else
-    {
-        nrfx_adc_channel_t * p_curr_channel = m_cb.p_head;
-        while (p_curr_channel->p_next != NULL)
-        {
-            NRFX_ASSERT(p_channel != p_curr_channel);
-            p_curr_channel = p_curr_channel->p_next;
-        }
-        p_curr_channel->p_next = p_channel;
-    }
-
-    NRFX_LOG_INFO("Enabled.");
-}
-
-void nrfx_adc_channel_disable(nrfx_adc_channel_t * const p_channel)
-{
-    NRFX_ASSERT(m_cb.p_head);
-    NRFX_ASSERT(!nrfx_adc_is_busy());
-
-    nrfx_adc_channel_t * p_curr_channel = m_cb.p_head;
-    nrfx_adc_channel_t * p_prev_channel = NULL;
-    while (p_curr_channel != p_channel)
-    {
-        p_prev_channel = p_curr_channel;
-        p_curr_channel = p_curr_channel->p_next;
-        NRFX_ASSERT(p_curr_channel != NULL);
-    }
-    if (p_prev_channel)
-    {
-        p_prev_channel->p_next = p_curr_channel->p_next;
-    }
-    else
-    {
-        m_cb.p_head = p_curr_channel->p_next;
-    }
-
-    NRFX_LOG_INFO("Disabled.");
-}
-
-void nrfx_adc_all_channels_disable(void)
-{
-    NRFX_ASSERT(!nrfx_adc_is_busy());
-
-    m_cb.p_head = NULL;
-}
-
-void nrfx_adc_sample(void)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-    NRFX_ASSERT(!nrf_adc_busy_check());
-    nrf_adc_task_trigger(NRF_ADC_TASK_START);
-}
-
-nrfx_err_t nrfx_adc_sample_convert(nrfx_adc_channel_t const * const p_channel,
-                                   nrf_adc_value_t                * p_value)
-{
-    nrfx_err_t err_code;
-
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-    if (m_cb.state == NRFX_DRV_STATE_POWERED_ON)
-    {
-        err_code = NRFX_ERROR_BUSY;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-    else
-    {
-        m_cb.state = NRFX_DRV_STATE_POWERED_ON;
-
-        nrf_adc_init(&p_channel->config);
-        nrf_adc_enable();
-        nrf_adc_int_disable(NRF_ADC_INT_END_MASK);
-        nrf_adc_task_trigger(NRF_ADC_TASK_START);
-        if (p_value)
-        {
-            while (!nrf_adc_event_check(NRF_ADC_EVENT_END)) {}
-            nrf_adc_event_clear(NRF_ADC_EVENT_END);
-            *p_value = (nrf_adc_value_t)nrf_adc_result_get();
-            nrf_adc_disable();
-
-            m_cb.state = NRFX_DRV_STATE_INITIALIZED;
-        }
-        else
-        {
-            NRFX_ASSERT(m_cb.event_handler);
-            m_cb.p_buffer = NULL;
-            nrf_adc_int_enable(NRF_ADC_INT_END_MASK);
-        }
-        err_code = NRFX_SUCCESS;
-        NRFX_LOG_INFO("Function: %s, error code: %s.",
-                      __func__,
-                      NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-}
-
-static bool adc_sample_process()
-{
-    nrf_adc_event_clear(NRF_ADC_EVENT_END);
-    nrf_adc_disable();
-    m_cb.p_buffer[m_cb.idx] = (nrf_adc_value_t)nrf_adc_result_get();
-    m_cb.idx++;
-    if (m_cb.idx < m_cb.size)
-    {
-        bool task_trigger = false;
-        if (m_cb.p_current_conv->p_next == NULL)
-        {
-            // Make sure the list of channels has not been somehow removed
-            // (it is when all channels are disabled).
-            NRFX_ASSERT(m_cb.p_head);
-
-            m_cb.p_current_conv = m_cb.p_head;
-        }
-        else
-        {
-            m_cb.p_current_conv = m_cb.p_current_conv->p_next;
-            task_trigger = true;
-        }
-        nrf_adc_init(&m_cb.p_current_conv->config);
-        nrf_adc_enable();
-        if (task_trigger)
-        {
-            nrf_adc_task_trigger(NRF_ADC_TASK_START);
-        }
-        return false;
-    }
-    else
-    {
-        return true;
-    }
-}
-
-nrfx_err_t nrfx_adc_buffer_convert(nrf_adc_value_t * buffer, uint16_t size)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-
-    nrfx_err_t err_code;
-
-    NRFX_LOG_INFO("Number of samples requested to convert: %d.", size);
-
-    if (m_cb.state == NRFX_DRV_STATE_POWERED_ON)
-    {
-        err_code = NRFX_ERROR_BUSY;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-    else
-    {
-        m_cb.state          = NRFX_DRV_STATE_POWERED_ON;
-        m_cb.p_current_conv = m_cb.p_head;
-        m_cb.size           = size;
-        m_cb.idx            = 0;
-        m_cb.p_buffer       = buffer;
-        nrf_adc_init(&m_cb.p_current_conv->config);
-        nrf_adc_event_clear(NRF_ADC_EVENT_END);
-        nrf_adc_enable();
-        if (m_cb.event_handler)
-        {
-            nrf_adc_int_enable(NRF_ADC_INT_END_MASK);
-        }
-        else
-        {
-            while (1)
-            {
-                while (!nrf_adc_event_check(NRF_ADC_EVENT_END)){}
-
-                if (adc_sample_process())
-                {
-                    m_cb.state = NRFX_DRV_STATE_INITIALIZED;
-                    break;
-                }
-            }
-        }
-        err_code = NRFX_SUCCESS;
-        NRFX_LOG_INFO("Function: %s, error code: %s.",
-                      __func__,
-                      NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-}
-
-bool nrfx_adc_is_busy(void)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-    return (m_cb.state == NRFX_DRV_STATE_POWERED_ON) ? true : false;
-}
-
-void nrfx_adc_irq_handler(void)
-{
-    if (m_cb.p_buffer == NULL)
-    {
-        nrf_adc_event_clear(NRF_ADC_EVENT_END);
-        NRFX_LOG_DEBUG("Event: %s.",NRFX_LOG_ERROR_STRING_GET(NRF_ADC_EVENT_END));
-        nrf_adc_int_disable(NRF_ADC_INT_END_MASK);
-        nrf_adc_disable();
-        nrfx_adc_evt_t evt;
-        evt.type = NRFX_ADC_EVT_SAMPLE;
-        evt.data.sample.sample = (nrf_adc_value_t)nrf_adc_result_get();
-        NRFX_LOG_DEBUG("ADC data:");
-        NRFX_LOG_HEXDUMP_DEBUG((uint8_t *)(&evt.data.sample.sample), sizeof(nrf_adc_value_t));
-        m_cb.state = NRFX_DRV_STATE_INITIALIZED;
-        m_cb.event_handler(&evt);
-    }
-    else if (adc_sample_process())
-    {
-        NRFX_LOG_DEBUG("Event: %s.", NRFX_LOG_ERROR_STRING_GET(NRF_ADC_EVENT_END));
-        nrf_adc_int_disable(NRF_ADC_INT_END_MASK);
-        nrfx_adc_evt_t evt;
-        evt.type = NRFX_ADC_EVT_DONE;
-        evt.data.done.p_buffer = m_cb.p_buffer;
-        evt.data.done.size     = m_cb.size;
-        m_cb.state = NRFX_DRV_STATE_INITIALIZED;
-        NRFX_LOG_DEBUG("ADC data:");
-        NRFX_LOG_HEXDUMP_DEBUG((uint8_t *)m_cb.p_buffer, m_cb.size * sizeof(nrf_adc_value_t));
-        m_cb.event_handler(&evt);
-    }
-}
-
-#endif // NRFX_CHECK(NRFX_ADC_ENABLED)
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_ADC_ENABLED)
+
+#include <nrfx_adc.h>
+
+#define NRFX_LOG_MODULE ADC
+#include <nrfx_log.h>
+
+#define EVT_TO_STR(event)   (event == NRF_ADC_EVENT_END ? "NRF_ADC_EVENT_END" : "UNKNOWN EVENT")
+
+typedef struct
+{
+    nrfx_adc_event_handler_t event_handler;
+    nrfx_adc_channel_t     * p_head;
+    nrfx_adc_channel_t     * p_current_conv;
+    nrf_adc_value_t        * p_buffer;
+    uint16_t                 size;
+    uint16_t                 idx;
+    nrfx_drv_state_t         state;
+} adc_cb_t;
+
+static adc_cb_t m_cb;
+
+nrfx_err_t nrfx_adc_init(nrfx_adc_config_t const * p_config,
+                         nrfx_adc_event_handler_t  event_handler)
+{
+    NRFX_ASSERT(p_config);
+    nrfx_err_t err_code;
+
+    if (m_cb.state != NRFX_DRV_STATE_UNINITIALIZED)
+    {
+        err_code = NRFX_ERROR_INVALID_STATE;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    nrf_adc_event_clear(NRF_ADC_EVENT_END);
+    if (event_handler)
+    {
+        NRFX_IRQ_PRIORITY_SET(ADC_IRQn, p_config->interrupt_priority);
+        NRFX_IRQ_ENABLE(ADC_IRQn);
+    }
+    m_cb.event_handler = event_handler;
+    m_cb.state = NRFX_DRV_STATE_INITIALIZED;
+
+    err_code = NRFX_SUCCESS;
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+void nrfx_adc_uninit(void)
+{
+    NRFX_IRQ_DISABLE(ADC_IRQn);
+    nrf_adc_int_disable(NRF_ADC_INT_END_MASK);
+    nrf_adc_task_trigger(NRF_ADC_TASK_STOP);
+
+    // Disable all channels. This must be done after the interrupt is disabled
+    // because adc_sample_process() dereferences this pointer when it needs to
+    // switch back to the first channel in the list (when the number of samples
+    // to read is bigger than the number of enabled channels).
+    m_cb.p_head = NULL;
+
+    m_cb.state = NRFX_DRV_STATE_UNINITIALIZED;
+}
+
+void nrfx_adc_channel_enable(nrfx_adc_channel_t * const p_channel)
+{
+    NRFX_ASSERT(!nrfx_adc_is_busy());
+
+    p_channel->p_next = NULL;
+    if (m_cb.p_head == NULL)
+    {
+        m_cb.p_head = p_channel;
+    }
+    else
+    {
+        nrfx_adc_channel_t * p_curr_channel = m_cb.p_head;
+        while (p_curr_channel->p_next != NULL)
+        {
+            NRFX_ASSERT(p_channel != p_curr_channel);
+            p_curr_channel = p_curr_channel->p_next;
+        }
+        p_curr_channel->p_next = p_channel;
+    }
+
+    NRFX_LOG_INFO("Enabled.");
+}
+
+void nrfx_adc_channel_disable(nrfx_adc_channel_t * const p_channel)
+{
+    NRFX_ASSERT(m_cb.p_head);
+    NRFX_ASSERT(!nrfx_adc_is_busy());
+
+    nrfx_adc_channel_t * p_curr_channel = m_cb.p_head;
+    nrfx_adc_channel_t * p_prev_channel = NULL;
+    while (p_curr_channel != p_channel)
+    {
+        p_prev_channel = p_curr_channel;
+        p_curr_channel = p_curr_channel->p_next;
+        NRFX_ASSERT(p_curr_channel != NULL);
+    }
+    if (p_prev_channel)
+    {
+        p_prev_channel->p_next = p_curr_channel->p_next;
+    }
+    else
+    {
+        m_cb.p_head = p_curr_channel->p_next;
+    }
+
+    NRFX_LOG_INFO("Disabled.");
+}
+
+void nrfx_adc_all_channels_disable(void)
+{
+    NRFX_ASSERT(!nrfx_adc_is_busy());
+
+    m_cb.p_head = NULL;
+}
+
+void nrfx_adc_sample(void)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+    NRFX_ASSERT(!nrf_adc_busy_check());
+    nrf_adc_task_trigger(NRF_ADC_TASK_START);
+}
+
+nrfx_err_t nrfx_adc_sample_convert(nrfx_adc_channel_t const * const p_channel,
+                                   nrf_adc_value_t                * p_value)
+{
+    nrfx_err_t err_code;
+
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+    if (m_cb.state == NRFX_DRV_STATE_POWERED_ON)
+    {
+        err_code = NRFX_ERROR_BUSY;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+    else
+    {
+        m_cb.state = NRFX_DRV_STATE_POWERED_ON;
+
+        nrf_adc_init(&p_channel->config);
+        nrf_adc_enable();
+        nrf_adc_int_disable(NRF_ADC_INT_END_MASK);
+        nrf_adc_task_trigger(NRF_ADC_TASK_START);
+        if (p_value)
+        {
+            while (!nrf_adc_event_check(NRF_ADC_EVENT_END)) {}
+            nrf_adc_event_clear(NRF_ADC_EVENT_END);
+            *p_value = (nrf_adc_value_t)nrf_adc_result_get();
+            nrf_adc_disable();
+
+            m_cb.state = NRFX_DRV_STATE_INITIALIZED;
+        }
+        else
+        {
+            NRFX_ASSERT(m_cb.event_handler);
+            m_cb.p_buffer = NULL;
+            nrf_adc_int_enable(NRF_ADC_INT_END_MASK);
+        }
+        err_code = NRFX_SUCCESS;
+        NRFX_LOG_INFO("Function: %s, error code: %s.",
+                      __func__,
+                      NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+}
+
+static bool adc_sample_process()
+{
+    nrf_adc_event_clear(NRF_ADC_EVENT_END);
+    nrf_adc_disable();
+    m_cb.p_buffer[m_cb.idx] = (nrf_adc_value_t)nrf_adc_result_get();
+    m_cb.idx++;
+    if (m_cb.idx < m_cb.size)
+    {
+        bool task_trigger = false;
+        if (m_cb.p_current_conv->p_next == NULL)
+        {
+            // Make sure the list of channels has not been somehow removed
+            // (it is when all channels are disabled).
+            NRFX_ASSERT(m_cb.p_head);
+
+            m_cb.p_current_conv = m_cb.p_head;
+        }
+        else
+        {
+            m_cb.p_current_conv = m_cb.p_current_conv->p_next;
+            task_trigger = true;
+        }
+        nrf_adc_init(&m_cb.p_current_conv->config);
+        nrf_adc_enable();
+        if (task_trigger)
+        {
+            nrf_adc_task_trigger(NRF_ADC_TASK_START);
+        }
+        return false;
+    }
+    else
+    {
+        return true;
+    }
+}
+
+nrfx_err_t nrfx_adc_buffer_convert(nrf_adc_value_t * buffer, uint16_t size)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+
+    nrfx_err_t err_code;
+
+    NRFX_LOG_INFO("Number of samples requested to convert: %d.", size);
+
+    if (m_cb.state == NRFX_DRV_STATE_POWERED_ON)
+    {
+        err_code = NRFX_ERROR_BUSY;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+    else
+    {
+        m_cb.state          = NRFX_DRV_STATE_POWERED_ON;
+        m_cb.p_current_conv = m_cb.p_head;
+        m_cb.size           = size;
+        m_cb.idx            = 0;
+        m_cb.p_buffer       = buffer;
+        nrf_adc_init(&m_cb.p_current_conv->config);
+        nrf_adc_event_clear(NRF_ADC_EVENT_END);
+        nrf_adc_enable();
+        if (m_cb.event_handler)
+        {
+            nrf_adc_int_enable(NRF_ADC_INT_END_MASK);
+        }
+        else
+        {
+            while (1)
+            {
+                while (!nrf_adc_event_check(NRF_ADC_EVENT_END)){}
+
+                if (adc_sample_process())
+                {
+                    m_cb.state = NRFX_DRV_STATE_INITIALIZED;
+                    break;
+                }
+            }
+        }
+        err_code = NRFX_SUCCESS;
+        NRFX_LOG_INFO("Function: %s, error code: %s.",
+                      __func__,
+                      NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+}
+
+bool nrfx_adc_is_busy(void)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+    return (m_cb.state == NRFX_DRV_STATE_POWERED_ON) ? true : false;
+}
+
+void nrfx_adc_irq_handler(void)
+{
+    if (m_cb.p_buffer == NULL)
+    {
+        nrf_adc_event_clear(NRF_ADC_EVENT_END);
+        NRFX_LOG_DEBUG("Event: %s.",NRFX_LOG_ERROR_STRING_GET(NRF_ADC_EVENT_END));
+        nrf_adc_int_disable(NRF_ADC_INT_END_MASK);
+        nrf_adc_disable();
+        nrfx_adc_evt_t evt;
+        evt.type = NRFX_ADC_EVT_SAMPLE;
+        evt.data.sample.sample = (nrf_adc_value_t)nrf_adc_result_get();
+        NRFX_LOG_DEBUG("ADC data:");
+        NRFX_LOG_HEXDUMP_DEBUG((uint8_t *)(&evt.data.sample.sample), sizeof(nrf_adc_value_t));
+        m_cb.state = NRFX_DRV_STATE_INITIALIZED;
+        m_cb.event_handler(&evt);
+    }
+    else if (adc_sample_process())
+    {
+        NRFX_LOG_DEBUG("Event: %s.", NRFX_LOG_ERROR_STRING_GET(NRF_ADC_EVENT_END));
+        nrf_adc_int_disable(NRF_ADC_INT_END_MASK);
+        nrfx_adc_evt_t evt;
+        evt.type = NRFX_ADC_EVT_DONE;
+        evt.data.done.p_buffer = m_cb.p_buffer;
+        evt.data.done.size     = m_cb.size;
+        m_cb.state = NRFX_DRV_STATE_INITIALIZED;
+        NRFX_LOG_DEBUG("ADC data:");
+        NRFX_LOG_HEXDUMP_DEBUG((uint8_t *)m_cb.p_buffer, m_cb.size * sizeof(nrf_adc_value_t));
+        m_cb.event_handler(&evt);
+    }
+}
+
+#endif // NRFX_CHECK(NRFX_ADC_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_clock.c

@@ -1,390 +1,376 @@
-/**
- * Copyright (c) 2016 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_CLOCK_ENABLED)
-
-#include <nrfx_clock.h>
-#include <nrfx_power.h>
-
-#define NRFX_LOG_MODULE CLOCK
-#include <nrfx_log.h>
-
-#if NRFX_CHECK(NRFX_POWER_ENABLED)
-extern bool nrfx_power_irq_enabled;
-#endif
-
-#define EVT_TO_STR(event)                                                     \
-    (event == NRF_CLOCK_EVENT_HFCLKSTARTED ? "NRF_CLOCK_EVENT_HFCLKSTARTED" : \
-    (event == NRF_CLOCK_EVENT_LFCLKSTARTED ? "NRF_CLOCK_EVENT_LFCLKSTARTED" : \
-    (event == NRF_CLOCK_EVENT_DONE         ? "NRF_CLOCK_EVENT_DONE"         : \
-    (event == NRF_CLOCK_EVENT_CTTO         ? "NRF_CLOCK_EVENT_CTTO"         : \
-                                             "UNKNOWN EVENT"))))
-
-
-/*lint -save -e652 */
-#define NRF_CLOCK_LFCLK_RC    CLOCK_LFCLKSRC_SRC_RC
-#define NRF_CLOCK_LFCLK_Xtal  CLOCK_LFCLKSRC_SRC_Xtal
-#define NRF_CLOCK_LFCLK_Synth CLOCK_LFCLKSRC_SRC_Synth
-/*lint -restore */
-
-#if (NRFX_CLOCK_CONFIG_LF_SRC == NRF_CLOCK_LFCLK_RC)
-#define CALIBRATION_SUPPORT 1
-#else
-#define CALIBRATION_SUPPORT 0
-#endif
-
-#if defined(NRF52810_XXAA) || \
-    defined(NRF52832_XXAA) || defined(NRF52832_XXAB) || \
-    defined(NRF52840_XXAA)
-// Enable workaround for nRF52 anomaly 192 (LFRC oscillator frequency is wrong
-// after calibration, exceeding 500 ppm).
-#define USE_WORKAROUND_FOR_ANOMALY_192
-
-// Enable workaround for nRF52 anomaly 201 (EVENTS_HFCLKSTARTED might be generated twice).
-#define USE_WORKAROUND_FOR_ANOMALY_201
-#endif
-
-typedef enum
-{
-    CAL_STATE_IDLE,
-    CAL_STATE_CAL
-} nrfx_clock_cal_state_t;
-
-/**@brief CLOCK control block. */
-typedef struct
-{
-    nrfx_clock_event_handler_t      event_handler;
-    bool                            module_initialized; /*< Indicate the state of module */
-#if defined(USE_WORKAROUND_FOR_ANOMALY_201)
-    bool                            hfclk_started;      /*< Anomaly 201 workaround. */
-#endif
-
-#if CALIBRATION_SUPPORT
-    volatile nrfx_clock_cal_state_t cal_state;
-#endif // CALIBRATION_SUPPORT
-} nrfx_clock_cb_t;
-
-static nrfx_clock_cb_t m_clock_cb;
-
-/**
- * This variable is used to check whether common POWER_CLOCK common interrupt
- * should be disabled or not if @ref nrfx_power tries to disable the interrupt.
- */
-#if NRFX_CHECK(NRFX_POWER_ENABLED)
-bool nrfx_clock_irq_enabled;
-#endif
-
-#if defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
-
-// ANOMALY 132 - LFCLK needs to avoid frame from 66us to 138us after LFCLK stop. This solution
-//               applies delay of 138us before starting LFCLK.
-#define ANOMALY_132_REQ_DELAY_US 138UL
-
-// nRF52832 is clocked with 64MHz.
-#define ANOMALY_132_NRF52832_FREQ_MHZ 64UL
-
-// Convert time to cycles.
-#define ANOMALY_132_DELAY_CYCLES (ANOMALY_132_REQ_DELAY_US * ANOMALY_132_NRF52832_FREQ_MHZ)
-
-/**
- * @brief Function for applying delay of 138us before starting LFCLK.
- */
-static void nrfx_clock_anomaly_132(void)
-{
-    uint32_t cyccnt_inital;
-    uint32_t core_debug;
-    uint32_t dwt_ctrl;
-
-    // Preserve DEMCR register to do not influence into its configuration. Enable the trace and
-    // debug blocks. It is required to read and write data to DWT block.
-    core_debug = CoreDebug->DEMCR;
-    CoreDebug->DEMCR = core_debug | CoreDebug_DEMCR_TRCENA_Msk;
-
-    // Preserve CTRL register in DWT block to do not influence into its configuration. Make sure
-    // that cycle counter is enabled.
-    dwt_ctrl = DWT->CTRL;
-    DWT->CTRL = dwt_ctrl | DWT_CTRL_CYCCNTENA_Msk;
-
-    // Store start value of cycle counter.
-    cyccnt_inital = DWT->CYCCNT;
-
-    // Delay required time.
-    while ((DWT->CYCCNT - cyccnt_inital) < ANOMALY_132_DELAY_CYCLES)
-    {}
-
-    // Restore preserved registers.
-    DWT->CTRL = dwt_ctrl;
-    CoreDebug->DEMCR = core_debug;
-}
-
-#endif // defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
-
-nrfx_err_t nrfx_clock_init(nrfx_clock_event_handler_t event_handler)
-{
-    NRFX_ASSERT(event_handler);
-
-    nrfx_err_t err_code = NRFX_SUCCESS;
-    if (m_clock_cb.module_initialized)
-    {
-        err_code = NRFX_ERROR_ALREADY_INITIALIZED;
-    }
-    else
-    {
-#if CALIBRATION_SUPPORT
-        m_clock_cb.cal_state = CAL_STATE_IDLE;
-#endif
-        m_clock_cb.event_handler = event_handler;
-        m_clock_cb.module_initialized = true;
-#if defined(USE_WORKAROUND_FOR_ANOMALY_201)
-        m_clock_cb.hfclk_started = false;
-#endif
-    }
-
-    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
-    return err_code;
-}
-
-void nrfx_clock_enable(void)
-{
-    NRFX_ASSERT(m_clock_cb.module_initialized);
-    nrfx_power_clock_irq_init();
-    nrf_clock_lf_src_set((nrf_clock_lfclk_t)NRFX_CLOCK_CONFIG_LF_SRC);
-
-#if NRFX_CHECK(NRFX_POWER_ENABLED)
-    nrfx_clock_irq_enabled = true;
-#endif
-
-    NRFX_LOG_INFO("Module enabled.");
-}
-
-void nrfx_clock_disable(void)
-{
-    NRFX_ASSERT(m_clock_cb.module_initialized);
-#if NRFX_CHECK(NRFX_POWER_ENABLED)
-    NRFX_ASSERT(nrfx_clock_irq_enabled);
-    if (!nrfx_power_irq_enabled)
-#endif
-    {
-        NRFX_IRQ_DISABLE(POWER_CLOCK_IRQn);
-    }
-    nrf_clock_int_disable(CLOCK_INTENSET_HFCLKSTARTED_Msk |
-                          CLOCK_INTENSET_LFCLKSTARTED_Msk |
-                          CLOCK_INTENSET_DONE_Msk |
-                          CLOCK_INTENSET_CTTO_Msk);
-#if NRFX_CHECK(NRFX_POWER_ENABLED)
-    nrfx_clock_irq_enabled = false;
-#endif
-    NRFX_LOG_INFO("Module disabled.");
-}
-
-void nrfx_clock_uninit(void)
-{
-    NRFX_ASSERT(m_clock_cb.module_initialized);
-    nrfx_clock_lfclk_stop();
-    nrfx_clock_hfclk_stop();
-    m_clock_cb.module_initialized = false;
-    NRFX_LOG_INFO("Uninitialized.");
-}
-
-void nrfx_clock_lfclk_start(void)
-{
-    NRFX_ASSERT(m_clock_cb.module_initialized);
-    nrf_clock_event_clear(NRF_CLOCK_EVENT_LFCLKSTARTED);
-    nrf_clock_int_enable(NRF_CLOCK_INT_LF_STARTED_MASK);
-
-#if defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
-    nrfx_clock_anomaly_132();
-#endif
-
-    nrf_clock_task_trigger(NRF_CLOCK_TASK_LFCLKSTART);
-}
-
-void nrfx_clock_lfclk_stop(void)
-{
-    NRFX_ASSERT(m_clock_cb.module_initialized);
-    nrf_clock_task_trigger(NRF_CLOCK_TASK_LFCLKSTOP);
-    while (nrf_clock_lf_is_running())
-    {}
-}
-
-void nrfx_clock_hfclk_start(void)
-{
-    NRFX_ASSERT(m_clock_cb.module_initialized);
-    nrf_clock_event_clear(NRF_CLOCK_EVENT_HFCLKSTARTED);
-    nrf_clock_int_enable(NRF_CLOCK_INT_HF_STARTED_MASK);
-    nrf_clock_task_trigger(NRF_CLOCK_TASK_HFCLKSTART);
-}
-
-void nrfx_clock_hfclk_stop(void)
-{
-    NRFX_ASSERT(m_clock_cb.module_initialized);
-    nrf_clock_task_trigger(NRF_CLOCK_TASK_HFCLKSTOP);
-    while (nrf_clock_hf_is_running(NRF_CLOCK_HFCLK_HIGH_ACCURACY))
-    {}
-#if defined(USE_WORKAROUND_FOR_ANOMALY_201)
-    m_clock_cb.hfclk_started = false;
-#endif
-}
-
-nrfx_err_t nrfx_clock_calibration_start(void)
-{
-    nrfx_err_t err_code = NRFX_SUCCESS;
-#if CALIBRATION_SUPPORT
-    if (nrfx_clock_hfclk_is_running() == false)
-    {
-        return NRFX_ERROR_INVALID_STATE;
-    }
-
-    if (nrfx_clock_lfclk_is_running() == false)
-    {
-        return NRFX_ERROR_INVALID_STATE;
-    }
-
-    if (m_clock_cb.cal_state == CAL_STATE_IDLE)
-    {
-        nrf_clock_event_clear(NRF_CLOCK_EVENT_DONE);
-        nrf_clock_int_enable(NRF_CLOCK_INT_DONE_MASK);
-        m_clock_cb.cal_state = CAL_STATE_CAL;
-#if defined(USE_WORKAROUND_FOR_ANOMALY_192)
-        *(volatile uint32_t *)0x40000C34 = 0x00000002;
-#endif
-        nrf_clock_task_trigger(NRF_CLOCK_TASK_CAL);
-    }
-    else
-    {
-        err_code = NRFX_ERROR_BUSY;
-    }
-#endif // CALIBRATION_SUPPORT
-    NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                     __func__,
-                     NRFX_LOG_ERROR_STRING_GET(err_code));
-    return err_code;
-}
-
-nrfx_err_t nrfx_clock_is_calibrating(void)
-{
-#if CALIBRATION_SUPPORT
-    if (m_clock_cb.cal_state == CAL_STATE_CAL)
-    {
-        return NRFX_ERROR_BUSY;
-    }
-#endif
-    return NRFX_SUCCESS;
-}
-
-void nrfx_clock_calibration_timer_start(uint8_t interval)
-{
-    nrf_clock_cal_timer_timeout_set(interval);
-    nrf_clock_event_clear(NRF_CLOCK_EVENT_CTTO);
-    nrf_clock_int_enable(NRF_CLOCK_INT_CTTO_MASK);
-    nrf_clock_task_trigger(NRF_CLOCK_TASK_CTSTART);
-}
-
-void nrfx_clock_calibration_timer_stop(void)
-{
-    nrf_clock_int_disable(NRF_CLOCK_INT_CTTO_MASK);
-    nrf_clock_task_trigger(NRF_CLOCK_TASK_CTSTOP);
-}
-
-void nrfx_clock_irq_handler(void)
-{
-    if (nrf_clock_event_check(NRF_CLOCK_EVENT_HFCLKSTARTED))
-    {
-        nrf_clock_event_clear(NRF_CLOCK_EVENT_HFCLKSTARTED);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_CLOCK_EVENT_HFCLKSTARTED));
-        nrf_clock_int_disable(NRF_CLOCK_INT_HF_STARTED_MASK);
-
-#if defined(USE_WORKAROUND_FOR_ANOMALY_201)
-        if (!m_clock_cb.hfclk_started)
-        {
-            m_clock_cb.hfclk_started = true;
-            m_clock_cb.event_handler(NRFX_CLOCK_EVT_HFCLK_STARTED);
-        }
-#else
-        m_clock_cb.event_handler(NRFX_CLOCK_EVT_HFCLK_STARTED);
-#endif
-    }
-    if (nrf_clock_event_check(NRF_CLOCK_EVENT_LFCLKSTARTED))
-    {
-        nrf_clock_event_clear(NRF_CLOCK_EVENT_LFCLKSTARTED);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_CLOCK_EVENT_LFCLKSTARTED));
-        nrf_clock_int_disable(NRF_CLOCK_INT_LF_STARTED_MASK);
-
-        m_clock_cb.event_handler(NRFX_CLOCK_EVT_LFCLK_STARTED);
-    }
-#if CALIBRATION_SUPPORT
-    if (nrf_clock_event_check(NRF_CLOCK_EVENT_CTTO))
-    {
-        nrf_clock_event_clear(NRF_CLOCK_EVENT_CTTO);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_CLOCK_EVENT_CTTO));
-        nrf_clock_int_disable(NRF_CLOCK_INT_CTTO_MASK);
-
-        m_clock_cb.event_handler(NRFX_CLOCK_EVT_CTTO);
-    }
-
-    if (nrf_clock_event_check(NRF_CLOCK_EVENT_DONE))
-    {
-#if defined(USE_WORKAROUND_FOR_ANOMALY_192)
-        *(volatile uint32_t *)0x40000C34 = 0x00000000;
-#endif
-        nrf_clock_event_clear(NRF_CLOCK_EVENT_DONE);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_CLOCK_EVENT_DONE));
-        nrf_clock_int_disable(NRF_CLOCK_INT_DONE_MASK);
-        m_clock_cb.cal_state = CAL_STATE_IDLE;
-        m_clock_cb.event_handler(NRFX_CLOCK_EVT_CAL_DONE);
-    }
-#endif // CALIBRATION_SUPPORT
-}
-
-#undef NRF_CLOCK_LFCLK_RC
-#undef NRF_CLOCK_LFCLK_Xtal
-#undef NRF_CLOCK_LFCLK_Synth
-
-#if NRFX_CHECK(NRFX_POWER_ENABLED) && NRFX_CHECK(NRFX_CLOCK_ENABLED)
-void nrfx_power_clock_irq_handler(void)
-{
-    nrfx_power_irq_handler();
-    nrfx_clock_irq_handler();
-}
-#endif
-
-#endif // NRFX_CHECK(NRFX_CLOCK_ENABLED)
+/*
+ * Copyright (c) 2016 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_CLOCK_ENABLED)
+
+#include <nrfx_clock.h>
+
+#define NRFX_LOG_MODULE CLOCK
+#include <nrfx_log.h>
+
+#if NRFX_CHECK(NRFX_POWER_ENABLED)
+extern bool nrfx_power_irq_enabled;
+#endif
+
+#define EVT_TO_STR(event)                                                     \
+    (event == NRF_CLOCK_EVENT_HFCLKSTARTED ? "NRF_CLOCK_EVENT_HFCLKSTARTED" : \
+    (event == NRF_CLOCK_EVENT_LFCLKSTARTED ? "NRF_CLOCK_EVENT_LFCLKSTARTED" : \
+    (event == NRF_CLOCK_EVENT_DONE         ? "NRF_CLOCK_EVENT_DONE"         : \
+    (event == NRF_CLOCK_EVENT_CTTO         ? "NRF_CLOCK_EVENT_CTTO"         : \
+                                             "UNKNOWN EVENT"))))
+
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+    #if (NRF_CLOCK_HAS_CALIBRATION == 0)
+        #error "Calibration is not available in the SoC that is used."
+    #endif
+    #if (NRFX_CLOCK_CONFIG_LF_SRC != CLOCK_LFCLKSRC_SRC_RC)
+        #error "Calibration can be performed only for the RC Oscillator."
+    #endif
+#endif
+
+#if defined(NRF52810_XXAA) || \
+    defined(NRF52832_XXAA) || defined(NRF52832_XXAB) || \
+    defined(NRF52840_XXAA)
+// Enable workaround for nRF52 anomaly 192 (LFRC oscillator frequency is wrong
+// after calibration, exceeding 500 ppm).
+#define USE_WORKAROUND_FOR_ANOMALY_192
+
+// Enable workaround for nRF52 anomaly 201 (EVENTS_HFCLKSTARTED might be generated twice).
+#define USE_WORKAROUND_FOR_ANOMALY_201
+#endif
+
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+typedef enum
+{
+    CAL_STATE_IDLE,
+    CAL_STATE_CAL
+} nrfx_clock_cal_state_t;
+#endif
+
+/**@brief CLOCK control block. */
+typedef struct
+{
+    nrfx_clock_event_handler_t      event_handler;
+    bool                            module_initialized; /*< Indicate the state of module */
+#if defined(USE_WORKAROUND_FOR_ANOMALY_201)
+    bool                            hfclk_started;      /*< Anomaly 201 workaround. */
+#endif
+
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+    volatile nrfx_clock_cal_state_t cal_state;
+#endif
+} nrfx_clock_cb_t;
+
+static nrfx_clock_cb_t m_clock_cb;
+
+/**
+ * This variable is used to check whether common POWER_CLOCK common interrupt
+ * should be disabled or not if @ref nrfx_power tries to disable the interrupt.
+ */
+#if NRFX_CHECK(NRFX_POWER_ENABLED)
+bool nrfx_clock_irq_enabled;
+#endif
+
+#if defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+
+// ANOMALY 132 - LFCLK needs to avoid frame from 66us to 138us after LFCLK stop. This solution
+//               applies delay of 138us before starting LFCLK.
+#define ANOMALY_132_REQ_DELAY_US 138UL
+
+// nRF52832 is clocked with 64MHz.
+#define ANOMALY_132_NRF52832_FREQ_MHZ 64UL
+
+// Convert time to cycles.
+#define ANOMALY_132_DELAY_CYCLES (ANOMALY_132_REQ_DELAY_US * ANOMALY_132_NRF52832_FREQ_MHZ)
+
+/**
+ * @brief Function for applying delay of 138us before starting LFCLK.
+ */
+static void nrfx_clock_anomaly_132(void)
+{
+    uint32_t cyccnt_inital;
+    uint32_t core_debug;
+    uint32_t dwt_ctrl;
+
+    // Preserve DEMCR register to do not influence into its configuration. Enable the trace and
+    // debug blocks. It is required to read and write data to DWT block.
+    core_debug = CoreDebug->DEMCR;
+    CoreDebug->DEMCR = core_debug | CoreDebug_DEMCR_TRCENA_Msk;
+
+    // Preserve CTRL register in DWT block to do not influence into its configuration. Make sure
+    // that cycle counter is enabled.
+    dwt_ctrl = DWT->CTRL;
+    DWT->CTRL = dwt_ctrl | DWT_CTRL_CYCCNTENA_Msk;
+
+    // Store start value of cycle counter.
+    cyccnt_inital = DWT->CYCCNT;
+
+    // Delay required time.
+    while ((DWT->CYCCNT - cyccnt_inital) < ANOMALY_132_DELAY_CYCLES)
+    {}
+
+    // Restore preserved registers.
+    DWT->CTRL = dwt_ctrl;
+    CoreDebug->DEMCR = core_debug;
+}
+
+#endif // defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+
+nrfx_err_t nrfx_clock_init(nrfx_clock_event_handler_t event_handler)
+{
+    NRFX_ASSERT(event_handler);
+
+    nrfx_err_t err_code = NRFX_SUCCESS;
+    if (m_clock_cb.module_initialized)
+    {
+        err_code = NRFX_ERROR_ALREADY_INITIALIZED;
+    }
+    else
+    {
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+        m_clock_cb.cal_state = CAL_STATE_IDLE;
+#endif
+        m_clock_cb.event_handler = event_handler;
+        m_clock_cb.module_initialized = true;
+#if defined(USE_WORKAROUND_FOR_ANOMALY_201)
+        m_clock_cb.hfclk_started = false;
+#endif
+    }
+
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+void nrfx_clock_enable(void)
+{
+    NRFX_ASSERT(m_clock_cb.module_initialized);
+    nrfx_power_clock_irq_init();
+    nrf_clock_lf_src_set((nrf_clock_lfclk_t)NRFX_CLOCK_CONFIG_LF_SRC);
+
+#if NRFX_CHECK(NRFX_POWER_ENABLED)
+    nrfx_clock_irq_enabled = true;
+#endif
+
+    NRFX_LOG_INFO("Module enabled.");
+}
+
+void nrfx_clock_disable(void)
+{
+    NRFX_ASSERT(m_clock_cb.module_initialized);
+#if NRFX_CHECK(NRFX_POWER_ENABLED)
+    NRFX_ASSERT(nrfx_clock_irq_enabled);
+    if (!nrfx_power_irq_enabled)
+#endif
+    {
+        NRFX_IRQ_DISABLE(nrfx_get_irq_number(NRF_CLOCK));
+    }
+    nrf_clock_int_disable(CLOCK_INTENSET_HFCLKSTARTED_Msk |
+                          CLOCK_INTENSET_LFCLKSTARTED_Msk |
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+                          CLOCK_INTENSET_DONE_Msk |
+                          CLOCK_INTENSET_CTTO_Msk |
+#endif
+                          0);
+#if NRFX_CHECK(NRFX_POWER_ENABLED)
+    nrfx_clock_irq_enabled = false;
+#endif
+    NRFX_LOG_INFO("Module disabled.");
+}
+
+void nrfx_clock_uninit(void)
+{
+    NRFX_ASSERT(m_clock_cb.module_initialized);
+    nrfx_clock_lfclk_stop();
+    nrfx_clock_hfclk_stop();
+    m_clock_cb.module_initialized = false;
+    NRFX_LOG_INFO("Uninitialized.");
+}
+
+void nrfx_clock_lfclk_start(void)
+{
+    NRFX_ASSERT(m_clock_cb.module_initialized);
+    nrf_clock_event_clear(NRF_CLOCK_EVENT_LFCLKSTARTED);
+    nrf_clock_int_enable(NRF_CLOCK_INT_LF_STARTED_MASK);
+
+#if defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+    nrfx_clock_anomaly_132();
+#endif
+
+    nrf_clock_task_trigger(NRF_CLOCK_TASK_LFCLKSTART);
+}
+
+void nrfx_clock_lfclk_stop(void)
+{
+    NRFX_ASSERT(m_clock_cb.module_initialized);
+    nrf_clock_task_trigger(NRF_CLOCK_TASK_LFCLKSTOP);
+    while (nrf_clock_lf_is_running())
+    {}
+}
+
+void nrfx_clock_hfclk_start(void)
+{
+    NRFX_ASSERT(m_clock_cb.module_initialized);
+    nrf_clock_event_clear(NRF_CLOCK_EVENT_HFCLKSTARTED);
+    nrf_clock_int_enable(NRF_CLOCK_INT_HF_STARTED_MASK);
+    nrf_clock_task_trigger(NRF_CLOCK_TASK_HFCLKSTART);
+}
+
+void nrfx_clock_hfclk_stop(void)
+{
+    NRFX_ASSERT(m_clock_cb.module_initialized);
+    nrf_clock_task_trigger(NRF_CLOCK_TASK_HFCLKSTOP);
+    while (nrf_clock_hf_is_running(NRF_CLOCK_HFCLK_HIGH_ACCURACY))
+    {}
+#if defined(USE_WORKAROUND_FOR_ANOMALY_201)
+    m_clock_cb.hfclk_started = false;
+#endif
+}
+
+nrfx_err_t nrfx_clock_calibration_start(void)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+    if (nrfx_clock_hfclk_is_running() == false)
+    {
+        return NRFX_ERROR_INVALID_STATE;
+    }
+
+    if (nrfx_clock_lfclk_is_running() == false)
+    {
+        return NRFX_ERROR_INVALID_STATE;
+    }
+
+    if (m_clock_cb.cal_state == CAL_STATE_IDLE)
+    {
+        nrf_clock_event_clear(NRF_CLOCK_EVENT_DONE);
+        nrf_clock_int_enable(NRF_CLOCK_INT_DONE_MASK);
+        m_clock_cb.cal_state = CAL_STATE_CAL;
+#if defined(USE_WORKAROUND_FOR_ANOMALY_192)
+        *(volatile uint32_t *)0x40000C34 = 0x00000002;
+#endif
+        nrf_clock_task_trigger(NRF_CLOCK_TASK_CAL);
+    }
+    else
+    {
+        err_code = NRFX_ERROR_BUSY;
+    }
+#endif // NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+
+    NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                     __func__,
+                     NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_clock_is_calibrating(void)
+{
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+    if (m_clock_cb.cal_state == CAL_STATE_CAL)
+    {
+        return NRFX_ERROR_BUSY;
+    }
+#endif
+    return NRFX_SUCCESS;
+}
+
+void nrfx_clock_calibration_timer_start(uint8_t interval)
+{
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+    nrf_clock_cal_timer_timeout_set(interval);
+    nrf_clock_event_clear(NRF_CLOCK_EVENT_CTTO);
+    nrf_clock_int_enable(NRF_CLOCK_INT_CTTO_MASK);
+    nrf_clock_task_trigger(NRF_CLOCK_TASK_CTSTART);
+#endif
+}
+
+void nrfx_clock_calibration_timer_stop(void)
+{
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+    nrf_clock_int_disable(NRF_CLOCK_INT_CTTO_MASK);
+    nrf_clock_task_trigger(NRF_CLOCK_TASK_CTSTOP);
+#endif
+}
+
+void nrfx_clock_irq_handler(void)
+{
+    if (nrf_clock_event_check(NRF_CLOCK_EVENT_HFCLKSTARTED))
+    {
+        nrf_clock_event_clear(NRF_CLOCK_EVENT_HFCLKSTARTED);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_CLOCK_EVENT_HFCLKSTARTED));
+        nrf_clock_int_disable(NRF_CLOCK_INT_HF_STARTED_MASK);
+
+#if defined(USE_WORKAROUND_FOR_ANOMALY_201)
+        if (!m_clock_cb.hfclk_started)
+        {
+            m_clock_cb.hfclk_started = true;
+            m_clock_cb.event_handler(NRFX_CLOCK_EVT_HFCLK_STARTED);
+        }
+#else
+        m_clock_cb.event_handler(NRFX_CLOCK_EVT_HFCLK_STARTED);
+#endif
+    }
+    if (nrf_clock_event_check(NRF_CLOCK_EVENT_LFCLKSTARTED))
+    {
+        nrf_clock_event_clear(NRF_CLOCK_EVENT_LFCLKSTARTED);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_CLOCK_EVENT_LFCLKSTARTED));
+        nrf_clock_int_disable(NRF_CLOCK_INT_LF_STARTED_MASK);
+
+        m_clock_cb.event_handler(NRFX_CLOCK_EVT_LFCLK_STARTED);
+    }
+
+#if NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+    if (nrf_clock_event_check(NRF_CLOCK_EVENT_CTTO))
+    {
+        nrf_clock_event_clear(NRF_CLOCK_EVENT_CTTO);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_CLOCK_EVENT_CTTO));
+        nrf_clock_int_disable(NRF_CLOCK_INT_CTTO_MASK);
+
+        m_clock_cb.event_handler(NRFX_CLOCK_EVT_CTTO);
+    }
+
+    if (nrf_clock_event_check(NRF_CLOCK_EVENT_DONE))
+    {
+#if defined(USE_WORKAROUND_FOR_ANOMALY_192)
+        *(volatile uint32_t *)0x40000C34 = 0x00000000;
+#endif
+        nrf_clock_event_clear(NRF_CLOCK_EVENT_DONE);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_CLOCK_EVENT_DONE));
+        nrf_clock_int_disable(NRF_CLOCK_INT_DONE_MASK);
+        m_clock_cb.cal_state = CAL_STATE_IDLE;
+        m_clock_cb.event_handler(NRFX_CLOCK_EVT_CAL_DONE);
+    }
+#endif //  NRFX_CHECK(NRFX_CLOCK_CONFIG_LF_CAL_ENABLED)
+}
+
+#endif // NRFX_CHECK(NRFX_CLOCK_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_comp.c

@@ -1,211 +1,202 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_COMP_ENABLED)
-
-#include <nrfx_comp.h>
-#include "prs/nrfx_prs.h"
-
-#define NRFX_LOG_MODULE COMP
-#include <nrfx_log.h>
-
-#define EVT_TO_STR(event)                                     \
-    (event == NRF_COMP_EVENT_READY ? "NRF_COMP_EVENT_READY" : \
-    (event == NRF_COMP_EVENT_DOWN  ? "NRF_COMP_EVENT_DOWN"  : \
-    (event == NRF_COMP_EVENT_UP    ? "NRF_COMP_EVENT_UP"    : \
-    (event == NRF_COMP_EVENT_CROSS ? "NRF_COMP_EVENT_CROSS" : \
-                                     "UNKNOWN ERROR"))))
-
-
-static nrfx_comp_event_handler_t    m_comp_event_handler = NULL;
-static nrfx_drv_state_t             m_state = NRFX_DRV_STATE_UNINITIALIZED;
-
-static void comp_execute_handler(nrf_comp_event_t event, uint32_t event_mask)
-{
-    if (nrf_comp_event_check(event) && nrf_comp_int_enable_check(event_mask))
-    {
-        nrf_comp_event_clear(event);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(event));
-
-        m_comp_event_handler(event);
-    }
-}
-
-void nrfx_comp_irq_handler(void)
-{
-    comp_execute_handler(NRF_COMP_EVENT_READY, COMP_INTENSET_READY_Msk);
-    comp_execute_handler(NRF_COMP_EVENT_DOWN,  COMP_INTENSET_DOWN_Msk);
-    comp_execute_handler(NRF_COMP_EVENT_UP,    COMP_INTENSET_UP_Msk);
-    comp_execute_handler(NRF_COMP_EVENT_CROSS, COMP_INTENSET_CROSS_Msk);
-}
-
-
-nrfx_err_t nrfx_comp_init(nrfx_comp_config_t const * p_config,
-                          nrfx_comp_event_handler_t  event_handler)
-{
-    NRFX_ASSERT(p_config);
-    NRFX_ASSERT(event_handler);
-    nrfx_err_t err_code;
-
-    if (m_state != NRFX_DRV_STATE_UNINITIALIZED)
-    { // COMP driver is already initialized
-        err_code = NRFX_ERROR_INVALID_STATE;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    m_comp_event_handler = event_handler;
-
-#if NRFX_CHECK(NRFX_PRS_ENABLED)
-    if (nrfx_prs_acquire(NRF_COMP, nrfx_comp_irq_handler) != NRFX_SUCCESS)
-    {
-        err_code = NRFX_ERROR_BUSY;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-#endif
-
-    nrf_comp_task_trigger(NRF_COMP_TASK_STOP);
-    nrf_comp_enable();
-
-    // Clear events to be sure there are no leftovers.
-    nrf_comp_event_clear(NRF_COMP_EVENT_READY);
-    nrf_comp_event_clear(NRF_COMP_EVENT_DOWN);
-    nrf_comp_event_clear(NRF_COMP_EVENT_UP);
-    nrf_comp_event_clear(NRF_COMP_EVENT_CROSS);
-
-    nrf_comp_ref_set(p_config->reference);
-
-    //If external source is chosen, write to appropriate register.
-    if (p_config->reference == COMP_REFSEL_REFSEL_ARef)
-    {
-        nrf_comp_ext_ref_set(p_config->ext_ref);
-    }
-
-    nrf_comp_th_set(p_config->threshold);
-    nrf_comp_main_mode_set(p_config->main_mode);
-    nrf_comp_speed_mode_set(p_config->speed_mode);
-    nrf_comp_hysteresis_set(p_config->hyst);
-#if defined (COMP_ISOURCE_ISOURCE_Msk)
-    nrf_comp_isource_set(p_config->isource);
-#endif
-    nrf_comp_shorts_disable(NRFX_COMP_SHORT_STOP_AFTER_CROSS_EVT |
-                            NRFX_COMP_SHORT_STOP_AFTER_UP_EVT |
-                            NRFX_COMP_SHORT_STOP_AFTER_DOWN_EVT);
-    nrf_comp_int_disable(COMP_INTENCLR_CROSS_Msk |
-                         COMP_INTENCLR_UP_Msk |
-                         COMP_INTENCLR_DOWN_Msk |
-                         COMP_INTENCLR_READY_Msk);
-
-    nrf_comp_input_select(p_config->input);
-
-    NRFX_IRQ_PRIORITY_SET(COMP_LPCOMP_IRQn, p_config->interrupt_priority);
-    NRFX_IRQ_ENABLE(COMP_LPCOMP_IRQn);
-
-    m_state = NRFX_DRV_STATE_INITIALIZED;
-
-    err_code = NRFX_SUCCESS;
-    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
-    return err_code;
-}
-
-void nrfx_comp_uninit(void)
-{
-    NRFX_ASSERT(m_state != NRFX_DRV_STATE_UNINITIALIZED);
-    NRFX_IRQ_DISABLE(COMP_LPCOMP_IRQn);
-    nrf_comp_disable();
-#if NRFX_CHECK(NRFX_PRS_ENABLED)
-    nrfx_prs_release(NRF_COMP);
-#endif
-    m_state = NRFX_DRV_STATE_UNINITIALIZED;
-    m_comp_event_handler = NULL;
-    NRFX_LOG_INFO("Uninitialized.");
-}
-
-void nrfx_comp_pin_select(nrf_comp_input_t psel)
-{
-    bool comp_enable_state = nrf_comp_enable_check();
-    nrf_comp_task_trigger(NRF_COMP_TASK_STOP);
-    if (m_state == NRFX_DRV_STATE_POWERED_ON)
-    {
-        m_state = NRFX_DRV_STATE_INITIALIZED;
-    }
-    nrf_comp_disable();
-    nrf_comp_input_select(psel);
-    if (comp_enable_state == true)
-    {
-        nrf_comp_enable();
-    }
-}
-
-void nrfx_comp_start(uint32_t comp_int_mask, uint32_t comp_shorts_mask)
-{
-    NRFX_ASSERT(m_state == NRFX_DRV_STATE_INITIALIZED);
-    nrf_comp_int_enable(comp_int_mask);
-    nrf_comp_shorts_enable(comp_shorts_mask);
-    nrf_comp_task_trigger(NRF_COMP_TASK_START);
-    m_state = NRFX_DRV_STATE_POWERED_ON;
-    NRFX_LOG_INFO("Enabled.");
-}
-
-void nrfx_comp_stop(void)
-{
-    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
-    nrf_comp_shorts_disable(UINT32_MAX);
-    nrf_comp_int_disable(UINT32_MAX);
-    nrf_comp_task_trigger(NRF_COMP_TASK_STOP);
-    m_state = NRFX_DRV_STATE_INITIALIZED;
-    NRFX_LOG_INFO("Disabled.");
-}
-
-uint32_t nrfx_comp_sample()
-{
-    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
-    nrf_comp_task_trigger(NRF_COMP_TASK_SAMPLE);
-    return nrf_comp_result_get();
-}
-
-#endif // NRFX_CHECK(NRFX_COMP_ENABLED)
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_COMP_ENABLED)
+
+#include <nrfx_comp.h>
+#include "prs/nrfx_prs.h"
+
+#define NRFX_LOG_MODULE COMP
+#include <nrfx_log.h>
+
+#define EVT_TO_STR(event)                                     \
+    (event == NRF_COMP_EVENT_READY ? "NRF_COMP_EVENT_READY" : \
+    (event == NRF_COMP_EVENT_DOWN  ? "NRF_COMP_EVENT_DOWN"  : \
+    (event == NRF_COMP_EVENT_UP    ? "NRF_COMP_EVENT_UP"    : \
+    (event == NRF_COMP_EVENT_CROSS ? "NRF_COMP_EVENT_CROSS" : \
+                                     "UNKNOWN ERROR"))))
+
+
+static nrfx_comp_event_handler_t    m_comp_event_handler = NULL;
+static nrfx_drv_state_t             m_state = NRFX_DRV_STATE_UNINITIALIZED;
+
+static void comp_execute_handler(nrf_comp_event_t event, uint32_t event_mask)
+{
+    if (nrf_comp_event_check(event) && nrf_comp_int_enable_check(event_mask))
+    {
+        nrf_comp_event_clear(event);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(event));
+
+        m_comp_event_handler(event);
+    }
+}
+
+void nrfx_comp_irq_handler(void)
+{
+    comp_execute_handler(NRF_COMP_EVENT_READY, COMP_INTENSET_READY_Msk);
+    comp_execute_handler(NRF_COMP_EVENT_DOWN,  COMP_INTENSET_DOWN_Msk);
+    comp_execute_handler(NRF_COMP_EVENT_UP,    COMP_INTENSET_UP_Msk);
+    comp_execute_handler(NRF_COMP_EVENT_CROSS, COMP_INTENSET_CROSS_Msk);
+}
+
+
+nrfx_err_t nrfx_comp_init(nrfx_comp_config_t const * p_config,
+                          nrfx_comp_event_handler_t  event_handler)
+{
+    NRFX_ASSERT(p_config);
+    NRFX_ASSERT(event_handler);
+    nrfx_err_t err_code;
+
+    if (m_state != NRFX_DRV_STATE_UNINITIALIZED)
+    { // COMP driver is already initialized
+        err_code = NRFX_ERROR_INVALID_STATE;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    m_comp_event_handler = event_handler;
+
+#if NRFX_CHECK(NRFX_PRS_ENABLED)
+    if (nrfx_prs_acquire(NRF_COMP, nrfx_comp_irq_handler) != NRFX_SUCCESS)
+    {
+        err_code = NRFX_ERROR_BUSY;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+#endif
+
+    nrf_comp_task_trigger(NRF_COMP_TASK_STOP);
+    nrf_comp_enable();
+
+    // Clear events to be sure there are no leftovers.
+    nrf_comp_event_clear(NRF_COMP_EVENT_READY);
+    nrf_comp_event_clear(NRF_COMP_EVENT_DOWN);
+    nrf_comp_event_clear(NRF_COMP_EVENT_UP);
+    nrf_comp_event_clear(NRF_COMP_EVENT_CROSS);
+
+    nrf_comp_ref_set(p_config->reference);
+
+    //If external source is chosen, write to appropriate register.
+    if (p_config->reference == COMP_REFSEL_REFSEL_ARef)
+    {
+        nrf_comp_ext_ref_set(p_config->ext_ref);
+    }
+
+    nrf_comp_th_set(p_config->threshold);
+    nrf_comp_main_mode_set(p_config->main_mode);
+    nrf_comp_speed_mode_set(p_config->speed_mode);
+    nrf_comp_hysteresis_set(p_config->hyst);
+#if defined (COMP_ISOURCE_ISOURCE_Msk)
+    nrf_comp_isource_set(p_config->isource);
+#endif
+    nrf_comp_shorts_disable(NRFX_COMP_SHORT_STOP_AFTER_CROSS_EVT |
+                            NRFX_COMP_SHORT_STOP_AFTER_UP_EVT |
+                            NRFX_COMP_SHORT_STOP_AFTER_DOWN_EVT);
+    nrf_comp_int_disable(COMP_INTENCLR_CROSS_Msk |
+                         COMP_INTENCLR_UP_Msk |
+                         COMP_INTENCLR_DOWN_Msk |
+                         COMP_INTENCLR_READY_Msk);
+
+    nrf_comp_input_select(p_config->input);
+
+    NRFX_IRQ_PRIORITY_SET(nrfx_get_irq_number(NRF_COMP), p_config->interrupt_priority);
+    NRFX_IRQ_ENABLE(nrfx_get_irq_number(NRF_COMP));
+
+    m_state = NRFX_DRV_STATE_INITIALIZED;
+
+    err_code = NRFX_SUCCESS;
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+void nrfx_comp_uninit(void)
+{
+    NRFX_ASSERT(m_state != NRFX_DRV_STATE_UNINITIALIZED);
+    NRFX_IRQ_DISABLE(nrfx_get_irq_number(NRF_COMP));
+    nrf_comp_disable();
+#if NRFX_CHECK(NRFX_PRS_ENABLED)
+    nrfx_prs_release(NRF_COMP);
+#endif
+    m_state = NRFX_DRV_STATE_UNINITIALIZED;
+    m_comp_event_handler = NULL;
+    NRFX_LOG_INFO("Uninitialized.");
+}
+
+void nrfx_comp_pin_select(nrf_comp_input_t psel)
+{
+    bool comp_enable_state = nrf_comp_enable_check();
+    nrf_comp_task_trigger(NRF_COMP_TASK_STOP);
+    if (m_state == NRFX_DRV_STATE_POWERED_ON)
+    {
+        m_state = NRFX_DRV_STATE_INITIALIZED;
+    }
+    nrf_comp_disable();
+    nrf_comp_input_select(psel);
+    if (comp_enable_state == true)
+    {
+        nrf_comp_enable();
+    }
+}
+
+void nrfx_comp_start(uint32_t comp_int_mask, uint32_t comp_shorts_mask)
+{
+    NRFX_ASSERT(m_state == NRFX_DRV_STATE_INITIALIZED);
+    nrf_comp_int_enable(comp_int_mask);
+    nrf_comp_shorts_enable(comp_shorts_mask);
+    nrf_comp_task_trigger(NRF_COMP_TASK_START);
+    m_state = NRFX_DRV_STATE_POWERED_ON;
+    NRFX_LOG_INFO("Enabled.");
+}
+
+void nrfx_comp_stop(void)
+{
+    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
+    nrf_comp_shorts_disable(UINT32_MAX);
+    nrf_comp_int_disable(UINT32_MAX);
+    nrf_comp_task_trigger(NRF_COMP_TASK_STOP);
+    m_state = NRFX_DRV_STATE_INITIALIZED;
+    NRFX_LOG_INFO("Disabled.");
+}
+
+uint32_t nrfx_comp_sample()
+{
+    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
+    nrf_comp_task_trigger(NRF_COMP_TASK_SAMPLE);
+    return nrf_comp_result_get();
+}
+
+#endif // NRFX_CHECK(NRFX_COMP_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_dppi.c

@@ -0,0 +1,310 @@
+/*
+ * Copyright (c) 2018 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_DPPI_ENABLED)
+
+#include <nrfx_dppi.h>
+
+#define NRFX_LOG_MODULE DPPI
+#include <nrfx_log.h>
+
+#if !defined(NRFX_DPPI_CHANNELS_USED)
+// Default mask of DPPI channels reserved for other modules.
+#define NRFX_DPPI_CHANNELS_USED 0x00000000uL
+#endif
+
+#if !defined(NRFX_DPPI_GROUPS_USED)
+// Default mask of DPPI groups reserved for other modules.
+#define NRFX_DPPI_GROUPS_USED 0x00000000uL
+#endif
+
+#define DPPI_AVAILABLE_CHANNELS_MASK \
+    (((1UL << DPPI_CH_NUM) - 1) & (~NRFX_DPPI_CHANNELS_USED))
+
+#define DPPI_AVAILABLE_GROUPS_MASK   \
+    (((1UL << DPPI_GROUP_NUM) - 1)   & (~NRFX_DPPI_GROUPS_USED))
+
+/** @brief Set bit at given position. */
+#define DPPI_BIT_SET(pos) (1uL << (pos))
+
+static uint32_t m_allocated_channels;
+
+static uint8_t  m_allocated_groups;
+
+__STATIC_INLINE bool channel_is_allocated(uint8_t channel)
+{
+    return ((m_allocated_channels & DPPI_BIT_SET(channel)) != 0);
+}
+
+__STATIC_INLINE bool group_is_allocated(nrf_dppi_channel_group_t group)
+{
+    return ((m_allocated_groups & DPPI_BIT_SET(group)) != 0);
+}
+
+void nrfx_dppi_free(void)
+{
+    uint32_t mask = m_allocated_groups;
+    nrf_dppi_channel_group_t group = NRF_DPPI_CHANNEL_GROUP0;
+
+    // Disable all channels
+    nrf_dppi_channels_disable(NRF_DPPIC, m_allocated_channels);
+
+    // Clear all groups configurations
+    while (mask)
+    {
+        if (mask & DPPI_BIT_SET(group))
+        {
+            nrf_dppi_group_clear(NRF_DPPIC, group);
+            mask &= ~DPPI_BIT_SET(group);
+        }
+        group++;
+    }
+
+    // Clear all allocated channels.
+    m_allocated_channels = 0;
+
+    // Clear all allocated groups.
+    m_allocated_groups = 0;
+}
+
+nrfx_err_t nrfx_dppi_channel_alloc(uint8_t * p_channel)
+{
+    nrfx_err_t err_code;
+
+    // Get mask of available DPPI channels
+    uint32_t remaining_channels = DPPI_AVAILABLE_CHANNELS_MASK & ~(m_allocated_channels);
+    uint8_t channel = 0;
+
+    if (!remaining_channels)
+    {
+        err_code = NRFX_ERROR_NO_MEM;
+        NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    // Find first free channel
+    while (!(remaining_channels & DPPI_BIT_SET(channel)))
+    {
+        channel++;
+    }
+
+    m_allocated_channels |= DPPI_BIT_SET(channel);
+    *p_channel = channel;
+
+    err_code = NRFX_SUCCESS;
+    NRFX_LOG_INFO("Allocated channel: %d.", channel);
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_channel_free(uint8_t channel)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (!channel_is_allocated(channel))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+    }
+    else
+    {
+        // First disable this channel
+        nrf_dppi_channels_disable(NRF_DPPIC, DPPI_BIT_SET(channel));
+        // Clear channel allocated indication.
+        m_allocated_channels &= ~DPPI_BIT_SET(channel);
+    }
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_channel_enable(uint8_t channel)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (!channel_is_allocated(channel))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+    }
+    else
+    {
+        nrf_dppi_channels_enable(NRF_DPPIC, DPPI_BIT_SET(channel));
+    }
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_channel_disable(uint8_t channel)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (!channel_is_allocated(channel))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+    }
+    else
+    {
+        nrf_dppi_channels_disable(NRF_DPPIC, DPPI_BIT_SET(channel));
+        err_code = NRFX_SUCCESS;
+    }
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_group_alloc(nrf_dppi_channel_group_t * p_group)
+{
+    nrfx_err_t err_code;
+
+    // Get mask of available DPPI groups
+    uint32_t remaining_groups = DPPI_AVAILABLE_GROUPS_MASK & ~(m_allocated_groups);
+    nrf_dppi_channel_group_t group = NRF_DPPI_CHANNEL_GROUP0;
+
+    if (!remaining_groups)
+    {
+        err_code = NRFX_ERROR_NO_MEM;
+        NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    // Find first free group
+    while (!(remaining_groups & DPPI_BIT_SET(group)))
+    {
+        group++;
+    }
+
+    m_allocated_groups |= DPPI_BIT_SET(group);
+    *p_group = group;
+
+    err_code = NRFX_SUCCESS;
+    NRFX_LOG_INFO("Allocated channel: %d.", group);
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_group_free(nrf_dppi_channel_group_t group)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (!group_is_allocated(group))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+    }
+    else
+    {
+        nrf_dppi_group_disable(NRF_DPPIC, group);
+        // Set bit value to zero at position corresponding to the group number.
+        m_allocated_groups &= ~DPPI_BIT_SET(group);
+    }
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_channel_include_in_group(uint8_t                  channel,
+                                              nrf_dppi_channel_group_t group)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (!group_is_allocated(group) || !channel_is_allocated(channel))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+    }
+    else
+    {
+        nrf_dppi_channels_include_in_group(NRF_DPPIC, DPPI_BIT_SET(channel), group);
+    }
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_channel_remove_from_group(uint8_t                  channel,
+                                               nrf_dppi_channel_group_t group)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (!group_is_allocated(group) || !channel_is_allocated(channel))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+    }
+    else
+    {
+        nrf_dppi_channels_remove_from_group(NRF_DPPIC, DPPI_BIT_SET(channel), group);
+    }
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_group_clear(nrf_dppi_channel_group_t group)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (!group_is_allocated(group))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+    }
+    else
+    {
+        nrf_dppi_channels_remove_from_group(NRF_DPPIC, DPPI_AVAILABLE_CHANNELS_MASK, group);
+    }
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_group_enable(nrf_dppi_channel_group_t group)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (!group_is_allocated(group))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+    }
+    else
+    {
+        nrf_dppi_group_enable(NRF_DPPIC, group);
+    }
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_dppi_group_disable(nrf_dppi_channel_group_t group)
+{
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (!group_is_allocated(group))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+    }
+    else
+    {
+        nrf_dppi_group_disable(NRF_DPPIC, group);
+    }
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+#endif // NRFX_CHECK(NRFX_DPPI_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_i2s.c

@@ -1,433 +1,436 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_I2S_ENABLED)
-
-#include <nrfx_i2s.h>
-#include <hal/nrf_gpio.h>
-
-#define NRFX_LOG_MODULE I2S
-#include <nrfx_log.h>
-
-#define EVT_TO_STR(event)                                         \
-    (event == NRF_I2S_EVENT_RXPTRUPD ? "NRF_I2S_EVENT_RXPTRUPD" : \
-    (event == NRF_I2S_EVENT_TXPTRUPD ? "NRF_I2S_EVENT_TXPTRUPD" : \
-    (event == NRF_I2S_EVENT_STOPPED  ? "NRF_I2S_EVENT_STOPPED"  : \
-                                       "UNKNOWN EVENT")))
-
-#if !defined(USE_WORKAROUND_FOR_ANOMALY_194) &&          \
-    (defined(NRF52832_XXAA) || defined(NRF52832_XXAB) || \
-     defined(NRF52840_XXAA))
-// Enable workaround for nRF52832 and nRF52840 anomaly 194 (STOP task does not
-// switch off all resources).
-#define USE_WORKAROUND_FOR_ANOMALY_194 1
-#endif
-
-// Control block - driver instance local data.
-typedef struct
-{
-    nrfx_i2s_data_handler_t handler;
-    nrfx_drv_state_t        state;
-
-    bool use_rx         : 1;
-    bool use_tx         : 1;
-    bool rx_ready       : 1;
-    bool tx_ready       : 1;
-    bool buffers_needed : 1;
-    bool buffers_reused : 1;
-
-    uint16_t            buffer_size;
-    nrfx_i2s_buffers_t  next_buffers;
-    nrfx_i2s_buffers_t  current_buffers;
-} i2s_control_block_t;
-static i2s_control_block_t m_cb;
-
-
-static void configure_pins(nrfx_i2s_config_t const * p_config)
-{
-    uint32_t mck_pin, sdout_pin, sdin_pin;
-
-    // Configure pins used by the peripheral:
-
-    // - SCK and LRCK (required) - depending on the mode of operation these
-    //   pins are configured as outputs (in Master mode) or inputs (in Slave
-    //   mode).
-    if (p_config->mode == NRF_I2S_MODE_MASTER)
-    {
-        nrf_gpio_cfg_output(p_config->sck_pin);
-        nrf_gpio_cfg_output(p_config->lrck_pin);
-    }
-    else
-    {
-        nrf_gpio_cfg_input(p_config->sck_pin,  NRF_GPIO_PIN_NOPULL);
-        nrf_gpio_cfg_input(p_config->lrck_pin, NRF_GPIO_PIN_NOPULL);
-    }
-
-    // - MCK (optional) - always output,
-    if (p_config->mck_pin != NRFX_I2S_PIN_NOT_USED)
-    {
-        mck_pin = p_config->mck_pin;
-        nrf_gpio_cfg_output(mck_pin);
-    }
-    else
-    {
-        mck_pin = NRF_I2S_PIN_NOT_CONNECTED;
-    }
-
-    // - SDOUT (optional) - always output,
-    if (p_config->sdout_pin != NRFX_I2S_PIN_NOT_USED)
-    {
-        sdout_pin = p_config->sdout_pin;
-        nrf_gpio_cfg_output(sdout_pin);
-    }
-    else
-    {
-        sdout_pin = NRF_I2S_PIN_NOT_CONNECTED;
-    }
-
-    // - SDIN (optional) - always input.
-    if (p_config->sdin_pin != NRFX_I2S_PIN_NOT_USED)
-    {
-        sdin_pin = p_config->sdin_pin;
-        nrf_gpio_cfg_input(sdin_pin, NRF_GPIO_PIN_NOPULL);
-    }
-    else
-    {
-        sdin_pin = NRF_I2S_PIN_NOT_CONNECTED;
-    }
-
-    nrf_i2s_pins_set(NRF_I2S,
-                     p_config->sck_pin,
-                     p_config->lrck_pin,
-                     mck_pin,
-                     sdout_pin,
-                     sdin_pin);
-}
-
-
-nrfx_err_t nrfx_i2s_init(nrfx_i2s_config_t const * p_config,
-                         nrfx_i2s_data_handler_t   handler)
-{
-    NRFX_ASSERT(p_config);
-    NRFX_ASSERT(handler);
-
-    nrfx_err_t err_code;
-
-    if (m_cb.state != NRFX_DRV_STATE_UNINITIALIZED)
-    {
-        err_code = NRFX_ERROR_INVALID_STATE;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    if (!nrf_i2s_configure(NRF_I2S,
-                           p_config->mode,
-                           p_config->format,
-                           p_config->alignment,
-                           p_config->sample_width,
-                           p_config->channels,
-                           p_config->mck_setup,
-                           p_config->ratio))
-    {
-        err_code = NRFX_ERROR_INVALID_PARAM;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-    configure_pins(p_config);
-
-    m_cb.handler = handler;
-
-    NRFX_IRQ_PRIORITY_SET(I2S_IRQn, p_config->irq_priority);
-    NRFX_IRQ_ENABLE(I2S_IRQn);
-
-    m_cb.state = NRFX_DRV_STATE_INITIALIZED;
-
-    NRFX_LOG_INFO("Initialized.");
-    return NRFX_SUCCESS;
-}
-
-
-void nrfx_i2s_uninit(void)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-
-    nrfx_i2s_stop();
-
-    NRFX_IRQ_DISABLE(I2S_IRQn);
-
-    nrf_i2s_pins_set(NRF_I2S,
-                     NRF_I2S_PIN_NOT_CONNECTED,
-                     NRF_I2S_PIN_NOT_CONNECTED,
-                     NRF_I2S_PIN_NOT_CONNECTED,
-                     NRF_I2S_PIN_NOT_CONNECTED,
-                     NRF_I2S_PIN_NOT_CONNECTED);
-
-    m_cb.state = NRFX_DRV_STATE_UNINITIALIZED;
-    NRFX_LOG_INFO("Uninitialized.");
-}
-
-
-nrfx_err_t nrfx_i2s_start(nrfx_i2s_buffers_t const * p_initial_buffers,
-                          uint16_t                   buffer_size,
-                          uint8_t                    flags)
-{
-    NRFX_ASSERT(p_initial_buffers != NULL);
-    NRFX_ASSERT(p_initial_buffers->p_rx_buffer != NULL ||
-                p_initial_buffers->p_tx_buffer != NULL);
-    NRFX_ASSERT(buffer_size != 0);
-    (void)(flags);
-
-    nrfx_err_t err_code;
-
-    if (m_cb.state != NRFX_DRV_STATE_INITIALIZED)
-    {
-        err_code = NRFX_ERROR_INVALID_STATE;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    if (((p_initial_buffers->p_rx_buffer != NULL)
-         && !nrfx_is_in_ram(p_initial_buffers->p_rx_buffer))
-        ||
-        ((p_initial_buffers->p_tx_buffer != NULL)
-         && !nrfx_is_in_ram(p_initial_buffers->p_tx_buffer)))
-    {
-        err_code = NRFX_ERROR_INVALID_ADDR;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    m_cb.use_rx         = (p_initial_buffers->p_rx_buffer != NULL);
-    m_cb.use_tx         = (p_initial_buffers->p_tx_buffer != NULL);
-    m_cb.rx_ready       = false;
-    m_cb.tx_ready       = false;
-    m_cb.buffers_needed = false;
-    m_cb.buffer_size    = buffer_size;
-
-    // Set the provided initial buffers as next, they will become the current
-    // ones after the IRQ handler is called for the first time, what will occur
-    // right after the START task is triggered.
-    m_cb.next_buffers = *p_initial_buffers;
-    m_cb.current_buffers.p_rx_buffer = NULL;
-    m_cb.current_buffers.p_tx_buffer = NULL;
-
-    nrf_i2s_transfer_set(NRF_I2S,
-                         m_cb.buffer_size,
-                         m_cb.next_buffers.p_rx_buffer,
-                         m_cb.next_buffers.p_tx_buffer);
-
-    nrf_i2s_enable(NRF_I2S);
-
-    m_cb.state = NRFX_DRV_STATE_POWERED_ON;
-
-    nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_RXPTRUPD);
-    nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_TXPTRUPD);
-    nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_STOPPED);
-    nrf_i2s_int_enable(NRF_I2S, (m_cb.use_rx ? NRF_I2S_INT_RXPTRUPD_MASK : 0) |
-                                (m_cb.use_tx ? NRF_I2S_INT_TXPTRUPD_MASK : 0) |
-                                NRF_I2S_INT_STOPPED_MASK);
-    nrf_i2s_task_trigger(NRF_I2S, NRF_I2S_TASK_START);
-
-    NRFX_LOG_INFO("Started.");
-    return NRFX_SUCCESS;
-}
-
-
-nrfx_err_t nrfx_i2s_next_buffers_set(nrfx_i2s_buffers_t const * p_buffers)
-{
-    NRFX_ASSERT(m_cb.state == NRFX_DRV_STATE_POWERED_ON);
-    NRFX_ASSERT(p_buffers);
-
-    nrfx_err_t err_code;
-
-    if (!m_cb.buffers_needed)
-    {
-        err_code = NRFX_ERROR_INVALID_STATE;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    if (((p_buffers->p_rx_buffer != NULL)
-         && !nrfx_is_in_ram(p_buffers->p_rx_buffer))
-        ||
-        ((p_buffers->p_tx_buffer != NULL)
-         && !nrfx_is_in_ram(p_buffers->p_tx_buffer)))
-    {
-        err_code = NRFX_ERROR_INVALID_ADDR;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    if (m_cb.use_tx)
-    {
-        NRFX_ASSERT(p_buffers->p_tx_buffer != NULL);
-        nrf_i2s_tx_buffer_set(NRF_I2S, p_buffers->p_tx_buffer);
-    }
-    if (m_cb.use_rx)
-    {
-        NRFX_ASSERT(p_buffers->p_rx_buffer != NULL);
-        nrf_i2s_rx_buffer_set(NRF_I2S, p_buffers->p_rx_buffer);
-    }
-
-    m_cb.next_buffers   = *p_buffers;
-    m_cb.buffers_needed = false;
-
-    return NRFX_SUCCESS;
-}
-
-
-void nrfx_i2s_stop(void)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-
-    m_cb.buffers_needed = false;
-
-    // First disable interrupts, then trigger the STOP task, so no spurious
-    // RXPTRUPD and TXPTRUPD events (see nRF52 anomaly 55) are processed.
-    nrf_i2s_int_disable(NRF_I2S, NRF_I2S_INT_RXPTRUPD_MASK |
-                                 NRF_I2S_INT_TXPTRUPD_MASK);
-    nrf_i2s_task_trigger(NRF_I2S, NRF_I2S_TASK_STOP);
-
-#if USE_WORKAROUND_FOR_ANOMALY_194
-    *((volatile uint32_t *)0x40025038) = 1;
-    *((volatile uint32_t *)0x4002503C) = 1;
-#endif
-}
-
-
-void nrfx_i2s_irq_handler(void)
-{
-    if (nrf_i2s_event_check(NRF_I2S, NRF_I2S_EVENT_TXPTRUPD))
-    {
-        nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_TXPTRUPD);
-        m_cb.tx_ready = true;
-        if (m_cb.use_tx && m_cb.buffers_needed)
-        {
-            m_cb.buffers_reused = true;
-        }
-    }
-    if (nrf_i2s_event_check(NRF_I2S, NRF_I2S_EVENT_RXPTRUPD))
-    {
-        nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_RXPTRUPD);
-        m_cb.rx_ready = true;
-        if (m_cb.use_rx && m_cb.buffers_needed)
-        {
-            m_cb.buffers_reused = true;
-        }
-    }
-
-    if (nrf_i2s_event_check(NRF_I2S, NRF_I2S_EVENT_STOPPED))
-    {
-        nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_STOPPED);
-        nrf_i2s_int_disable(NRF_I2S, NRF_I2S_INT_STOPPED_MASK);
-        nrf_i2s_disable(NRF_I2S);
-
-        // When stopped, release all buffers, including these scheduled for
-        // the next transfer.
-        m_cb.handler(&m_cb.current_buffers, 0);
-        m_cb.handler(&m_cb.next_buffers, 0);
-
-        m_cb.state = NRFX_DRV_STATE_INITIALIZED;
-        NRFX_LOG_INFO("Stopped.");
-    }
-    else
-    {
-        // Check if the requested transfer has been completed:
-        // - full-duplex mode
-        if ((m_cb.use_tx && m_cb.use_rx && m_cb.tx_ready && m_cb.rx_ready) ||
-            // - TX only mode
-            (!m_cb.use_rx && m_cb.tx_ready) ||
-            // - RX only mode
-            (!m_cb.use_tx && m_cb.rx_ready))
-        {
-            m_cb.tx_ready = false;
-            m_cb.rx_ready = false;
-
-            // If the application did not supply the buffers for the next
-            // part of the transfer until this moment, the current buffers
-            // cannot be released, since the I2S peripheral already started
-            // using them. Signal this situation to the application by
-            // passing NULL instead of the structure with released buffers.
-            if (m_cb.buffers_reused)
-            {
-                m_cb.buffers_reused = false;
-                // This will most likely be set at this point. However, there is
-                // a small time window between TXPTRUPD and RXPTRUPD events,
-                // and it is theoretically possible that next buffers will be
-                // set in this window, so to be sure this flag is set to true,
-                // set it explicitly.
-                m_cb.buffers_needed = true;
-                m_cb.handler(NULL,
-                             NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED);
-            }
-            else
-            {
-                // Buffers that have been used by the I2S peripheral (current)
-                // are now released and will be returned to the application,
-                // and the ones scheduled to be used as next become the current
-                // ones.
-                nrfx_i2s_buffers_t released_buffers = m_cb.current_buffers;
-                m_cb.current_buffers = m_cb.next_buffers;
-                m_cb.next_buffers.p_rx_buffer = NULL;
-                m_cb.next_buffers.p_tx_buffer = NULL;
-                m_cb.buffers_needed = true;
-                m_cb.handler(&released_buffers,
-                             NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED);
-            }
-
-        }
-    }
-}
-
-#endif // NRFX_CHECK(NRFX_I2S_ENABLED)
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_I2S_ENABLED)
+
+#include <nrfx_i2s.h>
+#include <hal/nrf_gpio.h>
+
+#define NRFX_LOG_MODULE I2S
+#include <nrfx_log.h>
+
+#define EVT_TO_STR(event)                                         \
+    (event == NRF_I2S_EVENT_RXPTRUPD ? "NRF_I2S_EVENT_RXPTRUPD" : \
+    (event == NRF_I2S_EVENT_TXPTRUPD ? "NRF_I2S_EVENT_TXPTRUPD" : \
+    (event == NRF_I2S_EVENT_STOPPED  ? "NRF_I2S_EVENT_STOPPED"  : \
+                                       "UNKNOWN EVENT")))
+
+#if !defined(USE_WORKAROUND_FOR_I2S_STOP_ANOMALY) &&                               \
+    (defined(NRF52832_XXAA) || defined(NRF52832_XXAB) || defined(NRF52840_XXAA) || \
+     defined(NRF9160_XXAA))
+// Enable workaround for nRF52832 and nRF52840 anomaly 194 / nrf9160 anomaly 1
+// (STOP task does not switch off all resources).
+#define USE_WORKAROUND_FOR_I2S_STOP_ANOMALY 1
+#endif
+
+// Control block - driver instance local data.
+typedef struct
+{
+    nrfx_i2s_data_handler_t handler;
+    nrfx_drv_state_t        state;
+
+    bool use_rx         : 1;
+    bool use_tx         : 1;
+    bool rx_ready       : 1;
+    bool tx_ready       : 1;
+    bool buffers_needed : 1;
+    bool buffers_reused : 1;
+
+    uint16_t            buffer_size;
+    nrfx_i2s_buffers_t  next_buffers;
+    nrfx_i2s_buffers_t  current_buffers;
+} i2s_control_block_t;
+static i2s_control_block_t m_cb;
+
+
+static void configure_pins(nrfx_i2s_config_t const * p_config)
+{
+    uint32_t mck_pin, sdout_pin, sdin_pin;
+
+    // Configure pins used by the peripheral:
+
+    // - SCK and LRCK (required) - depending on the mode of operation these
+    //   pins are configured as outputs (in Master mode) or inputs (in Slave
+    //   mode).
+    if (p_config->mode == NRF_I2S_MODE_MASTER)
+    {
+        nrf_gpio_cfg_output(p_config->sck_pin);
+        nrf_gpio_cfg_output(p_config->lrck_pin);
+    }
+    else
+    {
+        nrf_gpio_cfg_input(p_config->sck_pin,  NRF_GPIO_PIN_NOPULL);
+        nrf_gpio_cfg_input(p_config->lrck_pin, NRF_GPIO_PIN_NOPULL);
+    }
+
+    // - MCK (optional) - always output,
+    if (p_config->mck_pin != NRFX_I2S_PIN_NOT_USED)
+    {
+        mck_pin = p_config->mck_pin;
+        nrf_gpio_cfg_output(mck_pin);
+    }
+    else
+    {
+        mck_pin = NRF_I2S_PIN_NOT_CONNECTED;
+    }
+
+    // - SDOUT (optional) - always output,
+    if (p_config->sdout_pin != NRFX_I2S_PIN_NOT_USED)
+    {
+        sdout_pin = p_config->sdout_pin;
+        nrf_gpio_cfg_output(sdout_pin);
+    }
+    else
+    {
+        sdout_pin = NRF_I2S_PIN_NOT_CONNECTED;
+    }
+
+    // - SDIN (optional) - always input.
+    if (p_config->sdin_pin != NRFX_I2S_PIN_NOT_USED)
+    {
+        sdin_pin = p_config->sdin_pin;
+        nrf_gpio_cfg_input(sdin_pin, NRF_GPIO_PIN_NOPULL);
+    }
+    else
+    {
+        sdin_pin = NRF_I2S_PIN_NOT_CONNECTED;
+    }
+
+    nrf_i2s_pins_set(NRF_I2S,
+                     p_config->sck_pin,
+                     p_config->lrck_pin,
+                     mck_pin,
+                     sdout_pin,
+                     sdin_pin);
+}
+
+
+nrfx_err_t nrfx_i2s_init(nrfx_i2s_config_t const * p_config,
+                         nrfx_i2s_data_handler_t   handler)
+{
+    NRFX_ASSERT(p_config);
+    NRFX_ASSERT(handler);
+
+    nrfx_err_t err_code;
+
+    if (m_cb.state != NRFX_DRV_STATE_UNINITIALIZED)
+    {
+        err_code = NRFX_ERROR_INVALID_STATE;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    if (!nrf_i2s_configure(NRF_I2S,
+                           p_config->mode,
+                           p_config->format,
+                           p_config->alignment,
+                           p_config->sample_width,
+                           p_config->channels,
+                           p_config->mck_setup,
+                           p_config->ratio))
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+    configure_pins(p_config);
+
+    m_cb.handler = handler;
+
+    NRFX_IRQ_PRIORITY_SET(I2S_IRQn, p_config->irq_priority);
+    NRFX_IRQ_ENABLE(I2S_IRQn);
+
+    m_cb.state = NRFX_DRV_STATE_INITIALIZED;
+
+    NRFX_LOG_INFO("Initialized.");
+    return NRFX_SUCCESS;
+}
+
+
+void nrfx_i2s_uninit(void)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+
+    nrfx_i2s_stop();
+
+    NRFX_IRQ_DISABLE(I2S_IRQn);
+
+    nrf_i2s_pins_set(NRF_I2S,
+                     NRF_I2S_PIN_NOT_CONNECTED,
+                     NRF_I2S_PIN_NOT_CONNECTED,
+                     NRF_I2S_PIN_NOT_CONNECTED,
+                     NRF_I2S_PIN_NOT_CONNECTED,
+                     NRF_I2S_PIN_NOT_CONNECTED);
+
+    m_cb.state = NRFX_DRV_STATE_UNINITIALIZED;
+    NRFX_LOG_INFO("Uninitialized.");
+}
+
+
+nrfx_err_t nrfx_i2s_start(nrfx_i2s_buffers_t const * p_initial_buffers,
+                          uint16_t                   buffer_size,
+                          uint8_t                    flags)
+{
+    NRFX_ASSERT(p_initial_buffers != NULL);
+    NRFX_ASSERT(p_initial_buffers->p_rx_buffer != NULL ||
+                p_initial_buffers->p_tx_buffer != NULL);
+    NRFX_ASSERT((p_initial_buffers->p_rx_buffer == NULL) ||
+                (nrfx_is_in_ram(p_initial_buffers->p_rx_buffer) &&
+                 nrfx_is_word_aligned(p_initial_buffers->p_rx_buffer)));
+    NRFX_ASSERT((p_initial_buffers->p_tx_buffer == NULL) ||
+                (nrfx_is_in_ram(p_initial_buffers->p_tx_buffer) &&
+                 nrfx_is_word_aligned(p_initial_buffers->p_tx_buffer)));
+    NRFX_ASSERT(buffer_size != 0);
+    (void)(flags);
+
+    nrfx_err_t err_code;
+
+    if (m_cb.state != NRFX_DRV_STATE_INITIALIZED)
+    {
+        err_code = NRFX_ERROR_INVALID_STATE;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    if (((p_initial_buffers->p_rx_buffer != NULL)
+         && !nrfx_is_in_ram(p_initial_buffers->p_rx_buffer))
+        ||
+        ((p_initial_buffers->p_tx_buffer != NULL)
+         && !nrfx_is_in_ram(p_initial_buffers->p_tx_buffer)))
+    {
+        err_code = NRFX_ERROR_INVALID_ADDR;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    m_cb.use_rx         = (p_initial_buffers->p_rx_buffer != NULL);
+    m_cb.use_tx         = (p_initial_buffers->p_tx_buffer != NULL);
+    m_cb.rx_ready       = false;
+    m_cb.tx_ready       = false;
+    m_cb.buffers_needed = false;
+    m_cb.buffer_size    = buffer_size;
+
+    // Set the provided initial buffers as next, they will become the current
+    // ones after the IRQ handler is called for the first time, what will occur
+    // right after the START task is triggered.
+    m_cb.next_buffers = *p_initial_buffers;
+    m_cb.current_buffers.p_rx_buffer = NULL;
+    m_cb.current_buffers.p_tx_buffer = NULL;
+
+    nrf_i2s_transfer_set(NRF_I2S,
+                         m_cb.buffer_size,
+                         m_cb.next_buffers.p_rx_buffer,
+                         m_cb.next_buffers.p_tx_buffer);
+
+    nrf_i2s_enable(NRF_I2S);
+
+    m_cb.state = NRFX_DRV_STATE_POWERED_ON;
+
+    nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_RXPTRUPD);
+    nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_TXPTRUPD);
+    nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_STOPPED);
+    nrf_i2s_int_enable(NRF_I2S, (m_cb.use_rx ? NRF_I2S_INT_RXPTRUPD_MASK : 0) |
+                                (m_cb.use_tx ? NRF_I2S_INT_TXPTRUPD_MASK : 0) |
+                                NRF_I2S_INT_STOPPED_MASK);
+    nrf_i2s_task_trigger(NRF_I2S, NRF_I2S_TASK_START);
+
+    NRFX_LOG_INFO("Started.");
+    return NRFX_SUCCESS;
+}
+
+
+nrfx_err_t nrfx_i2s_next_buffers_set(nrfx_i2s_buffers_t const * p_buffers)
+{
+    NRFX_ASSERT(m_cb.state == NRFX_DRV_STATE_POWERED_ON);
+    NRFX_ASSERT(p_buffers);
+    NRFX_ASSERT((p_buffers->p_rx_buffer == NULL) ||
+                (nrfx_is_in_ram(p_buffers->p_rx_buffer) &&
+                 nrfx_is_word_aligned(p_buffers->p_rx_buffer)));
+    NRFX_ASSERT((p_buffers->p_tx_buffer == NULL) ||
+                (nrfx_is_in_ram(p_buffers->p_tx_buffer) &&
+                 nrfx_is_word_aligned(p_buffers->p_tx_buffer)));
+
+    nrfx_err_t err_code;
+
+    if (!m_cb.buffers_needed)
+    {
+        err_code = NRFX_ERROR_INVALID_STATE;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    if (((p_buffers->p_rx_buffer != NULL)
+         && !nrfx_is_in_ram(p_buffers->p_rx_buffer))
+        ||
+        ((p_buffers->p_tx_buffer != NULL)
+         && !nrfx_is_in_ram(p_buffers->p_tx_buffer)))
+    {
+        err_code = NRFX_ERROR_INVALID_ADDR;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    if (m_cb.use_tx)
+    {
+        NRFX_ASSERT(p_buffers->p_tx_buffer != NULL);
+        nrf_i2s_tx_buffer_set(NRF_I2S, p_buffers->p_tx_buffer);
+    }
+    if (m_cb.use_rx)
+    {
+        NRFX_ASSERT(p_buffers->p_rx_buffer != NULL);
+        nrf_i2s_rx_buffer_set(NRF_I2S, p_buffers->p_rx_buffer);
+    }
+
+    m_cb.next_buffers   = *p_buffers;
+    m_cb.buffers_needed = false;
+
+    return NRFX_SUCCESS;
+}
+
+
+void nrfx_i2s_stop(void)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+
+    m_cb.buffers_needed = false;
+
+    // First disable interrupts, then trigger the STOP task, so no spurious
+    // RXPTRUPD and TXPTRUPD events (see nRF52 anomaly 55) are processed.
+    nrf_i2s_int_disable(NRF_I2S, NRF_I2S_INT_RXPTRUPD_MASK |
+                                 NRF_I2S_INT_TXPTRUPD_MASK);
+    nrf_i2s_task_trigger(NRF_I2S, NRF_I2S_TASK_STOP);
+
+#if NRFX_CHECK(USE_WORKAROUND_FOR_I2S_STOP_ANOMALY)
+    *((volatile uint32_t *)(((uint32_t)NRF_I2S) + 0x38)) = 1;
+    *((volatile uint32_t *)(((uint32_t)NRF_I2S) + 0x3C)) = 1;
+#endif
+}
+
+
+void nrfx_i2s_irq_handler(void)
+{
+    if (nrf_i2s_event_check(NRF_I2S, NRF_I2S_EVENT_TXPTRUPD))
+    {
+        nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_TXPTRUPD);
+        m_cb.tx_ready = true;
+        if (m_cb.use_tx && m_cb.buffers_needed)
+        {
+            m_cb.buffers_reused = true;
+        }
+    }
+    if (nrf_i2s_event_check(NRF_I2S, NRF_I2S_EVENT_RXPTRUPD))
+    {
+        nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_RXPTRUPD);
+        m_cb.rx_ready = true;
+        if (m_cb.use_rx && m_cb.buffers_needed)
+        {
+            m_cb.buffers_reused = true;
+        }
+    }
+
+    if (nrf_i2s_event_check(NRF_I2S, NRF_I2S_EVENT_STOPPED))
+    {
+        nrf_i2s_event_clear(NRF_I2S, NRF_I2S_EVENT_STOPPED);
+        nrf_i2s_int_disable(NRF_I2S, NRF_I2S_INT_STOPPED_MASK);
+        nrf_i2s_disable(NRF_I2S);
+
+        // When stopped, release all buffers, including these scheduled for
+        // the next transfer.
+        m_cb.handler(&m_cb.current_buffers, 0);
+        m_cb.handler(&m_cb.next_buffers, 0);
+
+        m_cb.state = NRFX_DRV_STATE_INITIALIZED;
+        NRFX_LOG_INFO("Stopped.");
+    }
+    else
+    {
+        // Check if the requested transfer has been completed:
+        // - full-duplex mode
+        if ((m_cb.use_tx && m_cb.use_rx && m_cb.tx_ready && m_cb.rx_ready) ||
+            // - TX only mode
+            (!m_cb.use_rx && m_cb.tx_ready) ||
+            // - RX only mode
+            (!m_cb.use_tx && m_cb.rx_ready))
+        {
+            m_cb.tx_ready = false;
+            m_cb.rx_ready = false;
+
+            // If the application did not supply the buffers for the next
+            // part of the transfer until this moment, the current buffers
+            // cannot be released, since the I2S peripheral already started
+            // using them. Signal this situation to the application by
+            // passing NULL instead of the structure with released buffers.
+            if (m_cb.buffers_reused)
+            {
+                m_cb.buffers_reused = false;
+                // This will most likely be set at this point. However, there is
+                // a small time window between TXPTRUPD and RXPTRUPD events,
+                // and it is theoretically possible that next buffers will be
+                // set in this window, so to be sure this flag is set to true,
+                // set it explicitly.
+                m_cb.buffers_needed = true;
+                m_cb.handler(NULL,
+                             NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED);
+            }
+            else
+            {
+                // Buffers that have been used by the I2S peripheral (current)
+                // are now released and will be returned to the application,
+                // and the ones scheduled to be used as next become the current
+                // ones.
+                nrfx_i2s_buffers_t released_buffers = m_cb.current_buffers;
+                m_cb.current_buffers = m_cb.next_buffers;
+                m_cb.next_buffers.p_rx_buffer = NULL;
+                m_cb.next_buffers.p_tx_buffer = NULL;
+                m_cb.buffers_needed = true;
+                m_cb.handler(&released_buffers,
+                             NRFX_I2S_STATUS_NEXT_BUFFERS_NEEDED);
+            }
+
+        }
+    }
+}
+
+#endif // NRFX_CHECK(NRFX_I2S_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_lpcomp.c

@@ -1,174 +1,165 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_LPCOMP_ENABLED)
-
-#include <nrfx_lpcomp.h>
-#include "prs/nrfx_prs.h"
-
-#define NRFX_LOG_MODULE LPCOMP
-#include <nrfx_log.h>
-
-#define EVT_TO_STR(event)                                         \
-    (event == NRF_LPCOMP_EVENT_READY ? "NRF_LPCOMP_EVENT_READY" : \
-    (event == NRF_LPCOMP_EVENT_DOWN  ? "NRF_LPCOMP_EVENT_DOWN"  : \
-    (event == NRF_LPCOMP_EVENT_UP    ? "NRF_LPCOMP_EVENT_UP"    : \
-    (event == NRF_LPCOMP_EVENT_CROSS ? "NRF_LPCOMP_EVENT_CROSS" : \
-                                       "UNKNOWN EVENT"))))
-
-
-static nrfx_lpcomp_event_handler_t  m_lpcomp_event_handler = NULL;
-static nrfx_drv_state_t             m_state = NRFX_DRV_STATE_UNINITIALIZED;
-
-static void lpcomp_execute_handler(nrf_lpcomp_event_t event, uint32_t event_mask)
-{
-    if (nrf_lpcomp_event_check(event) && nrf_lpcomp_int_enable_check(event_mask))
-    {
-        nrf_lpcomp_event_clear(event);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(event));
-
-        m_lpcomp_event_handler(event);
-    }
-}
-
-void nrfx_lpcomp_irq_handler(void)
-{
-    lpcomp_execute_handler(NRF_LPCOMP_EVENT_READY, LPCOMP_INTENSET_READY_Msk);
-    lpcomp_execute_handler(NRF_LPCOMP_EVENT_DOWN,  LPCOMP_INTENSET_DOWN_Msk);
-    lpcomp_execute_handler(NRF_LPCOMP_EVENT_UP,    LPCOMP_INTENSET_UP_Msk);
-    lpcomp_execute_handler(NRF_LPCOMP_EVENT_CROSS, LPCOMP_INTENSET_CROSS_Msk);
-}
-
-nrfx_err_t nrfx_lpcomp_init(nrfx_lpcomp_config_t const * p_config,
-                            nrfx_lpcomp_event_handler_t  event_handler)
-{
-    NRFX_ASSERT(p_config);
-    NRFX_ASSERT(event_handler);
-    nrfx_err_t err_code;
-
-    if (m_state != NRFX_DRV_STATE_UNINITIALIZED)
-    { // LPCOMP driver is already initialized
-        err_code = NRFX_ERROR_INVALID_STATE;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    m_lpcomp_event_handler = event_handler;
-
-#if NRFX_CHECK(NRFX_PRS_ENABLED)
-    if (nrfx_prs_acquire(NRF_LPCOMP, nrfx_lpcomp_irq_handler) != NRFX_SUCCESS)
-    {
-        err_code = NRFX_ERROR_BUSY;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-#endif
-
-    nrf_lpcomp_configure(&(p_config->hal));
-
-    nrf_lpcomp_input_select(p_config->input);
-
-    switch (p_config->hal.detection)
-    {
-        case NRF_LPCOMP_DETECT_UP:
-            nrf_lpcomp_int_enable(LPCOMP_INTENSET_UP_Msk);
-            break;
-
-        case NRF_LPCOMP_DETECT_DOWN:
-            nrf_lpcomp_int_enable(LPCOMP_INTENSET_DOWN_Msk);
-            break;
-
-        case NRF_LPCOMP_DETECT_CROSS:
-            nrf_lpcomp_int_enable(LPCOMP_INTENSET_CROSS_Msk);
-            break;
-
-        default:
-            break;
-    }
-    nrf_lpcomp_shorts_enable(NRF_LPCOMP_SHORT_READY_SAMPLE_MASK);
-
-    NRFX_IRQ_PRIORITY_SET(LPCOMP_IRQn, p_config->interrupt_priority);
-    NRFX_IRQ_ENABLE(LPCOMP_IRQn);
-
-    m_state = NRFX_DRV_STATE_INITIALIZED;
-
-    err_code = NRFX_SUCCESS;
-    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
-    return err_code;
-}
-
-void nrfx_lpcomp_uninit(void)
-{
-    NRFX_ASSERT(m_state != NRFX_DRV_STATE_UNINITIALIZED);
-    NRFX_IRQ_DISABLE(LPCOMP_IRQn);
-    nrfx_lpcomp_disable();
-#if NRFX_CHECK(NRFX_PRS_ENABLED)
-    nrfx_prs_release(NRF_LPCOMP);
-#endif
-    m_state = NRFX_DRV_STATE_UNINITIALIZED;
-    m_lpcomp_event_handler = NULL;
-    NRFX_LOG_INFO("Uninitialized.");
-}
-
-void nrfx_lpcomp_enable(void)
-{
-    NRFX_ASSERT(m_state == NRFX_DRV_STATE_INITIALIZED);
-    nrf_lpcomp_enable();
-    nrf_lpcomp_task_trigger(NRF_LPCOMP_TASK_START);
-    m_state = NRFX_DRV_STATE_POWERED_ON;
-    NRFX_LOG_INFO("Enabled.");
-}
-
-void nrfx_lpcomp_disable(void)
-{
-    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
-    nrf_lpcomp_disable();
-    nrf_lpcomp_task_trigger(NRF_LPCOMP_TASK_STOP);
-    m_state = NRFX_DRV_STATE_INITIALIZED;
-    NRFX_LOG_INFO("Disabled.");
-}
-
-#endif // NRFX_CHECK(NRFX_LPCOMP_ENABLED)
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_LPCOMP_ENABLED)
+
+#include <nrfx_lpcomp.h>
+#include "prs/nrfx_prs.h"
+
+#define NRFX_LOG_MODULE LPCOMP
+#include <nrfx_log.h>
+
+#define EVT_TO_STR(event)                                         \
+    (event == NRF_LPCOMP_EVENT_READY ? "NRF_LPCOMP_EVENT_READY" : \
+    (event == NRF_LPCOMP_EVENT_DOWN  ? "NRF_LPCOMP_EVENT_DOWN"  : \
+    (event == NRF_LPCOMP_EVENT_UP    ? "NRF_LPCOMP_EVENT_UP"    : \
+    (event == NRF_LPCOMP_EVENT_CROSS ? "NRF_LPCOMP_EVENT_CROSS" : \
+                                       "UNKNOWN EVENT"))))
+
+
+static nrfx_lpcomp_event_handler_t  m_lpcomp_event_handler = NULL;
+static nrfx_drv_state_t             m_state = NRFX_DRV_STATE_UNINITIALIZED;
+
+static void lpcomp_execute_handler(nrf_lpcomp_event_t event, uint32_t event_mask)
+{
+    if (nrf_lpcomp_event_check(event) && nrf_lpcomp_int_enable_check(event_mask))
+    {
+        nrf_lpcomp_event_clear(event);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(event));
+
+        m_lpcomp_event_handler(event);
+    }
+}
+
+void nrfx_lpcomp_irq_handler(void)
+{
+    lpcomp_execute_handler(NRF_LPCOMP_EVENT_READY, LPCOMP_INTENSET_READY_Msk);
+    lpcomp_execute_handler(NRF_LPCOMP_EVENT_DOWN,  LPCOMP_INTENSET_DOWN_Msk);
+    lpcomp_execute_handler(NRF_LPCOMP_EVENT_UP,    LPCOMP_INTENSET_UP_Msk);
+    lpcomp_execute_handler(NRF_LPCOMP_EVENT_CROSS, LPCOMP_INTENSET_CROSS_Msk);
+}
+
+nrfx_err_t nrfx_lpcomp_init(nrfx_lpcomp_config_t const * p_config,
+                            nrfx_lpcomp_event_handler_t  event_handler)
+{
+    NRFX_ASSERT(p_config);
+    NRFX_ASSERT(event_handler);
+    nrfx_err_t err_code;
+
+    if (m_state != NRFX_DRV_STATE_UNINITIALIZED)
+    { // LPCOMP driver is already initialized
+        err_code = NRFX_ERROR_INVALID_STATE;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    m_lpcomp_event_handler = event_handler;
+
+#if NRFX_CHECK(NRFX_PRS_ENABLED)
+    if (nrfx_prs_acquire(NRF_LPCOMP, nrfx_lpcomp_irq_handler) != NRFX_SUCCESS)
+    {
+        err_code = NRFX_ERROR_BUSY;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+#endif
+
+    nrf_lpcomp_configure(&(p_config->hal));
+
+    nrf_lpcomp_input_select(p_config->input);
+
+    switch (p_config->hal.detection)
+    {
+        case NRF_LPCOMP_DETECT_UP:
+            nrf_lpcomp_int_enable(LPCOMP_INTENSET_UP_Msk);
+            break;
+
+        case NRF_LPCOMP_DETECT_DOWN:
+            nrf_lpcomp_int_enable(LPCOMP_INTENSET_DOWN_Msk);
+            break;
+
+        case NRF_LPCOMP_DETECT_CROSS:
+            nrf_lpcomp_int_enable(LPCOMP_INTENSET_CROSS_Msk);
+            break;
+
+        default:
+            break;
+    }
+    nrf_lpcomp_shorts_enable(NRF_LPCOMP_SHORT_READY_SAMPLE_MASK);
+
+    NRFX_IRQ_PRIORITY_SET(LPCOMP_IRQn, p_config->interrupt_priority);
+    NRFX_IRQ_ENABLE(LPCOMP_IRQn);
+
+    m_state = NRFX_DRV_STATE_INITIALIZED;
+
+    err_code = NRFX_SUCCESS;
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+void nrfx_lpcomp_uninit(void)
+{
+    NRFX_ASSERT(m_state != NRFX_DRV_STATE_UNINITIALIZED);
+    NRFX_IRQ_DISABLE(LPCOMP_IRQn);
+    nrfx_lpcomp_disable();
+#if NRFX_CHECK(NRFX_PRS_ENABLED)
+    nrfx_prs_release(NRF_LPCOMP);
+#endif
+    m_state = NRFX_DRV_STATE_UNINITIALIZED;
+    m_lpcomp_event_handler = NULL;
+    NRFX_LOG_INFO("Uninitialized.");
+}
+
+void nrfx_lpcomp_enable(void)
+{
+    NRFX_ASSERT(m_state == NRFX_DRV_STATE_INITIALIZED);
+    nrf_lpcomp_enable();
+    nrf_lpcomp_task_trigger(NRF_LPCOMP_TASK_START);
+    m_state = NRFX_DRV_STATE_POWERED_ON;
+    NRFX_LOG_INFO("Enabled.");
+}
+
+void nrfx_lpcomp_disable(void)
+{
+    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
+    nrf_lpcomp_disable();
+    nrf_lpcomp_task_trigger(NRF_LPCOMP_TASK_STOP);
+    m_state = NRFX_DRV_STATE_INITIALIZED;
+    NRFX_LOG_INFO("Disabled.");
+}
+
+#endif // NRFX_CHECK(NRFX_LPCOMP_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_nfct.c

@@ -0,0 +1,893 @@
+/*
+ * Copyright (c) 2018 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_NFCT_ENABLED)
+
+#include <nrfx_nfct.h>
+
+#define NRFX_LOG_MODULE NFCT
+#include <nrfx_log.h>
+
+#if defined(NRF52832_XXAA) || defined(NRF52832_XXAB) || defined(NRF52840_XXAA)
+#define USE_TIMER_WORKAROUND
+#endif
+
+#ifdef USE_TIMER_WORKAROUND
+#include <nrfx_timer.h>
+
+typedef struct
+{
+    const nrfx_timer_t timer;                     /**< Timer instance that supports the correct NFC field detection. */
+#ifdef NRF52840_XXAA
+    bool               fieldevents_filter_active; /**< Flag that indicates that the field events are ignored. */
+    bool               is_hfclk_on;               /**< HFCLK has started - one of the NFC activation conditions. */
+    bool               is_delayed;                /**< Required time delay has passed - one of the NFC activation conditions. */
+#else
+    uint32_t           field_state_cnt;           /**< Counter of the FIELDLOST events. */
+#endif // NRF52840_XXAA
+} nrfx_nfct_timer_workaround_t;
+
+#ifdef NRF52840_XXAA
+    #define NRFX_NFCT_ACTIVATE_DELAY     1000 /**< Minimal delay in us between NFC field detection and activation of NFCT. */
+    #define NRFX_NFCT_TIMER_PERIOD       NRFX_NFCT_ACTIVATE_DELAY
+#else
+    #define NRFX_NFCT_FIELDLOST_THR      7
+    #define NRFX_NFCT_FIELD_TIMER_PERIOD 100  /**< Field polling period in us. */
+    #define NRFX_NFCT_TIMER_PERIOD       NRFX_NFCT_FIELD_TIMER_PERIOD
+#endif // NRF52840_XXAA
+#define NRFX_NFCT_TIMER_INSTANCE         4    /**< Timer instance used for various workarounds for the NFCT HW issues.*/
+
+static nrfx_nfct_timer_workaround_t m_timer_workaround = 
+{
+    .timer = NRFX_TIMER_INSTANCE(NRFX_NFCT_TIMER_INSTANCE),
+};
+#endif // USE_TIMER_WORKAROUND
+
+#define NRFX_NFCT_FRAMEDELAYMAX_52840S (0xFFFFUL) /**< Bit mask of the FRAMEDELAYMAX field for the first sample of 52840.*/
+#define NRFX_NFCT_FWT_MAX_DIFF         1u         /**< The maximal difference between the requested FWT and HW-limited FWT settings.*/
+
+/* Mask of all possible interrupts that are relevant for data reception. */
+#define NRFX_NFCT_RX_INT_MASK (NRF_NFCT_INT_RXFRAMESTART_MASK | \
+                               NRF_NFCT_INT_RXFRAMEEND_MASK   | \
+                               NRF_NFCT_INT_RXERROR_MASK)
+
+/* Mask of all possible interrupts that are relevant for data transmission. */
+#define NRFX_NFCT_TX_INT_MASK (NRF_NFCT_INT_TXFRAMESTART_MASK | \
+                               NRF_NFCT_INT_TXFRAMEEND_MASK)
+
+
+/* Mask of all possible errors from the @ref NRF_NFCT_EVENT_RXERROR event. */
+#define NRFX_NFCT_FRAME_STATUS_RX_ALL_MASK (NRF_NFCT_RX_FRAME_STATUS_CRC_MASK    | \
+                                            NRF_NFCT_RX_FRAME_STATUS_PARITY_MASK | \
+                                            NRF_NFCT_RX_FRAME_STATUS_OVERRUN_MASK)
+
+/* Mask of all possible errors from the @ref NRF_NFCT_EVENT_ERROR event. */
+#if defined (NRF52832_XXAA) || defined(NRF52832_XXAB)
+#define NRFX_NFCT_ERROR_STATUS_ALL_MASK (NRF_NFCT_ERROR_FRAMEDELAYTIMEOUT_MASK | \
+                                         NRF_NFCT_ERROR_NFCFIELDTOOSTRONG_MASK | \
+                                         NRF_NFCT_ERROR_NFCFIELDTOOWEAK_MASK)
+#else
+#define NRFX_NFCT_ERROR_STATUS_ALL_MASK (NRF_NFCT_ERROR_FRAMEDELAYTIMEOUT_MASK)
+#endif
+
+/* Macros for conversion of bits to bytes. */
+#define NRFX_NFCT_BYTES_TO_BITS(_bytes) ((_bytes) << 3)
+#define NRFX_NFCT_BITS_TO_BYTES(_bits)  ((_bits)  >> 3)
+
+/* Macro for checking whether the NFCT interrupt is active. */
+#define NRFX_NFCT_EVT_ACTIVE(_name) (nrf_nfct_event_check(NRFX_CONCAT_2(NRF_NFCT_EVENT_, _name)) &&        \
+                                     nrf_nfct_int_enable_check(NRFX_CONCAT_3(NRF_NFCT_INT_, _name, _MASK)))
+
+/* Macro for callback execution. */
+#define NRFX_NFCT_CB_HANDLE(_cb, _evt) \
+    if (_cb != NULL)                   \
+    {                                  \
+        _cb(&_evt);                    \
+    }
+
+typedef enum
+{
+    NRFX_NFC_FIELD_STATE_NONE,   /**< Initial value that indicates no NFCT field events. */
+    NRFX_NFC_FIELD_STATE_OFF,    /**< The NFCT FIELDLOST event has been set. */
+    NRFX_NFC_FIELD_STATE_ON,     /**< The NFCT FIELDDETECTED event has been set. */
+    NRFX_NFC_FIELD_STATE_UNKNOWN /**< Both NFCT field events have been set - ambiguous state. */
+} nrfx_nfct_field_state_t;
+
+#ifdef NRF52840_XXAA
+/**
+ * @brief Internal auxiliary function for checking whether the program is running on the NRF52840 chip.
+ *
+ * @retval true  It is NRF52480 chip.
+ * @retval false It is an other chip.
+ */
+static inline bool nrfx_nfct_type_52840_check(void)
+{
+    return ((((*(uint32_t *)0xF0000FE0) & 0xFF) == 0x08) &&
+        (((*(uint32_t *)0xF0000FE4) & 0x0F) == 0x0));
+}
+
+/**
+ * @brief Internal auxiliary function for checking whether the program is running on the first sample of
+ *        the nRF52840 chip.
+ *
+ * @retval true  It is the nRF52480 chip and it is the first sample version.
+ * @retval false It is an other chip.
+ */
+static inline bool nrfx_nfct_type_52840_sample_check(void)
+{
+    return ( nrfx_nfct_type_52840_check() &&
+               ( ((*(uint32_t *)0xF0000FE8) & 0xF0) == 0x00 ) &&
+               ( ((*(uint32_t *)0xF0000FEC) & 0xF0) == 0x00 ) );
+}
+
+/**
+ * @brief Internal auxiliary function for checking whether the program is running on the final version of
+ *        the nRF52840 chip.
+ *
+ * @retval true  It is the nRF52480 chip and it is the final version.
+ * @retval false It is an other chip.
+ */
+static inline bool nrfx_nfct_type_52840_final_check(void)
+{
+    return ( nrfx_nfct_type_52840_check() &&
+              ( ( ((*(uint32_t *)0xF0000FE8) & 0xF0) != 0x00 ) ||
+                ( ((*(uint32_t *)0xF0000FEC) & 0xF0) != 0x00 ) ));
+}
+
+typedef struct
+{
+    bool eng_a;  /**< Engineering sample A of the NRF52840 chip. */
+    bool eng_bc; /**< Engineering sample B, C of the NRF52840 chip, or its final version. */
+} nrfx_nfct_nrf52840_ver_t;
+
+static nrfx_nfct_nrf52840_ver_t m_nrf52840;
+#endif // NRF52840_XXAA
+
+/**@brief NFCT control block. */
+typedef struct
+{
+    nrfx_nfct_config_t config;
+    nrfx_drv_state_t   state;
+    volatile bool      field_on;
+} nrfx_nfct_control_block_t;
+
+static nrfx_nfct_control_block_t m_nfct_cb;
+
+/**
+ * @brief Common part of the setup used for the NFCT initialization and reinitialization.
+ */
+static void nrfx_nfct_hw_init_setup(void)
+{
+#ifdef NRF52840_XXAA
+    if (m_nrf52840.eng_a)
+    {
+        /* Begin: Bugfix for FTPAN-98 */
+        *(volatile uint32_t *) 0x4000568C = 0x00038148;
+        /* End: Bugfix for FTPAN-98 */
+        /* Begin: Bugfix for FTPAN-144 */
+        *(volatile uint32_t *) 0x4000561c = 0x01;
+        *(volatile uint32_t *) 0x4000562c = 0x3F;
+        *(volatile uint32_t *) 0x4000563c = 0x0;
+        /* End: Bugfix for FTPAN-144 */
+    }
+#endif // NRF52840_XXAA
+
+    // Use Window Grid frame delay mode.
+    nrf_nfct_frame_delay_mode_set(NRF_NFCT_FRAME_DELAY_MODE_WINDOWGRID);
+
+    /* Begin: Bugfix for FTPAN-25 (IC-9929) */
+    /* Workaround for wrong SENSRES values require using SDD00001, but here SDD00100 is used
+       because it is required to operate with Windows Phone */
+    nrf_nfct_sensres_bit_frame_sdd_set(NRF_NFCT_SENSRES_BIT_FRAME_SDD_00100);
+    /* End: Bugfix for FTPAN-25 (IC-9929) */
+}
+
+/**@brief Function for evaluating and handling the NFC field events.
+ *
+ * @param[in]  field_state  Current field state.
+ */
+static void nrfx_nfct_field_event_handler(volatile nrfx_nfct_field_state_t field_state)
+{
+    nrfx_nfct_evt_t nfct_evt;
+
+#ifdef NRF52840_XXAA
+    if((!m_nrf52840.eng_a) && (m_timer_workaround.fieldevents_filter_active))
+    {
+        return;
+    }
+#endif // NRF52840_XXAA
+
+    if (field_state == NRFX_NFC_FIELD_STATE_UNKNOWN)
+    {
+        /* Probe NFC field */
+        field_state = (nrfx_nfct_field_check()) ? NRFX_NFC_FIELD_STATE_ON : NRFX_NFC_FIELD_STATE_OFF;
+    }
+
+    /* Field event service */
+    switch (field_state)
+    {
+        case NRFX_NFC_FIELD_STATE_ON:
+            if (!m_nfct_cb.field_on)
+            {
+#ifdef NRF52840_XXAA
+                /* Begin: Bugfix for FTPAN-190 */
+                if (!m_nrf52840.eng_a)
+                {
+                    m_timer_workaround.is_hfclk_on               = false;
+                    m_timer_workaround.is_delayed                = false;
+                    m_timer_workaround.fieldevents_filter_active = true;
+
+                    nrfx_timer_clear(&m_timer_workaround.timer);
+                    nrfx_timer_enable(&m_timer_workaround.timer);
+                }
+                /* END: Bugfix for FTPAN-190 */
+#elif defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+                nrfx_timer_clear(&m_timer_workaround.timer);
+                nrfx_timer_enable(&m_timer_workaround.timer);
+                m_timer_workaround.field_state_cnt = 0;  
+#endif // NRF52840_XXAA
+
+                m_nfct_cb.field_on = true;
+                nfct_evt.evt_id    = NRFX_NFCT_EVT_FIELD_DETECTED;
+                NRFX_NFCT_CB_HANDLE(m_nfct_cb.config.cb, nfct_evt);
+            }
+            break;
+
+        case NRFX_NFC_FIELD_STATE_OFF:
+            nrfx_nfct_state_force(NRFX_NFCT_STATE_SENSING);
+#ifdef NRF52840_XXAA
+            /* Begin: Bugfix for FTPAN-116 (IC-12886) */
+            if (m_nrf52840.eng_a)
+            {
+                *(volatile uint32_t *)0x40005010 = 1;
+            }
+            /* END: Bugfix for FTPAN-116 (IC-12886) */
+#endif // NRF52840_XXAA
+            nrf_nfct_int_disable(NRFX_NFCT_RX_INT_MASK | NRFX_NFCT_TX_INT_MASK);
+            m_nfct_cb.field_on = false;
+            nfct_evt.evt_id    = NRFX_NFCT_EVT_FIELD_LOST;
+
+            NRFX_NFCT_CB_HANDLE(m_nfct_cb.config.cb, nfct_evt);
+            break;
+
+        default:
+            /* No implementation required */
+            break;
+    }
+}
+
+#ifdef USE_TIMER_WORKAROUND
+
+#ifdef NRF52840_XXAA
+static void nrfx_nfct_activate_check(void)
+{
+    static bool is_field_validation_pending = false;
+
+    if (is_field_validation_pending)
+    {
+        is_field_validation_pending                  = false;
+        m_timer_workaround.fieldevents_filter_active = false;
+
+        // Check the field status and take action if field is lost.
+        nrfx_nfct_field_event_handler(NRFX_NFC_FIELD_STATE_UNKNOWN);
+        return;
+    }
+
+    if ((m_timer_workaround.is_hfclk_on) && (m_timer_workaround.is_delayed))
+    {
+        nrf_nfct_task_trigger(NRF_NFCT_TASK_ACTIVATE);
+        is_field_validation_pending = true;
+
+        // Start the timer second time to validate whether the tag has locked to the field.
+        nrfx_timer_clear(&m_timer_workaround.timer);
+        nrfx_timer_enable(&m_timer_workaround.timer);
+    }
+}
+#endif // NRF52840_XXAA
+
+#if defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+static inline void nrfx_nfct_reset(void)
+{
+    uint32_t                       fdm;
+    uint32_t                       int_enabled;
+    uint8_t                        nfcid1[NRF_NFCT_SENSRES_NFCID1_SIZE_TRIPLE];
+    nrf_nfct_sensres_nfcid1_size_t nfcid1_size;
+    nrf_nfct_selres_protocol_t     protocol;
+
+    // Save parameter settings before the reset of the NFCT peripheral.
+    fdm         = nrf_nfct_frame_delay_max_get();
+    nfcid1_size = nrf_nfct_nfcid1_get(nfcid1);
+    protocol    = nrf_nfct_selsres_protocol_get();
+    int_enabled = nrf_nfct_int_enable_get();
+
+    // Reset the NFCT peripheral.
+    *(volatile uint32_t *)0x40005FFC = 0;
+    *(volatile uint32_t *)0x40005FFC;
+    *(volatile uint32_t *)0x40005FFC = 1;
+
+    // Restore parameter settings after the reset of the NFCT peripheral.
+    nrf_nfct_frame_delay_max_set(fdm);
+    nrf_nfct_nfcid1_set(nfcid1, nfcid1_size);
+    nrf_nfct_selres_protocol_set(protocol);
+
+    // Restore general HW configuration.
+    nrfx_nfct_hw_init_setup();
+
+    // Restore interrupts.
+    nrf_nfct_int_enable(int_enabled);
+
+    NRFX_LOG_INFO("Reinitialize");
+}
+
+static void nrfx_nfct_field_poll(void)
+{
+    if (!nrfx_nfct_field_check())
+    {
+        if (++m_timer_workaround.field_state_cnt > NRFX_NFCT_FIELDLOST_THR)
+        {
+            nrfx_nfct_evt_t nfct_evt =
+            {
+                .evt_id = NRFX_NFCT_EVT_FIELD_LOST,
+            };
+
+            nrfx_timer_disable(&m_timer_workaround.timer);
+            m_nfct_cb.field_on = false;
+
+            /* Begin: Bugfix for FTPAN-116 */
+            // resume the NFCT to initialized state
+            nrfx_nfct_reset();
+            /* End: Bugfix for FTPAN-116 */
+
+            NRFX_NFCT_CB_HANDLE(m_nfct_cb.config.cb, nfct_evt);
+        }
+        return;
+    }
+
+    m_timer_workaround.field_state_cnt = 0;
+}
+#endif // defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+
+static void nrfx_nfct_field_timer_handler(nrf_timer_event_t event_type, void * p_context)
+{
+    (void)p_context;
+
+    if (event_type != NRF_TIMER_EVENT_COMPARE0)
+    {
+        return;
+    }
+
+#ifdef NRF52840_XXAA
+    m_timer_workaround.is_delayed = true;
+
+    nrfx_timer_disable(&m_timer_workaround.timer);
+    nrfx_nfct_activate_check();
+#else
+    nrfx_nfct_field_poll();
+#endif //NRF52840_XXAA
+}
+
+static inline nrfx_err_t nrfx_nfct_field_timer_config(void)
+{
+    nrfx_err_t          err_code;
+    nrfx_timer_config_t timer_cfg = 
+    {
+        .frequency          = NRF_TIMER_FREQ_1MHz,
+        .mode               = NRF_TIMER_MODE_TIMER,
+        .bit_width          = NRF_TIMER_BIT_WIDTH_16,
+        .interrupt_priority = NRFX_NFCT_CONFIG_IRQ_PRIORITY
+    };
+
+    err_code = nrfx_timer_init(&m_timer_workaround.timer, &timer_cfg, nrfx_nfct_field_timer_handler);
+    if (err_code != NRFX_SUCCESS)
+    {
+        return err_code;
+    }
+
+    nrfx_timer_extended_compare(&m_timer_workaround.timer,
+                                NRF_TIMER_CC_CHANNEL0,
+                                nrfx_timer_us_to_ticks(&m_timer_workaround.timer, NRFX_NFCT_TIMER_PERIOD),
+                                NRF_TIMER_SHORT_COMPARE0_CLEAR_MASK,
+                                true);
+    return err_code;
+}
+
+#endif // USE_TIMER_WORKAROUND
+
+static inline nrf_nfct_sensres_nfcid1_size_t nrf_nfct_nfcid1_size_to_sensres_size(uint8_t nfcid1_size)
+{
+    switch (nfcid1_size)
+    {
+        case NRFX_NFCT_NFCID1_SINGLE_SIZE:
+            return NRF_NFCT_SENSRES_NFCID1_SIZE_SINGLE;
+
+        case NRFX_NFCT_NFCID1_DOUBLE_SIZE:
+            return NRF_NFCT_SENSRES_NFCID1_SIZE_DOUBLE;
+
+        case NRFX_NFCT_NFCID1_TRIPLE_SIZE:
+            return NRF_NFCT_SENSRES_NFCID1_SIZE_TRIPLE;
+
+        default:
+            return NRF_NFCT_SENSRES_NFCID1_SIZE_DOUBLE;
+    }
+}
+
+static inline void nrfx_nfct_rxtx_int_enable(uint32_t rxtx_int_mask)
+{
+    nrf_nfct_int_enable(rxtx_int_mask & m_nfct_cb.config.rxtx_int_mask);
+}
+
+nrfx_err_t nrfx_nfct_init(nrfx_nfct_config_t const * p_config)
+{
+    NRFX_ASSERT(p_config);
+
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    if (m_nfct_cb.state != NRFX_DRV_STATE_UNINITIALIZED)
+    {
+        return NRFX_ERROR_INVALID_STATE;
+    }
+
+#ifdef NRF52840_XXAA
+    m_nrf52840.eng_a  = nrfx_nfct_type_52840_sample_check();
+    m_nrf52840.eng_bc = nrfx_nfct_type_52840_final_check();
+#endif // NRF52840_XXAA
+
+    m_nfct_cb.config = *p_config;
+    nrfx_nfct_hw_init_setup();
+
+    NRFX_IRQ_PENDING_CLEAR(NFCT_IRQn);
+    NRFX_IRQ_PRIORITY_SET(NFCT_IRQn, NRFX_NFCT_CONFIG_IRQ_PRIORITY);
+    NRFX_IRQ_ENABLE(NFCT_IRQn);
+
+#ifdef USE_TIMER_WORKAROUND
+    /* Initialize Timer module as the workaround for NFCT HW issues. */
+    #ifdef NRF52840_XXAA
+    if (!m_nrf52840.eng_a)
+    #endif // NRF52840_XXAA
+    {
+        err_code = nrfx_nfct_field_timer_config();
+    }
+#endif // USE_TIMER_WORKAROUND
+
+    if (err_code == NRFX_SUCCESS)
+    {
+        uint8_t default_nfcid1[NRFX_NFCT_NFCID1_DEFAULT_LEN];
+        err_code = nrfx_nfct_nfcid1_default_bytes_get(default_nfcid1, sizeof(default_nfcid1));
+        NRFX_ASSERT(err_code == NRFX_SUCCESS);
+        nrf_nfct_nfcid1_set(default_nfcid1, NRF_NFCT_SENSRES_NFCID1_SIZE_DEFAULT);
+    }
+    else
+    {
+        return err_code;
+    }
+
+    m_nfct_cb.state = NRFX_DRV_STATE_INITIALIZED;
+
+    NRFX_LOG_INFO("Initialized");
+    return err_code;
+}
+
+void nrfx_nfct_uninit(void)
+{
+    nrfx_nfct_disable();
+
+    NRFX_IRQ_DISABLE(NFCT_IRQn);
+    NRFX_IRQ_PENDING_CLEAR(NFCT_IRQn);
+
+#ifdef USE_TIMER_WORKAROUND
+    /* Initialize Timer module as the workaround for NFCT HW issues. */
+    #ifdef NRF52840_XXAA
+    if (!m_nrf52840.eng_a)
+    #endif // NRF52840_XXAA
+    {
+        nrfx_timer_uninit(&m_timer_workaround.timer);
+    }
+#endif // USE_TIMER_WORKAROUND
+
+    m_nfct_cb.state = NRFX_DRV_STATE_UNINITIALIZED;
+}
+
+void nrfx_nfct_enable(void)
+{
+    nrf_nfct_error_status_clear(NRFX_NFCT_ERROR_STATUS_ALL_MASK);
+    nrf_nfct_task_trigger(NRF_NFCT_TASK_SENSE);
+
+    nrf_nfct_int_enable(NRF_NFCT_INT_FIELDDETECTED_MASK | NRF_NFCT_INT_ERROR_MASK |
+                        NRF_NFCT_INT_SELECTED_MASK);
+#if !defined(NRF52832_XXAA) && !defined(NRF52832_XXAB)
+    nrf_nfct_int_enable(NRF_NFCT_INT_FIELDLOST_MASK);
+#endif //!defined(NRF52832_XXAA) && !defined(NRF52832_XXAB)
+
+    NRFX_LOG_INFO("Start");
+}
+
+void nrfx_nfct_disable(void)
+{
+    nrf_nfct_int_disable(NRF_NFCT_DISABLE_ALL_INT);
+    nrf_nfct_task_trigger(NRF_NFCT_TASK_DISABLE);
+
+    NRFX_LOG_INFO("Stop");
+}
+
+bool nrfx_nfct_field_check(void)
+{
+    uint32_t const field_state = nrf_nfct_field_status_get();
+
+    if (((field_state & NRF_NFCT_FIELD_STATE_PRESENT_MASK) == 0) &&
+        ((field_state & NRF_NFCT_FIELD_STATE_LOCK_MASK) == 0))
+    {
+        // Field is not active
+        return false;
+    }
+
+    return true;
+}
+
+void nrfx_nfct_rx(nrfx_nfct_data_desc_t const * p_tx_data)
+{
+    NRFX_ASSERT(p_tx_data);
+
+    nrf_nfct_rxtx_buffer_set((uint8_t *) p_tx_data->p_data, p_tx_data->data_size);
+
+    nrfx_nfct_rxtx_int_enable(NRFX_NFCT_RX_INT_MASK);
+    nrf_nfct_task_trigger(NRF_NFCT_TASK_ENABLERXDATA);
+}
+
+nrfx_err_t nrfx_nfct_tx(nrfx_nfct_data_desc_t const * p_tx_data,
+                        nrf_nfct_frame_delay_mode_t   delay_mode)
+{
+    NRFX_ASSERT(p_tx_data);
+    NRFX_ASSERT(p_tx_data->p_data);
+
+    if (p_tx_data->data_size == 0)
+    {
+        return NRFX_ERROR_INVALID_LENGTH;
+    }
+
+    nrf_nfct_rxtx_buffer_set((uint8_t *) p_tx_data->p_data, p_tx_data->data_size);
+    nrf_nfct_tx_bits_set(NRFX_NFCT_BYTES_TO_BITS(p_tx_data->data_size));
+    nrf_nfct_frame_delay_mode_set((nrf_nfct_frame_delay_mode_t) delay_mode);
+
+    nrfx_nfct_rxtx_int_enable(NRFX_NFCT_TX_INT_MASK);
+    nrf_nfct_task_trigger(NRF_NFCT_TASK_STARTTX);
+
+    NRFX_LOG_INFO("Tx start");
+    return NRFX_SUCCESS;
+}
+
+void nrfx_nfct_state_force(nrfx_nfct_state_t state)
+{
+#ifdef NRF52840_XXAA
+    if ((m_nrf52840.eng_bc) && (state == NRFX_NFCT_STATE_ACTIVATED))
+    {
+        m_timer_workaround.is_hfclk_on = true;
+        nrfx_nfct_activate_check();
+    }
+#endif
+    {
+        nrf_nfct_task_trigger((nrf_nfct_task_t) state);
+    }
+}
+
+void nrfx_nfct_init_substate_force(nrfx_nfct_active_state_t sub_state)
+{
+    if (sub_state == NRFX_NFCT_ACTIVE_STATE_DEFAULT)
+    {
+#if defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+        if (((*(uint32_t volatile *)(0x40005420)) & 0x1UL) == (1UL))
+#else
+        if (nrf_nfct_sleep_state_get() == NRF_NFCT_SLEEP_STATE_SLEEP_A)
+#endif //defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+        {
+            // Default state is SLEEP_A
+            nrf_nfct_task_trigger(NRF_NFCT_TASK_GOSLEEP);
+        }
+        else
+        {
+            // Default state is IDLE
+            nrf_nfct_task_trigger(NRF_NFCT_TASK_GOIDLE);
+        }
+    }
+    else
+    {
+        nrf_nfct_task_trigger((nrf_nfct_task_t) sub_state);
+    }
+
+    /* Disable TX/RX here (will be enabled at SELECTED) */
+    nrf_nfct_int_disable(NRFX_NFCT_RX_INT_MASK | NRFX_NFCT_TX_INT_MASK);
+}
+
+nrfx_err_t nrfx_nfct_parameter_set(nrfx_nfct_param_t const * p_param)
+{
+    NRFX_ASSERT(p_param);
+
+    switch (p_param->id)
+    {
+        case NRFX_NFCT_PARAM_ID_FDT:
+        {
+            uint32_t delay     = p_param->data.fdt;
+            uint32_t delay_thr = NFCT_FRAMEDELAYMAX_FRAMEDELAYMAX_Msk;
+
+#ifdef NRF52840_XXAA
+            delay_thr = (m_nrf52840.eng_a) ? NRFX_NFCT_FRAMEDELAYMAX_52840S : delay_thr;
+#endif // NRF52840_XXAA
+
+            // Delay validation.
+            if (delay > (delay_thr + NRFX_NFCT_FWT_MAX_DIFF))
+            {
+                return NRFX_ERROR_INVALID_PARAM;
+            }
+
+            delay = (delay > delay_thr) ? delay_thr : delay;
+            nrf_nfct_frame_delay_max_set(delay);
+            break;
+        }
+
+        case NRFX_NFCT_PARAM_ID_SEL_RES:
+            if (p_param->data.sel_res_protocol > NRF_NFCT_SELRES_PROTOCOL_NFCDEP_T4AT)
+            {
+                return NRFX_ERROR_INVALID_PARAM;
+            }
+
+            nrf_nfct_selres_protocol_set((nrf_nfct_selres_protocol_t) p_param->data.sel_res_protocol);
+            break;
+
+        case NRFX_NFCT_PARAM_ID_NFCID1:
+        {
+            nrf_nfct_sensres_nfcid1_size_t id_size_mask;
+
+            id_size_mask = nrf_nfct_nfcid1_size_to_sensres_size(p_param->data.nfcid1.id_size);
+            nrf_nfct_nfcid1_set(p_param->data.nfcid1.p_id, id_size_mask);
+            break;
+        }
+
+        default:
+            break;
+    }
+
+    return NRFX_SUCCESS;
+}
+
+nrfx_err_t nrfx_nfct_nfcid1_default_bytes_get(uint8_t * const p_nfcid1_buff,
+                                              uint32_t        nfcid1_buff_len)
+{
+    if ((nfcid1_buff_len != NRFX_NFCT_NFCID1_SINGLE_SIZE) &&
+        (nfcid1_buff_len != NRFX_NFCT_NFCID1_DOUBLE_SIZE) &&
+        (nfcid1_buff_len != NRFX_NFCT_NFCID1_TRIPLE_SIZE))
+    {
+        return NRFX_ERROR_INVALID_LENGTH;
+    }
+
+    uint32_t nfc_tag_header0 = NRF_FICR->NFC.TAGHEADER0;
+    uint32_t nfc_tag_header1 = NRF_FICR->NFC.TAGHEADER1;
+    uint32_t nfc_tag_header2 = NRF_FICR->NFC.TAGHEADER2;
+
+    p_nfcid1_buff[0] = (uint8_t) (nfc_tag_header0 >> 0);
+    p_nfcid1_buff[1] = (uint8_t) (nfc_tag_header0 >> 8);
+    p_nfcid1_buff[2] = (uint8_t) (nfc_tag_header0 >> 16);
+    p_nfcid1_buff[3] = (uint8_t) (nfc_tag_header1 >> 0);
+
+    if (nfcid1_buff_len != NRFX_NFCT_NFCID1_SINGLE_SIZE)
+    {
+        p_nfcid1_buff[4] = (uint8_t) (nfc_tag_header1 >> 8);
+        p_nfcid1_buff[5] = (uint8_t) (nfc_tag_header1 >> 16);
+        p_nfcid1_buff[6] = (uint8_t) (nfc_tag_header1 >> 24);
+
+        if (nfcid1_buff_len == NRFX_NFCT_NFCID1_TRIPLE_SIZE)
+        {
+            p_nfcid1_buff[7] = (uint8_t) (nfc_tag_header2 >> 0);
+            p_nfcid1_buff[8] = (uint8_t) (nfc_tag_header2 >> 8);
+            p_nfcid1_buff[9] = (uint8_t) (nfc_tag_header2 >> 16);
+        }
+        /* Begin: Bugfix for FTPAN-181. */
+        /* Workaround for wrong value in NFCID1. Value 0x88 cannot be used as byte 3 
+           of a double-size NFCID1, according to the NFC Forum Digital Protocol specification. */
+        else if (p_nfcid1_buff[3] == 0x88)
+        {
+            p_nfcid1_buff[3] |= 0x11;
+        }
+        /* End: Bugfix for FTPAN-181 */
+    }
+
+    return NRFX_SUCCESS;
+}
+
+void nrfx_nfct_autocolres_enable(void)
+{
+#if defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+    (*(uint32_t *)(0x4000559C)) &= (~(0x1UL));
+#else
+    nrf_nfct_autocolres_enable();
+#endif //defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+}
+
+void nrfx_nfct_autocolres_disable(void)
+{
+#if defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+    (*(uint32_t *)(0x4000559C)) |= (0x1UL);
+#else
+    nrf_nfct_autocolres_disable();
+#endif //defined(NRF52832_XXAA) || defined(NRF52832_XXAB)
+}
+
+void nrfx_nfct_irq_handler(void)
+{
+    nrfx_nfct_field_state_t current_field = NRFX_NFC_FIELD_STATE_NONE;
+
+    if (NRFX_NFCT_EVT_ACTIVE(FIELDDETECTED))
+    {
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_FIELDDETECTED);
+        current_field = NRFX_NFC_FIELD_STATE_ON;
+
+        NRFX_LOG_DEBUG("Field detected");
+    }
+
+#if !defined(NRF52832_XXAA) && !defined(NRF52832_XXAB)
+    if (NRFX_NFCT_EVT_ACTIVE(FIELDLOST))
+    {
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_FIELDLOST);
+        current_field = (current_field == NRFX_NFC_FIELD_STATE_NONE) ? 
+                        NRFX_NFC_FIELD_STATE_OFF : NRFX_NFC_FIELD_STATE_UNKNOWN;
+
+        NRFX_LOG_DEBUG("Field lost");
+    }
+#endif //!defined(NRF52832_XXAA) && !defined(NRF52832_XXAB)
+
+    /* Perform actions if any FIELD event is active */
+    if (current_field != NRFX_NFC_FIELD_STATE_NONE)
+    {
+        nrfx_nfct_field_event_handler(current_field);
+    }
+
+    if (NRFX_NFCT_EVT_ACTIVE(RXFRAMEEND))
+    {
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_RXFRAMEEND);
+
+        nrfx_nfct_evt_t nfct_evt =
+        {
+            .evt_id = NRFX_NFCT_EVT_RX_FRAMEEND
+        };
+
+        /* Take into account only the number of whole bytes. */
+        nfct_evt.params.rx_frameend.rx_status         = 0;
+        nfct_evt.params.rx_frameend.rx_data.p_data    = nrf_nfct_rxtx_buffer_get();
+        nfct_evt.params.rx_frameend.rx_data.data_size = NRFX_NFCT_BITS_TO_BYTES(nrf_nfct_rx_bits_get(true));
+
+        if (NRFX_NFCT_EVT_ACTIVE(RXERROR))
+        {
+            nfct_evt.params.rx_frameend.rx_status = 
+                (nrf_nfct_rx_frame_status_get() & NRFX_NFCT_FRAME_STATUS_RX_ALL_MASK);
+            nrf_nfct_event_clear(NRF_NFCT_EVENT_RXERROR);
+
+            NRFX_LOG_DEBUG("Rx error (0x%x)", (unsigned int) nfct_evt.params.rx_frameend.rx_status);
+
+            /* Clear rx frame status */
+            nrf_nfct_rx_frame_status_clear(NRFX_NFCT_FRAME_STATUS_RX_ALL_MASK);
+        }
+
+        NRFX_NFCT_CB_HANDLE(m_nfct_cb.config.cb, nfct_evt);
+
+        /* Clear TXFRAMESTART EVENT so it can be checked in hal_nfc_send */
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_TXFRAMESTART);
+
+        NRFX_LOG_DEBUG("Rx fend");
+    }
+
+    if (NRFX_NFCT_EVT_ACTIVE(TXFRAMEEND))
+    {
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_TXFRAMEEND);
+
+        nrfx_nfct_evt_t nfct_evt =
+        {
+            .evt_id = NRFX_NFCT_EVT_TX_FRAMEEND
+        };
+
+        /* Disable TX END event to ignore frame transmission other than READ response */
+        nrf_nfct_int_disable(NRFX_NFCT_TX_INT_MASK);
+
+        NRFX_NFCT_CB_HANDLE(m_nfct_cb.config.cb, nfct_evt);
+
+        NRFX_LOG_DEBUG("Tx fend");
+    }
+
+    if (NRFX_NFCT_EVT_ACTIVE(SELECTED))
+    {
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_SELECTED);
+        /* Clear also RX END and RXERROR events because SW does not take care of 
+           commands that were received before selecting the tag. */
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_RXFRAMEEND);
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_RXERROR);
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_TXFRAMESTART);
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_TXFRAMEEND);
+
+        /* At this point any previous error status can be ignored. */
+        nrf_nfct_rx_frame_status_clear(NRFX_NFCT_FRAME_STATUS_RX_ALL_MASK);
+        nrf_nfct_error_status_clear(NRFX_NFCT_ERROR_STATUS_ALL_MASK);
+
+        nrfx_nfct_evt_t nfct_evt =
+        {
+            .evt_id = NRFX_NFCT_EVT_SELECTED
+        };
+        NRFX_NFCT_CB_HANDLE(m_nfct_cb.config.cb, nfct_evt);
+
+        NRFX_LOG_DEBUG("Selected");
+    }
+
+    if (NRFX_NFCT_EVT_ACTIVE(ERROR))
+    {
+        uint32_t err_status = nrf_nfct_error_status_get();
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_ERROR);
+
+        nrfx_nfct_evt_t nfct_evt =
+        {
+            .evt_id = NRFX_NFCT_EVT_ERROR
+        };
+
+        /* Clear FRAMEDELAYTIMEOUT error (expected HW behaviour) when SLP_REQ command was received. */
+        if (err_status & NRF_NFCT_ERROR_FRAMEDELAYTIMEOUT_MASK)
+        {
+            nrf_nfct_error_status_clear(NRF_NFCT_ERROR_FRAMEDELAYTIMEOUT_MASK);
+
+            nfct_evt.params.error.reason = NRFX_NFCT_ERROR_FRAMEDELAYTIMEOUT;
+            NRFX_NFCT_CB_HANDLE(m_nfct_cb.config.cb, nfct_evt);
+        }
+
+        /* Report any other error. */
+        err_status &= ~NRF_NFCT_ERROR_FRAMEDELAYTIMEOUT_MASK;
+        if (err_status)
+        {
+            NRFX_LOG_DEBUG("Error (0x%x)", (unsigned int) err_status);
+        }
+
+        /* Clear error status. */
+        nrf_nfct_error_status_clear(NRFX_NFCT_ERROR_STATUS_ALL_MASK);
+    }
+
+    if (NRFX_NFCT_EVT_ACTIVE(TXFRAMESTART))
+    {
+        nrf_nfct_event_clear(NRF_NFCT_EVENT_TXFRAMESTART);
+
+        if (m_nfct_cb.config.cb != NULL)
+        {
+            nrfx_nfct_evt_t nfct_evt;
+
+            nfct_evt.evt_id                                 = NRFX_NFCT_EVT_TX_FRAMESTART;
+            nfct_evt.params.tx_framestart.tx_data.p_data    = nrf_nfct_rxtx_buffer_get();
+            nfct_evt.params.tx_framestart.tx_data.data_size = NRFX_NFCT_BITS_TO_BYTES(nrf_nfct_tx_bits_get());
+
+            m_nfct_cb.config.cb(&nfct_evt);
+        }
+    }
+}
+
+#endif // NRFX_CHECK(NRFX_NFCT_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_pdm.c

@@ -1,370 +1,361 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_PDM_ENABLED)
-
-#include <nrfx_pdm.h>
-#include <hal/nrf_gpio.h>
-
-#define NRFX_LOG_MODULE PDM
-#include <nrfx_log.h>
-
-#define EVT_TO_STR(event)                                       \
-    (event == NRF_PDM_EVENT_STARTED ? "NRF_PDM_EVENT_STARTED" : \
-    (event == NRF_PDM_EVENT_STOPPED ? "NRF_PDM_EVENT_STOPPED" : \
-    (event == NRF_PDM_EVENT_END     ? "NRF_PDM_EVENT_END"     : \
-                                      "UNKNOWN EVENT")))
-
-
-/** @brief PDM interface status. */
-typedef enum
-{
-    NRFX_PDM_STATE_IDLE,
-    NRFX_PDM_STATE_RUNNING,
-    NRFX_PDM_STATE_STARTING,
-    NRFX_PDM_STATE_STOPPING
-} nrfx_pdm_state_t;
-
-/** @brief PDM interface control block.*/
-typedef struct
-{
-    nrfx_pdm_event_handler_t  event_handler;    ///< Event handler function pointer.
-    int16_t *                 buff_address[2];  ///< Sample buffers.
-    uint16_t                  buff_length[2];   ///< Length of the sample buffers.
-    nrfx_drv_state_t          drv_state;        ///< Driver state.
-    volatile nrfx_pdm_state_t op_state;         ///< PDM peripheral operation state.
-    uint8_t                   active_buffer;    ///< Number of currently active buffer.
-    uint8_t                   error;            ///< Driver error flag.
-    volatile uint8_t          irq_buff_request; ///< Request the next buffer in the ISR.
-} nrfx_pdm_cb_t;
-
-static nrfx_pdm_cb_t m_cb;
-
-
-void nrfx_pdm_irq_handler(void)
-{
-    if (nrf_pdm_event_check(NRF_PDM_EVENT_STARTED))
-    {
-        nrf_pdm_event_clear(NRF_PDM_EVENT_STARTED);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_PDM_EVENT_STARTED));
-
-        uint8_t finished_buffer = m_cb.active_buffer;
-
-        // Check if the next buffer was set before.
-        uint8_t next_buffer = (~m_cb.active_buffer) & 0x01;
-        if (m_cb.buff_address[next_buffer] ||
-            m_cb.op_state == NRFX_PDM_STATE_STARTING)
-        {
-            nrfx_pdm_evt_t evt;
-            evt.error = NRFX_PDM_NO_ERROR;
-            m_cb.error = 0;
-
-            // Release the full buffer if ready and request the next one.
-            if (m_cb.op_state == NRFX_PDM_STATE_STARTING)
-            {
-                evt.buffer_released = 0;
-                m_cb.op_state = NRFX_PDM_STATE_RUNNING;
-            }
-            else
-            {
-                evt.buffer_released = m_cb.buff_address[finished_buffer];
-                m_cb.buff_address[finished_buffer] = 0;
-                m_cb.active_buffer = next_buffer;
-            }
-            evt.buffer_requested = true;
-            m_cb.event_handler(&evt);
-        }
-        else
-        {
-            // No next buffer available. Report an error.
-            // Do not request the new buffer as it was already done.
-            if (m_cb.error == 0)
-            {
-                nrfx_pdm_evt_t const evt = {
-                    .buffer_requested = false,
-                    .buffer_released  = NULL,
-                    .error = NRFX_PDM_ERROR_OVERFLOW
-                };
-                m_cb.error = 1;
-                m_cb.event_handler(&evt);
-            }
-        }
-
-        if (m_cb.op_state == NRFX_PDM_STATE_STARTING)
-        {
-            m_cb.op_state = NRFX_PDM_STATE_RUNNING;
-        }
-    }
-    else if (nrf_pdm_event_check(NRF_PDM_EVENT_STOPPED))
-    {
-        nrf_pdm_event_clear(NRF_PDM_EVENT_STOPPED);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_PDM_EVENT_STOPPED));
-        nrf_pdm_disable();
-        m_cb.op_state = NRFX_PDM_STATE_IDLE;
-
-        // Release the buffers.
-        nrfx_pdm_evt_t evt;
-        evt.error = NRFX_PDM_NO_ERROR;
-        evt.buffer_requested = false;
-        if (m_cb.buff_address[m_cb.active_buffer])
-        {
-            evt.buffer_released = m_cb.buff_address[m_cb.active_buffer];
-            m_cb.buff_address[m_cb.active_buffer] = 0;
-            m_cb.event_handler(&evt);
-        }
-
-        uint8_t second_buffer = (~m_cb.active_buffer) & 0x01;
-        if (m_cb.buff_address[second_buffer])
-        {
-            evt.buffer_released = m_cb.buff_address[second_buffer];
-            m_cb.buff_address[second_buffer] = 0;
-            m_cb.event_handler(&evt);
-        }
-        m_cb.active_buffer = 0;
-    }
-
-    if (m_cb.irq_buff_request)
-    {
-        nrfx_pdm_evt_t const evt =
-        {
-            .buffer_requested = true,
-            .buffer_released  = NULL,
-            .error = NRFX_PDM_NO_ERROR,
-        };
-        m_cb.irq_buff_request = 0;
-        m_cb.event_handler(&evt);
-    }
-}
-
-
-nrfx_err_t nrfx_pdm_init(nrfx_pdm_config_t const * p_config,
-                         nrfx_pdm_event_handler_t  event_handler)
-{
-    NRFX_ASSERT(p_config);
-    NRFX_ASSERT(event_handler);
-    nrfx_err_t err_code;
-
-    if (m_cb.drv_state != NRFX_DRV_STATE_UNINITIALIZED)
-    {
-        err_code = NRFX_ERROR_INVALID_STATE;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    if (p_config->gain_l > NRF_PDM_GAIN_MAXIMUM ||
-        p_config->gain_r > NRF_PDM_GAIN_MAXIMUM)
-    {
-        err_code = NRFX_ERROR_INVALID_PARAM;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    m_cb.buff_address[0] = 0;
-    m_cb.buff_address[1] = 0;
-    m_cb.active_buffer = 0;
-    m_cb.error = 0;
-    m_cb.event_handler = event_handler;
-    m_cb.op_state = NRFX_PDM_STATE_IDLE;
-
-    nrf_pdm_clock_set(p_config->clock_freq);
-    nrf_pdm_mode_set(p_config->mode, p_config->edge);
-    nrf_pdm_gain_set(p_config->gain_l, p_config->gain_r);
-
-    nrf_gpio_cfg_output(p_config->pin_clk);
-    nrf_gpio_pin_clear(p_config->pin_clk);
-    nrf_gpio_cfg_input(p_config->pin_din, NRF_GPIO_PIN_NOPULL);
-    nrf_pdm_psel_connect(p_config->pin_clk, p_config->pin_din);
-
-    nrf_pdm_event_clear(NRF_PDM_EVENT_STARTED);
-    nrf_pdm_event_clear(NRF_PDM_EVENT_END);
-    nrf_pdm_event_clear(NRF_PDM_EVENT_STOPPED);
-    nrf_pdm_int_enable(NRF_PDM_INT_STARTED | NRF_PDM_INT_STOPPED);
-    NRFX_IRQ_PRIORITY_SET(PDM_IRQn, p_config->interrupt_priority);
-    NRFX_IRQ_ENABLE(PDM_IRQn);
-    m_cb.drv_state = NRFX_DRV_STATE_INITIALIZED;
-
-    err_code = NRFX_SUCCESS;
-    NRFX_LOG_INFO("Function: %s, error code: %s.",
-                  __func__,
-                  NRFX_LOG_ERROR_STRING_GET(err_code));
-    return err_code;
-}
-
-void nrfx_pdm_uninit(void)
-{
-    nrf_pdm_disable();
-    nrf_pdm_psel_disconnect();
-    m_cb.drv_state = NRFX_DRV_STATE_UNINITIALIZED;
-    NRFX_LOG_INFO("Uninitialized.");
-}
-
-static void pdm_start()
-{
-    m_cb.drv_state = NRFX_DRV_STATE_POWERED_ON;
-    nrf_pdm_enable();
-    nrf_pdm_event_clear(NRF_PDM_EVENT_STARTED);
-    nrf_pdm_task_trigger(NRF_PDM_TASK_START);
-}
-
-static void pdm_buf_request()
-{
-    m_cb.irq_buff_request = 1;
-    NRFX_IRQ_PENDING_SET(PDM_IRQn);
-}
-
-nrfx_err_t nrfx_pdm_start(void)
-{
-    NRFX_ASSERT(m_cb.drv_state != NRFX_DRV_STATE_UNINITIALIZED);
-    nrfx_err_t err_code;
-
-    if (m_cb.op_state != NRFX_PDM_STATE_IDLE)
-    {
-        if (m_cb.op_state == NRFX_PDM_STATE_RUNNING)
-        {
-            err_code = NRFX_SUCCESS;
-            NRFX_LOG_INFO("Function: %s, error code: %s.",
-                          __func__,
-                          NRFX_LOG_ERROR_STRING_GET(err_code));
-            return err_code;
-        }
-        err_code = NRFX_ERROR_BUSY;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    m_cb.op_state = NRFX_PDM_STATE_STARTING;
-    pdm_buf_request();
-
-    err_code = NRFX_SUCCESS;
-    NRFX_LOG_INFO("Function: %s, error code: %s.",
-                  __func__,
-                  NRFX_LOG_ERROR_STRING_GET(err_code));
-    return err_code;
-}
-
-nrfx_err_t nrfx_pdm_buffer_set(int16_t * buffer, uint16_t buffer_length)
-{
-    if (m_cb.drv_state == NRFX_DRV_STATE_UNINITIALIZED)
-    {
-        return NRFX_ERROR_INVALID_STATE;
-    }
-    if (m_cb.op_state == NRFX_PDM_STATE_STOPPING)
-    {
-        return NRFX_ERROR_BUSY;
-    }
-    if ((buffer == NULL) || (buffer_length > NRFX_PDM_MAX_BUFFER_SIZE))
-    {
-        return NRFX_ERROR_INVALID_PARAM;
-    }
-
-    nrfx_err_t err_code = NRFX_SUCCESS;
-
-    // Enter the PDM critical section.
-    NRFX_IRQ_DISABLE(PDM_IRQn);
-
-    uint8_t next_buffer = (~m_cb.active_buffer) & 0x01;
-    if (m_cb.op_state == NRFX_PDM_STATE_STARTING)
-    {
-        next_buffer = 0;
-    }
-
-    if (m_cb.buff_address[next_buffer])
-    {
-        // Buffer already set.
-        err_code = NRFX_ERROR_BUSY;
-    }
-    else
-    {
-        m_cb.buff_address[next_buffer] = buffer;
-        m_cb.buff_length[next_buffer] = buffer_length;
-        nrf_pdm_buffer_set((uint32_t *)buffer, buffer_length);
-
-        if (m_cb.drv_state != NRFX_DRV_STATE_POWERED_ON)
-        {
-            pdm_start();
-        }
-    }
-
-    NRFX_IRQ_ENABLE(PDM_IRQn);
-    return err_code;
-}
-
-nrfx_err_t nrfx_pdm_stop(void)
-{
-    NRFX_ASSERT(m_cb.drv_state != NRFX_DRV_STATE_UNINITIALIZED);
-    nrfx_err_t err_code;
-
-    if (m_cb.op_state != NRFX_PDM_STATE_RUNNING)
-    {
-        if (m_cb.op_state == NRFX_PDM_STATE_IDLE ||
-            m_cb.op_state == NRFX_PDM_STATE_STARTING)
-        {
-            nrf_pdm_disable();
-            m_cb.op_state = NRFX_PDM_STATE_IDLE;
-            err_code = NRFX_SUCCESS;
-            NRFX_LOG_INFO("Function: %s, error code: %s.",
-                          __func__,
-                          NRFX_LOG_ERROR_STRING_GET(err_code));
-            return err_code;
-        }
-        err_code = NRFX_ERROR_BUSY;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-    m_cb.drv_state = NRFX_DRV_STATE_INITIALIZED;
-    m_cb.op_state = NRFX_PDM_STATE_STOPPING;
-
-    nrf_pdm_task_trigger(NRF_PDM_TASK_STOP);
-    err_code = NRFX_SUCCESS;
-    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
-    return err_code;
-}
-
-#endif // NRFX_CHECK(NRFX_PDM_ENABLED)
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_PDM_ENABLED)
+
+#include <nrfx_pdm.h>
+#include <hal/nrf_gpio.h>
+
+#define NRFX_LOG_MODULE PDM
+#include <nrfx_log.h>
+
+#define EVT_TO_STR(event)                                       \
+    (event == NRF_PDM_EVENT_STARTED ? "NRF_PDM_EVENT_STARTED" : \
+    (event == NRF_PDM_EVENT_STOPPED ? "NRF_PDM_EVENT_STOPPED" : \
+    (event == NRF_PDM_EVENT_END     ? "NRF_PDM_EVENT_END"     : \
+                                      "UNKNOWN EVENT")))
+
+
+/** @brief PDM interface status. */
+typedef enum
+{
+    NRFX_PDM_STATE_IDLE,
+    NRFX_PDM_STATE_RUNNING,
+    NRFX_PDM_STATE_STARTING,
+    NRFX_PDM_STATE_STOPPING
+} nrfx_pdm_state_t;
+
+/** @brief PDM interface control block.*/
+typedef struct
+{
+    nrfx_pdm_event_handler_t  event_handler;    ///< Event handler function pointer.
+    int16_t *                 buff_address[2];  ///< Sample buffers.
+    uint16_t                  buff_length[2];   ///< Length of the sample buffers.
+    nrfx_drv_state_t          drv_state;        ///< Driver state.
+    volatile nrfx_pdm_state_t op_state;         ///< PDM peripheral operation state.
+    uint8_t                   active_buffer;    ///< Number of currently active buffer.
+    uint8_t                   error;            ///< Driver error flag.
+    volatile uint8_t          irq_buff_request; ///< Request the next buffer in the ISR.
+} nrfx_pdm_cb_t;
+
+static nrfx_pdm_cb_t m_cb;
+
+
+void nrfx_pdm_irq_handler(void)
+{
+    if (nrf_pdm_event_check(NRF_PDM_EVENT_STARTED))
+    {
+        nrf_pdm_event_clear(NRF_PDM_EVENT_STARTED);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_PDM_EVENT_STARTED));
+
+        uint8_t finished_buffer = m_cb.active_buffer;
+
+        // Check if the next buffer was set before.
+        uint8_t next_buffer = (~m_cb.active_buffer) & 0x01;
+        if (m_cb.buff_address[next_buffer] ||
+            m_cb.op_state == NRFX_PDM_STATE_STARTING)
+        {
+            nrfx_pdm_evt_t evt;
+            evt.error = NRFX_PDM_NO_ERROR;
+            m_cb.error = 0;
+
+            // Release the full buffer if ready and request the next one.
+            if (m_cb.op_state == NRFX_PDM_STATE_STARTING)
+            {
+                evt.buffer_released = 0;
+                m_cb.op_state = NRFX_PDM_STATE_RUNNING;
+            }
+            else
+            {
+                evt.buffer_released = m_cb.buff_address[finished_buffer];
+                m_cb.buff_address[finished_buffer] = 0;
+                m_cb.active_buffer = next_buffer;
+            }
+            evt.buffer_requested = true;
+            m_cb.event_handler(&evt);
+        }
+        else
+        {
+            // No next buffer available. Report an error.
+            // Do not request the new buffer as it was already done.
+            if (m_cb.error == 0)
+            {
+                nrfx_pdm_evt_t const evt = {
+                    .buffer_requested = false,
+                    .buffer_released  = NULL,
+                    .error = NRFX_PDM_ERROR_OVERFLOW
+                };
+                m_cb.error = 1;
+                m_cb.event_handler(&evt);
+            }
+        }
+
+        if (m_cb.op_state == NRFX_PDM_STATE_STARTING)
+        {
+            m_cb.op_state = NRFX_PDM_STATE_RUNNING;
+        }
+    }
+    else if (nrf_pdm_event_check(NRF_PDM_EVENT_STOPPED))
+    {
+        nrf_pdm_event_clear(NRF_PDM_EVENT_STOPPED);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_PDM_EVENT_STOPPED));
+        nrf_pdm_disable();
+        m_cb.op_state = NRFX_PDM_STATE_IDLE;
+
+        // Release the buffers.
+        nrfx_pdm_evt_t evt;
+        evt.error = NRFX_PDM_NO_ERROR;
+        evt.buffer_requested = false;
+        if (m_cb.buff_address[m_cb.active_buffer])
+        {
+            evt.buffer_released = m_cb.buff_address[m_cb.active_buffer];
+            m_cb.buff_address[m_cb.active_buffer] = 0;
+            m_cb.event_handler(&evt);
+        }
+
+        uint8_t second_buffer = (~m_cb.active_buffer) & 0x01;
+        if (m_cb.buff_address[second_buffer])
+        {
+            evt.buffer_released = m_cb.buff_address[second_buffer];
+            m_cb.buff_address[second_buffer] = 0;
+            m_cb.event_handler(&evt);
+        }
+        m_cb.active_buffer = 0;
+    }
+
+    if (m_cb.irq_buff_request)
+    {
+        nrfx_pdm_evt_t const evt =
+        {
+            .buffer_requested = true,
+            .buffer_released  = NULL,
+            .error = NRFX_PDM_NO_ERROR,
+        };
+        m_cb.irq_buff_request = 0;
+        m_cb.event_handler(&evt);
+    }
+}
+
+
+nrfx_err_t nrfx_pdm_init(nrfx_pdm_config_t const * p_config,
+                         nrfx_pdm_event_handler_t  event_handler)
+{
+    NRFX_ASSERT(p_config);
+    NRFX_ASSERT(event_handler);
+    nrfx_err_t err_code;
+
+    if (m_cb.drv_state != NRFX_DRV_STATE_UNINITIALIZED)
+    {
+        err_code = NRFX_ERROR_INVALID_STATE;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    if (p_config->gain_l > NRF_PDM_GAIN_MAXIMUM ||
+        p_config->gain_r > NRF_PDM_GAIN_MAXIMUM)
+    {
+        err_code = NRFX_ERROR_INVALID_PARAM;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    m_cb.buff_address[0] = 0;
+    m_cb.buff_address[1] = 0;
+    m_cb.active_buffer = 0;
+    m_cb.error = 0;
+    m_cb.event_handler = event_handler;
+    m_cb.op_state = NRFX_PDM_STATE_IDLE;
+
+    nrf_pdm_clock_set(p_config->clock_freq);
+    nrf_pdm_mode_set(p_config->mode, p_config->edge);
+    nrf_pdm_gain_set(p_config->gain_l, p_config->gain_r);
+
+    nrf_gpio_cfg_output(p_config->pin_clk);
+    nrf_gpio_pin_clear(p_config->pin_clk);
+    nrf_gpio_cfg_input(p_config->pin_din, NRF_GPIO_PIN_NOPULL);
+    nrf_pdm_psel_connect(p_config->pin_clk, p_config->pin_din);
+
+    nrf_pdm_event_clear(NRF_PDM_EVENT_STARTED);
+    nrf_pdm_event_clear(NRF_PDM_EVENT_END);
+    nrf_pdm_event_clear(NRF_PDM_EVENT_STOPPED);
+    nrf_pdm_int_enable(NRF_PDM_INT_STARTED | NRF_PDM_INT_STOPPED);
+    NRFX_IRQ_PRIORITY_SET(PDM_IRQn, p_config->interrupt_priority);
+    NRFX_IRQ_ENABLE(PDM_IRQn);
+    m_cb.drv_state = NRFX_DRV_STATE_INITIALIZED;
+
+    err_code = NRFX_SUCCESS;
+    NRFX_LOG_INFO("Function: %s, error code: %s.",
+                  __func__,
+                  NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+void nrfx_pdm_uninit(void)
+{
+    nrf_pdm_disable();
+    nrf_pdm_psel_disconnect();
+    m_cb.drv_state = NRFX_DRV_STATE_UNINITIALIZED;
+    NRFX_LOG_INFO("Uninitialized.");
+}
+
+static void pdm_start()
+{
+    m_cb.drv_state = NRFX_DRV_STATE_POWERED_ON;
+    nrf_pdm_enable();
+    nrf_pdm_event_clear(NRF_PDM_EVENT_STARTED);
+    nrf_pdm_task_trigger(NRF_PDM_TASK_START);
+}
+
+static void pdm_buf_request()
+{
+    m_cb.irq_buff_request = 1;
+    NRFX_IRQ_PENDING_SET(PDM_IRQn);
+}
+
+nrfx_err_t nrfx_pdm_start(void)
+{
+    NRFX_ASSERT(m_cb.drv_state != NRFX_DRV_STATE_UNINITIALIZED);
+    nrfx_err_t err_code;
+
+    if (m_cb.op_state != NRFX_PDM_STATE_IDLE)
+    {
+        if (m_cb.op_state == NRFX_PDM_STATE_RUNNING)
+        {
+            err_code = NRFX_SUCCESS;
+            NRFX_LOG_INFO("Function: %s, error code: %s.",
+                          __func__,
+                          NRFX_LOG_ERROR_STRING_GET(err_code));
+            return err_code;
+        }
+        err_code = NRFX_ERROR_BUSY;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    m_cb.op_state = NRFX_PDM_STATE_STARTING;
+    pdm_buf_request();
+
+    err_code = NRFX_SUCCESS;
+    NRFX_LOG_INFO("Function: %s, error code: %s.",
+                  __func__,
+                  NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+nrfx_err_t nrfx_pdm_buffer_set(int16_t * buffer, uint16_t buffer_length)
+{
+    if (m_cb.drv_state == NRFX_DRV_STATE_UNINITIALIZED)
+    {
+        return NRFX_ERROR_INVALID_STATE;
+    }
+    if (m_cb.op_state == NRFX_PDM_STATE_STOPPING)
+    {
+        return NRFX_ERROR_BUSY;
+    }
+    if ((buffer == NULL) || (buffer_length > NRFX_PDM_MAX_BUFFER_SIZE))
+    {
+        return NRFX_ERROR_INVALID_PARAM;
+    }
+
+    nrfx_err_t err_code = NRFX_SUCCESS;
+
+    // Enter the PDM critical section.
+    NRFX_IRQ_DISABLE(PDM_IRQn);
+
+    uint8_t next_buffer = (~m_cb.active_buffer) & 0x01;
+    if (m_cb.op_state == NRFX_PDM_STATE_STARTING)
+    {
+        next_buffer = 0;
+    }
+
+    if (m_cb.buff_address[next_buffer])
+    {
+        // Buffer already set.
+        err_code = NRFX_ERROR_BUSY;
+    }
+    else
+    {
+        m_cb.buff_address[next_buffer] = buffer;
+        m_cb.buff_length[next_buffer] = buffer_length;
+        nrf_pdm_buffer_set((uint32_t *)buffer, buffer_length);
+
+        if (m_cb.drv_state != NRFX_DRV_STATE_POWERED_ON)
+        {
+            pdm_start();
+        }
+    }
+
+    NRFX_IRQ_ENABLE(PDM_IRQn);
+    return err_code;
+}
+
+nrfx_err_t nrfx_pdm_stop(void)
+{
+    NRFX_ASSERT(m_cb.drv_state != NRFX_DRV_STATE_UNINITIALIZED);
+    nrfx_err_t err_code;
+
+    if (m_cb.op_state != NRFX_PDM_STATE_RUNNING)
+    {
+        if (m_cb.op_state == NRFX_PDM_STATE_IDLE ||
+            m_cb.op_state == NRFX_PDM_STATE_STARTING)
+        {
+            nrf_pdm_disable();
+            m_cb.op_state = NRFX_PDM_STATE_IDLE;
+            err_code = NRFX_SUCCESS;
+            NRFX_LOG_INFO("Function: %s, error code: %s.",
+                          __func__,
+                          NRFX_LOG_ERROR_STRING_GET(err_code));
+            return err_code;
+        }
+        err_code = NRFX_ERROR_BUSY;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+    m_cb.drv_state = NRFX_DRV_STATE_INITIALIZED;
+    m_cb.op_state = NRFX_PDM_STATE_STOPPING;
+
+    nrf_pdm_task_trigger(NRF_PDM_TASK_STOP);
+    err_code = NRFX_SUCCESS;
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+#endif // NRFX_CHECK(NRFX_PDM_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_power.c

@@ -1,306 +1,330 @@
-/**
- * Copyright (c) 2017 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_POWER_ENABLED)
-
-#include <nrfx_power.h>
-
-#if NRFX_CHECK(NRFX_CLOCK_ENABLED)
-extern bool nrfx_clock_irq_enabled;
-#endif
-
-/**
- * @internal
- * @defgroup nrfx_power_internals POWER driver internals
- * @ingroup nrfx_power
- *
- * Internal variables, auxiliary macros and functions of POWER driver.
- * @{
- */
-
-/**
- * This variable is used to check whether common POWER_CLOCK common interrupt
- * should be disabled or not if @ref nrfx_clock tries to disable the interrupt.
- */
-
-bool nrfx_power_irq_enabled;
-
-/**
- * @brief The initialization flag
- */
-
-#define m_initialized nrfx_power_irq_enabled
-
-/**
- * @brief The handler of power fail comparator warning event
- */
-static nrfx_power_pofwarn_event_handler_t m_pofwarn_handler;
-
-#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
-/**
- * @brief The handler of sleep event handler
- */
-static nrfx_power_sleep_event_handler_t m_sleepevt_handler;
-#endif
-
-#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
-/**
- * @brief The handler of USB power events
- */
-static nrfx_power_usb_event_handler_t m_usbevt_handler;
-#endif
-
-/** @} */
-
-nrfx_power_pofwarn_event_handler_t nrfx_power_pof_handler_get(void)
-{
-    return m_pofwarn_handler;
-}
-
-#if NRF_POWER_HAS_USBREG
-nrfx_power_usb_event_handler_t nrfx_power_usb_handler_get(void)
-{
-    return m_usbevt_handler;
-}
-#endif
-
-nrfx_err_t nrfx_power_init(nrfx_power_config_t const * p_config)
-{
-    NRFX_ASSERT(p_config);
-    if (m_initialized)
-    {
-        return NRFX_ERROR_ALREADY_INITIALIZED;
-    }
-
-#if NRF_POWER_HAS_VDDH
-    nrf_power_dcdcen_vddh_set(p_config->dcdcenhv);
-#endif
-    nrf_power_dcdcen_set(p_config->dcdcen);
-
-    nrfx_power_clock_irq_init();
-
-    m_initialized = true;
-    return NRFX_SUCCESS;
-}
-
-
-void nrfx_power_uninit(void)
-{
-    NRFX_ASSERT(m_initialized);
-
-#if NRFX_CHECK(NRFX_CLOCK_ENABLED)
-    if (!nrfx_clock_irq_enabled)
-#endif
-    {
-        NRFX_IRQ_DISABLE(POWER_CLOCK_IRQn);
-    }
-
-    nrfx_power_pof_uninit();
-#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
-    nrfx_power_sleepevt_uninit();
-#endif
-#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
-    nrfx_power_usbevt_uninit();
-#endif
-    m_initialized = false;
-}
-
-void nrfx_power_pof_init(nrfx_power_pofwarn_config_t const * p_config)
-{
-    NRFX_ASSERT(p_config != NULL);
-
-    nrfx_power_pof_uninit();
-
-    if (p_config->handler != NULL)
-    {
-        m_pofwarn_handler = p_config->handler;
-    }
-}
-
-void nrfx_power_pof_enable(nrfx_power_pofwarn_config_t const * p_config)
-{
-    nrf_power_pofcon_set(true, p_config->thr);
-#if NRF_POWER_HAS_VDDH || defined(__NRFX_DOXYGEN__)
-    nrf_power_pofcon_vddh_set(p_config->thrvddh);
-#endif
-    if (m_pofwarn_handler != NULL)
-    {
-        nrf_power_int_enable(NRF_POWER_INT_POFWARN_MASK);
-    }
-}
-
-void nrfx_power_pof_disable(void)
-{
-    nrf_power_int_disable(NRF_POWER_INT_POFWARN_MASK);
-}
-
-void nrfx_power_pof_uninit(void)
-{
-    m_pofwarn_handler = NULL;
-}
-
-#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
-void nrfx_power_sleepevt_init(nrfx_power_sleepevt_config_t const * p_config)
-{
-    NRFX_ASSERT(p_config != NULL);
-
-    nrfx_power_sleepevt_uninit();
-    if (p_config->handler != NULL)
-    {
-        m_sleepevt_handler = p_config->handler;
-    }
-}
-
-void nrfx_power_sleepevt_enable(nrfx_power_sleepevt_config_t const * p_config)
-{
-    uint32_t enmask = 0;
-    if (p_config->en_enter)
-    {
-        enmask |= NRF_POWER_INT_SLEEPENTER_MASK;
-        nrf_power_event_clear(NRF_POWER_EVENT_SLEEPENTER);
-    }
-    if (p_config->en_exit)
-    {
-        enmask |= NRF_POWER_INT_SLEEPEXIT_MASK;
-        nrf_power_event_clear(NRF_POWER_EVENT_SLEEPEXIT);
-    }
-    nrf_power_int_enable(enmask);
-}
-
-void nrfx_power_sleepevt_disable(void)
-{
-    nrf_power_int_disable(
-        NRF_POWER_INT_SLEEPENTER_MASK |
-        NRF_POWER_INT_SLEEPEXIT_MASK);
-}
-
-void nrfx_power_sleepevt_uninit(void)
-{
-    m_sleepevt_handler = NULL;
-}
-#endif /* NRF_POWER_HAS_SLEEPEVT */
-
-#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
-void nrfx_power_usbevt_init(nrfx_power_usbevt_config_t const * p_config)
-{
-    nrfx_power_usbevt_uninit();
-    if (p_config->handler != NULL)
-    {
-        m_usbevt_handler = p_config->handler;
-    }
-}
-
-void nrfx_power_usbevt_enable(void)
-{
-    nrf_power_int_enable(
-        NRF_POWER_INT_USBDETECTED_MASK |
-        NRF_POWER_INT_USBREMOVED_MASK  |
-        NRF_POWER_INT_USBPWRRDY_MASK);
-}
-
-void nrfx_power_usbevt_disable(void)
-{
-    nrf_power_int_disable(
-        NRF_POWER_INT_USBDETECTED_MASK |
-        NRF_POWER_INT_USBREMOVED_MASK  |
-        NRF_POWER_INT_USBPWRRDY_MASK);
-}
-
-void nrfx_power_usbevt_uninit(void)
-{
-    m_usbevt_handler = NULL;
-}
-#endif /* NRF_POWER_HAS_USBREG */
-
-
-void nrfx_power_irq_handler(void)
-{
-    uint32_t enabled = nrf_power_int_enable_get();
-    if ((0 != (enabled & NRF_POWER_INT_POFWARN_MASK)) &&
-        nrf_power_event_get_and_clear(NRF_POWER_EVENT_POFWARN))
-    {
-        /* Cannot be null if event is enabled */
-        NRFX_ASSERT(m_pofwarn_handler != NULL);
-        m_pofwarn_handler();
-    }
-#if NRF_POWER_HAS_SLEEPEVT || defined(__NRFX_DOXYGEN__)
-    if ((0 != (enabled & NRF_POWER_INT_SLEEPENTER_MASK)) &&
-        nrf_power_event_get_and_clear(NRF_POWER_EVENT_SLEEPENTER))
-    {
-        /* Cannot be null if event is enabled */
-        NRFX_ASSERT(m_sleepevt_handler != NULL);
-        m_sleepevt_handler(NRFX_POWER_SLEEP_EVT_ENTER);
-    }
-    if ((0 != (enabled & NRF_POWER_INT_SLEEPEXIT_MASK)) &&
-        nrf_power_event_get_and_clear(NRF_POWER_EVENT_SLEEPEXIT))
-    {
-        /* Cannot be null if event is enabled */
-        NRFX_ASSERT(m_sleepevt_handler != NULL);
-        m_sleepevt_handler(NRFX_POWER_SLEEP_EVT_EXIT);
-    }
-#endif
-#if NRF_POWER_HAS_USBREG || defined(__NRFX_DOXYGEN__)
-    if ((0 != (enabled & NRF_POWER_INT_USBDETECTED_MASK)) &&
-        nrf_power_event_get_and_clear(NRF_POWER_EVENT_USBDETECTED))
-    {
-        /* Cannot be null if event is enabled */
-        NRFX_ASSERT(m_usbevt_handler != NULL);
-        m_usbevt_handler(NRFX_POWER_USB_EVT_DETECTED);
-    }
-    if ((0 != (enabled & NRF_POWER_INT_USBREMOVED_MASK)) &&
-        nrf_power_event_get_and_clear(NRF_POWER_EVENT_USBREMOVED))
-    {
-        /* Cannot be null if event is enabled */
-        NRFX_ASSERT(m_usbevt_handler != NULL);
-        m_usbevt_handler(NRFX_POWER_USB_EVT_REMOVED);
-    }
-    if ((0 != (enabled & NRF_POWER_INT_USBPWRRDY_MASK)) &&
-        nrf_power_event_get_and_clear(NRF_POWER_EVENT_USBPWRRDY))
-    {
-        /* Cannot be null if event is enabled */
-        NRFX_ASSERT(m_usbevt_handler != NULL);
-        m_usbevt_handler(NRFX_POWER_USB_EVT_READY);
-    }
-#endif
-}
-
-#endif // NRFX_CHECK(NRFX_POWER_ENABLED)
+/*
+ * Copyright (c) 2017 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_POWER_ENABLED)
+
+#include <nrfx_power.h>
+#if defined(REGULATORS_PRESENT)
+#include <hal/nrf_regulators.h>
+#endif
+
+#if NRFX_CHECK(NRFX_CLOCK_ENABLED)
+extern bool nrfx_clock_irq_enabled;
+extern void nrfx_clock_irq_handler(void);
+#endif
+
+/**
+ * @internal
+ * @defgroup nrfx_power_internals POWER driver internals
+ * @ingroup nrfx_power
+ *
+ * Internal variables, auxiliary macros and functions of POWER driver.
+ * @{
+ */
+
+/**
+ * This variable is used to check whether common POWER_CLOCK common interrupt
+ * should be disabled or not if @ref nrfx_clock tries to disable the interrupt.
+ */
+
+bool nrfx_power_irq_enabled;
+
+/**
+ * @brief The initialization flag
+ */
+
+#define m_initialized nrfx_power_irq_enabled
+
+/**
+ * @brief The handler of power fail comparator warning event
+ */
+static nrfx_power_pofwarn_event_handler_t m_pofwarn_handler;
+
+#if NRF_POWER_HAS_SLEEPEVT
+/**
+ * @brief The handler of sleep event handler
+ */
+static nrfx_power_sleep_event_handler_t m_sleepevt_handler;
+#endif
+
+#if NRF_POWER_HAS_USBREG
+/**
+ * @brief The handler of USB power events
+ */
+static nrfx_power_usb_event_handler_t m_usbevt_handler;
+#endif
+
+/** @} */
+
+nrfx_power_pofwarn_event_handler_t nrfx_power_pof_handler_get(void)
+{
+    return m_pofwarn_handler;
+}
+
+#if NRF_POWER_HAS_USBREG
+nrfx_power_usb_event_handler_t nrfx_power_usb_handler_get(void)
+{
+    return m_usbevt_handler;
+}
+#endif
+
+nrfx_err_t nrfx_power_init(nrfx_power_config_t const * p_config)
+{
+    NRFX_ASSERT(p_config);
+    if (m_initialized)
+    {
+        return NRFX_ERROR_ALREADY_INITIALIZED;
+    }
+
+#if NRF_POWER_HAS_VDDH
+    nrf_power_dcdcen_vddh_set(p_config->dcdcenhv);
+#endif
+#if NRF_POWER_HAS_DCDCEN
+    nrf_power_dcdcen_set(p_config->dcdcen);
+#else
+    nrf_regulators_dcdcen_set(NRF_REGULATORS, p_config->dcdcen);
+#endif
+
+    nrfx_power_clock_irq_init();
+
+    m_initialized = true;
+    return NRFX_SUCCESS;
+}
+
+
+void nrfx_power_uninit(void)
+{
+    NRFX_ASSERT(m_initialized);
+
+#if NRFX_CHECK(NRFX_CLOCK_ENABLED)
+    if (!nrfx_clock_irq_enabled)
+#endif
+    {
+        NRFX_IRQ_DISABLE(nrfx_get_irq_number(NRF_POWER));
+    }
+#if NRF_POWER_HAS_POFCON
+    nrfx_power_pof_uninit();
+#endif
+#if NRF_POWER_HAS_SLEEPEVT
+    nrfx_power_sleepevt_uninit();
+#endif
+#if NRF_POWER_HAS_USBREG
+    nrfx_power_usbevt_uninit();
+#endif
+    m_initialized = false;
+}
+
+#if NRF_POWER_HAS_POFCON
+void nrfx_power_pof_init(nrfx_power_pofwarn_config_t const * p_config)
+{
+    NRFX_ASSERT(p_config != NULL);
+
+    nrfx_power_pof_uninit();
+
+    if (p_config->handler != NULL)
+    {
+        m_pofwarn_handler = p_config->handler;
+    }
+}
+
+void nrfx_power_pof_enable(nrfx_power_pofwarn_config_t const * p_config)
+{
+    nrf_power_pofcon_set(true, p_config->thr);
+#if NRF_POWER_HAS_VDDH
+    nrf_power_pofcon_vddh_set(p_config->thrvddh);
+#endif
+    if (m_pofwarn_handler != NULL)
+    {
+        nrf_power_int_enable(NRF_POWER_INT_POFWARN_MASK);
+    }
+}
+
+void nrfx_power_pof_disable(void)
+{
+    nrf_power_pofcon_set(false, NRF_POWER_POFTHR_V27);
+    nrf_power_int_disable(NRF_POWER_INT_POFWARN_MASK);
+}
+
+void nrfx_power_pof_uninit(void)
+{
+    m_pofwarn_handler = NULL;
+}
+#endif // NRF_POWER_HAS_POFCON
+
+#if NRF_POWER_HAS_SLEEPEVT
+void nrfx_power_sleepevt_init(nrfx_power_sleepevt_config_t const * p_config)
+{
+    NRFX_ASSERT(p_config != NULL);
+
+    nrfx_power_sleepevt_uninit();
+    if (p_config->handler != NULL)
+    {
+        m_sleepevt_handler = p_config->handler;
+    }
+}
+
+void nrfx_power_sleepevt_enable(nrfx_power_sleepevt_config_t const * p_config)
+{
+    uint32_t enmask = 0;
+    if (p_config->en_enter)
+    {
+        enmask |= NRF_POWER_INT_SLEEPENTER_MASK;
+        nrf_power_event_clear(NRF_POWER_EVENT_SLEEPENTER);
+    }
+    if (p_config->en_exit)
+    {
+        enmask |= NRF_POWER_INT_SLEEPEXIT_MASK;
+        nrf_power_event_clear(NRF_POWER_EVENT_SLEEPEXIT);
+    }
+    nrf_power_int_enable(enmask);
+}
+
+void nrfx_power_sleepevt_disable(void)
+{
+    nrf_power_int_disable(
+        NRF_POWER_INT_SLEEPENTER_MASK |
+        NRF_POWER_INT_SLEEPEXIT_MASK);
+}
+
+void nrfx_power_sleepevt_uninit(void)
+{
+    m_sleepevt_handler = NULL;
+}
+#endif /* NRF_POWER_HAS_SLEEPEVT */
+
+#if NRF_POWER_HAS_USBREG
+void nrfx_power_usbevt_init(nrfx_power_usbevt_config_t const * p_config)
+{
+    nrfx_power_usbevt_uninit();
+    if (p_config->handler != NULL)
+    {
+        m_usbevt_handler = p_config->handler;
+    }
+}
+
+void nrfx_power_usbevt_enable(void)
+{
+    nrf_power_int_enable(
+        NRF_POWER_INT_USBDETECTED_MASK |
+        NRF_POWER_INT_USBREMOVED_MASK  |
+        NRF_POWER_INT_USBPWRRDY_MASK);
+}
+
+void nrfx_power_usbevt_disable(void)
+{
+    nrf_power_int_disable(
+        NRF_POWER_INT_USBDETECTED_MASK |
+        NRF_POWER_INT_USBREMOVED_MASK  |
+        NRF_POWER_INT_USBPWRRDY_MASK);
+}
+
+void nrfx_power_usbevt_uninit(void)
+{
+    m_usbevt_handler = NULL;
+}
+#endif /* NRF_POWER_HAS_USBREG */
+
+
+void nrfx_power_irq_handler(void)
+{
+    uint32_t enabled = nrf_power_int_enable_get();
+
+#if NRF_POWER_HAS_POFCON
+    if ((0 != (enabled & NRF_POWER_INT_POFWARN_MASK)) &&
+        nrf_power_event_get_and_clear(NRF_POWER_EVENT_POFWARN))
+    {
+        /* Cannot be null if event is enabled */
+        NRFX_ASSERT(m_pofwarn_handler != NULL);
+        m_pofwarn_handler();
+    }
+#endif
+#if NRF_POWER_HAS_SLEEPEVT
+    if ((0 != (enabled & NRF_POWER_INT_SLEEPENTER_MASK)) &&
+        nrf_power_event_get_and_clear(NRF_POWER_EVENT_SLEEPENTER))
+    {
+        /* Cannot be null if event is enabled */
+        NRFX_ASSERT(m_sleepevt_handler != NULL);
+        m_sleepevt_handler(NRFX_POWER_SLEEP_EVT_ENTER);
+    }
+    if ((0 != (enabled & NRF_POWER_INT_SLEEPEXIT_MASK)) &&
+        nrf_power_event_get_and_clear(NRF_POWER_EVENT_SLEEPEXIT))
+    {
+        /* Cannot be null if event is enabled */
+        NRFX_ASSERT(m_sleepevt_handler != NULL);
+        m_sleepevt_handler(NRFX_POWER_SLEEP_EVT_EXIT);
+    }
+#endif
+#if NRF_POWER_HAS_USBREG
+    if ((0 != (enabled & NRF_POWER_INT_USBDETECTED_MASK)) &&
+        nrf_power_event_get_and_clear(NRF_POWER_EVENT_USBDETECTED))
+    {
+        /* Cannot be null if event is enabled */
+        NRFX_ASSERT(m_usbevt_handler != NULL);
+        m_usbevt_handler(NRFX_POWER_USB_EVT_DETECTED);
+    }
+    if ((0 != (enabled & NRF_POWER_INT_USBREMOVED_MASK)) &&
+        nrf_power_event_get_and_clear(NRF_POWER_EVENT_USBREMOVED))
+    {
+        /* Cannot be null if event is enabled */
+        NRFX_ASSERT(m_usbevt_handler != NULL);
+        m_usbevt_handler(NRFX_POWER_USB_EVT_REMOVED);
+    }
+    if ((0 != (enabled & NRF_POWER_INT_USBPWRRDY_MASK)) &&
+        nrf_power_event_get_and_clear(NRF_POWER_EVENT_USBPWRRDY))
+    {
+        /* Cannot be null if event is enabled */
+        NRFX_ASSERT(m_usbevt_handler != NULL);
+        m_usbevt_handler(NRFX_POWER_USB_EVT_READY);
+    }
+#endif
+}
+
+#if NRFX_CHECK(NRFX_CLOCK_ENABLED)
+/*
+ * If both POWER and CLOCK drivers are used, a common IRQ handler function must
+ * be used that calls the handlers in these two drivers. This is because these
+ * two peripherals share one interrupt.
+ * This function is located here, not in a separate nrfx_power_clock.c file,
+ * so that it does not end up as the only symbol in a separate object when
+ * a library with nrfx is created. In such case, forcing a linker to use this
+ * function instead of another one defined as weak will require additional
+ * actions, and might be even impossible.
+ */
+void nrfx_power_clock_irq_handler(void)
+{
+    nrfx_power_irq_handler();
+    nrfx_clock_irq_handler();
+}
+#endif
+
+#endif // NRFX_CHECK(NRFX_POWER_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_power_clock.c

@@ -1,51 +0,0 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-#include <nrfx_power.h>
-#include <nrfx_clock.h>
-
-#if NRFX_CHECK(NRFX_POWER_ENABLED) && NRFX_CHECK(NRFX_CLOCK_ENABLED)
-void nrfx_power_clock_irq_handler(void)
-{
-    nrfx_power_irq_handler();
-    nrfx_clock_irq_handler();
-}
-#endif

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_qdec.c

@@ -1,201 +1,195 @@
-/**
- * Copyright (c) 2015 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_QDEC_ENABLED)
-
-#include <nrfx_qdec.h>
-#include <hal/nrf_gpio.h>
-
-#define NRFX_LOG_MODULE QDEC
-#include <nrfx_log.h>
-
-#define EVT_TO_STR(event)                                             \
-    (event == NRF_QDEC_EVENT_SAMPLERDY ? "NRF_QDEC_EVENT_SAMPLERDY" : \
-    (event == NRF_QDEC_EVENT_REPORTRDY ? "NRF_QDEC_EVENT_REPORTRDY" : \
-    (event == NRF_QDEC_EVENT_ACCOF     ? "NRF_QDEC_EVENT_ACCOF"     : \
-                                         "UNKNOWN EVENT")))
-
-
-static nrfx_qdec_event_handler_t m_qdec_event_handler = NULL;
-static nrfx_drv_state_t m_state = NRFX_DRV_STATE_UNINITIALIZED;
-
-void nrfx_qdec_irq_handler(void)
-{
-    nrfx_qdec_event_t event;
-    if ( nrf_qdec_event_check(NRF_QDEC_EVENT_SAMPLERDY) &&
-         nrf_qdec_int_enable_check(NRF_QDEC_INT_SAMPLERDY_MASK) )
-    {
-        nrf_qdec_event_clear(NRF_QDEC_EVENT_SAMPLERDY);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_QDEC_EVENT_SAMPLERDY));
-
-        event.type = NRF_QDEC_EVENT_SAMPLERDY;
-        event.data.sample.value = (int8_t)nrf_qdec_sample_get();
-        m_qdec_event_handler(event);
-    }
-
-    if ( nrf_qdec_event_check(NRF_QDEC_EVENT_REPORTRDY) &&
-         nrf_qdec_int_enable_check(NRF_QDEC_INT_REPORTRDY_MASK) )
-    {
-        nrf_qdec_event_clear(NRF_QDEC_EVENT_REPORTRDY);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_QDEC_EVENT_REPORTRDY));
-
-        event.type = NRF_QDEC_EVENT_REPORTRDY;
-
-        event.data.report.acc    = (int16_t)nrf_qdec_accread_get();
-        event.data.report.accdbl = (uint16_t)nrf_qdec_accdblread_get();
-        m_qdec_event_handler(event);
-    }
-
-    if ( nrf_qdec_event_check(NRF_QDEC_EVENT_ACCOF) &&
-         nrf_qdec_int_enable_check(NRF_QDEC_INT_ACCOF_MASK) )
-    {
-        nrf_qdec_event_clear(NRF_QDEC_EVENT_ACCOF);
-        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_QDEC_EVENT_ACCOF));
-
-        event.type = NRF_QDEC_EVENT_ACCOF;
-        m_qdec_event_handler(event);
-    }
-}
-
-
-nrfx_err_t nrfx_qdec_init(nrfx_qdec_config_t const * p_config,
-                          nrfx_qdec_event_handler_t  event_handler)
-{
-    NRFX_ASSERT(p_config);
-    NRFX_ASSERT(event_handler);
-    nrfx_err_t err_code;
-
-    if (m_state != NRFX_DRV_STATE_UNINITIALIZED)
-    {
-        err_code = NRFX_ERROR_INVALID_STATE;
-        NRFX_LOG_WARNING("Function: %s, error code: %s.",
-                         __func__,
-                         NRFX_LOG_ERROR_STRING_GET(err_code));
-        return err_code;
-    }
-
-    m_qdec_event_handler = event_handler;
-
-    nrf_qdec_sampleper_set(p_config->sampleper);
-    nrf_gpio_cfg_input(p_config->pselled, NRF_GPIO_PIN_NOPULL);
-    nrf_gpio_cfg_input(p_config->psela, NRF_GPIO_PIN_NOPULL);
-    nrf_gpio_cfg_input(p_config->pselb, NRF_GPIO_PIN_NOPULL);
-    nrf_qdec_pio_assign(p_config->psela, p_config->pselb, p_config->pselled);
-    nrf_qdec_ledpre_set(p_config->ledpre);
-    nrf_qdec_ledpol_set(p_config->ledpol);
-    nrf_qdec_shorts_enable(NRF_QDEC_SHORT_REPORTRDY_READCLRACC_MASK);
-
-    if (p_config->dbfen)
-    {
-        nrf_qdec_dbfen_enable();
-    }
-    else
-    {
-        nrf_qdec_dbfen_disable();
-    }
-
-    uint32_t int_mask = NRF_QDEC_INT_ACCOF_MASK;
-
-    if (p_config->reportper != NRF_QDEC_REPORTPER_DISABLED)
-    {
-        nrf_qdec_reportper_set(p_config->reportper);
-        int_mask |= NRF_QDEC_INT_REPORTRDY_MASK;
-    }
-
-    if (p_config->sample_inten)
-    {
-        int_mask |= NRF_QDEC_INT_SAMPLERDY_MASK;
-    }
-
-    nrf_qdec_int_enable(int_mask);
-    NRFX_IRQ_PRIORITY_SET(QDEC_IRQn, p_config->interrupt_priority);
-    NRFX_IRQ_ENABLE(QDEC_IRQn);
-
-    m_state = NRFX_DRV_STATE_INITIALIZED;
-
-    err_code = NRFX_SUCCESS;
-    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
-    return err_code;
-}
-
-void nrfx_qdec_uninit(void)
-{
-    NRFX_ASSERT(m_state != NRFX_DRV_STATE_UNINITIALIZED);
-    nrfx_qdec_disable();
-    NRFX_IRQ_DISABLE(QDEC_IRQn);
-    m_state = NRFX_DRV_STATE_UNINITIALIZED;
-    NRFX_LOG_INFO("Uninitialized.");
-}
-
-void nrfx_qdec_enable(void)
-{
-    NRFX_ASSERT(m_state == NRFX_DRV_STATE_INITIALIZED);
-    nrf_qdec_enable();
-    nrf_qdec_task_trigger(NRF_QDEC_TASK_START);
-    m_state = NRFX_DRV_STATE_POWERED_ON;
-    NRFX_LOG_INFO("Enabled.");
-}
-
-void nrfx_qdec_disable(void)
-{
-    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
-    nrf_qdec_task_trigger(NRF_QDEC_TASK_STOP);
-    nrf_qdec_disable();
-    m_state = NRFX_DRV_STATE_INITIALIZED;
-    NRFX_LOG_INFO("Disabled.");
-}
-
-void nrfx_qdec_accumulators_read(int16_t * p_acc, int16_t * p_accdbl)
-{
-    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
-    nrf_qdec_task_trigger(NRF_QDEC_TASK_READCLRACC);
-
-    *p_acc    = (int16_t)nrf_qdec_accread_get();
-    *p_accdbl = (int16_t)nrf_qdec_accdblread_get();
-
-    NRFX_LOG_DEBUG("Accumulators data, ACC register:");
-    NRFX_LOG_HEXDUMP_DEBUG((uint8_t *)p_acc, sizeof(p_acc[0]));
-    NRFX_LOG_DEBUG("Accumulators data, ACCDBL register:");
-    NRFX_LOG_HEXDUMP_DEBUG((uint8_t *)p_accdbl, sizeof(p_accdbl[0]));
-}
-
-#endif // NRFX_CHECK(NRFX_QDEC_ENABLED)
+/*
+ * Copyright (c) 2015 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_QDEC_ENABLED)
+
+#include <nrfx_qdec.h>
+#include <hal/nrf_gpio.h>
+
+#define NRFX_LOG_MODULE QDEC
+#include <nrfx_log.h>
+
+#define EVT_TO_STR(event)                                             \
+    (event == NRF_QDEC_EVENT_SAMPLERDY ? "NRF_QDEC_EVENT_SAMPLERDY" : \
+    (event == NRF_QDEC_EVENT_REPORTRDY ? "NRF_QDEC_EVENT_REPORTRDY" : \
+    (event == NRF_QDEC_EVENT_ACCOF     ? "NRF_QDEC_EVENT_ACCOF"     : \
+                                         "UNKNOWN EVENT")))
+
+
+static nrfx_qdec_event_handler_t m_qdec_event_handler = NULL;
+static nrfx_drv_state_t m_state = NRFX_DRV_STATE_UNINITIALIZED;
+
+void nrfx_qdec_irq_handler(void)
+{
+    nrfx_qdec_event_t event;
+    if ( nrf_qdec_event_check(NRF_QDEC_EVENT_SAMPLERDY) &&
+         nrf_qdec_int_enable_check(NRF_QDEC_INT_SAMPLERDY_MASK) )
+    {
+        nrf_qdec_event_clear(NRF_QDEC_EVENT_SAMPLERDY);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_QDEC_EVENT_SAMPLERDY));
+
+        event.type = NRF_QDEC_EVENT_SAMPLERDY;
+        event.data.sample.value = (int8_t)nrf_qdec_sample_get();
+        m_qdec_event_handler(event);
+    }
+
+    if ( nrf_qdec_event_check(NRF_QDEC_EVENT_REPORTRDY) &&
+         nrf_qdec_int_enable_check(NRF_QDEC_INT_REPORTRDY_MASK) )
+    {
+        nrf_qdec_event_clear(NRF_QDEC_EVENT_REPORTRDY);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_QDEC_EVENT_REPORTRDY));
+
+        event.type = NRF_QDEC_EVENT_REPORTRDY;
+
+        event.data.report.acc    = (int16_t)nrf_qdec_accread_get();
+        event.data.report.accdbl = (uint16_t)nrf_qdec_accdblread_get();
+        m_qdec_event_handler(event);
+    }
+
+    if ( nrf_qdec_event_check(NRF_QDEC_EVENT_ACCOF) &&
+         nrf_qdec_int_enable_check(NRF_QDEC_INT_ACCOF_MASK) )
+    {
+        nrf_qdec_event_clear(NRF_QDEC_EVENT_ACCOF);
+        NRFX_LOG_DEBUG("Event: %s.", EVT_TO_STR(NRF_QDEC_EVENT_ACCOF));
+
+        event.type = NRF_QDEC_EVENT_ACCOF;
+        m_qdec_event_handler(event);
+    }
+}
+
+
+nrfx_err_t nrfx_qdec_init(nrfx_qdec_config_t const * p_config,
+                          nrfx_qdec_event_handler_t  event_handler)
+{
+    NRFX_ASSERT(p_config);
+    NRFX_ASSERT(event_handler);
+    nrfx_err_t err_code;
+
+    if (m_state != NRFX_DRV_STATE_UNINITIALIZED)
+    {
+        err_code = NRFX_ERROR_INVALID_STATE;
+        NRFX_LOG_WARNING("Function: %s, error code: %s.",
+                         __func__,
+                         NRFX_LOG_ERROR_STRING_GET(err_code));
+        return err_code;
+    }
+
+    m_qdec_event_handler = event_handler;
+
+    nrf_qdec_sampleper_set(p_config->sampleper);
+    nrf_gpio_cfg_input(p_config->psela, NRF_GPIO_PIN_NOPULL);
+    nrf_gpio_cfg_input(p_config->pselb, NRF_GPIO_PIN_NOPULL);
+    if (p_config->pselled != NRF_QDEC_LED_NOT_CONNECTED)
+    {
+        nrf_gpio_cfg_input(p_config->pselled, NRF_GPIO_PIN_NOPULL);
+        nrf_qdec_ledpre_set(p_config->ledpre);
+        nrf_qdec_ledpol_set(p_config->ledpol);
+    }
+    nrf_qdec_pio_assign(p_config->psela, p_config->pselb, p_config->pselled);
+    nrf_qdec_shorts_enable(NRF_QDEC_SHORT_REPORTRDY_READCLRACC_MASK);
+
+    if (p_config->dbfen)
+    {
+        nrf_qdec_dbfen_enable();
+    }
+    else
+    {
+        nrf_qdec_dbfen_disable();
+    }
+
+    uint32_t int_mask = NRF_QDEC_INT_ACCOF_MASK;
+
+    if (p_config->reportper != NRF_QDEC_REPORTPER_DISABLED)
+    {
+        nrf_qdec_reportper_set(p_config->reportper);
+        int_mask |= NRF_QDEC_INT_REPORTRDY_MASK;
+    }
+
+    if (p_config->sample_inten)
+    {
+        int_mask |= NRF_QDEC_INT_SAMPLERDY_MASK;
+    }
+
+    nrf_qdec_int_enable(int_mask);
+    NRFX_IRQ_PRIORITY_SET(QDEC_IRQn, p_config->interrupt_priority);
+    NRFX_IRQ_ENABLE(QDEC_IRQn);
+
+    m_state = NRFX_DRV_STATE_INITIALIZED;
+
+    err_code = NRFX_SUCCESS;
+    NRFX_LOG_INFO("Function: %s, error code: %s.", __func__, NRFX_LOG_ERROR_STRING_GET(err_code));
+    return err_code;
+}
+
+void nrfx_qdec_uninit(void)
+{
+    NRFX_ASSERT(m_state != NRFX_DRV_STATE_UNINITIALIZED);
+    nrfx_qdec_disable();
+    NRFX_IRQ_DISABLE(QDEC_IRQn);
+    m_state = NRFX_DRV_STATE_UNINITIALIZED;
+    NRFX_LOG_INFO("Uninitialized.");
+}
+
+void nrfx_qdec_enable(void)
+{
+    NRFX_ASSERT(m_state == NRFX_DRV_STATE_INITIALIZED);
+    nrf_qdec_enable();
+    nrf_qdec_task_trigger(NRF_QDEC_TASK_START);
+    m_state = NRFX_DRV_STATE_POWERED_ON;
+    NRFX_LOG_INFO("Enabled.");
+}
+
+void nrfx_qdec_disable(void)
+{
+    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
+    nrf_qdec_task_trigger(NRF_QDEC_TASK_STOP);
+    nrf_qdec_disable();
+    m_state = NRFX_DRV_STATE_INITIALIZED;
+    NRFX_LOG_INFO("Disabled.");
+}
+
+void nrfx_qdec_accumulators_read(int16_t * p_acc, int16_t * p_accdbl)
+{
+    NRFX_ASSERT(m_state == NRFX_DRV_STATE_POWERED_ON);
+    nrf_qdec_task_trigger(NRF_QDEC_TASK_READCLRACC);
+
+    *p_acc    = (int16_t)nrf_qdec_accread_get();
+    *p_accdbl = (int16_t)nrf_qdec_accdblread_get();
+
+    NRFX_LOG_DEBUG("Accumulators data, ACC register:");
+    NRFX_LOG_HEXDUMP_DEBUG((uint8_t *)p_acc, sizeof(p_acc[0]));
+    NRFX_LOG_DEBUG("Accumulators data, ACCDBL register:");
+    NRFX_LOG_HEXDUMP_DEBUG((uint8_t *)p_accdbl, sizeof(p_accdbl[0]));
+}
+
+#endif // NRFX_CHECK(NRFX_QDEC_ENABLED)

third_party/NordicSemiconductor/nrfx/drivers/src/nrfx_qspi.c

@@ -1,337 +1,329 @@
-/**
- * Copyright (c) 2016 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- *    list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- *    Semiconductor ASA integrated circuit in a product or a software update for
- *    such product, must reproduce the above copyright notice, this list of
- *    conditions and the following disclaimer in the documentation and/or other
- *    materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- *    contributors may be used to endorse or promote products derived from this
- *    software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- *    Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- *    engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
-
-#include <nrfx.h>
-
-#if NRFX_CHECK(NRFX_QSPI_ENABLED)
-
-#include <nrfx_qspi.h>
-
-
-/**
- * @brief Command byte used to read status register.
- *
- */
-#define QSPI_STD_CMD_RDSR 0x05
-
-/**
- * @brief Byte used to mask status register and retrieve the write-in-progess bit.
- *
- */
-#define QSPI_MEM_STATUSREG_WIP_Pos 0x01
-
-/**
- * @brief Default time used in timeout function.
- */
-#define QSPI_DEF_WAIT_TIME_US 10
-
-/**
- * @brief Default number of tries in timeout function.
- */
-#define QSPI_DEF_WAIT_ATTEMPTS 100
-
-/**
-  * @brief Control block - driver instance local data.
-  */
-typedef struct
-{
-    nrfx_qspi_handler_t handler;          /**< Handler. */
-    nrfx_drv_state_t    state;            /**< Driver state. */
-    volatile bool       interrupt_driven; /**< Information if the current operation is performed and is interrupt-driven. */
-    void *              p_context;        /**< Driver context used in interrupt. */
-} qspi_control_block_t;
-
-static qspi_control_block_t m_cb;
-
-static nrfx_err_t qspi_task_perform(nrf_qspi_task_t task)
-{
-    // Wait for peripheral
-    if (m_cb.interrupt_driven)
-    {
-        return NRFX_ERROR_BUSY;
-    }
-
-    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
-
-    if (m_cb.handler)
-    {
-        m_cb.interrupt_driven = true;
-        nrf_qspi_int_enable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
-    }
-
-    nrf_qspi_task_trigger(NRF_QSPI, task);
-
-    if (m_cb.handler == NULL)
-    {
-        while (!nrf_qspi_event_check(NRF_QSPI, NRF_QSPI_EVENT_READY))
-        {};
-    }
-    return NRFX_SUCCESS;
-}
-
-static bool qspi_pins_configure(nrf_qspi_pins_t const * p_config)
-{
-    // Check if the user set meaningful values to struct fields. If not, return false.
-    if ((p_config->sck_pin == NRF_QSPI_PIN_NOT_CONNECTED) ||
-        (p_config->csn_pin == NRF_QSPI_PIN_NOT_CONNECTED) ||
-        (p_config->io0_pin == NRF_QSPI_PIN_NOT_CONNECTED) ||
-        (p_config->io1_pin == NRF_QSPI_PIN_NOT_CONNECTED))
-    {
-        return false;
-    }
-
-    nrf_qspi_pins_set(NRF_QSPI, p_config);
-
-    return true;
-}
-
-nrfx_err_t nrfx_qspi_init(nrfx_qspi_config_t const * p_config,
-                          nrfx_qspi_handler_t        handler,
-                          void *                     p_context)
-{
-    NRFX_ASSERT(p_config);
-    if (m_cb.state != NRFX_DRV_STATE_UNINITIALIZED)
-    {
-        return NRFX_ERROR_INVALID_STATE;
-    }
-
-    if (!qspi_pins_configure(&p_config->pins))
-    {
-        return NRFX_ERROR_INVALID_PARAM;
-    }
-
-    nrf_qspi_xip_offset_set(NRF_QSPI, p_config->xip_offset);
-    nrf_qspi_ifconfig0_set(NRF_QSPI, &p_config->prot_if);
-    nrf_qspi_ifconfig1_set(NRF_QSPI, &p_config->phy_if);
-
-    m_cb.interrupt_driven = false;
-    m_cb.handler = handler;
-    m_cb.p_context = p_context;
-
-    /* QSPI interrupt is disabled because the device should be enabled in polling mode (wait for activate
-       task event ready)*/
-    nrf_qspi_int_disable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
-
-    if (handler)
-    {
-        NRFX_IRQ_PRIORITY_SET(QSPI_IRQn, p_config->irq_priority);
-        NRFX_IRQ_ENABLE(QSPI_IRQn);
-    }
-
-    m_cb.state = NRFX_DRV_STATE_INITIALIZED;
-
-    nrf_qspi_enable(NRF_QSPI);
-
-    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
-    nrf_qspi_task_trigger(NRF_QSPI, NRF_QSPI_TASK_ACTIVATE);
-
-    // Waiting for the peripheral to activate
-    bool result;
-    NRFX_WAIT_FOR(nrf_qspi_event_check(NRF_QSPI, NRF_QSPI_EVENT_READY),
-                  QSPI_DEF_WAIT_ATTEMPTS,
-                  QSPI_DEF_WAIT_TIME_US,
-                  result);
-
-    if (!result)
-    {
-        return NRFX_ERROR_TIMEOUT;
-    }
-
-    return NRFX_SUCCESS;
-}
-
-nrfx_err_t nrfx_qspi_cinstr_xfer(nrf_qspi_cinstr_conf_t const * p_config,
-                                 void const *                   p_tx_buffer,
-                                 void *                         p_rx_buffer)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-
-    if (m_cb.interrupt_driven)
-    {
-        return NRFX_ERROR_BUSY;
-    }
-
-    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
-    /* In some cases, only opcode should be sent. To prevent execution, set function code is
-     * surrounded by an if.
-     */
-    if (p_tx_buffer)
-    {
-        nrf_qspi_cinstrdata_set(NRF_QSPI, p_config->length, p_tx_buffer);
-    }
-    nrf_qspi_int_disable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
-
-    nrf_qspi_cinstr_transfer_start(NRF_QSPI, p_config);
-
-    bool result;
-    NRFX_WAIT_FOR(nrf_qspi_event_check(NRF_QSPI, NRF_QSPI_EVENT_READY),
-                  QSPI_DEF_WAIT_ATTEMPTS,
-                  QSPI_DEF_WAIT_TIME_US,
-                  result);
-
-    if (!result)
-    {
-        // This timeout should never occur when WIPWAIT is not active, since in this
-        // case the QSPI peripheral should send the command immediately, without any
-        // waiting for previous write to complete.
-        NRFX_ASSERT(p_config->wipwait);
-
-        return NRFX_ERROR_TIMEOUT;
-    }
-    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
-    nrf_qspi_int_enable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
-
-    if (p_rx_buffer)
-    {
-        nrf_qspi_cinstrdata_get(NRF_QSPI, p_config->length, p_rx_buffer);
-    }
-
-    return NRFX_SUCCESS;
-}
-
-nrfx_err_t nrfx_qspi_cinstr_quick_send(uint8_t               opcode,
-                                       nrf_qspi_cinstr_len_t length,
-                                       void const *          p_tx_buffer)
-{
-    nrf_qspi_cinstr_conf_t config = NRFX_QSPI_DEFAULT_CINSTR(opcode, length);
-    return nrfx_qspi_cinstr_xfer(&config, p_tx_buffer, NULL);
-}
-
-nrfx_err_t nrfx_qspi_mem_busy_check(void)
-{
-    nrfx_err_t ret_code;
-    uint8_t status_value = 0;
-
-    nrf_qspi_cinstr_conf_t const config =
-        NRFX_QSPI_DEFAULT_CINSTR(QSPI_STD_CMD_RDSR,
-                                 NRF_QSPI_CINSTR_LEN_2B);
-    ret_code = nrfx_qspi_cinstr_xfer(&config, &status_value, &status_value);
-
-    if (ret_code != NRFX_SUCCESS)
-    {
-        return ret_code;
-    }
-
-    if ((status_value & QSPI_MEM_STATUSREG_WIP_Pos) != 0x00)
-    {
-        return NRFX_ERROR_BUSY;
-    }
-
-    return NRFX_SUCCESS;
-}
-
-void nrfx_qspi_uninit(void)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-
-    nrf_qspi_int_disable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
-
-    nrf_qspi_task_trigger(NRF_QSPI, NRF_QSPI_TASK_DEACTIVATE);
-
-    // Workaround for nRF52840 anomaly 122: Current consumption is too high.
-    *(volatile uint32_t *)0x40029054ul = 1ul;
-
-    nrf_qspi_disable(NRF_QSPI);
-
-    NRFX_IRQ_DISABLE(QSPI_IRQn);
-
-    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
-
-    m_cb.state = NRFX_DRV_STATE_UNINITIALIZED;
-}
-
-nrfx_err_t nrfx_qspi_write(void const * p_tx_buffer,
-                           size_t       tx_buffer_length,
-                           uint32_t     dst_address)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-    NRFX_ASSERT(p_tx_buffer != NULL);
-
-    if (!nrfx_is_in_ram(p_tx_buffer))
-    {
-        return NRFX_ERROR_INVALID_ADDR;
-    }
-
-    nrf_qspi_write_buffer_set(NRF_QSPI, p_tx_buffer, tx_buffer_length, dst_address);
-    return qspi_task_perform(NRF_QSPI_TASK_WRITESTART);
-
-}
-
-nrfx_err_t nrfx_qspi_read(void *   p_rx_buffer,
-                          size_t   rx_buffer_length,
-                          uint32_t src_address)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-    NRFX_ASSERT(p_rx_buffer != NULL);
-
-    if (!nrfx_is_in_ram(p_rx_buffer))
-    {
-        return NRFX_ERROR_INVALID_ADDR;
-    }
-
-    nrf_qspi_read_buffer_set(NRF_QSPI, p_rx_buffer, rx_buffer_length, src_address);
-    return qspi_task_perform(NRF_QSPI_TASK_READSTART);
-}
-
-nrfx_err_t nrfx_qspi_erase(nrf_qspi_erase_len_t length,
-                           uint32_t             start_address)
-{
-    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
-    nrf_qspi_erase_ptr_set(NRF_QSPI, start_address, length);
-    return qspi_task_perform(NRF_QSPI_TASK_ERASESTART);
-}
-
-nrfx_err_t nrfx_qspi_chip_erase(void)
-{
-    return nrfx_qspi_erase(NRF_QSPI_ERASE_LEN_ALL, 0);
-}
-
-void nrfx_qspi_irq_handler(void)
-{
-    // Catch Event ready interrupts
-    if (nrf_qspi_event_check(NRF_QSPI, NRF_QSPI_EVENT_READY))
-    {
-        m_cb.interrupt_driven = false;
-        nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
-        m_cb.handler(NRFX_QSPI_EVENT_DONE, m_cb.p_context);
-    }
-}
-
-#endif // NRFX_CHECK(NRFX_QSPI_ENABLED)
+/*
+ * Copyright (c) 2016 - 2019, Nordic Semiconductor ASA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from this
+ *    software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <nrfx.h>
+
+#if NRFX_CHECK(NRFX_QSPI_ENABLED)
+
+#include <nrfx_qspi.h>
+
+
+/**
+ * @brief Command byte used to read status register.
+ *
+ */
+#define QSPI_STD_CMD_RDSR 0x05
+
+/**
+ * @brief Byte used to mask status register and retrieve the write-in-progess bit.
+ *
+ */
+#define QSPI_MEM_STATUSREG_WIP_Pos 0x01
+
+/**
+ * @brief Default time used in timeout function.
+ */
+#define QSPI_DEF_WAIT_TIME_US 10
+
+/**
+ * @brief Default number of tries in timeout function.
+ */
+#define QSPI_DEF_WAIT_ATTEMPTS 100
+
+/**
+  * @brief Control block - driver instance local data.
+  */
+typedef struct
+{
+    nrfx_qspi_handler_t handler;          /**< Handler. */
+    nrfx_drv_state_t    state;            /**< Driver state. */
+    volatile bool       interrupt_driven; /**< Information if the current operation is performed and is interrupt-driven. */
+    void *              p_context;        /**< Driver context used in interrupt. */
+} qspi_control_block_t;
+
+static qspi_control_block_t m_cb;
+
+static nrfx_err_t qspi_task_perform(nrf_qspi_task_t task)
+{
+    // Wait for peripheral
+    if (m_cb.interrupt_driven)
+    {
+        return NRFX_ERROR_BUSY;
+    }
+
+    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
+
+    if (m_cb.handler)
+    {
+        m_cb.interrupt_driven = true;
+        nrf_qspi_int_enable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
+    }
+
+    nrf_qspi_task_trigger(NRF_QSPI, task);
+
+    if (m_cb.handler == NULL)
+    {
+        while (!nrf_qspi_event_check(NRF_QSPI, NRF_QSPI_EVENT_READY))
+        {};
+    }
+    return NRFX_SUCCESS;
+}
+
+static bool qspi_pins_configure(nrf_qspi_pins_t const * p_config)
+{
+    // Check if the user set meaningful values to struct fields. If not, return false.
+    if ((p_config->sck_pin == NRF_QSPI_PIN_NOT_CONNECTED) ||
+        (p_config->csn_pin == NRF_QSPI_PIN_NOT_CONNECTED) ||
+        (p_config->io0_pin == NRF_QSPI_PIN_NOT_CONNECTED) ||
+        (p_config->io1_pin == NRF_QSPI_PIN_NOT_CONNECTED))
+    {
+        return false;
+    }
+
+    nrf_qspi_pins_set(NRF_QSPI, p_config);
+
+    return true;
+}
+
+nrfx_err_t nrfx_qspi_init(nrfx_qspi_config_t const * p_config,
+                          nrfx_qspi_handler_t        handler,
+                          void *                     p_context)
+{
+    NRFX_ASSERT(p_config);
+    if (m_cb.state != NRFX_DRV_STATE_UNINITIALIZED)
+    {
+        return NRFX_ERROR_INVALID_STATE;
+    }
+
+    if (!qspi_pins_configure(&p_config->pins))
+    {
+        return NRFX_ERROR_INVALID_PARAM;
+    }
+
+    nrf_qspi_xip_offset_set(NRF_QSPI, p_config->xip_offset);
+    nrf_qspi_ifconfig0_set(NRF_QSPI, &p_config->prot_if);
+    nrf_qspi_ifconfig1_set(NRF_QSPI, &p_config->phy_if);
+
+    m_cb.interrupt_driven = false;
+    m_cb.handler = handler;
+    m_cb.p_context = p_context;
+
+    /* QSPI interrupt is disabled because the device should be enabled in polling mode (wait for activate
+       task event ready)*/
+    nrf_qspi_int_disable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
+
+    if (handler)
+    {
+        NRFX_IRQ_PRIORITY_SET(QSPI_IRQn, p_config->irq_priority);
+        NRFX_IRQ_ENABLE(QSPI_IRQn);
+    }
+
+    m_cb.state = NRFX_DRV_STATE_INITIALIZED;
+
+    nrf_qspi_enable(NRF_QSPI);
+
+    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
+    nrf_qspi_task_trigger(NRF_QSPI, NRF_QSPI_TASK_ACTIVATE);
+
+    // Waiting for the peripheral to activate
+    bool result;
+    NRFX_WAIT_FOR(nrf_qspi_event_check(NRF_QSPI, NRF_QSPI_EVENT_READY),
+                  QSPI_DEF_WAIT_ATTEMPTS,
+                  QSPI_DEF_WAIT_TIME_US,
+                  result);
+
+    if (!result)
+    {
+        return NRFX_ERROR_TIMEOUT;
+    }
+
+    return NRFX_SUCCESS;
+}
+
+nrfx_err_t nrfx_qspi_cinstr_xfer(nrf_qspi_cinstr_conf_t const * p_config,
+                                 void const *                   p_tx_buffer,
+                                 void *                         p_rx_buffer)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+
+    if (m_cb.interrupt_driven)
+    {
+        return NRFX_ERROR_BUSY;
+    }
+
+    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
+    /* In some cases, only opcode should be sent. To prevent execution, set function code is
+     * surrounded by an if.
+     */
+    if (p_tx_buffer)
+    {
+        nrf_qspi_cinstrdata_set(NRF_QSPI, p_config->length, p_tx_buffer);
+    }
+    nrf_qspi_int_disable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
+
+    nrf_qspi_cinstr_transfer_start(NRF_QSPI, p_config);
+
+    bool result;
+    NRFX_WAIT_FOR(nrf_qspi_event_check(NRF_QSPI, NRF_QSPI_EVENT_READY),
+                  QSPI_DEF_WAIT_ATTEMPTS,
+                  QSPI_DEF_WAIT_TIME_US,
+                  result);
+
+    if (!result)
+    {
+        // This timeout should never occur when WIPWAIT is not active, since in this
+        // case the QSPI peripheral should send the command immediately, without any
+        // waiting for previous write to complete.
+        NRFX_ASSERT(p_config->wipwait);
+
+        return NRFX_ERROR_TIMEOUT;
+    }
+    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
+    nrf_qspi_int_enable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
+
+    if (p_rx_buffer)
+    {
+        nrf_qspi_cinstrdata_get(NRF_QSPI, p_config->length, p_rx_buffer);
+    }
+
+    return NRFX_SUCCESS;
+}
+
+nrfx_err_t nrfx_qspi_cinstr_quick_send(uint8_t               opcode,
+                                       nrf_qspi_cinstr_len_t length,
+                                       void const *          p_tx_buffer)
+{
+    nrf_qspi_cinstr_conf_t config = NRFX_QSPI_DEFAULT_CINSTR(opcode, length);
+    return nrfx_qspi_cinstr_xfer(&config, p_tx_buffer, NULL);
+}
+
+nrfx_err_t nrfx_qspi_mem_busy_check(void)
+{
+    nrfx_err_t ret_code;
+    uint8_t status_value = 0;
+
+    nrf_qspi_cinstr_conf_t const config =
+        NRFX_QSPI_DEFAULT_CINSTR(QSPI_STD_CMD_RDSR,
+                                 NRF_QSPI_CINSTR_LEN_2B);
+    ret_code = nrfx_qspi_cinstr_xfer(&config, &status_value, &status_value);
+
+    if (ret_code != NRFX_SUCCESS)
+    {
+        return ret_code;
+    }
+
+    if ((status_value & QSPI_MEM_STATUSREG_WIP_Pos) != 0x00)
+    {
+        return NRFX_ERROR_BUSY;
+    }
+
+    return NRFX_SUCCESS;
+}
+
+void nrfx_qspi_uninit(void)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+
+    nrf_qspi_int_disable(NRF_QSPI, NRF_QSPI_INT_READY_MASK);
+
+    nrf_qspi_task_trigger(NRF_QSPI, NRF_QSPI_TASK_DEACTIVATE);
+
+    nrf_qspi_disable(NRF_QSPI);
+
+    NRFX_IRQ_DISABLE(QSPI_IRQn);
+
+    nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
+
+    m_cb.state = NRFX_DRV_STATE_UNINITIALIZED;
+}
+
+nrfx_err_t nrfx_qspi_write(void const * p_tx_buffer,
+                           size_t       tx_buffer_length,
+                           uint32_t     dst_address)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+    NRFX_ASSERT(p_tx_buffer != NULL);
+    NRFX_ASSERT(nrfx_is_in_ram(p_tx_buffer));
+    NRFX_ASSERT(nrfx_is_word_aligned(p_tx_buffer));
+
+    if (!nrfx_is_in_ram(p_tx_buffer))
+    {
+        return NRFX_ERROR_INVALID_ADDR;
+    }
+
+    nrf_qspi_write_buffer_set(NRF_QSPI, p_tx_buffer, tx_buffer_length, dst_address);
+    return qspi_task_perform(NRF_QSPI_TASK_WRITESTART);
+
+}
+
+nrfx_err_t nrfx_qspi_read(void *   p_rx_buffer,
+                          size_t   rx_buffer_length,
+                          uint32_t src_address)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+    NRFX_ASSERT(p_rx_buffer != NULL);
+    NRFX_ASSERT(nrfx_is_in_ram(p_rx_buffer));
+    NRFX_ASSERT(nrfx_is_word_aligned(p_rx_buffer));
+
+    if (!nrfx_is_in_ram(p_rx_buffer))
+    {
+        return NRFX_ERROR_INVALID_ADDR;
+    }
+
+    nrf_qspi_read_buffer_set(NRF_QSPI, p_rx_buffer, rx_buffer_length, src_address);
+    return qspi_task_perform(NRF_QSPI_TASK_READSTART);
+}
+
+nrfx_err_t nrfx_qspi_erase(nrf_qspi_erase_len_t length,
+                           uint32_t             start_address)
+{
+    NRFX_ASSERT(m_cb.state != NRFX_DRV_STATE_UNINITIALIZED);
+    nrf_qspi_erase_ptr_set(NRF_QSPI, start_address, length);
+    return qspi_task_perform(NRF_QSPI_TASK_ERASESTART);
+}
+
+nrfx_err_t nrfx_qspi_chip_erase(void)
+{
+    return nrfx_qspi_erase(NRF_QSPI_ERASE_LEN_ALL, 0);
+}
+
+void nrfx_qspi_irq_handler(void)
+{
+    // Catch Event ready interrupts
+    if (nrf_qspi_event_check(NRF_QSPI, NRF_QSPI_EVENT_READY))
+    {
+        m_cb.interrupt_driven = false;
+        nrf_qspi_event_clear(NRF_QSPI, NRF_QSPI_EVENT_READY);
+        m_cb.handler(NRFX_QSPI_EVENT_DONE, m_cb.p_context);
+    }
+}
+
+#endif // NRFX_CHECK(NRFX_QSPI_ENABLED)