===== DRAFT MATERIALS =====

===== Supports =====

===== References =====

===== IAm Lab =====

==== Middleware for IoT : MQTT Lab ===

=== MQTT API and languages ===

//Todo JY//

=== MQTT Brokers ===
//Todo JY//

=== Arduino MQTT Publishers and Subscribers ===
//Todo JY//

=== OpenHab MQTT Broker ===


== OpenHab distribution and installation manual for PC ==
{{:cours:ensitunis:installation_openhab_demo.docx|Word document listing the installation steps}}

== List of connected Devices for MQTT on OpenHab ==

This particular setup of OpenHAB supports several ZWave devices:
  * Fibaro button
  * Smart plug
  * Temperature/Light/Door sensor
  * Temperature/Motion sensor
And EnOcean devices:
  * Switches
  * Smart plug

But thanks to OpenHAB, many devices can be supported with little to no pain.

== Sample code and tests ==
After installing Mosquitto, OpenHAB and the bindings, you can test the setup with a few simple commands. **(maybe add a defined item to test)**

Note that if the server is running on ''localhost:1883'' parameters ''-h'' and ''-p'' can be omitted.

  * To subscribe to state updates for a certain item:\\
    ''mosquitto_sub -t openhab/{item}/state [-h {host} -p {port}]''\\
  * To subscribe to state updates for a certain item, with server generated timestamps:\\
    ''mosquitto_sub -t openhab/{item} [-h {host} -p {port}]''\\
  * To publish commands to an item:\\
    ''mosquitto_pub -t openhab/{item}/commandssub [-h {host} -p {port}] [-l | -m [ON | OFF]]'' \\

//(''-l'' reads messages
from the console window, ''-m'' sends the message immediately)//

=== Sample MQTT bean code === 

//Todo JY//


=== Rasbperry MQTT broker with Jeedom MQTT Broker === 

//stéph ? //

==== Middleware for IoT : Web of Things ===

=== Installation and Description of HDSN Kit ===
The HDSN kit is a commercial system designed to collect data from an environment using an array of sensors connected to a base.\\
Among the sensors available are temperature sensors, energy sensors, air quality sensors or wind speed sensors.\\
This kit uploads data to the manufacturer's cloud-based system every 20 minutes, and that can data can be retrieved using the supplied API.

== Installing the system ==
  * Plug the base unit into the mains and an RJ45 port connected to the internet
  * Open [[http://eu.e-sylife.com/|the web portal]] and register an account with the platform using the SN and security code found on the sticker on the base unit
  * After a minute the base unit should synchronize and its sensors will be available in web portal's dashboard

== Installing sensor modules ==
  * Open the web portal to the [[http://eu.e-sylife.com/en/pages/profil-modules/|module configuration page]] 
  * Click "Add a sensor"
  * Input the module number and security number, both can be found on the sticker on the unit
  * After waiting for about a minute, turn on the module by pulling the plastic tab on its backside, as close to the base unit as possible
  * The module should start reporting data

== (Optional) Setting up the dashboard ==
  * Open the web portal to the [[http://eu.e-sylife.com/en/pages/params/|parameter page]]
  * For each sensor, input a name and check the configuration (units, modes)

=== Documentation on HDSN Web site for data access  ===
Accessing the data programmatically can be done using the manufacturer-supplied REST API.\\
[[http://api.e-sylife.com/|Online API reference]]

=== Documentation and sample codes on HDSN Web services access to Data  ===
Example REST requests in [[https://www.getpostman.com/docs/introduction|Postman]] format to get data from a sensor using the API:  {{:cours:ensitunis:hdsn_postman.zip|}} 
  * In Postman, click Import at the top left
  * Drop both the environment and collection files into the window, click import
  * Open the HDSN collection from the left column, then open the first request
  * Select the HDSN environment in the top right drop down
  * Select the "pre-request script" tab and replace the values with your identification data: APIUsername and APIPassword are for your HDSN **developer** account, and username and password are for your HDSN **dashboard** account.
  * Then use the blue "Send" button to send the request.
  * Sending the requests in order will complete a full path from developer authentication to retrieving value for a sensor.

===== Semantic Web of Things ======

==== Lecture SWoT ====

==== Tutorial SWoT ====

=== Tools ===

== Protégé : Ontology Design ==

[[https://fr.wikipedia.org/wiki/Prot%C3%A9g%C3%A9_(logiciel)|Wikipedia Protégé]]

[[http://protege.stanford.edu/|Site Officiel Protégé]]

Installation de Protégé 

Configuration d'Installation : Pellet Reasoner Plugin