ISSDK  1.7
IoT Sensing Software Development Kit
mma845x_interrupt.c
Go to the documentation of this file.
1 /*
2  * The Clear BSD License
3  * Copyright (c) 2015 - 2016, Freescale Semiconductor, Inc.
4  * Copyright 2016-2017 NXP
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without modification,
8  * are permitted (subject to the limitations in the disclaimer below) provided
9  * that the following conditions are met:
10  *
11  * o Redistributions of source code must retain the above copyright notice, this list
12  * of conditions and the following disclaimer.
13  *
14  * o Redistributions in binary form must reproduce the above copyright notice, this
15  * list of conditions and the following disclaimer in the documentation and/or
16  * other materials provided with the distribution.
17  *
18  * o Neither the name of the copyright holder nor the names of its
19  * contributors may be used to endorse or promote products derived from this
20  * software without specific prior written permission.
21  *
22  * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY THIS LICENSE.
23  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
25  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
26  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
27  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
28  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
29  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
30  * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
32  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33  */
34 
35 /**
36  * @file mma845x_interrupt.c
37 * @brief The mma845x_interrupt.c file implements the ISSDK MMA845x sensor driver
38 * example demonstration with Interrupt mode.
39 */
40 
41 //-----------------------------------------------------------------------
42 // SDK Includes
43 //-----------------------------------------------------------------------
44 #include "board.h"
45 #include "pin_mux.h"
46 #include "clock_config.h"
47 #include "fsl_debug_console.h"
48 
49 //-----------------------------------------------------------------------
50 // CMSIS Includes
51 //-----------------------------------------------------------------------
52 #include "Driver_I2C.h"
53 
54 //-----------------------------------------------------------------------
55 // ISSDK Includes
56 //-----------------------------------------------------------------------
57 #include "issdk_hal.h"
58 #include "gpio_driver.h"
59 #include "mma845x_drv.h"
60 
61 //-----------------------------------------------------------------------
62 // Constants
63 //-----------------------------------------------------------------------
64 /*! Prepare the register write list to configure MMA845x in non-FIFO and ISR mode. */
66  /*! Configure the MMA845x CTRL_REG1 to set mode to STANDBY and odr to 12.5Hz. */
68  /*! Configure the MMA845x to disable FIFO */
70  /*! Configure the MMA845x CTRL_REG2 to set the Oversampling mode to High Resolution. */
72  /*! Configure the MMA845x CTRL_REG3 to set the Interrupt polarity to ACTIVE high. */
74  /*! Configure the MMA845x CTRL_REG4 to enable the data ready interrupt. */
76  /*! Configure the MMA845x CTRL_REG5 to route Interrupt to INT1 pin. */
79 
80 /*! Prepare the register read list to read the Data Ready Status from MMA845x. */
82 
83 /*! Prepare the register read list to read the raw Accel data from MMA845x. */
86 
87 //-----------------------------------------------------------------------
88 // Global Variables
89 //-----------------------------------------------------------------------
90 volatile bool mma845xInterrupt = false;
91 
92 //-----------------------------------------------------------------------
93 // Functions
94 //-----------------------------------------------------------------------
95 /*! -----------------------------------------------------------------------
96  * @brief This is the Sensor Data Ready ISR implementation.
97  * @details This function sets the flag which indicates if a new sample(s) is available for reading.
98  * @param[in] pUserData This is a void pointer to the instance of the user specific data structure for the ISR.
99  * @return void There is no return value.
100  * @constraints None
101  * @reeentrant Yes
102  * -----------------------------------------------------------------------*/
103 void mma845x_isr(void *pUserData)
104 { /*! @brief Set flag to indicate Sensor has signalled data ready. */
105  mma845xInterrupt = true;
106 }
107 
108 /*! -----------------------------------------------------------------------
109  * @brief This is the The main function implementation.
110  * @details This function invokes board initializes routines, then then brings up the sensor and
111  * finally enters an endless loop to continuously read available samples.
112  * @param[in] void This is no input parameter.
113  * @return void There is no return value.
114  * @constraints None
115  * @reeentrant No
116  * -----------------------------------------------------------------------*/
117 int main(void)
118 {
119  int32_t status;
120  uint8_t data[MMA845x_ACCEL_DATA_SIZE];
122 
123  ARM_DRIVER_I2C *I2Cdrv = &I2C_S_DRIVER; // Now using the shield.h value!!!
124  mma845x_i2c_sensorhandle_t MMA845xdrv;
125  GENERIC_DRIVER_GPIO *gpioDriver = &Driver_GPIO_KSDK;
126 
127  /*! Initialize the MCU hardware. */
128  BOARD_InitPins();
131 
132  PRINTF("\r\n ISSDK MMA845x sensor driver example for interrupt mode.\r\n");
133 
134  /*! Initialize INT1 pin used by FRDM board */
135  gpioDriver->pin_init(&MMA845x_INT1, GPIO_DIRECTION_IN, NULL, &mma845x_isr, NULL);
136  /*! Initialize RGB LED pin used by FRDM board */
137  gpioDriver->pin_init(&GREEN_LED, GPIO_DIRECTION_OUT, NULL, NULL, NULL);
138 
139  /*! Initialize the I2C driver. */
140  status = I2Cdrv->Initialize(I2C_S_SIGNAL_EVENT);
141  if (ARM_DRIVER_OK != status)
142  {
143  PRINTF("\r\n I2C Initialization Failed\r\n");
144  return -1;
145  }
146 
147  /*! Set the I2C Power mode. */
148  status = I2Cdrv->PowerControl(ARM_POWER_FULL);
149  if (ARM_DRIVER_OK != status)
150  {
151  PRINTF("\r\n I2C Power Mode setting Failed\r\n");
152  return -1;
153  }
154 
155  /*! Set the I2C bus speed. */
156  status = I2Cdrv->Control(ARM_I2C_BUS_SPEED, ARM_I2C_BUS_SPEED_FAST);
157  if (ARM_DRIVER_OK != status)
158  {
159  PRINTF("\r\n I2C Control Mode setting Failed\r\n");
160  return -1;
161  }
162 
163  /*! Initialize the MMA845x sensor driver. */
166  if (SENSOR_ERROR_NONE != status)
167  {
168  PRINTF("\r\n Sensor Initialization Failed\r\n");
169  return -1;
170  }
171  PRINTF("\r\n Successfully Initiliazed Sensor\r\n");
172 
173  /*! Set the task to be executed while waiting for I2C transactions to complete. */
175 
176  /*! Configure the MMA845x sensor driver with No FIFO mode. */
177  status = MMA845x_I2C_Configure(&MMA845xdrv, mma845x_Config_Isr);
178  if (SENSOR_ERROR_NONE != status)
179  {
180  PRINTF("\r\n MMA845x Sensor Configuration Failed, Err = %d\r\n", status);
181  return -1;
182  }
183  PRINTF("\r\n Successfully Applied MMA845x Sensor Configuration\r\n");
184 
185  for (;;) /* Forever loop */
186  { /* In ISR Mode we do not need to check Data Ready Register.
187  * The receipt of interrupt will indicate data is ready. */
188  if (false == mma845xInterrupt)
189  { /* Loop, if new sample is not available. */
191  continue;
192  }
193  else
194  { /*! Clear the data ready flag, it will be set again by the ISR. */
195  mma845xInterrupt = false;
196  gpioDriver->toggle_pin(&GREEN_LED);
197  }
198 
199  /*! Read the raw sensor data from the MMA845x. */
200  status = MMA845x_I2C_ReadData(&MMA845xdrv, mma845x_Output_Values, data);
201  if (ARM_DRIVER_OK != status)
202  {
203  PRINTF("\r\n Read Failed. \r\n");
204  return -1;
205  }
206 
207  /*! Convert the raw sensor data to signed 16-bit container for display to the debug port. */
208  rawData.accel[0] = ((int16_t)data[0] << 8) | data[1];
209  rawData.accel[0] /= 4;
210  rawData.accel[1] = ((int16_t)data[2] << 8) | data[3];
211  rawData.accel[1] /= 4;
212  rawData.accel[2] = ((int16_t)data[4] << 8) | data[5];
213  rawData.accel[2] /= 4;
214 
215  /* NOTE: PRINTF is relatively expensive in terms of CPU time, specially when used with-in execution loop. */
216  PRINTF("\r\n Accel X = %d Y = %d Z = %d\r\n", rawData.accel[0], rawData.accel[1], rawData.accel[2]);
217  ASK_USER_TO_RESUME(100); /* Ask for user input after processing 100 samples. */
218  }
219 }
#define MMA845x_CTRL_REG5_INT_CFG_DRDY_INT1
Definition: mma845x.h:1921
const registerreadlist_t MMA845x_Data_Ready[]
#define __END_WRITE_DATA__
Definition: sensor_drv.h:71
int main(void)
This is the The main function implementation.
const registerwritelist_t mma845x_Config_Isr[]
This defines the sensor specific information.
Definition: mma845x_drv.h:55
void(* pin_init)(pinID_t aPinId, gpio_direction_t dir, void *apPinConfig, gpio_isr_handler_t aIsrHandler, void *apUserData)
Definition: Driver_GPIO.h:67
#define BOARD_BootClockRUN
Definition: clock_config.h:45
#define MMA845x_CTRL_REG3_IPOL_HIGH
Definition: mma845x.h:1770
int16_t accel[3]
Definition: mma845x_drv.h:67
uint8_t data[FXLS8962_DATA_SIZE]
int32_t status
void(* toggle_pin)(pinID_t aPinId)
Definition: Driver_GPIO.h:74
volatile bool mma845xInterrupt
void BOARD_InitDebugConsole(void)
Definition: board.c:41
void(* registeridlefunction_t)(void *userParam)
This is the register idle function type.
Definition: sensor_drv.h:123
void mma845x_isr(void *pUserData)
This is the Sensor Data Ready ISR implementation.
int32_t MMA845x_I2C_Initialize(mma845x_i2c_sensorhandle_t *pSensorHandle, ARM_DRIVER_I2C *pBus, uint8_t index, uint16_t sAddress, uint8_t whoAmi)
The interface function to initialize the sensor.
Definition: mma845x_drv.c:48
#define __END_READ_DATA__
Definition: sensor_drv.h:77
#define MMA845x_CTRL_REG2_MODS_HIGHRES
Definition: mma845x.h:1695
This structure defines the mma845x raw data buffer.
Definition: mma845x_drv.h:64
#define MMA845x_F_SETUP_F_MODE_FIFODISABLED
Definition: mma845x.h:311
gpioHandleKSDK_t GREEN_LED
Definition: frdm_k64f.c:214
#define MMA845x_CTRL_REG4_INT_EN_DRDY_ENABLED
Definition: mma845x.h:1846
#define ASK_USER_TO_RESUME(x)
Definition: frdm_k64f.h:132
const registerreadlist_t mma845x_Output_Values[]
#define MMA845x_I2C_ADDR
Definition: frdm_kl25z.h:128
#define I2C_S_DEVICE_INDEX
Definition: issdk_hal.h:61
int32_t MMA845x_I2C_ReadData(mma845x_i2c_sensorhandle_t *pSensorHandle, const registerreadlist_t *pReadList, uint8_t *pBuffer)
The interface function to read the sensor data.
Definition: mma845x_drv.c:130
#define I2C_S_DRIVER
Definition: issdk_hal.h:59
#define MMA845x_CTRL_REG1_MODE_STANDBY
Definition: mma845x.h:1625
GENERIC_DRIVER_GPIO Driver_GPIO_KSDK
Definition: gpio_driver.c:203
typedef int32_t(DATA_FORMAT_Append_t))(void *pData
The interface function to append the data on the formated stream.
#define MMA845x_INT1
Definition: frdm_kl25z.h:129
int32_t MMA845x_I2C_Configure(mma845x_i2c_sensorhandle_t *pSensorHandle, const registerwritelist_t *pRegWriteList)
The interface function to configure he sensor.
Definition: mma845x_drv.c:87
Access structure of the GPIO Driver.
Definition: Driver_GPIO.h:64
fxls8962_acceldataUser_t rawData
This structure defines the Write command List.
Definition: sensor_drv.h:94
This structure defines the Read command List.
Definition: sensor_drv.h:104
#define SMC
Definition: lpc54114.h:144
status_t SMC_SetPowerModeWait(void *arg)
Configures the system to WAIT power mode. API name used from Kinetis family to maintain compatibility...
Definition: lpc54114.c:181
void MMA845x_I2C_SetIdleTask(mma845x_i2c_sensorhandle_t *pSensorHandle, registeridlefunction_t idleTask, void *userParam)
: The interface function to set the I2C Idle Task.
Definition: mma845x_drv.c:79
#define MMA845x_ACCEL_DATA_SIZE
The size of the MMA845x accel data.
Definition: mma845x_drv.h:73
void BOARD_InitPins(void)
Configures pin routing and optionally pin electrical features.
Definition: pin_mux.c:73
#define I2C_S_SIGNAL_EVENT
Definition: issdk_hal.h:60
#define MMA8451_WHO_AM_I_WHOAMI_VALUE
Definition: mma845x.h:508
The mma845x_drv.h file describes the MMA845x driver interface and structures.
#define MMA845x_CTRL_REG1_DR_12DOT5HZ
Definition: mma845x.h:1636