Firmware Library for X-NUCLEO-IKS01A1 (MEMS Inertial & Environmental Sensors) Expansion Board

Dependencies:   X_NUCLEO_COMMON ST_INTERFACES

Dependents:   MultiTech_Dragonfly_2015_ATT_Gov_Solutions_Hackathon_Example HelloWorld_IKS01A1 LoRaWAN-test-10secs ServoMotorDemo ... more

Fork of X_NUCLEO_IKS01A1 by ST Expansion SW Team

X-NUCLEO-IKS01A1 MEMS Inertial & Environmental Sensor Nucleo Expansion Board Firmware Package

Introduction

This firmware package includes Components Device Drivers and Board Support Package for STMicroelectronics' X-NUCLEO-IKS01A1 MEMS Inertial & Environmental Sensors Nucleo Expansion Board.

Firmware Library

Class X_NUCLEO_IKS01A1 is intended to represent the MEMS inertial & environmental sensors expansion board with the same name.

The expansion board is basically featuring four IPs:

  1. a HTS221 Relative Humidity and Temperature Sensor,
  2. a LIS3MDL 3-Axis Magnetometer,
  3. a LPS25H MEMS Pressure Sensor, and
  4. a LSM6DS0 3D Accelerometer and 3D Gyroscope

The expansion board features also a DIL 24-pin socket which makes it possible to add further MEMS adapters and other sensors (e.g. UV index).

It is intentionally implemented as a singleton because only one X_NUCLEO_IKS01A1 at a time might be deployed in a HW component stack. In order to get the singleton instance you have to call class method `Instance()`, e.g.:

// Sensors expansion board singleton instance
static X_NUCLEO_IKS01A1 *sensors_expansion_board = X_NUCLEO_IKS01A1::Instance();


Furthermore, library ST_INTERFACES contains all abstract classes which together constitute the common API to which all existing and future ST components will adhere to.

Example Applications

Revision:
71:78164ec41ad2
Parent:
57:04563dd74269
Child:
72:79a2a64c9b2f
--- a/x_nucleo_iks01a1.cpp	Fri Aug 14 15:47:40 2015 +0200
+++ b/x_nucleo_iks01a1.cpp	Mon Aug 31 12:07:22 2015 +0200
@@ -50,7 +50,7 @@
 X_NUCLEO_IKS01A1::X_NUCLEO_IKS01A1(DevI2C *ext_i2c) : dev_i2c(ext_i2c),
 	ht_sensor(new HTS221(*dev_i2c)),
 	magnetometer(new LIS3MDL(*dev_i2c)),
-	pressure_sensor(new LPS25H(*dev_i2c)),
+	pt_sensor(new LPS25H(*dev_i2c)),
 	gyro_lsm6ds0(new LSM6DS0(*dev_i2c)),
 	gyro_lsm6ds3(new LSM6DS3(*dev_i2c, IKS01A1_PIN_FF))
 { 
@@ -156,11 +156,11 @@
 	PRESSURE_InitTypeDef InitStructure;
 	
 	/* Check presence */
-	if((pressure_sensor->ReadID(&p_id) != PRESSURE_OK) ||
+	if((pt_sensor->ReadID(&p_id) != PRESSURE_OK) ||
 	   (p_id != I_AM_LPS25H))
 		{
-			delete pressure_sensor;
-			pressure_sensor = NULL;
+			delete pt_sensor;
+			pt_sensor = NULL;
 			return true;
 		}
             
@@ -172,7 +172,7 @@
 	InitStructure.PressureResolution = LPS25H_P_RES_AVG_32;
 	InitStructure.TemperatureResolution = LPS25H_T_RES_AVG_16;
         
-	if(pressure_sensor->Init(&InitStructure) != PRESSURE_OK)
+	if(pt_sensor->Init(&InitStructure) != PRESSURE_OK)
 		{
 			return false;
 		}