Smart Car Parking. Accelerator DDM & LWM2M Setup

Transcription

1 Smart Car Parking Accelerator DDM & LWM2M Setup 1

2 2

3 Table of Contents The APPIoT & LWM2M PoC General Information Introduction Hight level architect Setting up the Bootstrap Server with Security Settings Bootstrap Server Security Settings Configuration for APPIoT Register a Gateway Register a device Add Device Type to Smart Object Eclipse Leshan Leshan Installation and Development on Linux using Eclipse IDE Leshan Installation and Development on Windows using Eclipse IDE Developing LWM2M client using leshan-client-demo Distance measurement project Build and Run project Verify the Client Connection and show data on chart Interfacing HY-SRF05 Ultrasonic Sensor with Raspberry Pi 3 Model B APPIoT API used in web portal Create API Key Get the device network ID Get sensor s ID Get sensor s data from APPIoT Code

4 1. General Information 1.1 Introduction A smart car parking is a system that helps drivers to find a vacant spot using the sensors in each parking space by detecting the presence or absence of a vehicle. 1.2 Hight level architect LWM2M Server LWM2M M2M APPIoT LWM2M HTTPS LWM2M Client HY-SRF05 Raspberry Pi 3 M2M Device Web Application 4

5 Smart Car Parking is designed with HY-SRF05 Ultrasonic sensors which measure distance. All sensors integated to Raspberry Pi 3 Model B board. The sensor s data will send to APPIoT via LWM2M protocol. Smart Car Parking system include web application. We can monitor all with chart visualization from web. 2. Setting up the Bootstrap Server with Security Settings This section describes the steps to setup a Bootstrap Server with Security Settings. Note: The section is only valid if you have direct access to the bootstrap server. In most cases the setup of the bootstrap server is done via the AppIoT/DDM-application when registering a device. 2.1 Bootstrap Server - Please go to the URL: - Click on the Add new client bootstrap configuration button - Provide the Client endpoint, Identity and Key 5

6 6

7 Example: Client endpoint: tma_iot Identity: raspberrypi3 Key (secret in hexadecimal): (7777 ASCII) - Click on Create button to save the setting 2.2 Security Settings - Please go to the URL: - Click on the Add new client security configuration button - Provide the Client endpoint, Identity and Key - Click on Create button to save the setting 7

8 3. Configuration for APPIoT - Please go to the URL: (use Google Chrome browser) - Click on Sign in button - Enter username, password and click on Sign in Button (You need register a account before) If you have successful log in, you will see APPIoT Dashboard as follows: 8

9 3.1 Register a Gateway - Please click on Register Gateway button to create a new Gateway of the type LWM2M-GW - Provide the Serial Number and Gateway Type 9

10 Example: Serial Number: Gateway type: LwM2M Gateway - Click on Continue button - Enter name of Gateway Example: Name: CarParkingGateway - Click on Register button to save the setting - Click on CarParkingGateway link button 10

11 - Setting Category: LwM2MServer, click on Edit button for the setting category - Insert URL: coaps://customerxxx-appiot-lwm2m-server.xxx.cloudapp.azure.com:5684 Note: If the setting category is not present on the GW, click Action and add this to the GW. - Click Save button to save the setting 3.2 Register a device - Please click on Register Device button to create a new Device 11

12 - Provide the Name, Device Identifier (endpoint), Device Type, Template, Gateway, Bootstrap Server, Identity and presharedkey 12

13 Example: Name: CarpParkingDevice Device Identifier (endpoint): tma_iot Device Type: select the DevLwM2mWithPSK Template: Default Bootstrap Server: select the DEMO_BOOTSTRAP_2 Identity: raspberrypi3 (must be same as Bootstrap Device Identity) presharedkey: 7777 (must be same as Bootstrap Secret Key in ASCII) - Click on Register button to register the device - Verify LWM2M server connection to Bootstrap by refresh URL: Add Device Type to Smart Object After registering device, we need add Device Type to Smart Object. In this document, we do an example to measure the distance with HY-SRF05 Ultrasonic sensor and Raspberry Pi 3 Model B. So we need add a device Distance to Smart Object from Device Type. - Click on the Device Type link button - Click on Add Smart Object Type button 13

