Robin Robin SmartView Manuale utente
Version: 3.5.0 Robin NL
Datum: 01-11-2015
How-To:
Remote Control the Robin
ROBIN
Tech Note
How-To: Remote Control the RobinRobin Tech Note
About this Tech Note
This Tech Note is meant for the following Robin products:
• Robin SIP
• Robin SV
• Robin CV
• Robin HV
Software release 3.5.0 and higher
How-To: Remote Control the RobinRobin Tech Note
Remote Control
The Robin SIP, SV, CV and HV can be controlled using HTTP commands. It’s also possible to
retrieve data from these Robin devices, such as: call status, streaming video and version info.
You can use:
1. Directly, with HTTP commands (eg. with cURL)
2. The ‘Events’ option in the web interface
How-To: Remote Control the RobinRobin Tech Note
Control the Robin with HTTP commands
The Robin SmartView is controllable with HTTP-commands and it is also possible to retrieve data.
A set of commonly used commands are shown below, in these examples with cURL-commands.
To use these commands, the provision of the login credentials of the ‘admin’ user are mandatory.
! Note: cURL is only one of many ways to send HTTP-commands. For more information about
cURL, see: http://en.wikipedia.org/wiki/CURL !
Access to the MJPEG-video stream - Only available on Robin products with built-in camera -
The Robin SV, CV and HV are equipped with a high resolution camera. It generates a Motion-JPEG
video stream that can be retrieved with the following command:
curl -u admin:<password> “http://<address>/pbhelper/stream.mjpeg”
• <password> = the password for the -admin- account
• <address> = the Robin SV address
! Note: Multiple simultaneous MJPEG video streams can affect the performance of the Robin
negatively. !
You can also set the preferred resolution and compression level, just add the following to the URL:
• ?width=320&height=240 = resolution for the requested video (320x240 pixels) - MAX
resolution = 720x576
• ?quality=80 = JPEG quality level (80) - MAX JPEG quality level = 100
! Note: Low resolution and low MJPEG quality will both result in low bandwidth usage. High reso-
lution and high MJPEG quality will both result in high bandwidth usage. !
How-To: Remote Control the RobinRobin Tech Note
Access to the latest video frame
- Only available on Robin products with built-in camera -
The Robin SV, CV and HV not only generate a Motion-JPEG video stream but also individual video
frames (JPEG). These frames can be retrieved by using the following command:
curl -u admin:<password> “http://<address>/camera/frame.jpeg”
• <password> = the password for the -admin- account
• <address> = the Robin SV address
You can also set the preferred resolution and compression level, just add the following to the URL:
• ?width=320&height=240 = resolution for the requested video (320x240 pixels) - MAX
resolution = 720x576
• ?quality=80 = JPEG quality level (80) - MAX JPEG quality level = 100
! Note: Low resolution and low JPEG quality will both result in low bandwidth usage. High resolu-
tion and high JPEG quality will both result in high bandwidth usage. !
How-To: Remote Control the RobinRobin Tech Note
Making calls using HTTP commands
You can control the Robin to make calls, disconnect calls and retrieve the current call status.
The Robin will answer to these commands in JSON.
Command: curl -u admin:<password> “http://<address>/api/v1/call_
setup?number=501”
Goal: Call extension 501
Answer: {
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/call_status”
Goal: Retrieve the call status of the Robin
Answer: {
“rv” : {
“status” : “outgoing call to 501”
},
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/call_hangup”
Goal: disconnect the call (call hangup)
Answer: {
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/api_ping”
Goal: ping the Robin (to check if it responds)
Answer: {
“rv” : {
“pong” : “pong”
},
“ok” : true
}
! Note: If the HTTP command to dial an extension contains an extension that is already known
in the phone book, the Robin dials that extension and will use the profile that is defined for that
extension. !
How-To: Remote Control the RobinRobin Tech Note
Control the audio mute function using HTTP commands
The audio settings of the Robin can be controled using http commands. The commands control the
mute function of the Robin. It mutes speakers of the Robin.
You can mute three types of audio:
• All incoming tones: Mute all tones from an incomming phone call
• All tones: Mute all tones from incomming and outgoing phone calls
• All audio: Mute the speakers of the Robin. It mutes all tones and voice. Use this option to listen-
in on the Robin.
The audio mute can also be disabled using one command.
The Robin will answer to these commands in JSON.
Command: curl -u admin:<password> “http://<address>/api/v1/mute_set?mute=tones_
incoming”
Goal: mute all tones from an incomming phone call
Answer: {
“rv” : {
“mute”:”tones_incoming”
},
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/mute_set?mute=tones_
all”
Goal: mute all tones from incomming and outgoing phone calls
Answer: {
“rv” : {
“mute”:”tones_all”
},
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/mute_set?mute=all_au
dio”
Goal: mute the speakers of the Robin. (mutes all tones and voice)
Answer: {
“rv” : {
“mute”:”all_audio”
},
“ok” : true
}
How-To: Remote Control the RobinRobin Tech Note
Command: curl -u admin:<password> “http://<address>/api/v1/mute_set?mute=off”
Goal: disable the audio mute (all sound will be on)
Answer: {
“rv” : {
“mute”:”off”
},
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/mute_get”
Goal: retrieve the audio mute status
Answer: {
“rv” : {
“mute”:”off” / :”all_audio” / :”tones_all” / :”tones_incoming”
},
“ok” : true
}
How-To: Remote Control the RobinRobin Tech Note
Control the door opener using HTTP commands
- Only available on the Robin SIP and Robin SV -
You can control the Robin to open and close the door and retrieve the status of the door opener.
The Robin will answer to these commands in JSON.
Command: curl -u admin:<password> “http://<address>/api/v1/dooropener_open”
Goal: Open the door and keep it open (close the relay)
Answer: {
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/dooropener_close”
Goal: Close the door (open the relay)
Answer: {
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/dooropener_pulse”
Goal: Open the door and keep it open for the time set in the GUI. After that, close the door
Answer: {
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/dooropener_status”
Goal: Retrieve the status of the door opener
Answer: {
“rv” : {
“status” : “Open”
},
“ok” : true
}
How-To: Remote Control the RobinRobin Tech Note
Control the relay switch(es) using HTTP commands
- Only available on the Robin CV and HV -
You can control the Robin to control the built-in relay switch(es).
- The Robin CV is equipped with one relay switch, the Robin HV is equipped with two relay switch-
es. -
The Robin will answer to these commands in JSON.
Command: curl -u admin:<password> “http://<address>/api/v1/switch_
set?state=on&switch=1”
Goal: Activate switch no. 1 (close the relay)
Answer: {
“rv” :
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/switch_
set?state=off&switch=1”
Goal: Deactivate switch no. 1 (open the relay)
Answer: {
“rv” :
“ok” : true
}
Command: curl -u admin:<password> “http://<address>/api/v1/switch_
set?state=pulse&duration=5&switch=1”
Goal: Activate switch no. 1 for the duration of 5 seconds (pulse the relay)
Answer: {
“rv” :
“ok” : true
}
‘Duration’ is a variable value (in seconds)
Command: curl -u admin:<password> “http://<address>/api/v1/switch_get?switch=1”
Goal: Retrieve the state of switch no. 1 (get status of switch)
Answer: {
“rv” : {
“state”:”off” / :”on”
},
“ok” : true
}
Use switch=1 for the relay switch on the Robin CV, use switch=1 or switch=2 for the Robin HV.
Altri manuali per Robin SmartView
1
Indice
