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

Introduction

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

Example Application

First of all, the example application outputs information retrieved from the Expansion Board over UART. Launch a terminal application (e.g.: PuTTY on Windows, Minicom on Linux) and set the UART port to 9600 bps, 8 bit, No Parity, 1 stop bit.

The "Sensors Reader" program is a more complex example of how to use the X-NUCLEO-IKS01A1 expansion board featuring among others:

Support for LSM6DS3 3D Accelerometer & Gyroscope (on DIL 24-pin socket) including free-fall detection
Usage of LED & Ticker
Exploitation of wait for event
(Top-/Bottom-Half) Interrupt handling

Files at this revision

API Documentation at this revision

Revision 33:7ba7fbf0503a, committed 2015-06-08

Comitter:: Wolfgang Betz
Date:: Mon Jun 08 15:36:36 2015 +0200
Parent:: 32:97bff5dadafd
Child:: 34:85196b3af1bc
Child:: 39:f934ffc5c0da
Commit message:: Add LSM6DS3 component

Changed in this revision

main.cpp

Show annotated file Show diff for this revision Revisions of this file

--- a/main.cpp	Mon Jun 08 13:46:20 2015 +0200
+++ b/main.cpp	Mon Jun 08 15:36:36 2015 +0200
@@ -52,6 +52,7 @@
 
 /*** Includes ----------------------------------------------------------------- ***/
 #include "mbed.h"
+#include "assert.h"
 #include "x_nucleo_iks01a1.h"
 
 #include <Ticker.h>
@@ -90,8 +91,8 @@
 #endif // DBG_MCU
 
 static X_NUCLEO_IKS01A1 *mems_expansion_board = X_NUCLEO_IKS01A1::Instance();
-static GyroSensor *gyroscope = mems_expansion_board->gyroscope;
-static MotionSensor *accelerometer = mems_expansion_board->gyroscope;
+static GyroSensor *gyroscope = mems_expansion_board->GetGyroscope();
+static MotionSensor *accelerometer = mems_expansion_board->GetAccelerometer();
 static MagneticSensor *magnetometer = mems_expansion_board->magnetometer;
 static HumiditySensor *humidity_sensor = mems_expansion_board->ht_sensor;;
 static PressureSensor *pressure_sensor = mems_expansion_board->pressure_sensor;
@@ -133,14 +134,30 @@
 
 /* Initialization function */
 static void init(void) {
-	uint8_t hts221_id_hum;
-	uint8_t hts221_id_temp;
+	uint8_t id1, id2;
 
 	/* Determine ID of Humidity & Temperature Sensor */
-	CALL_METH(humidity_sensor, ReadID, &hts221_id_hum, 0x0);
-	CALL_METH(temp_sensor1, ReadID, &hts221_id_temp, 0x0);
-    	printf("HTS221_ID (Humidity)    = 0x%x (%u)\n", hts221_id_hum, hts221_id_hum);
-    	printf("HTS221_ID (Temperature) = 0x%x (%u)\n", hts221_id_temp, hts221_id_temp);
+	CALL_METH(humidity_sensor, ReadID, &id1, 0x0);
+	CALL_METH(temp_sensor1, ReadID, &id2, 0x0);
+    	printf("Humidity  | Temperature Sensor ID = %s (0x%x | 0x%x)\n", 
+	       ((id1 == I_AM_HTS221) ? "HTS221 " : "UNKNOWN"),
+	       id1, id2
+	       );
+	assert(id1 == id2);
+
+	/* Determine ID of Gyro & Motion Sensor */
+	assert((mems_expansion_board->gyro_lsm6ds0 == NULL) ||
+	       (mems_expansion_board->gyro_lsm6ds3 == NULL));
+	CALL_METH(gyroscope, ReadID, &id1, 0x0);
+	CALL_METH(accelerometer, ReadID, &id2, 0x0);
+    	printf("Gyroscope | Motion Sensor ID      = %s (0x%x | 0x%x)\n", 
+	       ((id1 == I_AM_LSM6DS3_XG) ? "LSM6DS3" : 
+		((id1 == I_AM_LSM6DS0_XG) ? "LSM6DS0" : "UNKNOWN")),
+	       id1, id2
+	       );
+	assert(id1 == id2);
+
+	wait(1.5);
 }
 
 /* Main cycle function */