14 - Select Distance(3330) and click on Add button - Click on Save button to save the setting The Distance device have added to Smart Objects 14

15 4. Eclipse Leshan We have used the leshan client to connect the smart objects with APPIoT. Please follow the following steps to connect the device using leshan client framework with APPIoT. The following steps to be followed to connect the client with the APPIoT platform. 4.1 Leshan Installation and Development on Linux using Eclipse IDE Apache Maven (or higher) and JDK8 (or higher) have been installed on the Ubuntu and their directory have been set to the PATH environment variable during the shell launch (.bashrc) and therefore can be called from any location. Version of Maven and Java Development Kit - Download and install Eclipse IDE for Java EE developer from URL: (This document use Eclipse Oxygen) - Download the zip distribution of eclipse/leshan version 1.0 from URL: - Extract the zip file in to the Eclipse Workspace directory - Open Eclipse and import the Leshan project to Eclipse by accessing File > Import> Maven > Existing Maven Projects and specify the directory of the project in the Eclipse Workspace folder 15

16 - Add jre8 to the Installed JREs menu in Window > Preferences > Java > Installed JREs, and set jre8 as default execution environment - You need to add the M2_REPO to your java classpath variables. To do that you can execute the following command: mvn -Declipse.workspace=<path-to-eclipse-workspace> eclipse:eclipse:configureworkspace - An eclipse restart is needed (if you already have it open). - You can also do that inside eclipse: From the menu bar, select Window > Preferences. Select the Java > Build Path > Classpath Variables page. - Now, you need to eclipsify leshan java projects, so run: mvn eclipse:eclipse 16

17 - Leshan project after importing into Eclipse 4.2 Leshan Installation and Development on Windows using Eclipse IDE You do the same things on Linux, but only different in setting up enviroment variables for Java and Maven. - Set up JAVA environment variables (for Windows 8 and Windows 10) 1. Make sure JDK is installed 2. Open Advanced system settings link. 3. Click Environment Variables. 17

18 4. In System variables, add a new JAVA_HOME variable and point it to the JDK installed folder. 5. In System variables, find PATH, clicks edit and append this %JAVA_HOME%\bin to the end 18

19 - Set up MAVEN environment variables (for Windows 8 and Windows 10) 1. Download Apache Maven from link 2. Unzip it to the folder you want to install Maven (Ex: C:\Program Files\apache-maven ) 3. Add both M2_HOME and MAVEN_HOME variables in the Windows environment, and point it to your Maven folder 4. Update PATH variable, append Maven bin folder %M2_HOME%\bin. 5. Done, to verify it, run mvn version in the command prompt. 19

20 4.3 Developing LWM2M client using leshan-client-demo Distance measurement project - Open leshan-client-demo project: a sample of LWM2M client - In the leshan-client-demo project, three object classes are created: MyDevice.java, MyLocation.java and RandomTemperatureSensor.java. You can use one of these classes as a template for your new objects. - In the package org.eclipse.leshan.client.demo, we create new classes with name DistanceSensor.java (view code in section 7) with some functions such as: Function name public DistanceSensor() private synchronized void adjustdistance() private double gettwodigitvalue(float value) public synchronized ReadResponse read(int resourceid) public synchronized ExecuteResponse execute(int resourceid, String params) private Integer adjustminmaxmeasuredvalue(float newdistance) Description Construction function use to initialize variables, pin modes, set schedule to read sensor s data and post to APPIoT Read sensor s data from HY-SRF05 Ultrasonic sensor Round number, takes only two decimal Return min, max, current value of sensor s data; min range, max range value, sensor unit Executing commands reset min max value from user Adjust min max measured value 20

21 private void resetminmaxmeasuredvalues() Reset min max measured value - Please go to the URL: - Add Pi4j library version 1.2 (Java I/O library for the Raspberry Pi) dependency in pom.xml file of leshan-client-demo projects (view code in section 7) - Please go to the URL: - Download 3330.xml file - Copy 3330.xml file and past in package src/main/resources/models - Open LeshanClientDemo.java file and initialize the DistanceSensor objects such as 21

22 22

23 4.3.2 Build and Run project - Right click on leshan-client-demo project > Run as > Maven build - Type clean install in the Goals text box - After successful build, 3.jar files are created Caution: On windows, you may get some errorrs when building the project. So, you open pom.xml file in leshan folder find and disable leshan-integration-tests module, after building again. - Copy leshan-client-demo snapshot-jar-with-dependencies.jar to raspberry - Make sure JDK have been installed on the Raspberry and their directory have been set to the PATH environment variable during the shell launch (.bashrc) - Run the client demo jar with the following options: java -jar leshan-client-demo snapshot-jar-with-dependencies.jar -u customerxxxdemo-lwm2m-bootstrap-server.japanwest.cloudapp.azure.com:5684 -n tma_iot -i raspberrypi3 -p b Where: customerxxx-demo-lwm2m-bootstrap-server.japanwest.cloudapp.azure.com:5684 is the bootstrap Server URL (DEMO_BOOTSTRAP_2) with PSK security tma_iot is the endpoint raspberrypi3 is the PSK Device Identity 23

24 is PSK key in Hex (7777 ASCII) -b option for bootstrapping Verify the Client Connection and show data on chart Once the configuration of LWM2M client is completed verify the connection by monitoring the smart object resource values in APPIoT portal. Below snapshot showing the Distance sensor value being read from the HY-SRF05 Ultrasonic sensor connect with Raspberry Pi 3 Model client. On Raspberry On LWM2M Server On APPIoT On Web Application 24

25 5. Interfacing HY-SRF05 Ultrasonic Sensor with Raspberry Pi 3 Model B Thera are four pins on the HY-SRF05 ultrasonic module that are connected to the Raspberry Pi 3 Model B. Raspberry Pi 3 Model B HY-SRF05 5V (pin 4) Vcc GND (pin 20) GND GPIO 0 (pin 11) Trig GPIO 2 (pin 13) Echo 25

26 6. APPIoT API used in web portal Web portal will GET sensor's data from APPIoT and display on bar charts. Get Sensor s data via https get with configuration as below: 6.1 Create API Key - Please go to APPIoT: - Create API key by accessing Settings > ApiKeys - Click on Create button - Provice the Name - Click on Save button to save the setting 6.2 Get the device network ID - Click on user icon and select about 26

27 - In about form you will see Current Device Network ID 6.3 Get sensor s ID - Click on sensor value of Distance in Smart Object - From URL in browser you can see ID of sensor value 27

28 6.4 Get sensor s data from APPIoT var baseurl = " var authorization = "<For Security Remove: Replace your Base64 String>"; var devicenetwork = "d74ab707-b8fb-420e-a56a-4aca544a1912"; var sensorid = "c8f3a3d5-b26e-45b3-a220-9bd33739a587"; //Header for getting sensor's data var requestheader = { url: baseurl + ' api/v3/resources/' + sensorid, method: 'GET', headers: { 'Authorization': authorization, 'X-DeviceNetwork': devicenetwork ; //And we have to authorize via https header and get data to display on bar chart as below: $http(requestheader).success(function(data) { if ((data!= null) && (data.latestmeasurement.v!= undefined)) { barevent("#bar_distance", parsefloat(data.latestmeasurement.v)); else { console.log("distance value incorrect"); ).error(function(error) { console.log("error: " + error); ); 28

