background image

 

 

15

 

 

Password:  

 

ioxec 

 

To reset the settings to the factory defaults, do the following: 

1.

 

With IO.XEC turned on, push and hold the reset button. The with LED lights steady. 

2.

 

Hold the reset, until the LED starts flashing 

3.

 

Release the reset button, and IO.XEC will boot with the new settings. 

6

 

HTTP API IO.XEC 

 

6.1

 

Introduction 

 

This secion describes the HTTP API of IO.XEC devices. This Application Programming Interface 
(API) permits the integration of this device in third party services and applications. 

IO.XEC allows access to all its functionality via a proprietary HTTP API. Thought this API, third 
party applications can control, if authenticated, the outputs of the device and retrieve the 
status of the inputs.  

The API implements a bridge between an automation application and physical inputs, outputs 
and sensors. 

 

6.2

 

Communications 

 

Data is exchanged trough TCIP protocol. This HTTP API it is based on the HTTP protocol which 
goes on top of TCP data links. 

 

6.2.1

 

System port 

 

The port used is the default for HTTP connections: 80. 

 

6.2.2

 

Authentication 

 

Summary of Contents for IO.XEC

Page 1: ...USER S MANUAL IO XEC ...

Page 2: ...6 ANALOG OUTPUT 9 2 2 7 RELATIVE HUMIDITY AND TEMPERATURE SENSOR 9 3 SETTING UP IO XEC 10 3 1 WEB SERVER 10 3 2 NETWORK SETTINGS 11 3 3 HARDWARE CONFIGURATION 12 3 4 DYNAMIC DNS CONFIGURATION 13 4 RETRIEVING STATUS OF IO XEC 14 5 FACTORY DEFAULTS 14 6 HTTP API IO XEC 15 6 1 INTRODUCTION 15 6 2 COMMUNICATIONS 15 6 2 1 SYSTEM PORT 15 6 2 2 AUTHENTICATION 15 6 2 3 PROTOCOL DESCRIPTION 16 6 3 DEVICE G...

Page 3: ...3 6 7 CONTROL IO XEC OUTPUTS 20 6 7 1 DIGITAL OUTPUTS 20 6 7 2 ANALOG OUTPUT 21 6 8 REBOOT IO XEC 21 7 FIRMWARE UPDATE 21 ...

Page 4: ...ons The main electrical specifications are 8 digital opto coupled inputs organized in 2 groups The activation voltage is between 8V and 24V 4 relay digital outputs 4 open collector digital outputs 1 analog input 0 10V 1 analog input for temperature sensor 1 analog output 0 10V 1 RS232 port 1 USB interface expansion port ...

Page 5: ...RH power Q2 Output 1 relay C1 Common of inputs 1 2 GND Digital T RH GND Q2 C2 Common of inputs 3 8 SDA Digital T RH data Q3 Output 1 relay CO Common of outputs 5 8 Q3 AT Analog temp sensor Q4 Output 1 relay AI Analog input Q4 AO Analog output Terminal block A Terminal block B Terminal block C Expansion port Ethernet port RS232 port USB connector Terminal block E Terminal block D Status LED ...

Page 6: ...k and an Ethernet cable or alternatively a cross over Ethernet cable A personal computer or any kind of device that can run a web browser 2 Installation 2 1 Connection blocks 2 2 Connecting 2 2 1 Power Power should be connected in the V and GND terminals 2 2 2 Digital inputs The inputs are photocoupled organized in 2 groups The activation voltage applied between the terminal C1 or C2 and the input...

Page 7: ...fore the terminal C1 can be connected to a positive or negative voltage 2 2 3 Digital outputs There are two types of outputs Q1 to Q4 are relay outputs capable of switching 8A and Q5 to Q8 are open collector outputs The following diagram shows how to connect a lamp using Q1 ...

Page 8: ...to connect an external relay to a open collector output 2 2 4 Analog input The analog input voltage must be connected to the AI terminal The reference is GND When not in use this feature should be disabled in order to prevent erroneous behavior Please consult section 3 3 ...

