Vybhav Kadaba / Mbed OS EV-PRO-MW1001_Development_MWARE2390

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.

common/utils.c@65:d91e1d63153d, 2020-04-14 (annotated)

Committer:
Vkadaba
Date:
Tue Apr 14 08:40:24 2020 +0000
Revision:
65:d91e1d63153d
Parent:
63:2655a04c00f5
Child:
67:d36977cbfe90
modified the ADMW_SAMPLE enum to match the sensor_result enum ;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Vkadaba 15:b5d57daeb7c0 1 /*
Vkadaba 15:b5d57daeb7c0 2 Copyright 2019 (c) Analog Devices, Inc.
Vkadaba 15:b5d57daeb7c0 3
Vkadaba 15:b5d57daeb7c0 4 All rights reserved.
Vkadaba 15:b5d57daeb7c0 5
Vkadaba 15:b5d57daeb7c0 6 Redistribution and use in source and binary forms, with or without
Vkadaba 15:b5d57daeb7c0 7 modification, are permitted provided that the following conditions are met:
Vkadaba 15:b5d57daeb7c0 8 - Redistributions of source code must retain the above copyright
Vkadaba 15:b5d57daeb7c0 9 notice, this list of conditions and the following disclaimer.
Vkadaba 15:b5d57daeb7c0 10 - Redistributions in binary form must reproduce the above copyright
Vkadaba 15:b5d57daeb7c0 11 notice, this list of conditions and the following disclaimer in
Vkadaba 15:b5d57daeb7c0 12 the documentation and/or other materials provided with the
Vkadaba 15:b5d57daeb7c0 13 distribution.
Vkadaba 15:b5d57daeb7c0 14 - Neither the name of Analog Devices, Inc. nor the names of its
Vkadaba 15:b5d57daeb7c0 15 contributors may be used to endorse or promote products derived
Vkadaba 15:b5d57daeb7c0 16 from this software without specific prior written permission.
Vkadaba 15:b5d57daeb7c0 17 - The use of this software may or may not infringe the patent rights
Vkadaba 15:b5d57daeb7c0 18 of one or more patent holders. This license does not release you
Vkadaba 15:b5d57daeb7c0 19 from the requirement that you obtain separate licenses from these
Vkadaba 15:b5d57daeb7c0 20 patent holders to use this software.
Vkadaba 15:b5d57daeb7c0 21 - Use of the software either in source or binary form, must be run
Vkadaba 15:b5d57daeb7c0 22 on or directly connected to an Analog Devices Inc. component.
Vkadaba 15:b5d57daeb7c0 23
Vkadaba 15:b5d57daeb7c0 24 THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR
Vkadaba 15:b5d57daeb7c0 25 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT,
Vkadaba 15:b5d57daeb7c0 26 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
Vkadaba 15:b5d57daeb7c0 27 IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT,
Vkadaba 15:b5d57daeb7c0 28 INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
Vkadaba 15:b5d57daeb7c0 29 LIMITED TO, INTELLECTUAL PROPERTY RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR
Vkadaba 15:b5d57daeb7c0 30 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Vkadaba 15:b5d57daeb7c0 31 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Vkadaba 15:b5d57daeb7c0 32 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Vkadaba 15:b5d57daeb7c0 33 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Vkadaba 15:b5d57daeb7c0 34 */
Vkadaba 15:b5d57daeb7c0 35
Vkadaba 15:b5d57daeb7c0 36 /*!
Vkadaba 15:b5d57daeb7c0 37 ******************************************************************************
Vkadaba 15:b5d57daeb7c0 38 * @file: utils.c
Vkadaba 15:b5d57daeb7c0 39 * @brief: Interface Utilities for ADMW1001
Vkadaba 15:b5d57daeb7c0 40 *-----------------------------------------------------------------------------
Vkadaba 15:b5d57daeb7c0 41 */
ADIJake 0:85855ecd3257 42 #include <stdlib.h>
ADIJake 0:85855ecd3257 43
ADIJake 0:85855ecd3257 44 #include "utils.h"
Vkadaba 5:0728bde67bdb 45 #include "admw_log.h"
ADIJake 0:85855ecd3257 46
ADIJake 0:85855ecd3257 47 void utils_printStatus(
Vkadaba 5:0728bde67bdb 48 ADMW_STATUS *pStatus)
ADIJake 0:85855ecd3257 49 {
Vkadaba 5:0728bde67bdb 50 ADMW_LOG_INFO("Status Summary:");
ADIJake 0:85855ecd3257 51
Vkadaba 23:bb685f35b08b 52 if (pStatus->deviceStatus == 0) {
Vkadaba 5:0728bde67bdb 53 ADMW_LOG_INFO("\tNo errors detected");
Vkadaba 23:bb685f35b08b 54 } else {
Vkadaba 5:0728bde67bdb 55 if (pStatus->deviceStatus & ADMW_DEVICE_STATUS_BUSY)
Vkadaba 5:0728bde67bdb 56 ADMW_LOG_INFO("\tCommand running");
Vkadaba 5:0728bde67bdb 57 if (pStatus->deviceStatus & ADMW_DEVICE_STATUS_DATAREADY)
Vkadaba 5:0728bde67bdb 58 ADMW_LOG_INFO("\tData ready");
Vkadaba 5:0728bde67bdb 59 if (pStatus->deviceStatus & ADMW_DEVICE_STATUS_ERROR)
Vkadaba 5:0728bde67bdb 60 ADMW_LOG_INFO("\tActive Errors - RESET REQUIRED");
Vkadaba 5:0728bde67bdb 61 if (pStatus->deviceStatus & ADMW_DEVICE_STATUS_FIFO_ERROR)
Vkadaba 5:0728bde67bdb 62 ADMW_LOG_INFO("\tActive FIFO Errors - ATTENTION REQUIRED");
Vkadaba 5:0728bde67bdb 63 if (pStatus->deviceStatus & ADMW_DEVICE_STATUS_CONFIG_ERROR)
Vkadaba 5:0728bde67bdb 64 ADMW_LOG_INFO("\tActive Configuration Errors - ATTENTION REQUIRED");
ADIJake 0:85855ecd3257 65
Vkadaba 23:bb685f35b08b 66 if (pStatus->deviceStatus & ADMW_DEVICE_STATUS_ALERT) {
Vkadaba 5:0728bde67bdb 67 ADMW_LOG_INFO("\tActive Alerts - ATTENTION REQUIRED:");
Vkadaba 5:0728bde67bdb 68 ADMW_LOG_INFO("\t\tLast Alert Code: %u (0x%X)",
Vkadaba 23:bb685f35b08b 69 pStatus->alertCode, pStatus->alertCode);
ADIJake 0:85855ecd3257 70
Vkadaba 23:bb685f35b08b 71 for (unsigned i = 0; i < ADMW1001_MAX_CHANNELS; i++) {
ADIJake 0:85855ecd3257 72 if (pStatus->channelAlerts[i] == 0)
ADIJake 0:85855ecd3257 73 continue;
ADIJake 0:85855ecd3257 74
Vkadaba 5:0728bde67bdb 75 ADMW_LOG_INFO("\t\tChannel #%u:", i);
Vkadaba 5:0728bde67bdb 76 ADMW_LOG_INFO("\t\t\tLast Alert Code: %u (0x%X)",
Vkadaba 23:bb685f35b08b 77 pStatus->channelAlertCodes[i],
Vkadaba 23:bb685f35b08b 78 pStatus->channelAlertCodes[i]);
Vkadaba 32:52445bef314d 79 if (pStatus->channelAlerts[i] & ADMW_ALERT_DETAIL_CH_ADC_NEAR_OVERRANGE)
Vkadaba 32:52445bef314d 80 ADMW_LOG_INFO("\t\t\ADC near overrange detected");
Vkadaba 32:52445bef314d 81 if (pStatus->channelAlerts[i] & ADMW_ALERT_DETAIL_CH_SENSOR_UNDERRANGE)
Vkadaba 32:52445bef314d 82 ADMW_LOG_INFO("\t\t\tSensor underrange detected");
Vkadaba 32:52445bef314d 83 if (pStatus->channelAlerts[i] & ADMW_ALERT_DETAIL_CH_SENSOR_OVERRANGE)
Vkadaba 32:52445bef314d 84 ADMW_LOG_INFO("\t\t\tSensor overrange detected");
Vkadaba 32:52445bef314d 85 if (pStatus->channelAlerts[i] & ADMW_ALERT_DETAIL_CH_CJ_SOFT_FAULT)
Vkadaba 32:52445bef314d 86 ADMW_LOG_INFO("\t\t\tCJC soft fault alert detected");
Vkadaba 32:52445bef314d 87 if (pStatus->channelAlerts[i] & ADMW_ALERT_DETAIL_CH_CJ_HARD_FAULT)
Vkadaba 32:52445bef314d 88 ADMW_LOG_INFO("\t\t\tCJC hard fault alert detected");
Vkadaba 32:52445bef314d 89 if (pStatus->channelAlerts[i] & ADMW_ALERT_DETAIL_CH_ADC_INPUT_OVERRANGE)
Vkadaba 32:52445bef314d 90 ADMW_LOG_INFO("\t\t\tADC input overranage alert detected");
Vkadaba 32:52445bef314d 91 if (pStatus->channelAlerts[i] & ADMW_ALERT_DETAIL_CH_SENSOR_HARDFAULT)
Vkadaba 32:52445bef314d 92 ADMW_LOG_INFO("\t\t\tChannel sensor hardfault alert detected");
ADIJake 0:85855ecd3257 93 }
ADIJake 0:85855ecd3257 94 }
ADIJake 0:85855ecd3257 95
Vkadaba 5:0728bde67bdb 96 if ((pStatus->deviceStatus & ADMW_DEVICE_STATUS_ERROR) ||
Vkadaba 23:bb685f35b08b 97 (pStatus->deviceStatus & ADMW_DEVICE_STATUS_ALERT)) {
Vkadaba 5:0728bde67bdb 98 ADMW_LOG_INFO("\t\tLast Debug Code: %u-%u",
Vkadaba 23:bb685f35b08b 99 (pStatus->debugCode >> 16) & 0xFFFF,
Vkadaba 23:bb685f35b08b 100 (pStatus->debugCode >> 0) & 0xFFFF);
ADIJake 0:85855ecd3257 101 }
ADIJake 0:85855ecd3257 102 }
ADIJake 0:85855ecd3257 103 }
ADIJake 0:85855ecd3257 104
ADIJake 0:85855ecd3257 105 void utils_printSamples(
Vkadaba 5:0728bde67bdb 106 ADMW_DATA_SAMPLE *pSampleBuffer,
ADIJake 0:85855ecd3257 107 uint32_t nNumSamples,
Vkadaba 5:0728bde67bdb 108 ADMW_MEASUREMENT_MODE eMeasurementMode)
ADIJake 0:85855ecd3257 109 {
Vkadaba 23:bb685f35b08b 110 for (uint32_t i = 0; i < nNumSamples; i++) {
Vkadaba 65:d91e1d63153d 111 ADMW_LOG_INFO("Sample # %2d Channel_ID # %2d :: Raw_Sample %f :: processedValue %f :: flags: ERROR:%X , ALERT:%X",
Vkadaba 23:bb685f35b08b 112 i+1,
Vkadaba 65:d91e1d63153d 113 pSampleBuffer[i].Channel_ID,
Vkadaba 65:d91e1d63153d 114 pSampleBuffer[i].Raw_Sample,
Vkadaba 23:bb685f35b08b 115 pSampleBuffer[i].processedValue,
Vkadaba 65:d91e1d63153d 116 pSampleBuffer[i].Ch_Error,
Vkadaba 65:d91e1d63153d 117 pSampleBuffer[i].Ch_Alert);
Vkadaba 10:14954555be2a 118 }
ADIJake 0:85855ecd3257 119 }
ADIJake 0:85855ecd3257 120
Vkadaba 5:0728bde67bdb 121 static void gpioCallbackFn(ADMW_GPIO_PIN ePinId, void * pArg)
ADIJake 0:85855ecd3257 122 {
ADIJake 0:85855ecd3257 123 volatile bool *pbFlag = (volatile bool *)pArg;
ADIJake 0:85855ecd3257 124 *pbFlag = true;
ADIJake 0:85855ecd3257 125 }
ADIJake 0:85855ecd3257 126
Vkadaba 5:0728bde67bdb 127 ADMW_RESULT utils_registerCallbacks(
Vkadaba 5:0728bde67bdb 128 ADMW_DEVICE_HANDLE hDevice,
ADIJake 0:85855ecd3257 129 volatile bool *pbDataReady,
ADIJake 0:85855ecd3257 130 volatile bool *pbError,
ADIJake 0:85855ecd3257 131 volatile bool *pbAlert)
ADIJake 0:85855ecd3257 132 {
Vkadaba 5:0728bde67bdb 133 ADMW_RESULT res;
ADIJake 0:85855ecd3257 134 bool state;
ADIJake 0:85855ecd3257 135
Vkadaba 5:0728bde67bdb 136 res = admw_RegisterGpioCallback(hDevice, ADMW_GPIO_PIN_DATAREADY,
Vkadaba 23:bb685f35b08b 137 gpioCallbackFn, (void *)pbDataReady);
Vkadaba 23:bb685f35b08b 138 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 139 ADMW_LOG_ERROR("Failed to register DATAREADY callback");
ADIJake 0:85855ecd3257 140 return res;
ADIJake 0:85855ecd3257 141 }
ADIJake 0:85855ecd3257 142
Vkadaba 5:0728bde67bdb 143 res = admw_GetGpioState(hDevice, ADMW_GPIO_PIN_ALERT_ERROR, &state);
Vkadaba 23:bb685f35b08b 144 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 145 ADMW_LOG_ERROR("Failed to get current ERROR state");
ADIJake 0:85855ecd3257 146 return res;
ADIJake 0:85855ecd3257 147 }
Vkadaba 23:bb685f35b08b 148 if (state) {
Vkadaba 5:0728bde67bdb 149 ADMW_LOG_ERROR("ERROR signal already asserted");
Vkadaba 5:0728bde67bdb 150 return ADMW_FAILURE;
ADIJake 0:85855ecd3257 151 }
Vkadaba 5:0728bde67bdb 152 res = admw_RegisterGpioCallback(hDevice, ADMW_GPIO_PIN_ALERT_ERROR,
Vkadaba 23:bb685f35b08b 153 gpioCallbackFn, (void *)pbError);
Vkadaba 23:bb685f35b08b 154 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 155 ADMW_LOG_ERROR("Failed to register ERROR callback");
ADIJake 0:85855ecd3257 156 return res;
ADIJake 0:85855ecd3257 157 }
ADIJake 0:85855ecd3257 158
Vkadaba 5:0728bde67bdb 159 /*res = admw_GetGpioState(hDevice, ADMW_GPIO_PIN_ALERT, &state);
Vkadaba 5:0728bde67bdb 160 if (res != ADMW_SUCCESS)
ADIJake 0:85855ecd3257 161 {
Vkadaba 5:0728bde67bdb 162 ADMW_LOG_ERROR("Failed to get current ALERT state");
ADIJake 0:85855ecd3257 163 return res;
ADIJake 0:85855ecd3257 164 }
ADIJake 0:85855ecd3257 165 if (state)
ADIJake 0:85855ecd3257 166 {
Vkadaba 5:0728bde67bdb 167 ADMW_LOG_ERROR("ALERT signal already asserted");
Vkadaba 5:0728bde67bdb 168 return ADMW_FAILURE;
ADIJake 1:63dd03580de4 169 }*/
Vkadaba 5:0728bde67bdb 170 res = admw_RegisterGpioCallback(hDevice, ADMW_GPIO_PIN_ALERT_ERROR,
Vkadaba 23:bb685f35b08b 171 gpioCallbackFn, (void *)pbAlert);
Vkadaba 23:bb685f35b08b 172 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 173 ADMW_LOG_ERROR("Failed to register ALERT callback");
ADIJake 0:85855ecd3257 174 return res;
ADIJake 0:85855ecd3257 175 }
ADIJake 0:85855ecd3257 176
Vkadaba 5:0728bde67bdb 177 return ADMW_SUCCESS;
ADIJake 0:85855ecd3257 178 }
ADIJake 0:85855ecd3257 179
Vkadaba 5:0728bde67bdb 180 ADMW_RESULT utils_deregisterCallbacks(
Vkadaba 5:0728bde67bdb 181 ADMW_DEVICE_HANDLE hDevice)
ADIJake 0:85855ecd3257 182 {
Vkadaba 5:0728bde67bdb 183 ADMW_RESULT res;
ADIJake 0:85855ecd3257 184
Vkadaba 5:0728bde67bdb 185 res = admw_RegisterGpioCallback(hDevice, ADMW_GPIO_PIN_DATAREADY,
Vkadaba 23:bb685f35b08b 186 NULL, NULL);
Vkadaba 23:bb685f35b08b 187 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 188 ADMW_LOG_ERROR("Failed to deregister DATAREADY callback");
ADIJake 0:85855ecd3257 189 return res;
ADIJake 0:85855ecd3257 190 }
ADIJake 0:85855ecd3257 191
Vkadaba 5:0728bde67bdb 192 res = admw_RegisterGpioCallback(hDevice, ADMW_GPIO_PIN_ALERT_ERROR,
Vkadaba 23:bb685f35b08b 193 NULL, NULL);
Vkadaba 23:bb685f35b08b 194 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 195 ADMW_LOG_ERROR("Failed to deregister ERROR callback");
ADIJake 0:85855ecd3257 196 return res;
ADIJake 0:85855ecd3257 197 }
ADIJake 0:85855ecd3257 198
Vkadaba 5:0728bde67bdb 199 res = admw_RegisterGpioCallback(hDevice, ADMW_GPIO_PIN_ALERT_ERROR,
Vkadaba 23:bb685f35b08b 200 NULL, NULL);
Vkadaba 23:bb685f35b08b 201 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 202 ADMW_LOG_INFO("Failed to deregister ALERT callback");
ADIJake 0:85855ecd3257 203 return res;
ADIJake 0:85855ecd3257 204 }
ADIJake 0:85855ecd3257 205
Vkadaba 5:0728bde67bdb 206 return ADMW_SUCCESS;
ADIJake 0:85855ecd3257 207 }
ADIJake 0:85855ecd3257 208
Vkadaba 5:0728bde67bdb 209 ADMW_RESULT utils_runMeasurement(
Vkadaba 5:0728bde67bdb 210 ADMW_DEVICE_HANDLE hDevice,
Vkadaba 5:0728bde67bdb 211 ADMW_MEASUREMENT_MODE eMeasurementMode)
ADIJake 0:85855ecd3257 212 {
Vkadaba 5:0728bde67bdb 213 ADMW_RESULT res;
ADIJake 0:85855ecd3257 214 volatile bool bDataReady = false;
ADIJake 0:85855ecd3257 215 volatile bool bError = false;
ADIJake 0:85855ecd3257 216 volatile bool bAlert = false;
ADIJake 0:85855ecd3257 217 res = utils_registerCallbacks(hDevice, &bDataReady, &bError, &bAlert);
Vkadaba 5:0728bde67bdb 218 if (res != ADMW_SUCCESS)
ADIJake 0:85855ecd3257 219 return res;
ADIJake 0:85855ecd3257 220
ADIJake 0:85855ecd3257 221 /*
ADIJake 0:85855ecd3257 222 * Retrieve the number of samples per cycle, per DATAREADY pulse, etc. for
ADIJake 0:85855ecd3257 223 * this configuration.
ADIJake 0:85855ecd3257 224 */
Vkadaba 5:0728bde67bdb 225 ADMW1001_OPERATING_MODE eOperatingMode;
Vkadaba 5:0728bde67bdb 226 ADMW1001_DATAREADY_MODE eDataReadyMode;
ADIJake 0:85855ecd3257 227 uint32_t nSamplesPerDataready;
ADIJake 0:85855ecd3257 228 uint32_t nSamplesPerCycle;
ADIJake 0:85855ecd3257 229 uint8_t nBytesPerSample;
Vkadaba 5:0728bde67bdb 230 res = admw1001_GetDataReadyModeInfo(hDevice,
Vkadaba 23:bb685f35b08b 231 eMeasurementMode,
Vkadaba 23:bb685f35b08b 232 &eOperatingMode,
Vkadaba 23:bb685f35b08b 233 &eDataReadyMode,
Vkadaba 23:bb685f35b08b 234 &nSamplesPerDataready,
Vkadaba 23:bb685f35b08b 235 &nSamplesPerCycle,
Vkadaba 23:bb685f35b08b 236 &nBytesPerSample);
Vkadaba 5:0728bde67bdb 237 if (res != ADMW_SUCCESS)
ADIJake 0:85855ecd3257 238 return res;
ADIJake 0:85855ecd3257 239
ADIJake 0:85855ecd3257 240 /*
ADIJake 0:85855ecd3257 241 * Allocate a buffer to store the samples retrieved on each DATAREADY pulse
ADIJake 0:85855ecd3257 242 */
Vkadaba 5:0728bde67bdb 243 ADMW_DATA_SAMPLE *pSampleBuffer;
Vkadaba 5:0728bde67bdb 244 pSampleBuffer = malloc(sizeof(ADMW_DATA_SAMPLE) *
ADIJake 0:85855ecd3257 245 nSamplesPerDataready);
Vkadaba 23:bb685f35b08b 246 if (pSampleBuffer == NULL) {
Vkadaba 5:0728bde67bdb 247 ADMW_LOG_ERROR("Failed to allocate sample buffer");
Vkadaba 5:0728bde67bdb 248 return ADMW_NO_MEM;
ADIJake 0:85855ecd3257 249 }
ADIJake 0:85855ecd3257 250
ADIJake 0:85855ecd3257 251 /*
ADIJake 0:85855ecd3257 252 * Kick off the measurement cycle(s) here
ADIJake 0:85855ecd3257 253 */
Vkadaba 5:0728bde67bdb 254 ADMW_LOG_INFO("Starting measurement");
Vkadaba 5:0728bde67bdb 255 res = admw_StartMeasurement(hDevice, eMeasurementMode);
Vkadaba 23:bb685f35b08b 256 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 257 ADMW_LOG_ERROR("Failed to start measurement");
ADIJake 0:85855ecd3257 258 return res;
ADIJake 0:85855ecd3257 259 }
ADIJake 0:85855ecd3257 260
ADIJake 0:85855ecd3257 261 /*
ADIJake 0:85855ecd3257 262 * Loop continuously unless operating mode is single-cycle
ADIJake 0:85855ecd3257 263 */
ADIJake 0:85855ecd3257 264 uint32_t nSampleCount = 0;
ADIJake 0:85855ecd3257 265 uint32_t nReturned;
Vkadaba 23:bb685f35b08b 266 while (true) {
Vkadaba 5:0728bde67bdb 267 ADMW_STATUS status;
ADIJake 0:85855ecd3257 268
ADIJake 0:85855ecd3257 269 /*
ADIJake 0:85855ecd3257 270 * Wait until the next batch of 1 or more samples is ready, continuously
ADIJake 0:85855ecd3257 271 * checking DATAREADY until it is asserted
ADIJake 0:85855ecd3257 272 */
Vkadaba 39:e255f52072fc 273 while (! (bDataReady || bError));
ADIJake 0:85855ecd3257 274
Vkadaba 39:e255f52072fc 275 if (!bError) {
Vkadaba 39:e255f52072fc 276 /*
Vkadaba 39:e255f52072fc 277 * Get data samples from the measurement cycle, if no error has occurred
Vkadaba 39:e255f52072fc 278 */
Vkadaba 39:e255f52072fc 279 bDataReady = false;
Vkadaba 39:e255f52072fc 280 res = admw_GetData(hDevice, eMeasurementMode, pSampleBuffer,
Vkadaba 39:e255f52072fc 281 nBytesPerSample, nSamplesPerDataready,
Vkadaba 39:e255f52072fc 282 &nReturned);
Vkadaba 39:e255f52072fc 283 if (res != ADMW_SUCCESS) {
Vkadaba 39:e255f52072fc 284 if (res == ADMW_INCOMPLETE) {
Vkadaba 39:e255f52072fc 285 /*
Vkadaba 39:e255f52072fc 286 * This is expected in cases where cycleSkipCount may
Vkadaba 39:e255f52072fc 287 * be non-zero for some channels, resulting in
Vkadaba 39:e255f52072fc 288 * variable-length sequences
Vkadaba 39:e255f52072fc 289 */
Vkadaba 55:215da406282b 290
Vkadaba 39:e255f52072fc 291 ADMW_LOG_DEBUG("Retrieved %u of %u requested data samples",
Vkadaba 56:38b36e947602 292 nReturned, nSamplesPerDataready);
Vkadaba 39:e255f52072fc 293 continue;
Vkadaba 39:e255f52072fc 294 } else {
Vkadaba 39:e255f52072fc 295 ADMW_LOG_WARN("Failed to get data samples from device");
Vkadaba 39:e255f52072fc 296 return res;
Vkadaba 39:e255f52072fc 297 }
ADIJake 0:85855ecd3257 298 }
Vkadaba 39:e255f52072fc 299
Vkadaba 39:e255f52072fc 300 /*
Vkadaba 39:e255f52072fc 301 * Display the data samples.
Vkadaba 39:e255f52072fc 302 *
Vkadaba 39:e255f52072fc 303 * NOTE: this requires a sufficient idle time between subsequent
Vkadaba 39:e255f52072fc 304 * DATAREADY pulses to allow printing to occur. Otherwise,
Vkadaba 39:e255f52072fc 305 * subsequent samples may be missed if not retrieved promptly when
Vkadaba 39:e255f52072fc 306 * the next DATAREADY assertion occurs.
Vkadaba 39:e255f52072fc 307 */
Vkadaba 39:e255f52072fc 308 utils_printSamples(pSampleBuffer, nReturned, eMeasurementMode);
Vkadaba 39:e255f52072fc 309 nSampleCount += nReturned;
ADIJake 0:85855ecd3257 310 }
ADIJake 0:85855ecd3257 311
ADIJake 0:85855ecd3257 312 /*
ADIJake 0:85855ecd3257 313 * Check and print device status if errors/alerts have been triggered
ADIJake 0:85855ecd3257 314 */
Vkadaba 23:bb685f35b08b 315 if (bError || bAlert) {
Vkadaba 5:0728bde67bdb 316 res = admw_GetStatus(hDevice, &status);
Vkadaba 23:bb685f35b08b 317 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 318 ADMW_LOG_ERROR("Failed to retrieve device status");
ADIJake 0:85855ecd3257 319 return res;
ADIJake 0:85855ecd3257 320 }
ADIJake 0:85855ecd3257 321
ADIJake 0:85855ecd3257 322 if (status.deviceStatus &
Vkadaba 23:bb685f35b08b 323 (ADMW_DEVICE_STATUS_ERROR | ADMW_DEVICE_STATUS_ALERT)) {
ADIJake 0:85855ecd3257 324 utils_printStatus(&status);
ADIJake 0:85855ecd3257 325
ADIJake 0:85855ecd3257 326 /* Break out of the loop if any errors are raised */
ADIJake 0:85855ecd3257 327 if (bError)
ADIJake 0:85855ecd3257 328 break;
ADIJake 0:85855ecd3257 329 }
ADIJake 0:85855ecd3257 330 }
ADIJake 0:85855ecd3257 331
Vkadaba 23:bb685f35b08b 332 if (eOperatingMode == ADMW1001_OPERATING_MODE_SINGLECYCLE) {
ADIJake 0:85855ecd3257 333 /*
ADIJake 0:85855ecd3257 334 * In this mode, break out of the loop when the measurement command
ADIJake 0:85855ecd3257 335 * has completed.
ADIJake 0:85855ecd3257 336 *
ADIJake 0:85855ecd3257 337 * One option is to check for the expected number of samples to be
ADIJake 0:85855ecd3257 338 * returned for the cycle. However, cycles may have variable-length
ADIJake 0:85855ecd3257 339 * sequences if the cycleSkipCount option is non-zero for any of the
ADIJake 0:85855ecd3257 340 * channels.
ADIJake 0:85855ecd3257 341 *
ADIJake 0:85855ecd3257 342 * So, instead, we check for the command-running status, which
ADIJake 0:85855ecd3257 343 * will de-assert in this mode when the measurement command has
ADIJake 0:85855ecd3257 344 * completed a single cycle.
ADIJake 0:85855ecd3257 345 */
ADIJake 0:85855ecd3257 346 bool bCommandRunning;
Vkadaba 5:0728bde67bdb 347 res = admw_GetCommandRunningState(hDevice, &bCommandRunning);
Vkadaba 23:bb685f35b08b 348 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 349 ADMW_LOG_ERROR("Failed to get command-running status");
ADIJake 0:85855ecd3257 350 return res;
ADIJake 0:85855ecd3257 351 }
ADIJake 0:85855ecd3257 352
ADIJake 0:85855ecd3257 353 if (!bCommandRunning && !bDataReady)
ADIJake 0:85855ecd3257 354 break;
ADIJake 0:85855ecd3257 355 }
ADIJake 0:85855ecd3257 356 }
ADIJake 0:85855ecd3257 357
Vkadaba 5:0728bde67bdb 358 ADMW_LOG_INFO("Stopping measurement");
Vkadaba 5:0728bde67bdb 359 res = admw_StopMeasurement(hDevice);
Vkadaba 23:bb685f35b08b 360 if (res != ADMW_SUCCESS) {
Vkadaba 5:0728bde67bdb 361 ADMW_LOG_ERROR("Failed to send stop measurement");
ADIJake 0:85855ecd3257 362 return res;
ADIJake 0:85855ecd3257 363 }
ADIJake 0:85855ecd3257 364
ADIJake 0:85855ecd3257 365 free(pSampleBuffer);
ADIJake 0:85855ecd3257 366
ADIJake 0:85855ecd3257 367 res = utils_deregisterCallbacks(hDevice);
Vkadaba 5:0728bde67bdb 368 if (res != ADMW_SUCCESS)
ADIJake 0:85855ecd3257 369 return res;
ADIJake 0:85855ecd3257 370
Vkadaba 5:0728bde67bdb 371 return ADMW_SUCCESS;
ADIJake 0:85855ecd3257 372 }
ADIJake 0:85855ecd3257 373