background image

GW-ETH-02A

Operation Mode

The 

Operation mode

 tab provides the setting of the gateway.

Mode

Dataloger

The datalogger is active. Its content can be read using IQRF Cloud server (if enabled), GW web 
server or IQRF IDE GW Tool.

Gateway

UDP channel is active. It is direct connection to the GW (without IQRF Cloud) using the 
application protocol described in chapter 

Application protocol

Communication ports can be selected in the 

Gateway

 field - 

Port

 and 

Remote port

.

Logger

Packet Size

The size dedicated for the data log in the gateway memory. By default, this value is set to 64 B, 
the same as the maximum size of the IQRF packet. Shorter packets allow to store more data 
logs. Minimum packet size is 1 B. When an IQRF packet oversizes the selected packet size, a 
part of user data is lost.

 When the packet size is changed the content of internal memory is cleared.

IQRF Cloud

Period

Defines how often the gateway transmits the data to IQRF Cloud server. Allowed values are from
2 s to 24 hours.

Use IQRF Cloud hosted by CIS

 

    The gateway is configured by default to communicate with IQRF Cloud server 

provided by CIS. Any gateway can also communicate with another IQRF Cloud server provided 
by anyone else. In such a case, the checkbox must be unchecked and the following fields must 
be filled.

AES key

Encryption key used for secure communication between the gateway and the IQRF Cloud server.
The same key must also be specified at the server side. 

Cloud path

The URL address where IQRF Cloud server is hosted. The 

'/cloud' 

substring must follow

Cloud port

The TCP port used. In most cases port 80 is used.

Gateway

GW Port

UDP port for the GW side.

Remote port

UDP port for a remote device side.

© 2016  MICRORISC s.r.o.

www.iqrf.org

User_Guide_GW-ETH-02A_ 160208

Page 14

Summary of Contents for GW-ETH-02A

Page 1: ...GW ETH 02A IQRF Ethernet Gateway Firmware v2 80 User s Guide 2016 MICRORISC s r o www iqrf org User_Guide_GW ETH 02A_160208 Page 1...

Page 2: ...n DPA applications are supported as well GW ETH 02A supports exchanging data with any cloud server designed according to IQRF Cloud server specification Applications Remote monitoring and control Data...

Page 3: ...ge Operating 0 C to 60 C Storage 10 C to 20 C recommended IQRF Frequency bands 868 MHz or 916 MHz SW selectable RF output power According to TR module programmable TR module DCTR 52DA Antenna PCB ante...

Page 4: ...s 10 s restore the factory settings of the gateway After 10 s all LEDs get off to indicate that the factory setting was restored Reset Reset button can be pressed by a pin through the hole in the case...

Page 5: ...is 3308 positions for IQRF RX and 1680 positions for IQRF TX For System log there is always 6553 positions in the buffer The actual size of the data log is the Packet size 14 B where the additional 14...

Page 6: ...data is transmitted to the Cloud server always after the Cloud period elapsed See chapters IQRF IDE GW Tool and Web server Data to be sent to IQRF IQRF TX is stored in internal Flash memory When used...

Page 7: ...t connected to the internal web server it is necessary to know IP address of the GW or the GW host name if the network supports the NBNS i e within the LAN only Internal web server is used for GW conf...

Page 8: ...ferCOM memory array inside the TR module Therefore the application in TR must have the SPI communication activated When using DPA a hardware profile with SPI interface must be uploaded in TR Such plug...

Page 9: ...r IQRF gateway providing Internet connectivity Ethernet GPRS or WiFi is intended An IQRF Cloud server is available free of charge on http s cloud iqrf org provided by CIS Complete Internet Services s...

Page 10: ...ord must be entered Default values are iqrf and iqrf Status The Status tab contains general overview about the gateway status Several buttons are available to control the GW Copy ID To copy the GW ID...

Page 11: ...IP address Current IP address of the GW Subnet mask Ethernet network address range Gateway Main gateway server of the Ethernet network Primary DNS Primary server with DNS service Secondary DNS Seconda...

Page 12: ...sed by NBNS If the main gateway server offers NBNS service it is allowed to use this host name instead IP address of GW Obtain automatically DHCP If the main gateway server offers DHCP service it is a...

Page 13: ...server using the ID of the GW For other DDNS servers The user or user application accesses the GW using the Host Name Refer to the website of given server DDNS DDNS service activation Service provider...

Page 14: ...lost When the packet size is changed the content of internal memory is cleared IQRF Cloud Period Defines how often the gateway transmits the data to IQRF Cloud server Allowed values are from 2 s to 24...

Page 15: ...GW Date Time Date and time currently running in the GW Time zone Time zone selection Use daylight savings Daylight savings for given time zone selection Use SNTP server When activated the GW time wil...

Page 16: ...ngth is from 4 to 8 characters When the username or the password is lost the user can reset the gateway to factory settings The default username and password values are iqrf and iqrf HTTP Server Disab...

Page 17: ...to the Cloud server IQRF Tx Data downloaded from Cloud server and transmitted to IQRF network System Certain events that occurs during the execution The user do not usually need to take care about it...

