HARTING MICA User Manual

Page 1
HARTING MICA Wireless User Guide
Page 2
HARTING MICA Wireless User Guide
2 HARTING IT Software Development
© HARTING IT Software Development, Espelkamp
All rights reserved, including those of the translation.
No part of this manual may be reproduced in any form (print, photocopy, microfilm or any other process), processed, duplicated or distributed by means of electronic systems without the written permission of HARTING IT Software Development GmbH & Co. KG, Espelkamp.
Subject to alterations without notice.
This Guide refers to Base Version 3, Interface Version and Container Version 1.1.0_b1.
Page 3
HARTING MICA Wireless User Guide
HARTING MICA Wireless User Guide 3
Contents
Contents ........................................................................................................................ 3
1 Overview ................................................................................................................. 4
2 Components and Connectors .............................................................................. 4
3 Connecting MICA Wireless to Power ................................................................... 5
4 Antenna Selection and Installation ...................................................................... 6
5 Initial Configuration ............................................................................................... 7
6 WiFi Client and Access Point Mode ..................................................................... 8
7 WLAN Settings ....................................................................................................... 9
7.1 Access Point Mode Configuration ........................................................... 9
7.2 Client Mode Configuration ..................................................................... 10
7.3 Advanced Roaming ................................................................................. 10
8 LTE Configuration ............................................................................................... 12
9 The Mobile Container .......................................................................................... 13
10 Using LTE Communications ............................................................................... 14
11 Accessing the LTE Container through Emnify VPN ........................................ 15
12 Using Location Services ..................................................................................... 16
13 Further Documentation ....................................................................................... 18
14 Appendix .............................................................................................................. 19
14.1 LED modes ............................................................................................... 19
Page 4
HARTING MICA Wireless User Guide
4 HARTING IT Software Development
1 Overview
MICA® Wireless brings a full suite of wireless connectivity to the award-winning HARTING Modular Industry Computing Architecture. It lets you collect and process data directly at the machine or plant and forward relevant information to MES and ERP systems wirelessly.
This guide describes the basic MICA Wireless; depending on the MICA variant you have, there may be an additional function board installed in the device. For any functionality spe­cific to the function board, please refer to the documentation for your MICA variant.
2 Components and Connectors
The order of connectors is as shown in the picture above (from left to right)
M8 24 V Power connector Reverse SMA for Wi-Fi (802.11.a/b/g/n, 2.4GHz and 5GHz) Reverse SMA for GNSS Reverse SMA for GSM / UMTS
Page 5
HARTING MICA Wireless User Guide
HARTING MICA Wireless User Guide 5
3 Connecting MICA Wireless to Power
If you received a power supply, connect the cable to the M8 connector. If you received an open ended power cable, the pin layout is:
Pins 1 and 2 as well as pins 3 and 4 are connected with each other internally.
Page 6
HARTING MICA Wireless User Guide
6 HARTING IT Software Development
4 Antenna Selection and Installation
When installing antennas, make sure that you use the appropriate antennas and adapters. The connections on the MICA are reverse SMA. If you are using SMA antennas, the con­nectors will physically fit, but will not connect correctly electronically.
Since the MICA Wireless only comes with one antenna for each technology, the strength of the connection can depend highly on the relative orientation of the antennas on the MICA and other wireless devices the MICA connects to. If you experience weak connections or frequently dropped connections, check the relative alignment, or chose a different antenna with a more appropriate characteristic.
Note: if you experience weak connections or frequently dropped connec­tions, please check that the antennas are installed and connected cor­rectly first. Then try adjusting the relative alignment of the antennas on the MICA and other wireless devices or access points in your wireless network.
Page 7
HARTING MICA Wireless User Guide
HARTING MICA Wireless User Guide 7
5 Initial Configuration
When the MICA Wireless is initially connected to power, it starts in Access Point mode with IP address 10.10.10.10 and WPA2 enabled. The SSID and WPA2 password are listed on the type shield on the bottom of the MICA. Use these to connect to the MICA from your PC or tablet and to perform the initial configuration.
Page 8
HARTING MICA Wireless User Guide
8 HARTING IT Software Development
6 WiFi Client and Access Point Mode
The MICA Wireless is initially configured to start in Access Point mode. When you switch the MICA to Client mode, it will restart and try to connect to the specified wireless access point. If the MICA is unable to connect to an access point within 1 minute, it will restart in Access Point mode to make sure it stays available for configuration.
If you are preconfiguring the MICA to deploy later, you can disable this fallback mechanism by disconnecting the MICA from power after switching to Client Mode. The countdown to the fallback mechanism then starts when the MICA restarts.
Page 9
HARTING MICA Wireless User Guide
HARTING MICA Wireless User Guide 9
7 WLAN Settings
7.1 Access Point Mode Configuration
To use the MICA Wireless as an access point:
1. Navigate to Settings Network
2. Set the correct Country Code for your region
3. Set the operation mode to Access Point
4. Choose the Standard you want the access point to use
5. Optionally, select a specific channel
6. Select the desired security mode
7. Enter the SSID and the network key (PSK). Make sure to remember the access key since you will need it to connect any Wi-Fi client to the MICA.
8. Choose a DHCP lease range. This is the range of IP addresses the access point will issue to connected clients
Page 10
HARTING MICA Wireless User Guide
10 HARTING IT Software Development
7.2 Client Mode Configuration
To configure the MICA in client mode.
1. Navigate to Settings Network
2. Set the correct Country Code for your region
3. Set the Operation Mode to Client
4. Choose a frequency band
5. Enter the SSID of the access point or scan for available access points. You can also scan for available access points by clicking the Scan button.
6. Select the appropriate security mode supported by the chosen access point
7. Choose the desired roaming mode (see section 7.3).
When you switch the MICA to Client mode, it will restart and try to connect to the specified wireless access point. If the MICA is unable to connect to an access point within 1 minute, it will restart in Access Point mode to make sure it stays available for configuration.
7.3 Advanced Roaming
Starting with Firmware 3, the MICA Wireless supports two roaming modes between two or more access points with the same SSID und authentication.
Normal Roaming
The default roaming behavior is to switch the AP only if the connection to the old AP
is lost. This saves energy, but can cause low bandwidth and higher latency at larger distances to the access point.
Advanced Roaming
MICA checks for new access points every 5 seconds and switches the to a new ac-
cess point if the signal strength drops below -40dBm.
Page 11
HARTING MICA Wireless User Guide
HARTING MICA Wireless User Guide 11
Advanced roaming can be activated in the Client network settings.
While advanced roaming is active, it is recommended not to launch scans for additional ac­cess points.
Page 12
HARTING MICA Wireless User Guide
12 HARTING IT Software Development
8 LTE Configuration
MICA Wireless ships with an Emnify eSIM. To commission the eSIM and set up your ac­count, check with your system administrator, or follow the instructions in the EMnify Set-Up Guide available at www.emnify.com to sign up for the Emnify User Interface.
If you were invited to the Emnify User Interface by an existing organization, you should have received an email with an activation link. Please open the link within 48 hours and choose a password for your account. You will then be able to log in with your email address and cho­sen password.
After signing up, please create a support ticket with the ICC-IDs of the MICAs you want to use on a mobile network. Emnify will activate your account typically within 24 hours.
Notes
Enter the same email address
you used to log-in to the Em-
nify User Interface.
Enter the 19-digit ICCID, listed
on the MICA type shield or in the LTE container running on
your MICA.
If you want to get a higher
volume of SIMs assigned you can enter an ICCID range or attach a list with all ICCIDs to the ticket.
Page 13
HARTING MICA Wireless User Guide
HARTING MICA Wireless User Guide 13
9 The LTE Container
MICA Wireless ships with a container which handles the mobile and the GNSS (GPS, Gali­leo, GLONASS) module. To start using the module, start the mobile containercalled LTE in the default installationby clicking Start Module, and choose the desired network mode.
To start using the mobile network, move the Use Mobile slider to right. If you have not com­missioned your eSIM, you will receive an error message.
The Received Signal Strength Indicator (RSSI) is a measurement of the power present in a received radio signal. If you have trouble keeping a stable connection you can use the RSSI to check if changes to the antenna position and orientation improve reception.
Page 14
HARTING MICA Wireless User Guide
14 HARTING IT Software Development
10 Using LTE Communications
You can connect your mobile container using the web UI or the RPC interface:
https://<
mica-name
>/<container-name>/rpc/
For more information on the RPC interface, you can append the container URL in your browser with /api, for example
https://<
mica-name
>/<
container-name
>/api
to view the container documentation. You can now use this mobile connection from within other containers by adding the mobile
container as default gateway by selecting the mobile container as the default IPv4 gateway in the Container Settings. To access the Settings, right-click on the container and select Set­tings.
Then add the mobile container as Gateway to the IPv4 Settings.
You can also log into the container with admin rights over ssh and setting the default gate­way manually.
route del default
route add default gw <lte-container-ip>
For more information on working with additional network interfaces, see the application note Additional Network Interfaces in the Technical Resources section of www.harting-mica.com.
Page 15
HARTING MICA Wireless User Guide
HARTING MICA Wireless User Guide 15
11 Accessing the LTE Container through Emnify VPN
To access the LTE container remotely from a mobile network (for example if you have WiFi access available), you need to use an OpenVPN connection via your EMnify account. To do this, login with your user account under www.emnify.com, go to Tokens, IPs & VPN Setup and follow the instructions.
Page 16
HARTING MICA Wireless User Guide
16 HARTING IT Software Development
12 Using Location Services
To activate Location Services, connect a GNSS antenna to the MICA and turn on the GNSS module in the mobile container (see 9) by moving the Use GNSS slider to the right. Note that it can take up to 20 minutes for the module to achieve a position lock when activated for the first time or after moving the MICA Wireless a large distance.
Position information can be requested from the Wireless Container either via the container UI or by using RPC calls.
The JSON RPC need to be requested from
https://<
mica-name
>/<
container-name
>/rpc/
It is necessary to have GNSS enabled before getting GNSS position information. When GNSS is enabled for the first time, it can take up to 20 minutes for the MICA to lock on to a sufficient number of satellites to calculate its position. If you cannot receive a GNSS posi­tion, check that GNSS is enabled, that an appropriate antenna is connected, and that the antenna has an unobstructed view of the sky.
To request GNSS data using RPC1, enable the interface
{
"method" : "set_config",
"params" : { "auth_token" : auth_token, { "gnss": True } }
}
and request the latitude and longitude.
{
"method" : "get_state",
"params" : { "auth_token" : auth_token }
}
1
The ID and JSON information is being left out for readability. Please see the MICA Pro-
gramming Guide for an overview of the MICA JSON RPC API.
Page 17
HARTING MICA Wireless User Guide
HARTING MICA Wireless User Guide 17
The response will look like the following.
{
"result" : {
"rssi" : rssi,
"gnss_position" : [ latitude, longitude ]
}
}
Page 18
HARTING MICA Wireless User Guide
18 HARTING IT Software Development
13 Further Documentation
Documentation on programming your MICA or developing custom hardware is available from http://www.harting-mica.com/ . If you need further assistance, please contact your HARTING partner, or email micasupport@harting.com.
Page 19
HARTING MICA Wireless User Guide
HARTING MICA Wireless User Guide 19
14 Appendix
14.1 LED modes
14.1.1 System status
LED color
Mode
Status
Green
On
Operating normally
Green
Flashing
Initialization
Red
On
Boot process
14.1.2 Mobile network status
LED color
Mode
Status
Red
200ms on / 1800ms off
Looking for network
Red
1800ms on / 200ms off
Idle
Red
125ms on / 125ms off
Transferring data
Red
Off
Module disabled
14.1.3 WiFi status
LED color
Mode
Status
Orange
on
WiFi eabled
Orange
Off
WiFi disabled
Red
125ms on / 125ms off
Transferring data
Red
Off
Module disabled
Loading...