anyThing Connected Team / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   BREAK_SENSOR_LED

Fork of mbed-dev by mbed official

targets/TARGET_NORDIC/TARGET_NRF5/TARGET_SDK11/drivers_nrf/hal/nrf_pdm.h@180:d79f997829d6, 2017-12-18 (annotated)

Committer:
Anythingconnected
Date:
Mon Dec 18 10:14:27 2017 +0000
Revision:
180:d79f997829d6
Parent:
165:e614a9f1c9e2 
Getting byte by byte read to work

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /*
<> 144:ef7eb2e8f9f7 2 * Copyright (c) 2015 Nordic Semiconductor ASA
<> 144:ef7eb2e8f9f7 3 * All rights reserved.
<> 144:ef7eb2e8f9f7 4 *
<> 144:ef7eb2e8f9f7 5 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 6 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 7 *
<> 144:ef7eb2e8f9f7 8 * 1. Redistributions of source code must retain the above copyright notice, this list
<> 144:ef7eb2e8f9f7 9 * of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 10 *
<> 144:ef7eb2e8f9f7 11 * 2. Redistributions in binary form, except as embedded into a Nordic Semiconductor ASA
<> 144:ef7eb2e8f9f7 12 * integrated circuit in a product or a software update for such product, must reproduce
<> 144:ef7eb2e8f9f7 13 * the above copyright notice, this list of conditions and the following disclaimer in
<> 144:ef7eb2e8f9f7 14 * the documentation and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 15 *
<> 144:ef7eb2e8f9f7 16 * 3. Neither the name of Nordic Semiconductor ASA nor the names of its contributors may be
<> 144:ef7eb2e8f9f7 17 * used to endorse or promote products derived from this software without specific prior
<> 144:ef7eb2e8f9f7 18 * written permission.
<> 144:ef7eb2e8f9f7 19 *
<> 144:ef7eb2e8f9f7 20 * 4. This software, with or without modification, must only be used with a
<> 144:ef7eb2e8f9f7 21 * Nordic Semiconductor ASA integrated circuit.
<> 144:ef7eb2e8f9f7 22 *
<> 144:ef7eb2e8f9f7 23 * 5. Any software provided in binary or object form under this license must not be reverse
<> 144:ef7eb2e8f9f7 24 * engineered, decompiled, modified and/or disassembled.
<> 144:ef7eb2e8f9f7 25 *
<> 144:ef7eb2e8f9f7 26 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
<> 144:ef7eb2e8f9f7 27 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
<> 144:ef7eb2e8f9f7 28 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 29 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
<> 144:ef7eb2e8f9f7 30 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
<> 144:ef7eb2e8f9f7 31 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
<> 144:ef7eb2e8f9f7 32 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
<> 144:ef7eb2e8f9f7 33 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
<> 144:ef7eb2e8f9f7 34 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
<> 144:ef7eb2e8f9f7 35 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 36 *
<> 144:ef7eb2e8f9f7 37 */
<> 144:ef7eb2e8f9f7 38
<> 144:ef7eb2e8f9f7 39
<> 144:ef7eb2e8f9f7 40
<> 144:ef7eb2e8f9f7 41 #ifndef NRF_PDM_H_
<> 144:ef7eb2e8f9f7 42 #define NRF_PDM_H_
<> 144:ef7eb2e8f9f7 43
<> 144:ef7eb2e8f9f7 44 /**
<> 144:ef7eb2e8f9f7 45 * @defgroup nrf_pdm_hal PDM HAL
<> 144:ef7eb2e8f9f7 46 * @{
<> 144:ef7eb2e8f9f7 47 * @ingroup nrf_pdm
<> 144:ef7eb2e8f9f7 48 *
<> 144:ef7eb2e8f9f7 49 * @brief @tagAPI52 Hardware abstraction layer for accessing the pulse density modulation (PDM) peripheral.
<> 144:ef7eb2e8f9f7 50 */
<> 144:ef7eb2e8f9f7 51
<> 144:ef7eb2e8f9f7 52 #include <stdbool.h>
<> 144:ef7eb2e8f9f7 53 #include <stddef.h>
<> 144:ef7eb2e8f9f7 54 #include "nrf.h"
<> 144:ef7eb2e8f9f7 55 #include "nrf_assert.h"
<> 144:ef7eb2e8f9f7 56
<> 144:ef7eb2e8f9f7 57
<> 144:ef7eb2e8f9f7 58 #define NRF_PDM_GAIN_MINIMUM 0x00
<> 144:ef7eb2e8f9f7 59 #define NRF_PDM_GAIN_DEFAULT 0x28
<> 144:ef7eb2e8f9f7 60 #define NRF_PDM_GAIN_MAXIMUM 0x50
<> 144:ef7eb2e8f9f7 61
<> 144:ef7eb2e8f9f7 62 typedef uint8_t nrf_pdm_gain_t;
<> 144:ef7eb2e8f9f7 63
<> 144:ef7eb2e8f9f7 64
<> 144:ef7eb2e8f9f7 65 /**
<> 144:ef7eb2e8f9f7 66 * @brief PDM tasks.
<> 144:ef7eb2e8f9f7 67 */
<> 144:ef7eb2e8f9f7 68 typedef enum /*lint -save -e30 -esym(628,__INTADDR__) */
<> 144:ef7eb2e8f9f7 69 {
<> 144:ef7eb2e8f9f7 70 NRF_PDM_TASK_START = offsetof(NRF_PDM_Type, TASKS_START), ///< Starts continuous PDM transfer.
<> 144:ef7eb2e8f9f7 71 NRF_PDM_TASK_STOP = offsetof(NRF_PDM_Type, TASKS_STOP) ///< Stops PDM transfer.
<> 144:ef7eb2e8f9f7 72 } nrf_pdm_task_t;
<> 144:ef7eb2e8f9f7 73
<> 144:ef7eb2e8f9f7 74
<> 144:ef7eb2e8f9f7 75 /**
<> 144:ef7eb2e8f9f7 76 * @brief PDM events.
<> 144:ef7eb2e8f9f7 77 */
<> 144:ef7eb2e8f9f7 78 typedef enum /*lint -save -e30 -esym(628,__INTADDR__) */
<> 144:ef7eb2e8f9f7 79 {
<> 144:ef7eb2e8f9f7 80 NRF_PDM_EVENT_STARTED = offsetof(NRF_PDM_Type, EVENTS_STARTED), ///< PDM transfer has started.
<> 144:ef7eb2e8f9f7 81 NRF_PDM_EVENT_STOPPED = offsetof(NRF_PDM_Type, EVENTS_STOPPED), ///< PDM transfer has finished.
<> 144:ef7eb2e8f9f7 82 NRF_PDM_EVENT_END = offsetof(NRF_PDM_Type, EVENTS_END) ///< The PDM has written the last sample specified by SAMPLE.MAXCNT (or the last sample after a STOP task has been received) to Data RAM.
<> 144:ef7eb2e8f9f7 83 } nrf_pdm_event_t;
<> 144:ef7eb2e8f9f7 84
<> 144:ef7eb2e8f9f7 85
<> 144:ef7eb2e8f9f7 86 /**
<> 144:ef7eb2e8f9f7 87 * @brief PDM interrupt masks.
<> 144:ef7eb2e8f9f7 88 */
<> 144:ef7eb2e8f9f7 89 typedef enum
<> 144:ef7eb2e8f9f7 90 {
<> 144:ef7eb2e8f9f7 91 NRF_PDM_INT_STARTED = PDM_INTENSET_STARTED_Msk, ///< Interrupt on EVENTS_STARTED event.
<> 144:ef7eb2e8f9f7 92 NRF_PDM_INT_STOPPED = PDM_INTENSET_STOPPED_Msk, ///< Interrupt on EVENTS_STOPPED event.
<> 144:ef7eb2e8f9f7 93 NRF_PDM_INT_END = PDM_INTENSET_END_Msk ///< Interrupt on EVENTS_END event.
<> 144:ef7eb2e8f9f7 94 } nrf_pdm_int_mask_t;
<> 144:ef7eb2e8f9f7 95
<> 144:ef7eb2e8f9f7 96 /**
<> 144:ef7eb2e8f9f7 97 * @brief PDM clock frequency.
<> 144:ef7eb2e8f9f7 98 */
<> 144:ef7eb2e8f9f7 99 typedef enum
<> 144:ef7eb2e8f9f7 100 {
<> 144:ef7eb2e8f9f7 101 NRF_PDM_FREQ_1000K = PDM_PDMCLKCTRL_FREQ_1000K, ///< PDM_CLK = 1.000 MHz.
<> 144:ef7eb2e8f9f7 102 NRF_PDM_FREQ_1032K = PDM_PDMCLKCTRL_FREQ_Default, ///< PDM_CLK = 1.032 MHz.
<> 144:ef7eb2e8f9f7 103 NRF_PDM_FREQ_1067K = PDM_PDMCLKCTRL_FREQ_1067K ///< PDM_CLK = 1.067 MHz.
<> 144:ef7eb2e8f9f7 104 } nrf_pdm_freq_t;
<> 144:ef7eb2e8f9f7 105
<> 144:ef7eb2e8f9f7 106
<> 144:ef7eb2e8f9f7 107 /**
<> 144:ef7eb2e8f9f7 108 * @brief PDM operation mode.
<> 144:ef7eb2e8f9f7 109 */
<> 144:ef7eb2e8f9f7 110 typedef enum
<> 144:ef7eb2e8f9f7 111 {
<> 144:ef7eb2e8f9f7 112 NRF_PDM_MODE_STEREO = PDM_MODE_OPERATION_Stereo, ///< Sample and store one pair (Left + Right) of 16-bit samples per RAM word.
<> 144:ef7eb2e8f9f7 113 NRF_PDM_MODE_MONO = PDM_MODE_OPERATION_Mono ///< Sample and store two successive Left samples (16 bit each) per RAM word.
<> 144:ef7eb2e8f9f7 114 } nrf_pdm_mode_t;
<> 144:ef7eb2e8f9f7 115
<> 144:ef7eb2e8f9f7 116
<> 144:ef7eb2e8f9f7 117 /**
<> 144:ef7eb2e8f9f7 118 * @brief PDM sampling mode.
<> 144:ef7eb2e8f9f7 119 */
<> 144:ef7eb2e8f9f7 120 typedef enum
<> 144:ef7eb2e8f9f7 121 {
<> 144:ef7eb2e8f9f7 122 NRF_PDM_EDGE_LEFTFALLING = PDM_MODE_EDGE_LeftFalling, ///< Left (or mono) is sampled on falling edge of PDM_CLK.
<> 144:ef7eb2e8f9f7 123 NRF_PDM_EDGE_LEFTRISING = PDM_MODE_EDGE_LeftRising ///< Left (or mono) is sampled on rising edge of PDM_CLK.
<> 144:ef7eb2e8f9f7 124 } nrf_pdm_edge_t;
<> 144:ef7eb2e8f9f7 125
<> 144:ef7eb2e8f9f7 126
<> 144:ef7eb2e8f9f7 127 /**
<> 144:ef7eb2e8f9f7 128 * @brief Function for triggering a PDM task.
<> 144:ef7eb2e8f9f7 129 *
<> 144:ef7eb2e8f9f7 130 * @param[in] pdm_task PDM task.
<> 144:ef7eb2e8f9f7 131 */
<> 144:ef7eb2e8f9f7 132 __STATIC_INLINE void nrf_pdm_task_trigger(nrf_pdm_task_t pdm_task)
<> 144:ef7eb2e8f9f7 133 {
<> 144:ef7eb2e8f9f7 134 *((volatile uint32_t *)((uint8_t *)NRF_PDM + (uint32_t)pdm_task)) = 0x1UL;
<> 144:ef7eb2e8f9f7 135 }
<> 144:ef7eb2e8f9f7 136
<> 144:ef7eb2e8f9f7 137
<> 144:ef7eb2e8f9f7 138 /**
<> 144:ef7eb2e8f9f7 139 * @brief Function for getting the address of a PDM task register.
<> 144:ef7eb2e8f9f7 140 *
<> 144:ef7eb2e8f9f7 141 * @param[in] pdm_task PDM task.
<> 144:ef7eb2e8f9f7 142 *
<> 144:ef7eb2e8f9f7 143 * @return Address of the specified PDM task.
<> 144:ef7eb2e8f9f7 144 */
<> 144:ef7eb2e8f9f7 145 __STATIC_INLINE uint32_t nrf_pdm_task_address_get(nrf_pdm_task_t pdm_task)
<> 144:ef7eb2e8f9f7 146 {
<> 144:ef7eb2e8f9f7 147 return (uint32_t)((uint8_t *)NRF_PDM + (uint32_t)pdm_task);
<> 144:ef7eb2e8f9f7 148 }
<> 144:ef7eb2e8f9f7 149
<> 144:ef7eb2e8f9f7 150
<> 144:ef7eb2e8f9f7 151 /**
<> 144:ef7eb2e8f9f7 152 * @brief Function for getting the state of a PDM event.
<> 144:ef7eb2e8f9f7 153 *
<> 144:ef7eb2e8f9f7 154 * @param[in] pdm_event PDM event.
<> 144:ef7eb2e8f9f7 155 *
<> 144:ef7eb2e8f9f7 156 * @return State of the specified PDM event.
<> 144:ef7eb2e8f9f7 157 */
<> 144:ef7eb2e8f9f7 158 __STATIC_INLINE bool nrf_pdm_event_check(nrf_pdm_event_t pdm_event)
<> 144:ef7eb2e8f9f7 159 {
<> 144:ef7eb2e8f9f7 160 return (bool)*(volatile uint32_t *)((uint8_t *)NRF_PDM + (uint32_t)pdm_event);
<> 144:ef7eb2e8f9f7 161 }
<> 144:ef7eb2e8f9f7 162
<> 144:ef7eb2e8f9f7 163
<> 144:ef7eb2e8f9f7 164 /**
<> 144:ef7eb2e8f9f7 165 * @brief Function for clearing a PDM event.
<> 144:ef7eb2e8f9f7 166 *
<> 144:ef7eb2e8f9f7 167 * @param[in] pdm_event PDM event.
<> 144:ef7eb2e8f9f7 168 */
<> 144:ef7eb2e8f9f7 169 __STATIC_INLINE void nrf_pdm_event_clear(nrf_pdm_event_t pdm_event)
<> 144:ef7eb2e8f9f7 170 {
<> 144:ef7eb2e8f9f7 171 *((volatile uint32_t *)((uint8_t *)NRF_PDM + (uint32_t)pdm_event)) = 0x0UL;
<> 144:ef7eb2e8f9f7 172 }
<> 144:ef7eb2e8f9f7 173
<> 144:ef7eb2e8f9f7 174
<> 144:ef7eb2e8f9f7 175 /**
<> 144:ef7eb2e8f9f7 176 * @brief Function for getting the address of a PDM event register.
<> 144:ef7eb2e8f9f7 177 *
<> 144:ef7eb2e8f9f7 178 * @param[in] pdm_event PDM event.
<> 144:ef7eb2e8f9f7 179 *
<> 144:ef7eb2e8f9f7 180 * @return Address of the specified PDM event.
<> 144:ef7eb2e8f9f7 181 */
<> 144:ef7eb2e8f9f7 182 __STATIC_INLINE volatile uint32_t * nrf_pdm_event_address_get(nrf_pdm_event_t pdm_event)
<> 144:ef7eb2e8f9f7 183 {
<> 144:ef7eb2e8f9f7 184 return (volatile uint32_t *)((uint8_t *)NRF_PDM + (uint32_t)pdm_event);
<> 144:ef7eb2e8f9f7 185 }
<> 144:ef7eb2e8f9f7 186
<> 144:ef7eb2e8f9f7 187
<> 144:ef7eb2e8f9f7 188 /**
<> 144:ef7eb2e8f9f7 189 * @brief Function for enabling PDM interrupts.
<> 144:ef7eb2e8f9f7 190 *
<> 144:ef7eb2e8f9f7 191 * @param[in] pdm_int_mask Interrupts to enable.
<> 144:ef7eb2e8f9f7 192 */
<> 144:ef7eb2e8f9f7 193 __STATIC_INLINE void nrf_pdm_int_enable(uint32_t pdm_int_mask)
<> 144:ef7eb2e8f9f7 194 {
<> 144:ef7eb2e8f9f7 195 NRF_PDM->INTENSET = pdm_int_mask;
<> 144:ef7eb2e8f9f7 196 }
<> 144:ef7eb2e8f9f7 197
<> 144:ef7eb2e8f9f7 198
<> 144:ef7eb2e8f9f7 199 /**
<> 144:ef7eb2e8f9f7 200 * @brief Function for retrieving the state of PDM interrupts.
<> 144:ef7eb2e8f9f7 201 *
<> 144:ef7eb2e8f9f7 202 * @param[in] pdm_int_mask Interrupts to check.
<> 144:ef7eb2e8f9f7 203 *
<> 144:ef7eb2e8f9f7 204 * @retval true If all specified interrupts are enabled.
<> 144:ef7eb2e8f9f7 205 * @retval false If at least one of the given interrupts is not enabled.
<> 144:ef7eb2e8f9f7 206 */
<> 144:ef7eb2e8f9f7 207 __STATIC_INLINE bool nrf_pdm_int_enable_check(uint32_t pdm_int_mask)
<> 144:ef7eb2e8f9f7 208 {
<> 144:ef7eb2e8f9f7 209 return (bool)(NRF_PDM->INTENSET & pdm_int_mask);
<> 144:ef7eb2e8f9f7 210 }
<> 144:ef7eb2e8f9f7 211
<> 144:ef7eb2e8f9f7 212
<> 144:ef7eb2e8f9f7 213 /**
<> 144:ef7eb2e8f9f7 214 * @brief Function for disabling interrupts.
<> 144:ef7eb2e8f9f7 215 *
<> 144:ef7eb2e8f9f7 216 * @param pdm_int_mask Interrupts to disable.
<> 144:ef7eb2e8f9f7 217 */
<> 144:ef7eb2e8f9f7 218 __STATIC_INLINE void nrf_pdm_int_disable(uint32_t pdm_int_mask)
<> 144:ef7eb2e8f9f7 219 {
<> 144:ef7eb2e8f9f7 220 NRF_PDM->INTENCLR = pdm_int_mask;
<> 144:ef7eb2e8f9f7 221 }
<> 144:ef7eb2e8f9f7 222
<> 144:ef7eb2e8f9f7 223
<> 144:ef7eb2e8f9f7 224 /**
<> 144:ef7eb2e8f9f7 225 * @brief Function for enabling the PDM peripheral.
<> 144:ef7eb2e8f9f7 226 *
<> 144:ef7eb2e8f9f7 227 * The PDM peripheral must be enabled before use.
<> 144:ef7eb2e8f9f7 228 */
<> 144:ef7eb2e8f9f7 229 __STATIC_INLINE void nrf_pdm_enable(void)
<> 144:ef7eb2e8f9f7 230 {
<> 144:ef7eb2e8f9f7 231 NRF_PDM->ENABLE = (PDM_ENABLE_ENABLE_Enabled << PDM_ENABLE_ENABLE_Pos);
<> 144:ef7eb2e8f9f7 232 }
<> 144:ef7eb2e8f9f7 233
<> 144:ef7eb2e8f9f7 234
<> 144:ef7eb2e8f9f7 235 /**
<> 144:ef7eb2e8f9f7 236 * @brief Function for disabling the PDM peripheral.
<> 144:ef7eb2e8f9f7 237 */
<> 144:ef7eb2e8f9f7 238 __STATIC_INLINE void nrf_pdm_disable(void)
<> 144:ef7eb2e8f9f7 239 {
<> 144:ef7eb2e8f9f7 240 NRF_PDM->ENABLE = (PDM_ENABLE_ENABLE_Disabled << PDM_ENABLE_ENABLE_Pos);
<> 144:ef7eb2e8f9f7 241 }
<> 144:ef7eb2e8f9f7 242
<> 144:ef7eb2e8f9f7 243
<> 144:ef7eb2e8f9f7 244 /**
<> 144:ef7eb2e8f9f7 245 * @brief Function for checking if the PDM peripheral is enabled.
<> 144:ef7eb2e8f9f7 246 *
<> 144:ef7eb2e8f9f7 247 * @retval true If the PDM peripheral is enabled.
<> 144:ef7eb2e8f9f7 248 * @retval false If the PDM peripheral is not enabled.
<> 144:ef7eb2e8f9f7 249 */
<> 144:ef7eb2e8f9f7 250 __STATIC_INLINE bool nrf_pdm_enable_check(void)
<> 144:ef7eb2e8f9f7 251 {
<> 144:ef7eb2e8f9f7 252 return (NRF_PDM->ENABLE == (PDM_ENABLE_ENABLE_Enabled << PDM_ENABLE_ENABLE_Pos));
<> 144:ef7eb2e8f9f7 253 }
<> 144:ef7eb2e8f9f7 254
<> 144:ef7eb2e8f9f7 255
<> 144:ef7eb2e8f9f7 256 /**
<> 144:ef7eb2e8f9f7 257 * @brief Function for setting the PDM operation mode.
<> 144:ef7eb2e8f9f7 258 *
<> 144:ef7eb2e8f9f7 259 * @param[in] pdm_mode PDM operation mode.
<> 144:ef7eb2e8f9f7 260 * @param[in] pdm_edge PDM sampling mode.
<> 144:ef7eb2e8f9f7 261 */
<> 144:ef7eb2e8f9f7 262 __STATIC_INLINE void nrf_pdm_mode_set(nrf_pdm_mode_t pdm_mode, nrf_pdm_edge_t pdm_edge)
<> 144:ef7eb2e8f9f7 263 {
<> 144:ef7eb2e8f9f7 264 NRF_PDM->MODE = ((pdm_mode << PDM_MODE_OPERATION_Pos) & PDM_MODE_OPERATION_Msk)
<> 144:ef7eb2e8f9f7 265 | ((pdm_edge << PDM_MODE_EDGE_Pos) & PDM_MODE_EDGE_Msk);
<> 144:ef7eb2e8f9f7 266 }
<> 144:ef7eb2e8f9f7 267
<> 144:ef7eb2e8f9f7 268
<> 144:ef7eb2e8f9f7 269 /**
<> 144:ef7eb2e8f9f7 270 * @brief Function for getting the PDM operation mode.
<> 144:ef7eb2e8f9f7 271 *
<> 144:ef7eb2e8f9f7 272 * @param[out] p_pdm_mode PDM operation mode.
<> 144:ef7eb2e8f9f7 273 * @param[out] p_pdm_edge PDM sampling mode.
<> 144:ef7eb2e8f9f7 274 */
<> 144:ef7eb2e8f9f7 275 __STATIC_INLINE void nrf_pdm_mode_get(nrf_pdm_mode_t * p_pdm_mode, nrf_pdm_edge_t * p_pdm_edge)
<> 144:ef7eb2e8f9f7 276 {
<> 144:ef7eb2e8f9f7 277 uint32_t mode = NRF_PDM->MODE;
<> 144:ef7eb2e8f9f7 278 *p_pdm_mode = (nrf_pdm_mode_t)((mode & PDM_MODE_OPERATION_Msk ) >> PDM_MODE_OPERATION_Pos);
<> 144:ef7eb2e8f9f7 279 *p_pdm_edge = (nrf_pdm_edge_t)((mode & PDM_MODE_EDGE_Msk ) >> PDM_MODE_EDGE_Pos);
<> 144:ef7eb2e8f9f7 280 }
<> 144:ef7eb2e8f9f7 281
<> 144:ef7eb2e8f9f7 282
<> 144:ef7eb2e8f9f7 283 /**
<> 144:ef7eb2e8f9f7 284 * @brief Function for setting the PDM clock frequency.
<> 144:ef7eb2e8f9f7 285 *
<> 144:ef7eb2e8f9f7 286 * @param[in] pdm_freq PDM clock frequency.
<> 144:ef7eb2e8f9f7 287 */
<> 144:ef7eb2e8f9f7 288 __STATIC_INLINE void nrf_pdm_clock_set(nrf_pdm_freq_t pdm_freq)
<> 144:ef7eb2e8f9f7 289 {
<> 144:ef7eb2e8f9f7 290 NRF_PDM->PDMCLKCTRL = ((pdm_freq << PDM_PDMCLKCTRL_FREQ_Pos) & PDM_PDMCLKCTRL_FREQ_Msk);
<> 144:ef7eb2e8f9f7 291 }
<> 144:ef7eb2e8f9f7 292
<> 144:ef7eb2e8f9f7 293
<> 144:ef7eb2e8f9f7 294 /**
<> 144:ef7eb2e8f9f7 295 * @brief Function for getting the PDM clock frequency.
<> 144:ef7eb2e8f9f7 296 */
<> 144:ef7eb2e8f9f7 297 __STATIC_INLINE nrf_pdm_freq_t nrf_pdm_clock_get(void)
<> 144:ef7eb2e8f9f7 298 {
<> 144:ef7eb2e8f9f7 299 return (nrf_pdm_freq_t) ((NRF_PDM->PDMCLKCTRL << PDM_PDMCLKCTRL_FREQ_Pos) & PDM_PDMCLKCTRL_FREQ_Msk);
<> 144:ef7eb2e8f9f7 300 }
<> 144:ef7eb2e8f9f7 301
<> 144:ef7eb2e8f9f7 302
<> 144:ef7eb2e8f9f7 303 /**
<> 144:ef7eb2e8f9f7 304 * @brief Function for setting up the PDM pins.
<> 144:ef7eb2e8f9f7 305 *
<> 144:ef7eb2e8f9f7 306 * @param[in] psel_clk CLK pin number.
<> 144:ef7eb2e8f9f7 307 * @param[in] psel_din DIN pin number.
<> 144:ef7eb2e8f9f7 308 */
<> 144:ef7eb2e8f9f7 309 __STATIC_INLINE void nrf_pdm_psel_connect(uint32_t psel_clk, uint32_t psel_din)
<> 144:ef7eb2e8f9f7 310 {
<> 144:ef7eb2e8f9f7 311 NRF_PDM->PSEL.CLK = ((psel_clk << PDM_PSEL_CLK_PIN_Pos) & PDM_PSEL_CLK_PIN_Msk)
<> 144:ef7eb2e8f9f7 312 | ((PDM_PSEL_CLK_CONNECT_Connected << PDM_PSEL_CLK_CONNECT_Pos) & PDM_PSEL_CLK_CONNECT_Msk);
<> 144:ef7eb2e8f9f7 313 NRF_PDM->PSEL.DIN = ((psel_din << PDM_PSEL_DIN_PIN_Pos) & PDM_PSEL_DIN_PIN_Msk)
<> 144:ef7eb2e8f9f7 314 | ((PDM_PSEL_DIN_CONNECT_Connected << PDM_PSEL_CLK_CONNECT_Pos) & PDM_PSEL_DIN_CONNECT_Msk);
<> 144:ef7eb2e8f9f7 315 }
<> 144:ef7eb2e8f9f7 316
<> 144:ef7eb2e8f9f7 317 /**
<> 144:ef7eb2e8f9f7 318 * @brief Function for disconnecting the PDM pins.
<> 144:ef7eb2e8f9f7 319 */
<> 144:ef7eb2e8f9f7 320 __STATIC_INLINE void nrf_pdm_psel_disconnect()
<> 144:ef7eb2e8f9f7 321 {
<> 144:ef7eb2e8f9f7 322 NRF_PDM->PSEL.CLK = ((PDM_PSEL_CLK_CONNECT_Disconnected << PDM_PSEL_CLK_CONNECT_Pos)
<> 144:ef7eb2e8f9f7 323 & PDM_PSEL_CLK_CONNECT_Msk);
<> 144:ef7eb2e8f9f7 324 NRF_PDM->PSEL.DIN = ((PDM_PSEL_DIN_CONNECT_Disconnected << PDM_PSEL_DIN_CONNECT_Pos)
<> 144:ef7eb2e8f9f7 325 & PDM_PSEL_DIN_CONNECT_Msk);
<> 144:ef7eb2e8f9f7 326 }
<> 144:ef7eb2e8f9f7 327
<> 144:ef7eb2e8f9f7 328
<> 144:ef7eb2e8f9f7 329 /**
<> 144:ef7eb2e8f9f7 330 * @brief Function for setting the PDM gain.
<> 144:ef7eb2e8f9f7 331 *
<> 144:ef7eb2e8f9f7 332 * @param[in] gain_l Left channel gain.
<> 144:ef7eb2e8f9f7 333 * @param[in] gain_r Right channel gain.
<> 144:ef7eb2e8f9f7 334 */
<> 144:ef7eb2e8f9f7 335 __STATIC_INLINE void nrf_pdm_gain_set(nrf_pdm_gain_t gain_l, nrf_pdm_gain_t gain_r)
<> 144:ef7eb2e8f9f7 336 {
<> 144:ef7eb2e8f9f7 337 NRF_PDM->GAINL = gain_l;
<> 144:ef7eb2e8f9f7 338 NRF_PDM->GAINR = gain_r;
<> 144:ef7eb2e8f9f7 339 }
<> 144:ef7eb2e8f9f7 340
<> 144:ef7eb2e8f9f7 341
<> 144:ef7eb2e8f9f7 342 /**
<> 144:ef7eb2e8f9f7 343 * @brief Function for getting the PDM gain.
<> 144:ef7eb2e8f9f7 344 *
<> 144:ef7eb2e8f9f7 345 * @param[out] p_gain_l Left channel gain.
<> 144:ef7eb2e8f9f7 346 * @param[out] p_gain_r Right channel gain.
<> 144:ef7eb2e8f9f7 347 */
<> 144:ef7eb2e8f9f7 348 __STATIC_INLINE void nrf_pdm_gain_get(nrf_pdm_gain_t * p_gain_l, nrf_pdm_gain_t * p_gain_r)
<> 144:ef7eb2e8f9f7 349 {
<> 144:ef7eb2e8f9f7 350 *p_gain_l = NRF_PDM->GAINL;
<> 144:ef7eb2e8f9f7 351 *p_gain_r = NRF_PDM->GAINR;
<> 144:ef7eb2e8f9f7 352 }
<> 144:ef7eb2e8f9f7 353
<> 144:ef7eb2e8f9f7 354
<> 144:ef7eb2e8f9f7 355 /**
<> 144:ef7eb2e8f9f7 356 * @brief Function for setting the PDM sample buffer.
<> 144:ef7eb2e8f9f7 357 *
<> 144:ef7eb2e8f9f7 358 * @param[in] p_buffer Pointer to the RAM address where samples should be written with EasyDMA.
<> 144:ef7eb2e8f9f7 359 * @param[in] num Number of samples to allocate memory for in EasyDMA mode.
<> 144:ef7eb2e8f9f7 360 *
<> 144:ef7eb2e8f9f7 361 * The amount of allocated RAM depends on the operation mode.
<> 144:ef7eb2e8f9f7 362 * - For stereo mode: N 32-bit words.
<> 144:ef7eb2e8f9f7 363 * - For mono mode: Ceil(N/2) 32-bit words.
<> 144:ef7eb2e8f9f7 364 */
<> 144:ef7eb2e8f9f7 365 __STATIC_INLINE void nrf_pdm_buffer_set(uint32_t * p_buffer, uint32_t num)
<> 144:ef7eb2e8f9f7 366 {
<> 144:ef7eb2e8f9f7 367 NRF_PDM->SAMPLE.PTR = (uint32_t)p_buffer;
<> 144:ef7eb2e8f9f7 368 NRF_PDM->SAMPLE.MAXCNT = num;
<> 144:ef7eb2e8f9f7 369 }
<> 144:ef7eb2e8f9f7 370
<> 144:ef7eb2e8f9f7 371 /**
<> 144:ef7eb2e8f9f7 372 * @brief Function for getting the current PDM sample buffer address.
<> 144:ef7eb2e8f9f7 373 *
<> 144:ef7eb2e8f9f7 374 * @return Pointer to the current sample buffer.
<> 144:ef7eb2e8f9f7 375 */
<> 144:ef7eb2e8f9f7 376 __STATIC_INLINE uint32_t * nrf_pdm_buffer_get()
<> 144:ef7eb2e8f9f7 377 {
<> 144:ef7eb2e8f9f7 378 return (uint32_t *)NRF_PDM->SAMPLE.PTR;
<> 144:ef7eb2e8f9f7 379 }
<> 144:ef7eb2e8f9f7 380
<> 144:ef7eb2e8f9f7 381
<> 144:ef7eb2e8f9f7 382 /**
<> 144:ef7eb2e8f9f7 383 *@}
<> 144:ef7eb2e8f9f7 384 **/
<> 144:ef7eb2e8f9f7 385
<> 144:ef7eb2e8f9f7 386 #endif /* NRF_PDM_H_ */