Page 9: ...have to access the IO configuration page Please consult section 3 3 When not in use this feature should be disabled in order to prevent erroneous behavior Please consult section 3 3 2 2 6 Analog output The analog output is connected to AO terminal The reference is GND 2 2 7 Relative humidity and Temperature sensor IO XEC supports Sensirion SHT75 RH and temperature sensor Please consult the sensor ...

Page 10: ...is a DHCP server in the network If present the IP address is updated with the address leased by the DHCP server If not IO XEC will address itself with 169 254 1 1 In order to connect to IO XEC the computer running the browser must be in the same network Weather the DHCP server is present as IO XEC has a NETBIOS name server built in it will always respond to a network name instead of an address The...

Page 11: ...11 3 2 Network settings In order to change the network settings select the Network settings tab After these settings are validated IO XEC reboots to apply the new values ...

Page 12: ...12 3 3 Hardware configuration Select IO settings to reach this page where you can enable and disable some hardware features of IO XEC ...

Page 13: ...ice manages changing IP addresses and updates your domain information dynamically This feature along with proper port forwarding in place at the router can enable global access to this device behind a NAT router or firewall Before setting up this feature you must sign up this service To access this page select the Dynamic DNS tab ...

Page 14: ...status tab should be selected The status page refreshes itself automatically at time intervals of 500ms 5 Factory defaults The factory defaults of IO XEC are NetBIOS name IOXEC DHCP on IP address 169 254 1 1 Subnet mask 255 255 0 0 Gateway 169 254 1 1 Primary DNS 169 254 1 1 Secondary DNS 0 0 0 0 Username admin ...

Page 15: ...ts the integration of this device in third party services and applications IO XEC allows access to all its functionality via a proprietary HTTP API Thought this API third party applications can control if authenticated the outputs of the device and retrieve the status of the inputs The API implements a bridge between an automation application and physical inputs outputs and sensors 6 2 Communicati...

Page 16: ...teger variables and all other are sent as ASCII text strings as usual on HTTP requests The HTTP requests described use address to represent IO XEC current IP address The network name NetBIOS name can also be used 6 3 Device general information The device general configuration can be obtained retrieving the file home xml from IO XEC The location of the file is http address home xml No authenticatio...

Page 17: ...01 precision anain anatemp option 0 option_name Disabled option_name min_val min_val max_val max_val precision precision anatemp anatemp option 1 option_name LM35 option_name min_val 0 0 min_val max_val 150 0 max_val precision 0 1 precision anatemp anatemp option 2 option_name MCP9701 option_name min_val 40 0 min_val max_val 125 0 max_val precision 0 1 precision anatemp digtrh option 0 option_name...

Page 18: ...0 group din din index 2 label Input 3 label group 1 group din din index 3 label Input 4 label group 1 group din din index 4 label Input 5 label group 1 group din din index 5 label Input 6 label group 1 group din din index 6 label Input 7 label group 1 group din din index 7 label Input 8 label group 1 group din dout index 0 label Output 1 label type relay type dout dout index 1 label Output 2 label...

Page 19: ...nain anatemp option 0 option anatemp digtrh option 1 option digtrh current_config response 6 5 Current status The device status may be obtained by getting the file iostatus xml from IO XEC The location of the file is http address protect status xml The value of each digital input is concatenated in the field in of the above file The same operation is done with the outputs in the field out In this ...

Page 20: ...n the field option of ioconfig xml Example To disable analogue input enable LM35 temperature sensor and disable digital temperature and relative humidity sensor http ioxec protect ioconfig cgi anain 0 anatemp 1 temprh 0 6 7 Control IO XEC outputs 6 7 1 Digital outputs To change a digital output issue the following HTTP GET request http address protect set cgi outx val Where x output identifier The...

Page 21: ...t http ioxec protect set cgi aout 2 55 6 8 Reboot IO XEC To reboot IO XEC use the following HTTP GET request http address protect reboot cgi 7 Firmware update The IO XEC firmware is updateble With this feature IO XEC can run the most up to date firmware revision This operation is very simple and is supposed to be done by the user or installer You need an USB flash drive in order to proceed The ste...

Page 22: ...hold the reset button see section 0 6 Turn on IO XEC holding the reset button 7 Release the reset button 8 If the image is found the device will start updating itself During this process the white LED will flash 9 When finished IO XEC reboots This process may reset the device with the factory defaults ...

Reviews: