Artila RIO-2018BM User manual

RIO-2018BM
Bluemix Ready Remote I/O Module
User Guide
Version: 1.1
2017 July

RIO-2018BM User Guide
ARTILA
2
Trademarks
The Artila logo is a registered trademark of Artila I c. All other trademarks or
registered marks i this ma ual belo g to their respective ma ufacturers.
Disclaimer
I formatio i this docume t is subject to cha ge without otice a d does ot
represe t a commitme t o the part of Artila.
Artila provides this docume t as is, without warra ty of a y ki d, either expressed
or implied, i cludi g, but ot limited to, its particular purpose. Artila reserves the
right to make improveme ts a d/or cha ges to this ma ual, or to the products
a d/or the programs described i this ma ual, at a y time.
I formatio provided i this ma ual is i te ded to be accurate a d reliable.
However, Artila assumes o respo sibility for its use, or for a y i fri geme ts o
the rights of third parties that may result from its use.
This product might i clude u i te tio al tech ical or typographical errors.
Cha ges are periodically made to the i formatio herei to correct such errors,
a d these cha ges are i corporated i to ew editio s of the publicatio .

RIO-2018BM User Guide
ARTILA
3
Document Amendment History
Revision Date Remark
V 1.0 2017 Feb. Initia
V1.1 2017 Ju . Add “WAPI (Web API) information”

RIO-2018BM User Guide
ARTILA
4
Table of Contents
1. Introduction ...................................................................................................... 6
1.1 Features ............................................................................................. 6
1.2 Speci ication ....................................................................................... 6
1.3 Packing List ........................................................................................ 7
1.4 Optional Accessory ............................................................................ 7
2. Layout ............................................................................................................... 8
3. Pin Assignment and Definitions...................................................................... 9
3.1 Power Connector ............................................................................... 9
3.2 LED Status ......................................................................................... 9
3.3 Thermocouple Input (T/C1 to T/C3) .................................................... 9
3.4 Relay Output Connector (DO_OUT, DO_COM) ............................... 10
3.5 Digital Input Connector (DI1, DI2, DI_COM) ..................................... 10
3.6 Factory De ault Settings ................................................................... 11
4. Manager Uti ity Software ............................................................................... 12
4.1 Download Manager Utility ................................................................ 12
4.2 Manager Utility Installation and Execution ........................................ 13
4.3 Start-Up Manager Utility ................................................................... 13
4.4 Broadcast Search ............................................................................. 14
4.5 Con igure the device ........................................................................ 14
4.5.1 Basic Settings & Advanced Options ................................................. 15
4.5.2 Alarm Setting ................................................................................... 16
4.5.3 Bluemix Command ........................................................................... 17
5. Connect to Watson IoT P atform & Work with Node-RED ........................... 18
5.1 Start to Use IBM Bluemix ................................................................. 18
5.1.1 Sin-Up IBM Bluemix ......................................................................... 18
5.1.2 Log-in and setup .............................................................................. 19
5.1.3 Apps o Bluemix ............................................................................... 20
5.2 Device Registration .......................................................................... 21
5.3 Visual the data in Watson IoT Plat orm Dashboard .......................... 25
5.4 Working on Node-RED ..................................................................... 25
6. WAPI (Web API) on RIO-2018BM ................................................................... 27
6.1 Read Temperature Data ................................................................... 27
6.2 Read Digital Output value ................................................................ 27
6.3 Read Digital Input Value ................................................................... 27
6.4 Set Digital Output Value ................................................................... 28
6.4.1 GET Method ..................................................................................... 28
6.4.2 POST Method .................................................................................. 28

RIO-2018BM User Guide
ARTILA
5
6.5 NTP Time Sy chro izatio ............................................................... 30

RIO-2018BM User Guide
ARTILA
6
1 Introduction
RIO-2018BM is a thermocouple i put remote I/O module supports IBM Bluemix a d
Web i terface. RIO-2018BM has two models J a d K to support J a d K type
thermocouple. I additio to the thermocouple i put, RIO-2018BM also has two
isolated digital i put cha els a d o e form C relay output. Therefore, it is suitable for
temperature measureme t a d co trol. I additio to directly co ect to IBM Watso
IoT platform, data excha ge that ca be achieved by RESTful API for Web applicatio
access.
1 1 Features
 Remote A alog I put Module with TLS MQTT for Bluemix a d Web RESTful API
 O e 10/100Mbps Ether et port
 3 cha els J or K type thermocouple i put with cold ju ctio compe satio
 Two 2500Vrms isolated digital i put (bipolar i put photo-couple)
 O e Form C relay with co tact rati g 30VDC@1A or 1[email protected]
 Support Web-based temperature mo itori g a d DIO co trol
 Optio al DIN Rail mou ti g kit (DK-35A)
 Wi dows co figuratio utility i cluded