Page 18: ...ROR CLOUD_REGISTRATION_DONE CLOUD_LICENSE_DONE CLOUD_CONNECTION_ERROR CLOUD_REGISTRATION_ERROR CLOUD_UPLOAD_ERROR CLOUD_DOWNLOAD_ERROR CLOUD_DOWNLOAD_CONF_ERROR CLOUD_SYSTEM_PACKET_ERROR CLOUD_UNKNOWN...

Page 19: ...mplemented inside the GW ETH 02A should be accessed by any common up to date web browser except of Internet Explorer by Microsoft Menu The main menu provides an access to the configuration pages of GW...

Page 20: ...etwork connection parameters set manually or obtained through DHCP TR module Type TR module type inside the GW MID Unique IQRF TR module identification number OS Current version of IQRF OS and build v...

Page 21: ...address If the DHCP service is available in the network the Obtain automatically checkbox should be activated otherwise the parameters for access to the LAN network must be selected manually In the fa...

Page 22: ...e remaining data is not saved IQRF Cloud Enabled Activates the communication with the Cloud server Period Communication period which GW uploads downloads data to from the Cloud server in Every digit o...

Page 23: ...erver in minutes Minimum value is 10 minutes Password In factory settings the User Name and the Password are iqrf The password should be changed by the user on the Password Setup page To accomplish a...

Page 24: ...oud server Maintenance Main Menu returns from the Maintenance page to main menu Factory Defaults allows to restore the original factory settings or reboot the gateway Configuration page allows to writ...

Page 25: ...llows to reprogram the TR module inside the GW Supported files are hex iqrf and trcnfg trcnfg can be generated by export of TR configuration in IQRF IDE FW Upgrade This page allows to upgrade the GW b...

Page 26: ...0 0 0 Operation Mode Mode Datalogger Packet Size 64B IQRF Cloud Communication Enabled Use IQRF Cloud Server hosted by CIS Enabled Communication period 10 s GW port for the application protocol 55300 H...

Page 27: ...GW ETH 02A functionality the GW can be used with DPA hardware profile in similar way as which is described in IQRF DPA Quick Start Guide Follow this Guide chapters 1 to 5 Use GW ETH 02A instead of CK...

Page 28: ...en the main page of the GW by clicking to the GW ID number Click the Send data to IQRF button The window with predefined LED control commands opens Using the macros or by modification of commands in I...

Page 29: ...is the same for both communication directions HEADER H 9 B DATA D 0 497 B CRC 2 B For receiving GW checks GW_ADR validity see the packet header packet length must not be lower than HEADER CRC packet l...

Page 30: ...swer to the 0x02 command SUBCMD 0x00 no information DATA see Status data Write data to TR module Data according the IQRF SPI protocol is written to the TR module The answer is an acknowledge of writti...

Page 31: ...SUBCMD 0x00 no information DB1 username text to max 15 characters not used ones replace with zeroes DB15 DB16 old password text to max 15 characters not used ones replace with zeroes DB30 DB31 new pa...

Page 32: ...ata GW host direction CMD 0x80 answer to an unknown command SUBCMD 0x60 packet error DLEN 0x0000 no data Communication initiated by the GW asynchronous message Send data from TR module Sends data from...

Page 33: ...rs 7 IQRF module OS version e g 3 06D 8 Public IP address e g 213 214 215 120 Status data GW status data for the Get GW status command DB1 TR module status see the IQRF SPI protocol DB2 no used DB3 0x...

Page 34: ...enas tens and the lower nibble LN means units Example seconds DB 0x53 means 53 s Legal ranges seconds UN 0 5 LN 0 9 min 0 max 59 minutes UN 0 5 LN 0 9 min 0 max 59 hours UN 0 2 LN 0 9 min 0 max 23 day...

Page 35: ...ent from Thus the equipment finds out its public IP address in the format Current IP Address 10 100 20 200 Request for IP address http www iqrfdns org IP 001FD5010203 The http client of the GW ETH Too...

Page 36: ...starts If the upgrade is completed the GW will then be started with the new FW version To make sure that the upgrade passed successfully check the current FW version e g via the internal web server I...

Page 37: ...is connected to IQRF IDE Terminal the communication over Ethernet is disabled SPI communication is forwarded to the Terminal but not to the Cloud This mode is indicated by short flashes of green LED...

Page 38: ...ror when uploading data to IQRF Cloud server in the Datalogger mode only Download error Error when downloading data from IQRF Cloud server in the Datalogger mode only When the gateway indicates Run er...

Page 39: ...GW returns to run mode If the button was released at time 1 s to 10 s the GW is turned off Firmware upgrade In the first step the stored hex file is checking for errors If no errors occur the content...

Page 40: ...F Ethernet gateway DCTR 52DA inside Firmware history v2 80 Reset and factory settings improved Some minor improvements and bugs fixed v2 74 SPI timing changed according to changed IQRF SPI specificati...

Page 41: ...oned herein are property of their respective owners Legal All information contained in this publication is intended through suggestion only and may be superseded by updates without prior notice No rep...

Reviews: