Moxa UC-8100-ME Setup

This guide will walk you through the steps required to run Clarity Gateway on a Moxa UC-8100-ME edge computer. You may need to update the device's operating system and configure the device's networking before installing Clarity Gateway.

Updating the Operating System

To ensure support for Clarity Gateway, we recommend updating your UC-8100-ME firmware to version 3.0.

Updating the firmware on your Moxa device will erase all data on the device! Ensure that any data you want to keep is backed up before proceeding!

Download the latest UC-8100-ME-T firmware bundle, which as of this writing is moxa-uc-8100-me-t-series-firmware-v3.0.zip.

Unzip the firmware bundle, which should give you a file like FWR_UC8100ME_v3.0_Build_18110917.img. You'll need to paste that file name into your serial terminal later.

Connect a terminal emulator to the Moxa console connector. You can tell which side is pin 1 because there is no pin in location 3. The baud rate is 115200, with 8 data bits, 1 stop bit, and no parity.

1 TxD
2 RxD
3 (not populated)
4 GND

If you need serial terminal on a Linux device, try installing screen:

apt install screen
screen /dev/ttySC1 115200

To exit from screen, type ctrl-A then :quit.

Boot up the Moxa device, and press the backspace key as it powers up to reach the bootloader menu

 Model: UC-8112-ME-T-LX
 Boot Loader Version 1.0.0S09 CPU TYPE: 1GHz
 Build date: Jan 30 2016 - 14:44:07 Serial Number: TAFBB1064329
 LAN1 MAC: 00:90:E8:55:46:33 LAN2 MAC: 00:90:E8:55:46:34
----------------------------------------------------------------------------
(0) Extend USB Port Control (1) Firmware Update by SD Card
(2) Firmware Update by Tftp (3) Select Boot Device
(4) Go To OS (5) Auto update ThingsPro from SD card
---------------------------------------------------------------------------
Command>>1

Enter the name of the firmware file you saved on the SD card:

Command>>1
Firmware File Name (firmware.img): FWR_UC8100ME_v3.0_Build_18110917.img

Wait for the firmware update to finish, then reboot the device.

Configuring Networking

The default IP addresses on the Moxa device are:

• LAN 1: 192.168.3.127

• LAN 2: 192.168.4.127

To open a shell on the Moxa device: ssh -l moxa 192.168.3.127. The username and password are moxa / moxa.

Here's an example of a /etc/network/interfaces file that re-configures LAN 1 to work on a 10.1.1.x network:

# interfaces(5) file used by ifup(8) and ifdown(8)
# Include files from /etc/network/interfaces.d:
source-directory /etc/network/interfaces.d
auto eth0 eth1 lo
iface lo inet loopback
iface eth0 inet static
        address 10.1.1.240 
    gateway 10.1.1.1
    dns-nameservers 10.1.1.1
        network 10.1.1.0
        netmask 255.255.255.0
        broadcast 10.1.1.255
iface eth1 inet static
        address 192.168.4.127
        network 192.168.4.0
        netmask 255.255.255.0
        broadcast 192.168.4.255

Installing Clarity Gateway

Download the latest Clarity Gateway bundle from the Clarity Gateway Releases Page

Transfer the bundle to the Moxa device: scp clarity-gateway-v1.5.2.tar.gz moxa@192.168.3.127:~

Open an SSH session on the Moxa device, and extract the bundle: tar xf clarity-gateway-v1.5.2.tar.gz

Run the Clarity Gateway install script: clarity-gateway/install.sh. When prompted for the sudo password by [sudo] password for moxa:, enter moxa.

Connect to Clarity Gateway with your browser: http://192.168.3.127. The default password is password.