pelion-example-disco-iot01 - Mbed OS and Pelion Device Management example over…

ST » Code » pelion-example-disco-iot01

Mbed OS and Pelion Device Management example over WIFI for DISCO_L475VG_IOT01 board

Dependencies: X_NUCLEO_COMMON ST_INTERFACES

DEPRECATED

This example application is not maintained and not recommended. It uses an old version of Mbed OS, Pelion DM and Arm toolchain. It doesn't work with Mbed Studio.

Please use: https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-pelion/

This example is known to work on the following platforms:

DISCO_L475E_IOT01A over WiFI and using onboard QSPI flash.

DISCO_L475E_IOT01A

Follow the Quick-Start instructions: https://cloud.mbed.com/quick-start

Example functionality

This example showcases the following device functionality:

Read onboard temperature and humidity sensors, and report them as Pelion LWM2M resources (see image below).
On user button click, increment Pelion LWM2M button resource.
Allow the user to change the state of the board LED from Pelion LWM2M led_state resource and PUT request.
Uses all onboard sensors and reports them as Pelion LWM2M resources.

/media/uploads/screamer/pelion_st_humidity_reading.png?v=2

Use this example with Mbed CLI

1. Import the application into your desktop:

mbed import https://os.mbed.com/teams/ST/code/pelion-example-disco-iot01

cd pelion-example-disco-iot01

2. Install the CLOUD_SDK_API_KEY

mbed config -G CLOUD_SDK_API_KEY <PELION_DM_API_KEY>

For instructions on how to generate your API key, please see the documentation.

3. Initialize firmware credentials (done once per repository). You can use the following command:

mbed dm init -d "<your company name in Pelion DM>" --model-name "<product model identifier>" -q --force

If above command do not work for your Mbed CLI, please consider upgrading Mbed CLI to version 1.8.x or above.

4. Compile and program:

mbed compile -t <toolchain> -m DISCO_L475VG_IOT01A

(supported toolchains : GCC_ARM / ARM / IAR)

5. You can connect on a virtual terminal/COM port to the platform using:

mbed sterm -b 115200

This should give you an output similar to:

[BOOT] Mbed Bootloader
[BOOT] ARM: 00000000000000000000
[BOOT] OEM: 00000000000000000000
[BOOT] Layout: 0 80096F4
[BOOT] Active firmware integrity check:
[BOOT] SHA256: 0660E360D432225D5251461998FD8617B017098C5F1F90D5FB607BF8C27ED530
[BOOT] Version: 1553615309
[BOOT] Slot 0 is empty
[BOOT] Active firmware up-to-date
[BOOT] Application's start address: 0x8010400
[BOOT] Application's jump address: 0x8011041
[BOOT] Application's stack address: 0x20018000
[BOOT] Forwarding to application...

Starting Simple Pelion Device Management Client example
You can hold the user button during boot to format the storage and change the device identity.

Sensors configuration:
Invalid new address!
HTS221  humidity & temperature    = 0xBC
LPS22HB pressure & temperature    = 0xB1
LIS3MDL magnetometer              = 0x3D
LSM6DSL accelerometer & gyroscope = 0x6A

Connecting to the network using Wifi...
Connected to the network successfully. IP address: 192.168.1.3
Initializing Pelion Device Management Client...
Initialized Pelion Client. Registering...
Registered to Pelion Device Management. Endpoint Name: 0169********************001002d5

ADC temp:     23.0037 C,  vref:      0.3661 V
HTS221 temp:   28.700 C,  humidity:   31.90 %
LPS22HB temp:  29.600 C,  pressure: 1032.01 mbar
LIS3MDL mag:    0.217 x,  -0.284 y,  -0.053 z [gauss]
LSM6DSL acc:    0.005 x,  -0.014 y,   1.029 z [g]
LSM6DSL gyro:   0.910 x,  -0.910 y,   1.120 z [dps]
VL53L0X dist:    1855 mm

sensors/LPS22HB/LPS22HBSensor.h@36:aaf44d2a6c33, 2020-03-13 (annotated)

Committer:: chris
Date:: Fri Mar 13 13:18:07 2020 +0000
Revision:: 36:aaf44d2a6c33
Parent:: 18:a15bfe7aaebd

First revision

Who changed what in which revision?

User	Revision	Line number	New contents of line
screamer	18:a15bfe7aaebd	1	/**
screamer	18:a15bfe7aaebd	2	******************************************************************************
screamer	18:a15bfe7aaebd	3	* @file LPS22HBSensor.h
screamer	18:a15bfe7aaebd	4	* @author CLab
screamer	18:a15bfe7aaebd	5	* @version V1.0.0
screamer	18:a15bfe7aaebd	6	* @date 5 August 2016
screamer	18:a15bfe7aaebd	7	* @brief Abstract Class of an LPS22HB Pressure sensor.
screamer	18:a15bfe7aaebd	8	******************************************************************************
screamer	18:a15bfe7aaebd	9	* @attention
screamer	18:a15bfe7aaebd	10	*
screamer	18:a15bfe7aaebd	11	* <h2><center>© COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
screamer	18:a15bfe7aaebd	12	*
screamer	18:a15bfe7aaebd	13	* Redistribution and use in source and binary forms, with or without modification,
screamer	18:a15bfe7aaebd	14	* are permitted provided that the following conditions are met:
screamer	18:a15bfe7aaebd	15	* 1. Redistributions of source code must retain the above copyright notice,
screamer	18:a15bfe7aaebd	16	* this list of conditions and the following disclaimer.
screamer	18:a15bfe7aaebd	17	* 2. Redistributions in binary form must reproduce the above copyright notice,
screamer	18:a15bfe7aaebd	18	* this list of conditions and the following disclaimer in the documentation
screamer	18:a15bfe7aaebd	19	* and/or other materials provided with the distribution.
screamer	18:a15bfe7aaebd	20	* 3. Neither the name of STMicroelectronics nor the names of its contributors
screamer	18:a15bfe7aaebd	21	* may be used to endorse or promote products derived from this software
screamer	18:a15bfe7aaebd	22	* without specific prior written permission.
screamer	18:a15bfe7aaebd	23	*
screamer	18:a15bfe7aaebd	24	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
screamer	18:a15bfe7aaebd	25	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
screamer	18:a15bfe7aaebd	26	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
screamer	18:a15bfe7aaebd	27	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
screamer	18:a15bfe7aaebd	28	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
screamer	18:a15bfe7aaebd	29	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
screamer	18:a15bfe7aaebd	30	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
screamer	18:a15bfe7aaebd	31	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
screamer	18:a15bfe7aaebd	32	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
screamer	18:a15bfe7aaebd	33	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
screamer	18:a15bfe7aaebd	34	*
screamer	18:a15bfe7aaebd	35	******************************************************************************
screamer	18:a15bfe7aaebd	36	*/
screamer	18:a15bfe7aaebd	37
screamer	18:a15bfe7aaebd	38
screamer	18:a15bfe7aaebd	39	/* Prevent recursive inclusion -----------------------------------------------*/
screamer	18:a15bfe7aaebd	40
screamer	18:a15bfe7aaebd	41	#ifndef __LPS22HBSensor_H__
screamer	18:a15bfe7aaebd	42	#define __LPS22HBSensor_H__
screamer	18:a15bfe7aaebd	43
screamer	18:a15bfe7aaebd	44
screamer	18:a15bfe7aaebd	45	/* Includes ------------------------------------------------------------------*/
screamer	18:a15bfe7aaebd	46
screamer	18:a15bfe7aaebd	47	#include "DevI2C.h"
screamer	18:a15bfe7aaebd	48	#include "LPS22HB_driver.h"
screamer	18:a15bfe7aaebd	49	#include "PressureSensor.h"
screamer	18:a15bfe7aaebd	50	#include "TempSensor.h"
screamer	18:a15bfe7aaebd	51	#include <assert.h>
screamer	18:a15bfe7aaebd	52
screamer	18:a15bfe7aaebd	53	/* Class Declaration ---------------------------------------------------------*/
screamer	18:a15bfe7aaebd	54
screamer	18:a15bfe7aaebd	55	/**
screamer	18:a15bfe7aaebd	56	* Abstract class of an LPS22HB Pressure sensor.
screamer	18:a15bfe7aaebd	57	*/
screamer	18:a15bfe7aaebd	58	class LPS22HBSensor : public PressureSensor, public TempSensor
screamer	18:a15bfe7aaebd	59	{
screamer	18:a15bfe7aaebd	60	public:
screamer	18:a15bfe7aaebd	61
screamer	18:a15bfe7aaebd	62	enum SPI_type_t {SPI3W, SPI4W};
screamer	18:a15bfe7aaebd	63	LPS22HBSensor(SPI *spi, PinName cs_pin, PinName int_pin=NC, SPI_type_t spi_type=SPI4W);
screamer	18:a15bfe7aaebd	64	LPS22HBSensor(DevI2C *i2c, uint8_t address=LPS22HB_ADDRESS_HIGH, PinName int_pin=NC);
screamer	18:a15bfe7aaebd	65	virtual int init(void *init);
screamer	18:a15bfe7aaebd	66	virtual int read_id(uint8_t *id);
screamer	18:a15bfe7aaebd	67	virtual int get_pressure(float *pfData);
screamer	18:a15bfe7aaebd	68	virtual int get_temperature(float *pfData);
screamer	18:a15bfe7aaebd	69	int enable(void);
screamer	18:a15bfe7aaebd	70	int disable(void);
screamer	18:a15bfe7aaebd	71	int reset(void);
screamer	18:a15bfe7aaebd	72	int get_odr(float *odr);
screamer	18:a15bfe7aaebd	73	int set_odr(float odr);
screamer	18:a15bfe7aaebd	74	int read_reg(uint8_t reg, uint8_t *data);
screamer	18:a15bfe7aaebd	75	int write_reg(uint8_t reg, uint8_t data);
screamer	18:a15bfe7aaebd	76
screamer	18:a15bfe7aaebd	77	/**
screamer	18:a15bfe7aaebd	78	* @brief Utility function to read data.
screamer	18:a15bfe7aaebd	79	* @param pBuffer: pointer to data to be read.
screamer	18:a15bfe7aaebd	80	* @param RegisterAddr: specifies internal address register to be read.
screamer	18:a15bfe7aaebd	81	* @param NumByteToRead: number of bytes to be read.
screamer	18:a15bfe7aaebd	82	* @retval 0 if ok, an error code otherwise.
screamer	18:a15bfe7aaebd	83	*/
screamer	18:a15bfe7aaebd	84	uint8_t io_read(uint8_t* pBuffer, uint8_t RegisterAddr, uint16_t NumByteToRead)
screamer	18:a15bfe7aaebd	85	{
screamer	18:a15bfe7aaebd	86	if (_dev_spi) {
screamer	18:a15bfe7aaebd	87	/* Write Reg Address */
screamer	18:a15bfe7aaebd	88	_dev_spi->lock();
screamer	18:a15bfe7aaebd	89	_cs_pin = 0;
screamer	18:a15bfe7aaebd	90	if (_spi_type == SPI4W) {
screamer	18:a15bfe7aaebd	91	_dev_spi->write(RegisterAddr \| 0x80);
screamer	18:a15bfe7aaebd	92	for (int i=0; i<NumByteToRead; i++) {
screamer	18:a15bfe7aaebd	93	*(pBuffer+i) = _dev_spi->write(0x00);
screamer	18:a15bfe7aaebd	94	}
screamer	18:a15bfe7aaebd	95	} else if (_spi_type == SPI3W){
screamer	18:a15bfe7aaebd	96	/* Write RD Reg Address with RD bit*/
screamer	18:a15bfe7aaebd	97	uint8_t TxByte = RegisterAddr \| 0x80;
screamer	18:a15bfe7aaebd	98	_dev_spi->write((char )&TxByte, 1, (char )pBuffer, (int) NumByteToRead);
screamer	18:a15bfe7aaebd	99	}
screamer	18:a15bfe7aaebd	100	_cs_pin = 1;
screamer	18:a15bfe7aaebd	101	_dev_spi->unlock();
screamer	18:a15bfe7aaebd	102	return 0;
screamer	18:a15bfe7aaebd	103	}
screamer	18:a15bfe7aaebd	104	if (_dev_i2c) return (uint8_t) _dev_i2c->i2c_read(pBuffer, _address, RegisterAddr, NumByteToRead);
screamer	18:a15bfe7aaebd	105	return 1;
screamer	18:a15bfe7aaebd	106	}
screamer	18:a15bfe7aaebd	107
screamer	18:a15bfe7aaebd	108	/**
screamer	18:a15bfe7aaebd	109	* @brief Utility function to write data.
screamer	18:a15bfe7aaebd	110	* @param pBuffer: pointer to data to be written.
screamer	18:a15bfe7aaebd	111	* @param RegisterAddr: specifies internal address register to be written.
screamer	18:a15bfe7aaebd	112	* @param NumByteToWrite: number of bytes to write.
screamer	18:a15bfe7aaebd	113	* @retval 0 if ok, an error code otherwise.
screamer	18:a15bfe7aaebd	114	*/
screamer	18:a15bfe7aaebd	115	uint8_t io_write(uint8_t* pBuffer, uint8_t RegisterAddr, uint16_t NumByteToWrite)
screamer	18:a15bfe7aaebd	116	{
screamer	18:a15bfe7aaebd	117	if (_dev_spi) {
screamer	18:a15bfe7aaebd	118	_dev_spi->lock();
screamer	18:a15bfe7aaebd	119	_cs_pin = 0;
screamer	18:a15bfe7aaebd	120	int data = _dev_spi->write(RegisterAddr);
screamer	18:a15bfe7aaebd	121	_dev_spi->write((char *)pBuffer, (int) NumByteToWrite, NULL, 0);
screamer	18:a15bfe7aaebd	122	_cs_pin = 1;
screamer	18:a15bfe7aaebd	123	_dev_spi->unlock();
screamer	18:a15bfe7aaebd	124	return data;
screamer	18:a15bfe7aaebd	125	}
screamer	18:a15bfe7aaebd	126	if (_dev_i2c) return (uint8_t) _dev_i2c->i2c_write(pBuffer, _address, RegisterAddr, NumByteToWrite);
screamer	18:a15bfe7aaebd	127	return 1;
screamer	18:a15bfe7aaebd	128	}
screamer	18:a15bfe7aaebd	129
screamer	18:a15bfe7aaebd	130	private:
screamer	18:a15bfe7aaebd	131	int Set_ODR_When_Enabled(float odr);
screamer	18:a15bfe7aaebd	132	int Set_ODR_When_Disabled(float odr);
screamer	18:a15bfe7aaebd	133
screamer	18:a15bfe7aaebd	134	/* Helper classes. */
screamer	18:a15bfe7aaebd	135	DevI2C *_dev_i2c;
screamer	18:a15bfe7aaebd	136	SPI *_dev_spi;
screamer	18:a15bfe7aaebd	137
screamer	18:a15bfe7aaebd	138	/* Configuration */
screamer	18:a15bfe7aaebd	139	uint8_t _address;
screamer	18:a15bfe7aaebd	140	DigitalOut _cs_pin;
screamer	18:a15bfe7aaebd	141	InterruptIn _int_pin;
screamer	18:a15bfe7aaebd	142	SPI_type_t _spi_type;
screamer	18:a15bfe7aaebd	143
screamer	18:a15bfe7aaebd	144	uint8_t _is_enabled;
screamer	18:a15bfe7aaebd	145	float _last_odr;
screamer	18:a15bfe7aaebd	146	};
screamer	18:a15bfe7aaebd	147
screamer	18:a15bfe7aaebd	148	#ifdef __cplusplus
screamer	18:a15bfe7aaebd	149	extern "C" {
screamer	18:a15bfe7aaebd	150	#endif
screamer	18:a15bfe7aaebd	151	uint8_t LPS22HB_io_write( void handle, uint8_t WriteAddr, uint8_t pBuffer, uint16_t nBytesToWrite );
screamer	18:a15bfe7aaebd	152	uint8_t LPS22HB_io_read( void handle, uint8_t ReadAddr, uint8_t pBuffer, uint16_t nBytesToRead );
screamer	18:a15bfe7aaebd	153	#ifdef __cplusplus
screamer	18:a15bfe7aaebd	154	}
screamer	18:a15bfe7aaebd	155	#endif
screamer	18:a15bfe7aaebd	156
screamer	18:a15bfe7aaebd	157	#endif