29 7. Code - Class DistanceSensor.java import java.math.bigdecimal; import java.math.roundingmode; import java.util.concurrent.executors; import java.util.concurrent.scheduledexecutorservice; import java.util.concurrent.timeunit; import org.eclipse.leshan.client.resource.baseinstanceenabler; import org.eclipse.leshan.core.response.executeresponse; import org.eclipse.leshan.core.response.readresponse; import org.eclipse.leshan.util.namedthreadfactory; import com.pi4j.io.gpio.gpiocontroller; import com.pi4j.io.gpio.gpiofactory; import com.pi4j.io.gpio.gpiopindigitalinput; import com.pi4j.io.gpio.gpiopindigitaloutput; import com.pi4j.io.gpio.pinpullresistance; import com.pi4j.io.gpio.raspipin; public class DistanceSensor extends BaseInstanceEnabler { private static final Float UNIT_DISTANCE = 0.0f; private static final int SENSOR_VALUE = 5700; private static final int SENSOR_UNIT = 5701; private static final int MIN_MEASURED_VALUE = 5601; private static final int MAX_MEASURED_VALUE = 5602; private static final int MIN_RANGE_VALUE = 5603; private static final int MAX_RANGE_VALUE = 5604; private static final int RESET_MIN_MAX_MEASURED_VALUES = 5605; private static final String CALIBRATION = "Calibration"; private static final int CURENT_CALIBRATION = 5821; private static final String APPLICATION = "Car Parking"; private static final int APPLICATION_TYPE = 5750; private final ScheduledExecutorService scheduler; private float MIN_VALUE = 2.0f; private float MAX_VALUE = 400.0f; private float currentdistance = 0.0f; private float minmeasuredvalue = MAX_VALUE; private float maxmeasuredvalue = MIN_VALUE; // Connect HY-SRF05 with Raspberry Pi3 Model B // HY-SRF05==============Raspberry Pi3 Model B // VCC===================5V (Pin 02) // GND===================GND (Pin 04) // Trigger===============GPIO_00 (Pin 11) // Echo==================GPIO_02 (Pin 13) // GPIO Pins private GpioPinDigitalOutput sensortriggerpin; private GpioPinDigitalInput sensorechopin; private GpioController gpio = GpioFactory.getInstance(); public DistanceSensor() { sensortriggerpin = gpio.provisiondigitaloutputpin(raspipin.gpio_00); sensorechopin = gpio.provisiondigitalinputpin(raspipin.gpio_02, PinPullResistance.PULL_DOWN); this.scheduler = Executors.newSingleThreadScheduledExecutor(new NamedThreadFactory("Distance Sensor")); scheduler.scheduleatfixedrate(new Runnable() { 29

30 @Override public void run() { adjustdistance();, 10, 2, TimeUnit.SECONDS);// delay 2 seconds /** * Function adjust distance */ private synchronized void adjustdistance() { try { Thread.sleep(100); // Make trigger pin HIGH sensortriggerpin.high(); // Delay for 10 microseconds Thread.sleep((long) 0.01); // Make trigger pin LOW sensortriggerpin.low(); while (sensorechopin.islow()) { // Wait until the ECHO pin gets HIGH // Store the current time to calculate ECHO pin HIGH time. long starttime = System.nanoTime(); while (sensorechopin.ishigh()) { // Wait until the ECHO pin gets LOW // Store the echo pin HIGH end time to calculate ECHO pin HIGH time. long endtime = System.nanoTime(); currentdistance = (float) ((((endtime - starttime) / 1e3) / 2) / 29.1); System.out.println("Distance: " + currentdistance); Integer changedresource = adjustminmaxmeasuredvalue(currentdistance); if (changedresource!= null) { fireresourceschange(sensor_value, changedresource); else { fireresourceschange(sensor_value); Thread.sleep(100); catch (InterruptedException e) { e.printstacktrace(); /** * Function round number value */ private double gettwodigitvalue(float value) { BigDecimal tobetruncated = BigDecimal.valueOf(value); return tobetruncated.setscale(2, RoundingMode.HALF_UP).doubleValue(); 30

31 @Override public synchronized ReadResponse read(int resourceid) { switch (resourceid) { case MIN_MEASURED_VALUE: return ReadResponse.success(resourceId, gettwodigitvalue(minmeasuredvalue)); case MAX_MEASURED_VALUE: return ReadResponse.success(resourceId, gettwodigitvalue(maxmeasuredvalue)); case SENSOR_VALUE: return ReadResponse.success(resourceId, gettwodigitvalue(currentdistance)); case SENSOR_UNIT: return ReadResponse.success(resourceId, UNIT_DISTANCE); case MIN_RANGE_VALUE: return ReadResponse.success(resourceId, MIN_VALUE); case MAX_RANGE_VALUE: return ReadResponse.success(resourceId, MAX_VALUE); case APPLICATION_TYPE: return ReadResponse.success(resourceId, APPLICATION); case CURENT_CALIBRATION: return ReadResponse.success(resourceId, CALIBRATION); default: return public synchronized ExecuteResponse execute(int resourceid, String params) { switch (resourceid) { case RESET_MIN_MAX_MEASURED_VALUES: resetminmaxmeasuredvalues(); return ExecuteResponse.success(); default: return super.execute(resourceid, params); /** * Function adjust min max measured value newdistance */ private Integer adjustminmaxmeasuredvalue(float newdistance) { if (newdistance > maxmeasuredvalue) { maxmeasuredvalue = newdistance; return MAX_MEASURED_VALUE; else if (newdistance < minmeasuredvalue) { minmeasuredvalue = newdistance; return MIN_MEASURED_VALUE; else { return null; /** * Function reset min max measured values */ private void resetminmaxmeasuredvalues() { minmeasuredvalue = currentdistance; maxmeasuredvalue = currentdistance; 31

32 - Add Pi4j library version 1.2 dependency in pom.xml file of leshan-client-demo projects <project xmlns=" xmlns:xsi=" xsi:schemalocation=" <modelversion>4.0.0</modelversion> <parent> <groupid>org.eclipse.leshan</groupid> <artifactid>leshan</artifactid> <version>1.0.0-snapshot</version> </parent> <artifactid>leshan-client-demo</artifactid> <name>leshan - client demo</name> <description>a demonstration client built upon the Leshan client.</description> <!-- To download SNAPSHOT builds in your Maven project, you must include the following repository definition in your POM.XML file --> <repositories> <repository> <id>oss-snapshots-repo</id> <name>sonatype OSS Maven Repository</name> <url> <snapshots> <enabled>true</enabled> <updatepolicy>always</updatepolicy> </snapshots> </repository> </repositories> <dependencies> <dependency> <groupid>org.eclipse.leshan</groupid> <artifactid>leshan-client-cf</artifactid> </dependency> <dependency> <groupid>commons-cli</groupid> <artifactid>commons-cli</artifactid> </dependency> <!-- The following dependency is all that is needed to include Pi4J (core library) in your Maven project --> <dependency> <groupid>com.pi4j</groupid> <artifactid>pi4j-core</artifactid> <version>1.2-snapshot</version> </dependency> <!-- runtime dependencies --> <dependency> <groupid>org.slf4j</groupid> <artifactid>slf4j-simple</artifactid> <scope>runtime</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupid>org.apache.maven.plugins</groupid> <artifactid>maven-assembly-plugin</artifactid> <version>2.4</version> <configuration> <archive> <manifest> <mainclass>org.eclipse.leshan.client.demo.leshanclientdemo</mainclass> 32

33 </manifest> </archive> <descriptorrefs> <descriptorref>jar-with-dependencies</descriptorref> </descriptorrefs> </configuration> <executions> <execution> <id>make-assembly</id> <!-- this is used for inheritance merges --> <phase>package</phase> <!-- bind to the packaging phase --> <goals> <goal>single</goal> </goals> </execution> </executions> </plugin> </plugins> </build> </project> 33