Difference between revisions of "SRS - Tachymètre"

From air
Jump to navigation Jump to search
 
(25 intermediate revisions by 2 users not shown)
Line 22: Line 22:
   
 
= Introduction=
  
= Introduction=
−
== Objectif du projet==
 +
== Goal of the project ==
  +
:The aim of the project is to learn how to use the Cohorte platform to develop a web application which displays an historic of measures made by a sensor and stored on a remote server.
−
:L’objectif du projet est de prendre en main les outils de la plateforme Cohorte pour développer un application web qui affiche l’historique des mesures effectuées par un capteur de présence et stockées sur un serveur.
  
  +
:The main point of the project is to be able to transmit and process the information from the measures given by the sensor to the processed data on the user interface. Moreover, there is a more mathematical step, that consist in calculating the speed with the frequency, and filtering the signal to eliminate noise.
−
:Le cœur du projet est d’arriver à transmettre et à traiter l’information des mesures sur le capteur jusqu’à l’affichage des données élaborées sur l’interface utilisateur. Cela comprend toutes les étapes de traitement des données comme le passage d’une mesure de fréquence à une mesure de vitesse (effet Doppler), ainsi que les étapes d’analyse des données comme l’extraction des mesures utiles parmi le bruit fréquentiel.
  
   
−
== Visée du produit==
 +
== Scope of the product ==
  +
:The implementation of the sensor on the Raspberry and the process of measures can be added on any other application that needs movement detection in front of the sensor. The steps of calculation and storage on the server have to be autonomous so that any number of sensors are connected to the application.
−
:L’implémentation du capteur sur le Raspberry Pi et le traitement de ces mesures peuvent être intégrés à n’importe quelle autre application nécessitant la détection de mouvements ou de passages devant le capteur. Ces étapes de traitement et d’envoi ou de stockage doivent être autonomes pour qu’un nombre quelconque de capteurs puissent faire partie de l’application.
  
  +
:The storage on the server and the interface have to be scalable. During the project, we only have one sensor, but the application we want to develop should be able to displays data form several sensors, which are characterised by a unique identifier, a name, an owner, GPS coordinates, … Besides, an interface has to be implemented on the Raspberry so that the owner can define all these attributes on the sensor in a way that it can be clearly identified by the Cohorte application.
−
:Le stockage sur le serveur et l’interface doivent être conçus pour être évolutifs. En effet, lors de notre projet nous ne disposons que d’un capteur, mais l’application à développer doit pouvoir interroger et afficher les données de plusieurs capteurs, qui seront reconnus par un identifiant unique, un nom, un propriétaire, des coordonnées GPS, etc… De plus, une interface doit être implémentée sur le Raspberry pour que le propriétaire puisse définir ces attributs sur le capteur pour qu’il soit recensé avec clarté sur l’interface utilisateur.
  
−
:De cette façon, le système aura la possibilité d’être utilisé par des clients ou d’autres entreprises.
  
   
  +
== Definitions, acronyms and abbreviations ==
−
== Définitions, acronymes et abréviations==
  
−
* Raspberry Pi : Ordinateur monocarte (processeur ARM) à taille réduite, compatible avec de nombreux périphériques (clavier, souris, …). Le Raspberry Pi peut héberger un programme, offrant ainsi de nombreuses possibilité d’utilisation. Pour notre projet, le Raspberry nous sert de support pour le capteur. De plus, il héberge le code qui va traiter les mesures et les envoyer au serveur.
 +
* Raspberry Pi : Reduced size computer (ARM processor), compatible with devices like keyboards, mouses, … The Raspberry Pi can host a program, providing many opportunities of use. In our project, the Raspberry is linked to the Arduino, and host the python modules that process the data and send it to the server.
   
  +
* Arduino : Programmable microcontroller able to generate and analyse electric signals. For our project, the Arduino get the measures from the HB100 sensor. Once the voltage and frequency values are available, they are transformed into distance and speed values, and send to the Raspberry by serial link.
−
* Cohorte : plate-forme de développement développé par Isandlatech qui fournit des outils pour créer des applications réparties sur plusieurs systèmes indépendants, y compris au niveau du langage de programmation. Il s’agit d’outils orientés composant et services, ce qui permet une importante flexibilité et une application dont les différents isolats sont indépendants.
  
   
  +
