Home

IO.XEC

1. 6 2 Communications Data is exchanged trough TCP IP 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 Tas Authentication uses Base64 encoding generally called Basic Authentication The user name is appended with a colon and concatenated with the password The resulting string is encoded with the Base64 algorithm Example User admin with Password 1234 These are concatenated into admin 1234 which then gets encoded with base64 The final encoded string is YWRtaW46MTIZNA All the requests except for the one described in section 6 3 need the authentication described above 6 2 3 Protocol description Data is passed on HTTP GET requests Please note that integer 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 lt address gt home xml No authentication is needed for this file Example lt response gt lt gt lt gt lt version gt 3 0 3LT lt version gt lt dhcp gt 1 lt dhcp gt lt ip gt 192 168 1 119 lt ip g
2. USER S MANUAL 1 BEFORE STARTING 4 1 1 INSIDE THE BOX 4 1 2 GENERAL SPECIFICATIONS 4 1 3 IDENTIFYING THE COMPONENTS OF IO XEC 5 1 4 WHAT 15 NEEDED 6 2 INSTALLATION 6 2 1 CONNECTION BLOCKS 6 2 2 CONNECTING ERRO MARCADOR NAO DEFINIDO 2 2 1 POWER 6 2 2 2 DIGITAL INPUTS 6 2 2 3 DIGITAL OUTPUTS 7 2 2 4 ANALOG INPUT 8 2 2 5 ANALOG TEMPERATURE SENSOR 9 2 2 6 ANALOG OUTPUT 9 2 2 7 RELATIVE HUMIDITY AND TEMPERATURE SENSOR 9 3 SETTINGUPIO 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 HITP 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 GENERAL INFORMATION 16 6 4 DEVICE HARDWARE CONFIGURATION 17 6 5 CURRENT STATUS 19 6 6 CHANGE IO XEC CONFIGURATION 20 7 6 7 CONTROL lO XEC OUTPUTS 6 7 1 DIGITAL OUTPUTS 6 7 2 ANALOG OUTPUT 6 8 REBOOT IO XEC 7 FIRMWARE UPDATE 20 20 21 21 21 1 Before starting 1 1 Inside the box Inside the box you must find IO XEC and 5 wire connectors 1 2 General specifications The main electrical specifications are 8 digital opto coupled inputs organized in 2 groups The activation voltage is between 8V and 24V e 4 relay digital outputs 4open collector digital outputs e lanalog input 0 10V lanalog input for temperature sensor analog outpu
3. gt lt label gt Input 6 lt label gt lt group gt 1 lt group gt lt din gt lt din index 6 gt lt label gt Input 7 lt label gt lt group gt 1 lt group gt lt din gt lt din index 7 gt lt label gt Input 8 lt label gt lt group gt 1 lt group gt lt din gt lt dout index 0 gt lt label gt Output 1 lt label gt lt type gt relay lt type gt lt dout gt lt dout index 1 gt lt label gt Output 2 lt label gt lt type gt relay lt type gt lt dout gt lt dout index 2 gt lt label gt Output 3 lt label gt lt type gt relay lt type gt lt dout gt lt dout index 3 gt lt label gt Output 4 lt label gt lt type gt relay lt type gt lt dout gt lt dout index 4 gt lt label gt Output 5 lt label gt lt type gt openc lt type gt lt dout gt lt dout index 5 gt lt label gt Output 6 lt label gt lt type gt openc lt type gt lt dout gt lt dout index 6 gt lt label gt Output 7 lt label gt lt type gt openc lt type gt lt dout gt lt dout index 7 gt lt label gt Output 8 lt label gt lt type gt openc lt type gt lt dout gt lt dout index 8 gt lt label gt Buzzer lt label gt lt type gt buzz lt type gt lt dout gt lt all_configs gt lt current_config gt lt anain gt lt option gt 0 lt option gt lt anain gt lt anatemp gt lt option gt 0 lt option gt lt anatemp gt lt digtrh gt lt option gt 1 lt op
4. d 3 4 Dynamic DNS configuration Dynamic DNS allows you to access your network using domain names instead of IP addresses The service 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 eo Q 10 xec Y f ioxec protect dyndns htm Dynamic DNS Dynamic Domain Name System DDNS DDNS Service No IP www no ip com The last update was successful DDNS allows you to access your network using domain names instead of IP addresses The service 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 You must sign up this service 2009 2011 ideioriginal Ida All rights reserved Copyright 4 Retrieving status of IO XEC The status of IO XEC can be retrieved using a browser see section 3 1 The IO status tab should be selected The status page refreshes itself automatically at time intervals of 500ms The page also allows to control the outputs digital and analog Digital Inputs input1 input 5 input 7 D
5. e x Output identifier The following identifiers can be used 0 7 digital outputs 8 internal buzzer val Resulting value The following values can be used 0 resets output 1 sets output t toggles output Examples To reset output 0 http ioxec protect set cgi out0 0 To toggle output 3 http ioxec protect set cgi out3 t To turn on the internal buzzer http ioxec protect set cgi out8 1 6 7 2 Analog output To change the analogue value of the analog output issue the following HTTP GET request http lt address gt protect set cgi aout val Where val is the desired voltage of the output Example To set the output voltage to 2 55Volt http ioxec protect set cgi aout 2 55 6 8 RebootIO 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 steps needed to make a firmware update are the following 1 Download the firmware image from io xec website http ioxec ideiao com A file named image bin 2 Copythe file to the root directory folder of the USB flash drive Ta 9 Turn off IO XEC Insert the USB flash drive in USB connector With a sharp object a pencil for example push and
6. er name and password combination The default are User Name admin Password ioxec Please note that user name and password are case sensitive System Information Host Name IOXEC 3 0 3LT On 192 168 1 119 255 255 255 0 192 168 1 254 192 168 1 11 0 0 0 0 00 04 A3 3A F1 E8 Copyright 2009 2011 ideioriginal Ida All rights reserved 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 Q 10 xec veh ioxec protect netconfig htm Network Configuration Host Name 192 468 1 119 255 255 255 0 192 168 1 254 192 168 1 11 0 0 0 0 CAUTION Incorrect settings may cause the board to loose network connectivity Recovery options will be provided on the next page Copyright 2009 2011 ideioriginal Ida All rights reserved 3 3 Hardware configuration Select IO settings to reach this page where you can enable and disable some hardware features of IO XEC Q 10 xec o ioxec protect ioconfig htm TA IO Configuration Analog Input Disabled Enabled Analog Temp Disabled LM35 MCP9701 Digital Temp R H Disabled SHT75 The analog inputs should be only enabled if in use If these inputs are not connected erroneous values are captured Copyright 2009 2011 ideioriginal Ida All rights reserve
7. hold the reset button see section 1 3 Turn on IO XEC holding the reset button Release the reset button If the image is found the device will start updating itself During this process the white LED will flash When finished IO XEC reboots This process may reset the device with the factory defaults Wo z
8. igital Outputs output 1 output 4 5 8 Analog Inputs amp Outputs Temperature C A Input V A Output V New value Digital temperature amp Relative humidty Temperature C 17 0 40 0 Ta R H 96 80 2 0 0 wn Copyright 2009 2011 ideioriginal Ida All rights reserved 5 Factory defaults The factory defaults of IO XEC are NetBIOS name 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 Tha Username admin 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 default settings 6 HTTP API of IO XEC 6 1 Introduction This section 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 retrieve the status of the inputs and analog values as well The API implements a bridge between an automation application and physical inputs outputs and sensors
9. og output is connected to AO terminal The reference is GND 2 1 7 Relative humidity and Temperature sensor IO XEC supports Sensirion SHT75 relative humidity and temperature sensor Please consult the sensor datasheet The terminals to use are SDA SCL 3V3 GND When not in use this feature should be disabled in order to prevent erroneous behavior Please consult section 3 3 3 Setting up IO XEC All the configuration and setup of IO XEC is made using a browser There are no serviceable parts inside the enclosure 3 1 Web server To reach IO XEC web server you have to use a browser like Microsoft Internet Explorer Mozilla Firefox or Google Chrome The device checks if there 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 default name is IOXEC In conclusion you can access IO XEC web server using this link http IOXEC fi O ioxec indexhtm You have reached IO XEC web server where you can see the status of your hardware and set up your device Some of the contents are restricted for authenticated users In order to access them you have to provide a us
10. option name min val 40 0 min val max val 125 0 max val lt precision gt 0 1 lt precision gt lt anatemp gt lt digtrh option 0 gt lt option_name gt Disabled lt option_name gt lt min_val_t gt lt min_val_t gt lt max_val_t gt lt max_val_t gt lt precision gt lt precision gt lt min_val_rh gt lt min_val_rh gt lt max_val_rh gt lt max_val_rh gt lt precision gt lt precision gt lt digtrh gt lt digtrh option 1 gt option name SHT75 option name min val t 40 0 min val t TE CE a lt max_val_t gt 100 0 lt max_val_t gt lt precision gt 0 1 lt precision gt lt min_val_rh gt 0 0 lt min_val_rh gt lt max_val_rh gt 100 0 lt max_val_rh gt lt precision gt 0 1 lt precision gt lt digtrh gt lt anaout gt lt min_val gt 0 00 lt min_val gt lt max_val gt 10 00 lt max_val gt lt precision gt 0 01 lt precision gt lt anaout gt lt din index 0 gt lt label gt Input 1 lt label gt lt group gt 0 lt group gt lt din gt lt din index 1 gt lt label gt Input 2 lt label gt lt group gt 0 lt group gt lt din gt lt din index 2 gt lt label gt Input 3 lt label gt lt group gt 1 lt group gt lt din gt lt din index 3 gt lt label gt Input 4 lt label gt lt group gt 1 lt group gt lt din gt lt din index 4 gt lt label gt Input 5 lt label gt lt group gt 1 lt group gt lt din gt lt din index 5
11. t lt subnet gt 255 255 255 0 lt subnet gt lt gateway gt 192 168 1 254 lt gateway gt lt dns1 gt 192 168 1 11 lt dns1 gt lt dns2 gt 0 0 0 0 lt dns2 gt lt mac gt 00 04 A3 3A F1 E8 lt mac gt lt defuser gt admin lt defuser gt lt defpassw gt ioxec lt defpassw gt lt response gt http en wikipedia org wiki Basic access authentication 6 4 Device hardware configuration The device configuration can be obtained retrieving the file ioconfig xml from IO XEC The location of the file is http lt address gt protect ioconfig xml Example lt response gt lt all_configs gt lt anain option 0 gt lt option_name gt Disabled lt option_name gt lt min_val gt lt min_val gt lt max_val gt lt max_val gt lt precision gt lt precision gt lt anain gt lt anain option 1 gt lt option_name gt Enabled lt option_name gt lt min_val gt 0 00 lt min_val gt lt max_val gt 10 00 lt max_val gt lt precision gt 0 01 lt precision gt lt anain gt anatemp option 0 gt lt option_name gt Disabled lt option_name gt lt min_val gt lt min_val gt lt max_val gt lt max_val gt lt precision gt lt precision gt lt anatemp gt lt anatemp optionz 1 lt option_name gt LM35 lt option_name gt lt min_val gt 0 0 lt min_val gt lt max_val gt 150 0 lt max_val gt lt precision gt 0 1 lt precision gt lt anatemp gt anatemp option 2 gt option name MCP9701
12. t 0 10V 1 5232 port e 1 USB interface e expansion port 1 3 Identifying the components of IO XEC 7 Terminal block A __ Terminal block B p3 Terminal block C Expansion port 05 06 07 08 paa C l Status LED ne qp ij Ethernet port N i RS232 port N USB connector Terminal block E Terminal block D Terminal block A Terminal block B Terminal block C Output 1 Power supply 12V Digital T RH clock relay Power supply OV Digital T RH power Output 1 Common of inputs 1 2 Digital T RH GND relay Common of inputs 3 8 Digital T RH data Output 1 Common of outputs 5 8 relay Analog temp sensor Output 1 Analog input relay Analog output Terminal block D Terminal block E Output 5 Input 1 06 Output 6 Input 2 Output 7 Input 3 O8 Output 8 Input 4 Input 5 Input 6 Input 7 Input 8 1 4 Whatis needed To start you ll need e Apower supply The minimum rating is 12Vdc 1A e Aworking Ethernet network and an Ethernet cable or alternatively a cross over Ethernet cable e Apersonal computer or any kind of device that can run a web browser 2 Installation 2 1 Connection blocks 2 1 1 Power Power should be connected in the V and GND terminals 2 1 2 Digital inputs The inputs are photocoupled organized in 2 groups The activation vol
13. tage applied between the terminal C1 or C2 and the input terminal is between 8V RMS and 24V RMS Here are some examples of connection diagrams Please note that the activation voltage has no fixed polarization therefore the terminal C1 can be connected to a positive or negative voltage 2 1 3 Digital outputs There are two types of outputs Q1 to O4 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 If needed more relays can be added The following diagram shows how to connect an external relay to a open collector output External Relay 2 14 Analoginput The analog input voltage must be connected to the Al 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 Ts 2 1 5 Analog temperature sensor The device supports 2 different sensors LM35DZ and MCP9701 In both of them the output signal should be connected to the AT terminal The reference is GND Regarding power supply to the sensor the LM35DZ can be powered using terminals V and GND while MCP9701 can be powered using terminals 3V3 and GND To choose between the two you have to access the IO configuration page When not in use this feature should be disabled in order to prevent erroneous behavior Please consult section 3 3 2 1 6 Analogoutput The anal
14. tion gt lt digtrh gt lt current_config gt lt response gt 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 case the status of the buzzer is also concatenated as if it were the 9 output The fields marked with are inactive Example response lt in gt 00000000 lt in gt Tas lt out gt 000000000 lt out gt lt anatemp gt lt anatemp gt lt anain gt lt anain gt lt anaout gt 0 00 lt anaout gt lt digtemp gt 17 4 lt digtemp gt lt digrh gt 78 8 lt digrh gt lt response gt 6 6 Change IO XEC configuration It is possible to change the hardware configuration of IO XEC as described on section 3 3 The HTTP request has the following structure The parameters x y z are the possible options present in 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 O amp anatemp 1 amp 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 lt address gt protect set cgi outx val Wher

IO.XEC

Contents

Download Pdf Manuals

Related Search

Related Contents