Garage Door Monitor and Opener

Dependencies:   X_NUCLEO_COMMON ST_INTERFACES

Introduction

This system implements a simple garage door opener and environmental monitor. The hardware connects to the internet using Wi-Fi then on to the Pelion Device Management Platform which provides device monitoring and secure firmware updates over the air (FOTA). Pelion Device Management provides a flexible set of REST APIs which we will use to communicate to a web application running on an EC-2 instance in AWS. The web application will serve a web page where we can monitor and control our garage..

This project is intended to work on the DISCO-L475VG-IOT01A from ST Microelectronics It implements a simple actuator to drive a relay to simulate pushing the "open" button on older style garage doors which do not use a rolling code interface.

The system is designed to be mounted over the door so that the on board time of flight sensor can be used to detect if the door is open or closed.

The system also monitors temperature, humidity and barometric pressure.

https://os.mbed.com/media/uploads/JimCarver/garageopener.jpg

Hardware Requirements:

DISCO-L475G-IOT01A https://os.mbed.com/platforms/ST-Discovery-L475E-IOT01A/

Seeed Studio Grove Relay module https://www.seeedstudio.com/Grove-Relay.html

Seeed Studio Grove cable, I used this one: https://www.seeedstudio.com/Grove-4-pin-Male-Jumper-to-Grove-4-pin-Conversion-Cable-5-PCs-per-Pack.html

Connect to the PMOD connector like this:

https://os.mbed.com/media/uploads/JimCarver/opener.jpg

This shows how I installed so that the time of flight sensor can detect when the door is open

https://os.mbed.com/media/uploads/JimCarver/opener1.jpg https://os.mbed.com/media/uploads/JimCarver/opener2.jpg

To use the project:

You will also need a Pelion developers account.

I suggest you first use the Pelion quick state to become familiar with Pelion Device Management. https://os.mbed.com/guides/connect-device-to-pelion/1/?board=ST-Discovery-L475E-IOT01A

Web Interface

For my web interface I am running node-red under Ubuntu in an EC2 instance on AWS. This can run for 12 month within the constraints of their free tier. Here is a tutorial: https://nodered.org/docs/getting-started/aws

You will also need to install several node-red add ons:

sudo npm install -g node-red-dashboard

sudo npm install -g node-red-contrib-mbed-cloud

sudo npm istall -g node-red-contrib-moment

After starting node-red import the contents of GarageFlow.txt from the project, pin the flow into the page.

To enable your web app to access your Pelion account you need an API key.

First you will neet to use your Pelion account to create an API key.

https://os.mbed.com/media/uploads/JimCarver/api_portal.jpg

Now we need to apply that API key to your Node-Red flow.

https://os.mbed.com/media/uploads/JimCarver/api_node-red.jpg

Committer:
JimCarver
Date:
Thu Dec 05 19:03:48 2019 +0000
Revision:
37:ec1124e5ec1f
Parent:
18:a15bfe7aaebd
Bug fix

Who changed what in which revision?

UserRevisionLine numberNew 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>&copy; 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