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/HTS221/HTS221Sensor.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 HTS221Sensor.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 HTS221 Humidity and Temperature 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 __HTS221Sensor_H__
screamer	18:a15bfe7aaebd	42	#define __HTS221Sensor_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 "HTS221_driver.h"
screamer	18:a15bfe7aaebd	49	#include "HumiditySensor.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 HTS221 Humidity and Temperature sensor.
screamer	18:a15bfe7aaebd	57	*/
screamer	18:a15bfe7aaebd	58	class HTS221Sensor : public HumiditySensor, public TempSensor
screamer	18:a15bfe7aaebd	59	{
screamer	18:a15bfe7aaebd	60	public:
screamer	18:a15bfe7aaebd	61	HTS221Sensor(SPI *spi, PinName cs_pin=NC, PinName drdy_pin=NC); // SPI3W ONLY
screamer	18:a15bfe7aaebd	62	HTS221Sensor(DevI2C *i2c, uint8_t address=HTS221_I2C_ADDRESS, PinName drdy_pin=NC);
screamer	18:a15bfe7aaebd	63	virtual int init(void *init);
screamer	18:a15bfe7aaebd	64	virtual int read_id(uint8_t *id);
screamer	18:a15bfe7aaebd	65	virtual int get_humidity(float *pfData);
screamer	18:a15bfe7aaebd	66	virtual int get_temperature(float *pfData);
screamer	18:a15bfe7aaebd	67	int enable(void);
screamer	18:a15bfe7aaebd	68	int disable(void);
screamer	18:a15bfe7aaebd	69	int reset(void);
screamer	18:a15bfe7aaebd	70	int get_odr(float *odr);
screamer	18:a15bfe7aaebd	71	int set_odr(float odr);
screamer	18:a15bfe7aaebd	72	int read_reg(uint8_t reg, uint8_t *data);
screamer	18:a15bfe7aaebd	73	int write_reg(uint8_t reg, uint8_t data);
screamer	18:a15bfe7aaebd	74	/**
screamer	18:a15bfe7aaebd	75	* @brief Utility function to read data.
screamer	18:a15bfe7aaebd	76	* @param pBuffer: pointer to data to be read.
screamer	18:a15bfe7aaebd	77	* @param RegisterAddr: specifies internal address register to be read.
screamer	18:a15bfe7aaebd	78	* @param NumByteToRead: number of bytes to be read.
screamer	18:a15bfe7aaebd	79	* @retval 0 if ok, an error code otherwise.
screamer	18:a15bfe7aaebd	80	*/
screamer	18:a15bfe7aaebd	81	uint8_t io_read(uint8_t* pBuffer, uint8_t RegisterAddr, uint16_t NumByteToRead)
screamer	18:a15bfe7aaebd	82	{
screamer	18:a15bfe7aaebd	83	if (_dev_spi) {
screamer	18:a15bfe7aaebd	84	/* Write Reg Address */
screamer	18:a15bfe7aaebd	85	_dev_spi->lock();
screamer	18:a15bfe7aaebd	86	_cs_pin = 0;
screamer	18:a15bfe7aaebd	87	/* Write RD Reg Address with RD bit*/
screamer	18:a15bfe7aaebd	88	uint8_t TxByte = RegisterAddr \| 0x80;
screamer	18:a15bfe7aaebd	89	_dev_spi->write((char )&TxByte, 1, (char )pBuffer, (int) NumByteToRead);
screamer	18:a15bfe7aaebd	90	_cs_pin = 1;
screamer	18:a15bfe7aaebd	91	_dev_spi->unlock();
screamer	18:a15bfe7aaebd	92	return 0;
screamer	18:a15bfe7aaebd	93	}
screamer	18:a15bfe7aaebd	94	if (_dev_i2c) return (uint8_t) _dev_i2c->i2c_read(pBuffer, _address, RegisterAddr, NumByteToRead);
screamer	18:a15bfe7aaebd	95	return 1;
screamer	18:a15bfe7aaebd	96	}
screamer	18:a15bfe7aaebd	97
screamer	18:a15bfe7aaebd	98	/**
screamer	18:a15bfe7aaebd	99	* @brief Utility function to write data.
screamer	18:a15bfe7aaebd	100	* @param pBuffer: pointer to data to be written.
screamer	18:a15bfe7aaebd	101	* @param RegisterAddr: specifies internal address register to be written.
screamer	18:a15bfe7aaebd	102	* @param NumByteToWrite: number of bytes to write.
screamer	18:a15bfe7aaebd	103	* @retval 0 if ok, an error code otherwise.
screamer	18:a15bfe7aaebd	104	*/
screamer	18:a15bfe7aaebd	105	uint8_t io_write(uint8_t* pBuffer, uint8_t RegisterAddr, uint16_t NumByteToWrite)
screamer	18:a15bfe7aaebd	106	{
screamer	18:a15bfe7aaebd	107	if (_dev_spi) {
screamer	18:a15bfe7aaebd	108	_dev_spi->lock();
screamer	18:a15bfe7aaebd	109	_cs_pin = 0;
screamer	18:a15bfe7aaebd	110	int data = _dev_spi->write(RegisterAddr);
screamer	18:a15bfe7aaebd	111	_dev_spi->write((char *)pBuffer, (int) NumByteToWrite, NULL, 0);
screamer	18:a15bfe7aaebd	112	_cs_pin = 1;
screamer	18:a15bfe7aaebd	113	_dev_spi->unlock();
screamer	18:a15bfe7aaebd	114	return data;
screamer	18:a15bfe7aaebd	115	}
screamer	18:a15bfe7aaebd	116	if (_dev_i2c) return (uint8_t) _dev_i2c->i2c_write(pBuffer, _address, RegisterAddr, NumByteToWrite);
screamer	18:a15bfe7aaebd	117	return 1;
screamer	18:a15bfe7aaebd	118	}
screamer	18:a15bfe7aaebd	119
screamer	18:a15bfe7aaebd	120	private:
screamer	18:a15bfe7aaebd	121
screamer	18:a15bfe7aaebd	122	/* Helper classes. */
screamer	18:a15bfe7aaebd	123	DevI2C *_dev_i2c;
screamer	18:a15bfe7aaebd	124	SPI * _dev_spi;
screamer	18:a15bfe7aaebd	125
screamer	18:a15bfe7aaebd	126	/* Configuration */
screamer	18:a15bfe7aaebd	127	uint8_t _address;
screamer	18:a15bfe7aaebd	128	DigitalOut _cs_pin;
screamer	18:a15bfe7aaebd	129	InterruptIn _drdy_pin;
screamer	18:a15bfe7aaebd	130	};
screamer	18:a15bfe7aaebd	131
screamer	18:a15bfe7aaebd	132	#ifdef __cplusplus
screamer	18:a15bfe7aaebd	133	extern "C" {
screamer	18:a15bfe7aaebd	134	#endif
screamer	18:a15bfe7aaebd	135	uint8_t HTS221_io_write( void handle, uint8_t WriteAddr, uint8_t pBuffer, uint16_t nBytesToWrite );
screamer	18:a15bfe7aaebd	136	uint8_t HTS221_io_read( void handle, uint8_t ReadAddr, uint8_t pBuffer, uint16_t nBytesToRead );
screamer	18:a15bfe7aaebd	137	#ifdef __cplusplus
screamer	18:a15bfe7aaebd	138	}
screamer	18:a15bfe7aaebd	139	#endif
screamer	18:a15bfe7aaebd	140
screamer	18:a15bfe7aaebd	141	#endif