* ARM processor : Low consumption processor, equipped with a simpler architecture than other families of processors. ARM processors are mainly used on embedded computing like smartphones.
−
== References==
  
−
== Overview of the remainder of the document==
  
−
= Description du projet=
  
−
== Perspective du produit==
  
−
:Le produit a pour but d’être un détecteur de présence dont les mesures sont sauvegardées dans le but d’une interrogation par une interface utilisateur. On peut alors imaginer de nombreuses utilisations comme de la surveillance domestique (radar lié avec une alarme), ou tout simplement un appareil de mesure de trafic. Les données pouvant être triées et analysées (moyennes, histogramme), il y a une possibilité d’étude poussée de tronçon routier.
  
−
:Dans une version plus aboutie du produit, on pourrait introduire un système d’authentification. Cela permettrait d’implémenter des groupes d’utilisateurs avec des permissions d’accès différentes selon les groupes.
  
   
  +
* HB100 : Proximity sensor that provide a voltage and frequency measure. The voltage gives an information about the distance between the sensor and the object, whereas the frequency allows to calculate the speed of the object thanks to the Doppler effect (see below). The distance variation corresponds to the direction of movement.
−
== Fonctionnalités==
  
−
: Le capteur permet d’avoir une mesure de proximité et de vitesse. Le but est donc de mesurer la vitesse des objets passant devant le capteur (piétons, cyclistes, voiture, …) et de dater cette mesure. Les données sont stockées sur un serveur qui va permettre l’utilisation d’une interface graphique. Cette interface utilisateur affiche l’historique des mesures, avec diverses actions comme la sélection d’une plage de dates pour un affichage plus ciblé, ou encore la présentation des données sous la forme de graphiques pour permettre une analyse plus pointue du trafic.
  
   
  +
* Cohorte : Development platform created by Isandlatech that provides tools to program distributed applications on different independent devices, including the programming languages. Cohorte allows to do component oriented programming, which means that the application is flexible, and the different components are autonomous.
−
== Caractéristiques utilisateur==
  
−
== Contraintes générales==
  
−
: Les contraintes de ce projet sont l’utilisation de Cohorte et du Raspberry Pi comme support pour le capteur.
  
−
:Il n’y a pas de contraintes pour le langage de programmation, car grâce à Cohorte, les différents composants peuvent être développés dans différents langage : Python ou Java pour le Raspberry, Java et SQLite pour le stockage sur le serveur, et HTML/CSS/Javascript pour l’interface web.
  
   
  +
* SQLite : Database engine in a C library that allows table interrogation with SQL requests. In our server, the database contains only one table, so SQLite is quite enough for the management of the server.
−
== Assumptions and dependencies==
  
−
= Specific requirements, covering functional, non-functional and interface requirements=
  
   
  +
* Doppler effect : Physical phenomenon that consist in a frequency shift between the transmitter and the receiver when the distance between them is changing. With this phenomenon, we can calculate the speed of an object thanks to the relation between the measured frequency and the speed of the object.
−
== Exigences fonctionnelles ==
  
−
'''Fonction d’acquisitions des données'''
  
−
: Récupération des valeurs physiques : Vitesse et proximité Isolation et interprétation des mesures : Seuil (prévoir un buffer si le traitement est trop long).
  
−
: Propagation des données par consommation d’un service fourni par un composant distant.
  
   
  +
* Raw data : Data returned by the sensor and send to the Arduino (voltage, frequency, timestamp).
−
'''Fonction d’agrégation'''
  
−
: Stockage de la donnée (service write).
  
   
  +
* Processed data : Data returned by the process of raw data on the Raspberry (average speed, maximum speed, direction, date).
−
'''Fonction interface utilisateur'''
  
−
: Composants de récupération et de présentation des données.
  
   
  +
* Synthetic data : Analysis of processed data. For example, it could be a distribution of the flow during a month, or at a precise moment of the day, or also an historic of speed.
−
== Exigences non-fonctionnelles ==
  
−
'''Qualité du réseau'''
  
−
: Eventuellement envisager la mise en œuvre de solution de communication pour le Raspberry Pi pour garantir une bonne disponibilité.
  
   
  +
* Timestamp : date, hour, minute and second when the measure is done.
−
'''Environnement du capteur'''
  
−
: Perturbation possible des mesures.
  
   
  +
= Description of the project=
−
== Exigences de l’interface ==
  
  +
== Product perspective ==
−
'''Ergonomie'''
  
  +
: The product is meant to be a presence detector whose measurements are saved to interrogate them in the user interface. We could imagine many use like domestic surveillance (a detector with a bell), or also a road traffic detector.
−
: Compatibilité multi-support (différents navigateurs, version mobile)
  
  +
: In a fuller version of the product, we should integrate an authentication system that allows groups of users with different access permissions.
−
Interactions (sélection de plage de dates, affichage de graphiques, …).
  
   
  +
== Product functions ==
  +
: The sensor is able to measure speed and distance. Therefore, the aim is to detect the speed of objects in front of the sensor (pedestrians, cyclists, cars, …) and date this detection. The web interface gets the data from the server and displays it with the possibility to restrict to a certain time of day, or a date range, or to make graphs.
   
  +
== General constraints ==
−
= Cas d'usage =
  
  +
: The constraints of the project are the use of Cohorte and the Raspberry Pi with the sensor.
−
== Interaction de l’utilisateur avec l’interface web ==
  
  +
: There is no constraint about the programming language, because thanks to Cohorte, the different components can be developed in different languages : Python or Java for the Raspberry, Java and SQLite for the server, and HTML/CSS/Javascript for the web interface.
−
: - L’utilisateur entre sur le site web et s’authentifie avec un login et un mot de passe
  
−
: - L’utilisateur peut choisir de cliquer sur “tout” pour afficher l’ensemble des données de tous les capteurs (triées par date décroissante)
  
−
:: -la date / vitesse moyenne / sens / capteur
 
   
  +
= Specific requirements, covering functional, non-functional and interface requirements=
−
: - L’utilisateur choisit un capteur parmi la liste des capteurs installés (vert : connecté, rouge : déconnecté) :
  
−
:: -onglet données élaborées :
  
−
::: -le système affiche les données élaborées dans un tableau (triées par date décroissante)
  
−
:::: - la date (Heure / Minute / Jour / Mois / Année) / vitesse moyenne (km/h) / sens (sens du capteur, contresens du capteur)
  
−
::: - L’utilisateur peut cliquer sur les liens de pagination pour naviguer dans les données élaborées
  
−
::: - L’utilisateur peut filtrer les données affichées en fonction des paramètres suivants :
  
−
:::: - entre deux dates d1 et d2
 
−
:::: - une vitesse max / min.
  
−
:: - onglet données synthétisées :
  
−
::: - A définir avec Olivier
  
−
:: - onglet administrateur :
  
−
::: - le système affiche un tableau des événements relatifs au capteur sélectionné (trié par date décroissante) :
  
−
:::: - la date (Heure / Minute / Jour / Mois / Année)
  
−
:::: - l’état (connecté, déconnecté)
  
−
: - L’utilisateur peut se déconnecter
  
   
  +
== Functional requirements ==
−
== Interaction du technicien avec le capteur ==
  
  +
'''Data acquisition function'''
−
: - Le technicien branche le capteur au réseau internet du client
  
  +
: Getting of physical values : speed and distance
−
: - Le technicien démarre le capteur
  
  +
: Sending of processed data by consuming a service provided by a remote component.
   
  +
'''Aggregation function'''
−
== Interaction du technicien avec l’interface d’administration du capteur ==
  
  +
: Storage of the data in a server.
−
: - Le technicien ouvre la page d’administration du capteur
  
−
: - Le technicien remplit un formulaire :
  
