1 /*
2  * Copyright (c) 2015-2016, Freescale Semiconductor, Inc.
3  * Copyright 2016-2017 NXP
4  * All rights reserved.
5  *
6  * SPDX-License-Identifier: BSD-3-Clause
7  */
8 
9 /**
10  * @file mpl3115_normal_interrupt.c
11  * @brief The mpl3115_normal_interrupt.c file implements the ISSDK MPL3115 sensor driver
12  *        example demonstration with interrupt mode.
13  */
14 
15 //-----------------------------------------------------------------------
16 // SDK Includes
17 //-----------------------------------------------------------------------
18 #include "pin_mux.h"
19 #include "clock_config.h"
20 #include "board.h"
21 #include "fsl_debug_console.h"
22 
23 //-----------------------------------------------------------------------
24 // CMSIS Includes
25 //-----------------------------------------------------------------------
26 #include "Driver_I2C.h"
27 
28 //-----------------------------------------------------------------------
29 // ISSDK Includes
30 //-----------------------------------------------------------------------
31 #include "issdk_hal.h"
32 #include "gpio_driver.h"
33 #include "mpl3115_drv.h"
34 
35 //-----------------------------------------------------------------------
36 // Macros
37 //-----------------------------------------------------------------------
38 #define MPL3115_DATA_SIZE (5) /* 3 byte Pressure/Altitude and 2 byte Temperature. */
39 /*! In MPL3115 the Auto Acquisition Time Step (ODR) can be set only in powers of 2 (i.e. 2^x, where x is the
40  *  SAMPLING_EXPONENT).
41  *  This gives a range of 1 second to 2^15 seconds (9 hours). */
42 #define MPL3115_SAMPLING_EXPONENT (1) /* 2 seconds */
43 
44 //-----------------------------------------------------------------------
45 // Constants
46 //-----------------------------------------------------------------------
47 /*! @brief Register settings for Interrupt (non buffered) mode. */
48 const registerwritelist_t cMpl3115ConfigNormal[] = {
49     /* Enable Data Ready and Event flags for Pressure, Temperature or either. */
50     {MPL3115_PT_DATA_CFG,
51      MPL3115_PT_DATA_CFG_TDEFE_ENABLED | MPL3115_PT_DATA_CFG_PDEFE_ENABLED | MPL3115_PT_DATA_CFG_DREM_ENABLED,
52      MPL3115_PT_DATA_CFG_TDEFE_MASK | MPL3115_PT_DATA_CFG_PDEFE_MASK | MPL3115_PT_DATA_CFG_DREM_MASK},
53     /* Set Over Sampling Ratio to 128. */
54     {MPL3115_CTRL_REG1, MPL3115_CTRL_REG1_OS_OSR_128, MPL3115_CTRL_REG1_OS_MASK},
55     /* Set Auto acquisition time step. */
56     {MPL3115_CTRL_REG2, MPL3115_SAMPLING_EXPONENT, MPL3115_CTRL_REG2_ST_MASK},
57     /* Set INT1 Active High. */
58     {MPL3115_CTRL_REG3, MPL3115_CTRL_REG3_IPOL1_HIGH, MPL3115_CTRL_REG3_IPOL1_MASK},
59     /* Enable Interrupts for Data Ready Events. */
60     {MPL3115_CTRL_REG4, MPL3115_CTRL_REG4_INT_EN_DRDY_INTENABLED, MPL3115_CTRL_REG4_INT_EN_DRDY_MASK},
61     /* Route Interrupt to INT1. */
62     {MPL3115_CTRL_REG5, MPL3115_CTRL_REG5_INT_CFG_DRDY_INT1, MPL3115_CTRL_REG5_INT_CFG_DRDY_MASK},
63     __END_WRITE_DATA__};
64 
65 /*! @brief Address and size of Raw Pressure+Temperature Data in Normal Mode. */
66 const registerreadlist_t cMpl3115OutputNormal[] = {{.readFrom = MPL3115_OUT_P_MSB, .numBytes = MPL3115_DATA_SIZE},
67                                                    __END_READ_DATA__};
68 
69 //-----------------------------------------------------------------------
70 // Global Variables
71 //-----------------------------------------------------------------------
72 volatile uint8_t gMpl3115DataReady;
73 
74 //-----------------------------------------------------------------------
75 // Functions
76 //-----------------------------------------------------------------------
77 /*! -----------------------------------------------------------------------
78  *  @brief       This is the Sensor Data Ready ISR implementation.
79  *  @details     This function sets the flag which indicates if a new sample(s) is available for reading.
80  *  @param[in]   pUserData This is a void pointer to the instance of the user specific data structure for the ISR.
81  *  @return      void  There is no return value.
82  *  @constraints None
83  *  @reeentrant  Yes
84  *  -----------------------------------------------------------------------*/
mpl3115_int_data_ready_callback(void * pUserData)85 void mpl3115_int_data_ready_callback(void *pUserData)
86 { /*! @brief Set flag to indicate Sensor has signalled data ready. */
87     gMpl3115DataReady = true;
88 }
89 
90 /*! -----------------------------------------------------------------------
91  *  @brief       This is the The main function implementation.
92  *  @details     This function invokes board initializes routines, then then brings up the sensor and
93  *               finally enters an endless loop to continuously read available samples.
94  *  @param[in]   void This is no input parameter.
95  *  @return      void  There is no return value.
96  *  @constraints None
97  *  @reeentrant  No
98  *  -----------------------------------------------------------------------*/
main(void)99 int main(void)
100 {
101     int16_t tempInDegrees;
102     uint32_t pressureInPascals;
103     int32_t status;
104     uint8_t data[MPL3115_DATA_SIZE];
105     mpl3115_pressuredata_t rawData;
106 
107     ARM_DRIVER_I2C *I2Cdrv = &I2C_S_DRIVER; // Now using the shield.h value!!!
108     mpl3115_i2c_sensorhandle_t mpl3115Driver;
109     GENERIC_DRIVER_GPIO *pGpioDriver = &Driver_GPIO_KSDK;
110 
111     /*! Initialize the MCU hardware. */
112     BOARD_InitPins();
113     BOARD_BootClockRUN();
114     BOARD_InitDebugConsole();
115 
116     PRINTF("\r\n ISSDK MPL3115 sensor driver example demonstration with interrupt mode.\r\n");
117 
118     /*! Initialize MAG3110 pin used by FRDM board */
119     pGpioDriver->pin_init(&MPL3115_INT1, GPIO_DIRECTION_IN, NULL, &mpl3115_int_data_ready_callback, NULL);
120 
121     /*! Initialize RGB LED pin used by FRDM board */
122     pGpioDriver->pin_init(&GREEN_LED, GPIO_DIRECTION_OUT, NULL, NULL, NULL);
123 
124     /*! Initialize the I2C driver. */
125     status = I2Cdrv->Initialize(I2C_S_SIGNAL_EVENT);
126     if (ARM_DRIVER_OK != status)
127     {
128         PRINTF("\r\n I2C Initialization Failed\r\n");
129         return -1;
130     }
131 
132     /*! Set the I2C Power mode. */
133     status = I2Cdrv->PowerControl(ARM_POWER_FULL);
134     if (ARM_DRIVER_OK != status)
135     {
136         PRINTF("\r\n I2C Power Mode setting Failed\r\n");
137         return -1;
138     }
139 
140     /*! Set the I2C bus speed. */
141     status = I2Cdrv->Control(ARM_I2C_BUS_SPEED, ARM_I2C_BUS_SPEED_FAST);
142     if (ARM_DRIVER_OK != status)
143     {
144         PRINTF("\r\n I2C Control Mode setting Failed\r\n");
145         return -1;
146     }
147 
148     /*! Initialize MPL3115 sensor driver. */
149     status = MPL3115_I2C_Initialize(&mpl3115Driver, &I2C_S_DRIVER, I2C_S_DEVICE_INDEX, MPL3115_I2C_ADDR,
150                                     MPL3115_WHOAMI_VALUE);
151     if (SENSOR_ERROR_NONE != status)
152     {
153         PRINTF("\r\n Sensor Initialization Failed\r\n");
154         return -1;
155     }
156     PRINTF("\r\n Successfully Initiliazed Sensor\r\n");
157 
158     /*!  Set the task to be executed while waiting for I2C transactions to complete. */
159     MPL3115_I2C_SetIdleTask(&mpl3115Driver, (registeridlefunction_t)SMC_SetPowerModeVlpr, SMC);
160 
161     gMpl3115DataReady = false;
162 
163     /*! Configure the MAG3110 sensor driver. */
164     status = MPL3115_I2C_Configure(&mpl3115Driver, cMpl3115ConfigNormal);
165     if (SENSOR_ERROR_NONE != status)
166     {
167         PRINTF("\r\nMPL3115 configuration failed...\r\n");
168         return -1;
169     }
170     PRINTF("\r\n Successfully Applied MPL3115 Sensor Configuration\r\n");
171 
172     for (;;) /* Forever loop */
173     {        /* In ISR Mode we do not need to check Data Ready Register.
174               * The receipt of interrupt will indicate data is ready. */
175         if (false == gMpl3115DataReady)
176         { /* Loop, if new sample is not available. */
177             SMC_SetPowerModeWait(SMC);
178             continue;
179         }
180         else
181         { /*! Clear the data ready flag, it will be set again by the ISR. */
182             gMpl3115DataReady = false;
183             pGpioDriver->toggle_pin(&GREEN_LED);
184         }
185 
186         /*! Read new raw sensor data from the MPL3115. */
187         status = MPL3115_I2C_ReadData(&mpl3115Driver, cMpl3115OutputNormal, data);
188         if (ARM_DRIVER_OK != status)
189         {
190             PRINTF("\r\n Read Failed. \r\n");
191             return -1;
192         }
193 
194         /*! Process the sample and convert the raw sensor data to signed 16-bit container. */
195         rawData.pressure = (uint32_t)((data[0]) << 16) | ((data[1]) << 8) | ((data[2]));
196         pressureInPascals = rawData.pressure / MPL3115_PRESSURE_CONV_FACTOR;
197 
198         rawData.temperature = (int16_t)((data[3]) << 8) | (data[4]);
199         tempInDegrees = rawData.temperature / MPL3115_TEMPERATURE_CONV_FACTOR;
200 
201         /* NOTE: PRINTF is relatively expensive in terms of CPU time, specially when used with-in execution loop. */
202         PRINTF("\r\nPressure    = %d Pa\r\n", pressureInPascals);
203         PRINTF("\r\nTemperature = %d degC\r\n", tempInDegrees);
204         ASK_USER_TO_RESUME(8); /* Ask for user input after processing 8 samples. */
205     }
206 }
207