29 917
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 1 :
Ligne 1 : − − {{traduction}} Ligne 60 :
Ligne 58 : − + − + − + − + + + − Register your client at ws://your.unipi.ip.address/ws to receive status messages. Once it is connected, you can also send various commands to the UniPi All messages in websocket are sent in JSON string format, eg. {"dev":"relay", "circuit":"1", "value":"1"} to set Relay 1 On. Check the wsbase.js in www/js/ folder to see example of controlling the UniPi using websocket.+ − + − You can also control the UniPi using Python library jsonrpclib. See the list of all available methods below.+ − + − + − − + Ligne 96 :
Ligne 95 : − + Ligne 109 :
Ligne 108 : − + − + − + Ligne 122 :
Ligne 121 : − + − + − A simple example of controlling the UniPi via RPC use JSON::RPC::Client; − + − There is also a [https://metacpan.org/pod/AnyEvent::WebSocket::Client websocket client library for Perl] to get more control.+ Ligne 147 :
Ligne 145 : − + − + − + − + − + − + − + − + − + − + − + − + − +
aucun résumé de modification
{{UniPi-NAV}}
{{UniPi-NAV}}
== Introduction ==
== Introduction ==
Activer le relais 3 :
Activer le relais 3 :
wget -qO- http://your.pi.ip.address/rest/relay/3 --post-data='value=1'
wget -qO- http://l_adresse_ip_de_votre_Raspberry/rest/relay/3 --post-data='value=1'
Désactiver le relais 3 :
Désactiver le relais 3 :
wget -qO- http://your.pi.ip.address/rest/relay/3 --post-data='value=0'
wget -qO- http://l_adresse_ip_de_votre_Raspberry/rest/relay/3 --post-data='value=0'
Fixer la sortie analogique A0 à 5V :
Fixer la sortie analogique A0 à 5V :
wget -qO- http://your.pi.ip.address/rest/ao/1 --post-data='value=5'
wget -qO- http://l_adresse_ip_de_votre_Raspberry/rest/ao/1 --post-data='value=5'
{{ambox-stop|text=L'utilisation d'une requête POST n'autorise malheureusement pas la saisie de celle-ci dans la barre de navigation d'un navigateur.}}
{{ambox-stop|text=L'utilisation d'une requête POST n'autorise malheureusement pas la saisie de celle-ci dans la barre de navigation d'un navigateur.}}
== WebSocket ==
== WebSocket ==
{{traduction}}
Il est possible d'enregistrer un client (un socket client) auprès de {{fname|ws://l_adresse_ip_de_votre_Raspberry/ws}} pour recevoir les messages de statut.
Une fois le client connecté, vous pouvez envoyer divers commande sur l'UniPi. Tous les messages envoyés sur le websocket sont au format JSON. Par exemple, le message suivant permet d'activer le relais 1 {"dev":"relay", "circuit":"1", "value":"1"} .
Consultez le contenu du fichier wsbase.js dans le répertoire www/js/ pour voir des exemples de contrôle de l'UniPi via websocket.
=== Python using JsonRPC ===
=== Python en utilisant JsonRPC ===
Vous pouvez également contrôler UniPi en utilisant la bibliothèque Python {{fname|jsonrpclib}}. Voyez, ci-dessous, une liste de toutes les méthodes disponibles.
<syntaxhighlight lang="python">
<syntaxhighlight lang="python">
from jsonrpclib import Server
from jsonrpclib import Server
s=Server("http://your.pi.ip.address/rpc")
s=Server("http://l_adresse_ip_de_votre_Raspberry/rpc")
s.relay_set(1,1)
s.relay_set(1,1)
s.relay_get(1)
s.relay_get(1)
s.relay_set(1,0)
s.relay_set(1,0)
s.relay_get(0)
s.relay_get(0)
s.ai_get(1)
s.ai_get(1)</syntaxhighlight>
</syntaxhighlight>
=== Python using WebSocket ===
=== Python en utilisant WebSocket ===
<syntaxhighlight lang="python">
<syntaxhighlight lang="python">
import json
import json
url = "ws://your.unipi.ip.address/ws"
url = "ws://l_adresse_ip_de_votre_Raspberry/ws"
def on_message(ws, message):
def on_message(ws, message):
def on_close(ws):
def on_close(ws):
print "Connection closed"
print "Connection fermee"
#receiving messages
# Reception des messages
ws = websocket.WebSocketApp(url, on_message = on_message, on_error = on_error, on_close = on_close)
ws = websocket.WebSocketApp(url, on_message = on_message, on_error = on_error, on_close = on_close)
ws.run_forever()
ws.run_forever()
#sending messages
# Envoi des messages
ws = websocket.WebSocket()
ws = websocket.WebSocket()
ws.connect(url)
ws.connect(url)
</syntaxhighlight>
</syntaxhighlight>
=== Perl using JsonRPC
=== Perl en utilisant JsonRPC ===
Voici un exemple simple permettant de contrôler UniPi via RPC en utilisant JSON::RPC::Client;
<nowiki>use JSON::RPC::Client;
<nowiki>use JSON::RPC::Client;
my $client = new JSON::RPC::Client;
my $client = new JSON::RPC::Client;
my $url = 'http://your.pi.ip.address/rpc';
my $url = 'http://l_adresse_ip_de_votre_Raspberry/rpc';
$client->prepare($url, ['relay_set']);
$client->prepare($url, ['relay_set']);
$client->relay_set(1,1);</nowiki>
$client->relay_set(1,1);</nowiki>
Il y a également une [https://metacpan.org/pod/AnyEvent::WebSocket::Client bibliothèque websocket Perl client] pour obtenir plus de contrôle.
== Liste des périphériques disponibles ==
== Liste des périphériques disponibles ==
== Liste des méthodes disponibles ==
== Liste des méthodes disponibles ==
Les méthodes ci-dessous (et plus encore) peuvent être trouvé dans les fichiers source evok.py ou owclient.py.
Les méthodes ci-dessous (et plus encore) peuvent être trouvé dans les fichiers source {{fname|evok.py}} ou {{fname|owclient.py}} .
* Entrées digitales
* Entrées digitales
** {{fname|input_get(circuit)}} - get all information of input by circuit number
** {{fname|input_get(circuit)}} - obtenir toutes les informations sur les entrées du circuit mentionné (le numéro).
** {{fname|input_get_value(circuit)}} - get actual state f input by circuit number, returns 0=off/1=on
** {{fname|input_get_value(circuit)}} - Obtenir l'état de l'entrée su circuit mentionné (le numéro). Retourne 0=off/1=on
** {{fname|input_set(circuit)}} - sets the debounce timeout
** {{fname|input_set(circuit)}} - fixer le temps de déparasitage de l'entrée (debounce timeout)
* Relais
* Relais
** {{fname|relay_get(circuit)}} - get state of relay by circuit number
** {{fname|relay_get(circuit)}} - obtenir l'état du du relais mentionné (le numéro)
** {{fname|relay_set(circuit, value)}} - set relay by circuit number according value 0=off, 1=on
** {{fname|relay_set(circuit, value)}} - fixe l'état du relais mentionné (le numéro). La valeur {{fname|value}} peut prendre les valeurs suivantes 0=off, 1=on
** {{fname|relay_set_for_time(circuit, value, timeout)}} - set relay by circuit number according value 0=off, 1=on for time(seconds) timeout
** {{fname|relay_set_for_time(circuit, value, timeout)}} - active le relais mentionné à la valeur mentionnée (0=off, 1=on) pour le temps timeout (en secondes). ''Note: La description en anglais n'est pas très claire, il sera nécessaire d'expérimenter la fonction''.
* Entrée analogique
* Entrée analogique
** {{fname|ai_get(circuit)}} - get value of analog input by circuit number
** {{fname|ai_get(circuit)}} - retourne la valeur d'une entrée analogique (par numéro de circuit).
** {{fname|input_get
** {{fname|input_get}}
* Sortie analogique
* Sortie analogique
** {{fname|ao_set_value(circuit, value)}} - set the value(0-10) of Analog Output by circuit number
** {{fname|ao_set_value(circuit, value)}} - fixe la valeur (0-10) de la sortie analogique (par numéro de circuit)
* Bus 1-Wire
* Bus 1-Wire
** {{fname|owbus_scan(circuit)}} - force to scan 1Wire network for new devices
** {{fname|owbus_scan(circuit)}} - Force le scan du bus 1Wire pour le détection de nouveaux périphériques.
* Senseurs 1-Wire
* Senseurs 1-Wire
** {{fname|sensor_get(circuit)}} - returns all information in array [value, is_lost, timestamp_of_value, scan_interval] of sensor by given circuit or 1Wire address
** {{fname|sensor_get(circuit)}} - retourne toutes les information dans un tableau [value, is_lost, timestamp_of_value, scan_interval] du senseur pour un circuit donné ou une adresse 1Wire
** {{fname|sensor_get_value(circuit)}} - returns value of a circuit by given circuit or 1Wire address
** {{fname|sensor_get_value(circuit)}} - retourne la valeur pour un circuit donné ou une adresse 1Wire
{{UniPi-TRAILER}}
{{UniPi-TRAILER}}