−
:: - L’identifiant du capteur
  
−
:: - Coordonnées GPS du capteur (longitude latitude, altitude (décimales))
  
   
  +
'''User interface function'''
−
= Requirement X.Y.Z (in Structured Natural Language)=
  
  +
: Data presentation components.
−
'''Function''':
  
   
  +
== Non-functional requirements ==
−
'''Description''':
  
  +
'''Quality of the network'''
  +
: Store the data on the device allows to avoid losing data in the event of link loss.
   
−
'''Inputs''':
 +
'''Sensor environment'''
  +
: The measurements have to be filtred to eliminate the noise generate by the environment (street, wind, …).
   
  +
== Interface requirements ==
−
'''Source''':
  
  +
: Compatibility multi-platform (different browser, mobile version of the software).
  +
: Interactivity (date range selection, creation of graphs, …).
   
  +
= Use case =
−
'''Outputs''':
  
  +
== Interaction between user and web interface ==
  +
: - The user connects to the website and authenticate with his loin and password
  +
: - The user can choose to click on “all” to display all the data from every sensors (sorted in descending order of date)
  +
:: Data displayed : date, average speed, maximum speed, direction, sensor
   
  +
: - The user choose a sensor in the sensor list (green : connected, red : disconnected)
−
'''Destination''':
  
  +
:: - Processed data tab :
  +
::: - The system displays the processed data in a table (sorted in descending order of date)
  +
:::: Data displayed : date, average speed, maximum speed, direction, sensor
  +
::: - The user can click on pagination links to browse the data.
  +
::: - The user can filtrate the data with two types of parameters :
  +
:::: - Between two dates
  +
:::: - A minimum / maximum speed value
  +
:: - Synthetic data tab :
  +
::: - The user can make parameterized analyses choosing the option “historic”, or a distribution choosing the option “distribution. The parameters are :
  +
:::: - Selection of the type of data :
  +
::::: - Number of moves
  +
::::: - Average speed
  +
::::: - Maximum speed
  +
:::: - Selection of a date range :
  +
::::: - Start date (DD/MM/YYYY)
  +
::::: - End date (DD/MM/YYYY)
  +
:::: - Selection of time slot :
  +
::::: - Start hour (HH/MM)
  +
::::: - End hour (HH/MM)
  +
:: - Administration tab :
  +
::: - The system displays events related to the selected sensor in a table (sorted in descending order of date) :
  +
:::: - Selection of a date range :
  +
::::: - Start date (DD/MM/YYYY)
  +
::::: - End date (DD/MM/YYYY)
  +
:::: - Selection of time slot :
  +
::::: - Start hour (HH/MM)
  +
::::: - End hour (HH/MM)
  +
:::: - Date of event (HH/MM/DD/MM/YYYY)
  +
:::: - State of the sensor (connected / disconnected)
  +
: - The user can disconnect
   
  +
== Interaction du technicien avec le capteur ==
−
'''Action''':
  
  +
: - Le technicien branche le capteur au réseau internet du client
−
* Natural language sentences (with MUST, MAY, SHALL)
  
  +
: - Le technicien démarre le capteur
−
* Graphical Notations : UML Sequence w/o collaboration diagrams, Process maps, Task Analysis (HTA, CTT)
  
−
* Mathematical Notations
  
−
* Tabular notations for several (condition --> action) tuples
  
   
  +
== Interaction between the technician and the sensor ==
−
'''Non functional requirements''':
  
  +
: - The technician connects the sensor to the client’s internet network
  +
: - The technician fill a form on the Raspberry :
  +
:: - Identifier of the sensor
  +
:: - GPS coordinates of the sensor (latitude, longitude, altitude)
   
  +
= Appendicies =
−
'''Pre-condition''':
  
−  
−
'''Post-condition''':
  
−  
−
'''Side-effects''':
  
−  
−
=. Product evolution=
  
−  
−
= Appendicies=
  
 
'''Read first:'''
  
'''Read first:'''
 