1 2 Specification
 Ethernet:
 10/100Mbps, RJ45
 Protectio : 1500V Mag etic isolatio
 Protocol: MQTT, UDP, HTTP, DHCP
(MQTT Port is Fixed at 8883)
 Thermocouple input:
 J type: Maxim MAX31855J co verter with CJC
 Ra ge: -210°C to +1200°C
 K type: Maxim MAX31855K co verter with CJC
 Ra ge: 200°C to +1350°C
 Resolutio : 14-bit, 0.25°C
 Co ector: OMEGA PCC-SMP Thermocouple co ector
 Thermocouple fault detectio
 Relay output:
 Cha el umber: 1 form C
 Co tact rati g: 30VDC@1A or 125[email protected]

RIO-2018BM User Guide
ARTILA
7
 Power:
 9~48VDC power i put
 Termi al block
 Isolated digital input:
 Cha el umber: 2
 Logic high: 5~24VDC
 Logic low: 0~1.5VDC
 I put resista ce: 1.2KOhm@0.5W
 Respo se time: 20µs
 Opto-isolatio : 2500Vrms
1 3 Packing List
 RIO-2018J / RIO-2018K: Thermocouple I put Remote I/O Module
 Software utility dow load from Artila Web (http://www.artila.com/dow load)
1 4 Optional Accessory
 5SRTC-GG-J-24-36 (91-5SRTC-J50)*: Sta dard Size Co ector, J
Thermocouple, Glass Braid I sulatio , 24 AWG, 36 i ch Le gth, 5 PACK
 5SRTC-GG-K-24-36 (91-5SRTC-K50)*: Submi iature Co ector, K
Thermocouple, Glass Braid I sulatio , 24 AWG, 36 i ch Le gth, 5 PACK
 DK-35A (36-DK35A-000): DIN RAIL Mou ti g Kit
 PWR-12V-1A (31-62100-000): 110~240VAC to 12VDC 1A Power Adapter
* Artila ge erally suggests our customers to purchase this item from
origi al ma ufacturer directly.

RIO-2018BM User Guide
ARTILA
8
2 Layout
OMEGA PCC-SMP
LAN
9~48VDC
Power-I Relay Output
Digital I put
DI1 / DI2
Thermocou le
T/C1 ~ T/C3

RIO-2018BM User Guide
ARTILA
9
3 Pin Assignment and Definitions
3 1 Power Connector
Co ecti g 9~48VDC power li e to the Power i termi al block. If the power is
properly supplied, the Power LED will keep solid gree color a d a beep will be heard.
3 2 LED Status
The LED provides the RIO-2018BM operatio i formatio . The LED status is
described as followi g:
 Power LED: Power LED keeps ON if power (+9VDC to +48VDC) is correct.
 Ready LED: Ready LED keeps ON whe RIO-2018BM firmware is ready for
operatio .
 LAN LED: Li k a d Activity LED will tur ON whe the Ether et cable is
co ected. Whe there is etwork data traffic, this LED will flash.
3 3 Thermocouple Input (T/C1 to T/C3)
The thermocouple i put is co ected to MAX31855 with Cold Ju ctio Compe sated
Thermocouple to Digital Co verter. The co ector is OMEGA PCC-SMP. Please
make sure the type of thermocouple matches the model of RIO-2018BM. Refer to
data sheet of MAX31855 for the tech ical specificatio of thermocouple
measureme t.

RIO-2018BM User Guide
ARTILA
10
3 4 Relay Output Connector (DO_OUT, DO_COM)
The relay provides ormal ope output (NO) a d ormal close (NC) as show .
It ca switch voltage source up to 30VDC@1A or 125VAC@0.5A.
3 5 Digital Input Connector (DI1, DI2, DI_COM)
The two cha els isolated i put are equipped with 2500Vrms photo coupler isolator.
The two cha els form a group a d share the same commo grou d.
The specificatio of the isolated i put cha els are:
 Logical High: 5~24Vdc
 Logical Low: 0~1.5Vdc
 I put resista ce: [email protected]W
 Respo se time: 20µs
 Isolatio : 2500Vrms
DO_NC DO_NO
DO_COM
DI1~2
DI_COM
u it: mm (i ches)
Thermocouple connector

RIO-2018BM User Guide
ARTILA
11
3 6 Factory Default Settings
 IP Address: 192.168.2.127
 Netmask: 255.255.255.0
 Web port: 5003
 Telnet console port: 5001

RIO-2018BM User Guide
ARTILA
12
4 Manager Utility Software
Ma ager Utility is a software provided by Artila that is used to co figure a d test
devices though etworki g. Please i stall “Ma ager Utility” o PC before start up
RIO-2018BM.
4 1 Download Manager Utility
You may visit Artila website: http://www.artila.com/, click “Dow load”
Select “RIO/RIO-2018BM” at Dow load page that shows the product series.
http://www.artila.com/dow load/RIO/RIO-2018BM/
You may also go for RIO-2018BM product page at “Remote I/O”
click “resource butto ” to dow load Artila Ma ager utility

RIO-2018BM User Guide
ARTILA
13
4 2 Manager Utility Installation and Execution
I stall Ma ager Utility i your Wi dows-based computer a d ru the software.
4 3 Start-Up Manager Utility
After completed I stallatio of Ma ager Utility, you may see a ico o PC.
Click it to execute Ma ager Utility. It shows the home page as followi g:
: Broadcast Search a d device co figuratio
: Modbus test (NOT Available for RIO-XXXXBM series)
: Modbus user defi e test (NOT Available for RIO-XXXXBM series)
: Log (NOT Available for RIO-XXXXBM series)

RIO-2018BM User Guide
ARTILA
14
4 4 Broadcast Search
Start-up the Ma ager utility software a d click telescope ico to search the RIO
device i the etwork.
4 5 Configure the device
Double-click the RIO device at previous figure, it will go to “Co figure Device” page
Command Button:
: Device firmware upgrade
: Device Reboot
: Set device to default setti g (device will reboot)
: Disco ect etworki g
: Passward setti g (Default: NO passward)

RIO-2018BM User Guide
ARTILA
15
4 5 1 Basic Settings & Advanced Options
User ca upgrade firmware, reboot/disco ect device, set to default settti g, cha ge
device ame/password a d other basic setti g easily via remote operati g.
After co figured, be sure to press “Save to Device” to save all setti gs.
 Device Name: user co figurable device ame
 IP Configure: Static IP or DHCP
 Analog Input / AI#: A alog i put ra ge setti g
 DO Power on Value / DO#: Digital Output setti g
 Bluemix Settings
I put Bluemix related i formatio after registratio .
 NTP Settings
Clock Sy chro izatio setti g
 Web Server Settings
 E able: E able or Disable Web server
 Liste Port: Web server port
 Alive Timeout sec: disco ect co ectio while o data o li e, time out a d
o
respo se to Ack sig al
 TCP Command
 E able: E able or Disable TCP comma d port
 Liste Port: TCP comma d port umber
 Idle Timeout sec: disco ect co ectio while o data o li e a d time out
occur

RIO-2018BM User Guide
ARTILA
16
 Alive Timeout sec: disco ect co ectio while o data o li e, time out a d
o respo se to Ack sig al
 Console Settings
Co sole setti g is used for desig er to perform system debug,
Curre tly it is ot available for user’s applicatio
 Accessible IP Settings
Access co trol setti g. Let user co figure the IP address a d Netmask ra ge a d
masters o ly with these IP address ca access the device.
User ca setup three IP Address / Netmask (Maximum)
 DHCP Options
 Li kDow Re ew sec: Setti g the time period while device li kdow . after the , it
will re ew IP automatically.
 Co ti ue Discover: While device fails to get IP,
OFF: back to default setti g (static IP)
ON: Keep-o discover
4 5 2 Alarm Setting
User ca setup for alarm co ditio s a d actio via DO.

RIO-2018BM User Guide
ARTILA
17
4 5 3 Bluemix Command
Setup “Factory Reset” fu ctio of Bluemix to:
 NONE: No actio
 DO: Low
 DO: High

RIO-2018BM User Guide
ARTILA
18
5 Connect to Watson IoT Platform & Work with Node-
RED
Securely co ect the RIO-2018BM device to IBM Bluemix Watso IoT platform a d
visualize data by the dashboard of Watso IoT platform a d the use Node-RED
applicatio to receive eve ts from RIO-2018BM.
5 1 Start to Use IBM Bluemix
5 1 1 Sin-Up IBM Bluemix
To use Watso IoT platform, you eed to register your device first. Please visit IBM
Bluemix website for registratio at https://co sole. g.bluemix. et/
Press “Sig Up” or “Create a free accou t” to sig up your IBMID a d create your
Bluemix accou t.
After co firm Accou t via email, the registratio has bee completed.

RIO-2018BM User Guide
ARTILA
19
5 1 2 Log-in and setup
At first Log-i , it eeds to setup some i formatio step by step.
Create Organization and Space
Remember to select the Regio (US South) where Watso IoT platform is available.

RIO-2018BM User Guide
ARTILA
20
After completed the setti gs, press “I’m Ready” to explore Bluemix.
5 1 3 Apps of Bluemix
Get started with o e of the optio s that follow,.
or go to the catalog to create a app at https://co sole. g.bluemix. et/