* http://www.cs.st-andrews.ac.uk/~ifs/Books/SE9/Presentations/PPTX/Ch4.pptx
  
* http://www.cs.st-andrews.ac.uk/~ifs/Books/SE9/Presentations/PPTX/Ch4.pptx
Line 155: Line 153:
 
* http://ch.linkedin.com/in/mathieustephan
  
* http://ch.linkedin.com/in/mathieustephan
 
* http://www.limpkin.fr/index.php?post/2013/08/09/Making-the-electronics-for-a-%247-USD-doppler-motion-sensor
  
* http://www.limpkin.fr/index.php?post/2013/08/09/Making-the-electronics-for-a-%247-USD-doppler-motion-sensor
  +
* https://docs.google.com/document/d/1CVdH3UVTROaJ4_Bgsx_-hyg5_LvoNxYiB13pPRN9gzU/edit
   
 
'''Raspberry Frequency measurment'''
  
'''Raspberry Frequency measurment'''
Line 163: Line 162:
 
* http://raspberrypi.stackexchange.com/questions/24812/measuring-frequency-via-gpio
  
* http://raspberrypi.stackexchange.com/questions/24812/measuring-frequency-via-gpio
 
* http://hacker.instanet.net/forums/viewtopic.php?f=4&t=104
  
* http://hacker.instanet.net/forums/viewtopic.php?f=4&t=104
−  
−
= Index=
  

Latest revision as of 14:53, 30 March 2016

Document History
Version Date Authors Description Validator Validation Date
0.0.1 18/01/2016 MACE Quentin, NOUGUIER Thibaut, RAMEL Régis Développement d'une application de détection de passages devant un capteur de présence Oliver Gattaz 06/04/2016


Introduction

Goal of the project

The aim of the project is to learn how to use the Cohorte platform to develop a web application which displays an historic of measures made by a sensor and stored on a remote server.
The main point of the project is to be able to transmit and process the information from the measures given by the sensor to the processed data on the user interface. Moreover, there is a more mathematical step, that consist in calculating the speed with the frequency, and filtering the signal to eliminate noise.

Scope of the product

The implementation of the sensor on the Raspberry and the process of measures can be added on any other application that needs movement detection in front of the sensor. The steps of calculation and storage on the server have to be autonomous so that any number of sensors are connected to the application.
The storage on the server and the interface have to be scalable. During the project, we only have one sensor, but the application we want to develop should be able to displays data form several sensors, which are characterised by a unique identifier, a name, an owner, GPS coordinates, … Besides, an interface has to be implemented on the Raspberry so that the owner can define all these attributes on the sensor in a way that it can be clearly identified by the Cohorte application.

Definitions, acronyms and abbreviations

  • Raspberry Pi : Reduced size computer (ARM processor), compatible with devices like keyboards, mouses, … The Raspberry Pi can host a program, providing many opportunities of use. In our project, the Raspberry is linked to the Arduino, and host the python modules that process the data and send it to the server.
  • Arduino : Programmable microcontroller able to generate and analyse electric signals. For our project, the Arduino get the measures from the HB100 sensor. Once the voltage and frequency values are available, they are transformed into distance and speed values, and send to the Raspberry by serial link.
  • ARM processor : Low consumption processor, equipped with a simpler architecture than other families of processors. ARM processors are mainly used on embedded computing like smartphones.
  • HB100 : Proximity sensor that provide a voltage and frequency measure. The voltage gives an information about the distance between the sensor and the object, whereas the frequency allows to calculate the speed of the object thanks to the Doppler effect (see below). The distance variation corresponds to the direction of movement.
  • Cohorte : Development platform created by Isandlatech that provides tools to program distributed applications on different independent devices, including the programming languages. Cohorte allows to do component oriented programming, which means that the application is flexible, and the different components are autonomous.
  • SQLite : Database engine in a C library that allows table interrogation with SQL requests. In our server, the database contains only one table, so SQLite is quite enough for the management of the server.
  • Doppler effect : Physical phenomenon that consist in a frequency shift between the transmitter and the receiver when the distance between them is changing. With this phenomenon, we can calculate the speed of an object thanks to the relation between the measured frequency and the speed of the object.
  • Raw data : Data returned by the sensor and send to the Arduino (voltage, frequency, timestamp).
  • Processed data : Data returned by the process of raw data on the Raspberry (average speed, maximum speed, direction, date).
  • Synthetic data : Analysis of processed data. For example, it could be a distribution of the flow during a month, or at a precise moment of the day, or also an historic of speed.
  • Timestamp : date, hour, minute and second when the measure is done.

Description of the project

Product perspective

The product is meant to be a presence detector whose measurements are saved to interrogate them in the user interface. We could imagine many use like domestic surveillance (a detector with a bell), or also a road traffic detector.
In a fuller version of the product, we should integrate an authentication system that allows groups of users with different access permissions.

Product functions

The sensor is able to measure speed and distance. Therefore, the aim is to detect the speed of objects in front of the sensor (pedestrians, cyclists, cars, …) and date this detection. The web interface gets the data from the server and displays it with the possibility to restrict to a certain time of day, or a date range, or to make graphs.

General constraints

The constraints of the project are the use of Cohorte and the Raspberry Pi with the sensor.
There is no constraint about the programming language, because thanks to Cohorte, the different components can be developed in different languages : Python or Java for the Raspberry, Java and SQLite for the server, and HTML/CSS/Javascript for the web interface.

Specific requirements, covering functional, non-functional and interface requirements

Functional requirements

Data acquisition function

Getting of physical values : speed and distance
Sending of processed data by consuming a service provided by a remote component.

Aggregation function

Storage of the data in a server.

User interface function

Data presentation components.

Non-functional requirements

Quality of the network

Store the data on the device allows to avoid losing data in the event of link loss.

Sensor environment

The measurements have to be filtred to eliminate the noise generate by the environment (street, wind, …).

Interface requirements

Compatibility multi-platform (different browser, mobile version of the software).
Interactivity (date range selection, creation of graphs, …).

Use case

Interaction between user and web interface

- The user connects to the website and authenticate with his loin and password
- The user can choose to click on “all” to display all the data from every sensors (sorted in descending order of date)
Data displayed : date, average speed, maximum speed, direction, sensor
- The user choose a sensor in the sensor list (green : connected, red : disconnected)
- Processed data tab :
- The system displays the processed data in a table (sorted in descending order of date)
Data displayed : date, average speed, maximum speed, direction, sensor
- The user can click on pagination links to browse the data.
- The user can filtrate the data with two types of parameters :
- Between two dates
- A minimum / maximum speed value
- Synthetic data tab :
- The user can make parameterized analyses choosing the option “historic”, or a distribution choosing the option “distribution. The parameters are :
- Selection of the type of data :
- Number of moves
- Average speed
- Maximum speed
- Selection of a date range :
- Start date (DD/MM/YYYY)
- End date (DD/MM/YYYY)
- Selection of time slot :
- Start hour (HH/MM)
- End hour (HH/MM)
- Administration tab :
- The system displays events related to the selected sensor in a table (sorted in descending order of date) :
- Selection of a date range :
- Start date (DD/MM/YYYY)
- End date (DD/MM/YYYY)
- Selection of time slot :
- Start hour (HH/MM)
- End hour (HH/MM)
- Date of event (HH/MM/DD/MM/YYYY)
- State of the sensor (connected / disconnected)
- The user can disconnect

Interaction du technicien avec le capteur

- Le technicien branche le capteur au réseau internet du client
- Le technicien démarre le capteur

Interaction between the technician and the sensor

- The technician connects the sensor to the client’s internet network
- The technician fill a form on the Raspberry :
- Identifier of the sensor
- GPS coordinates of the sensor (latitude, longitude, altitude)

Appendicies

Read first:

Cohorte

  • cohorte.github.io

Microwave Motion Sensor

Making the electronics for $7 USD doppler motion sensor

Raspberry Frequency measurment

Retrieved from "https://air.imag.fr/index.php?title=SRS_-_Tachymètre&oldid=28429"