NXP Semiconductors SABRE i.MX 6 Series Montageanleitung

NXP i.MX 6 UltraLite Evaluation Kit

Edge MicroServer Installation and

Setup Guide

Version 1.0

NXP i.MX 6 UltraLite Evaluation Kit Installation and Setup Guide

Software Change Log ............................................................................................................................ 2

Introduction ............................................................................................................................................ 2

About the NXP i.MX 6 UltraLite Evaluation Kit ................................................................................... 2

Initial Setup ............................................................................................................................................ 2

Preparing the Device .......................................................................................................................... 3

Download and Install the Edge Microserver ....................................................................................... 5

Configuration and Connection ............................................................................................................... 6

Configuring and Setting up a Websocket Connection ........................................................................ 6

Verifying Websocket Connection ....................................................................................................... 7

Troubleshooting ..................................................................................................................................... 8

Compatibility........................................................................................................................................... 9

Document Revision History .................................................................................................................... 9

NXP i.MX 6 UltraLite Evaluation Kit Installation and Setup Guide

Software Change Log

Version

Release Date

Changes

1.0

4/15/2016

Initial Release

rod

ion

The Edge MicroServer is a powerful component of the ThingWorx architecture. The Edge MicroServer

allows for the rapid deployment of connections between the ThingWorx platform and an associated

data reporting device, with minimal design requirements on the part of the user.

The Edge MicroServer provides an “always-on” connection to the platform, and it opens a local web

server that interacts with the REST API available on the platform.

This document provides installation and usage instructions for setting up the Edge MicroServer with the

NXP i.MX 6 UltraLite Evaluation Kit.

About the NXP i.MX 6 UltraLite Evaluation Kit

The NXP i.MX 6 UltraLite Evaluation Kit [hereafter referred to as the NXP Device] is a development and

evaluation board manufactured by NXP Corporation. It allows for a rapid interchange of various NXP

accessories, including LCD screens, processor boards, and payment interfaces. It features a 528 MHz

ARM Cortex-A7 Core processor, 4GB DDR3L SDRAM @ 400MHz, 256 Mb Quad SPI Flash, a MicroSD

connector, as well as various peripheral input and outputs, including Bluetooth connectors, speaker,

HDMI, and Ethernet connectors, USB ports, CAN connectors, and more.

The ThingWorx Edge MicroServer Linux-ARM distribution may be installed on the NXP Device, and this

guide will follow the procedure for doing so. This guide will also follow the features involved with

initiating a connection between a remote Thingworx platform and the NXP Device.

Initial Setup

Setup of the NXP Device with an EMS will first require configuring and setting up the device according to

the instructions provided by NXP for this board. They may be found at

http://www.nxp.com/products/sensors/gyroscopes/i.mx6ultralite-evaluation-kit:MCIMX6UL-EVK?.

This device is required to be in a state where it is running off of the OS image installed on an SD card on

the device’s SD card slot. In addition, libstdc++ libraries are required by the ThingWorx EMS. More

information about the ThingWorx EMS may be found at

http://support.ptc.com/cs/help/thingworx_hc/thingworx_6.0_hc/.

NXP i.MX 6 UltraLite Evaluation Kit Installation and Setup Guide

Please note that this guide was written for a computer running Microsoft Windows.

Refer to the Troubleshooting section of this guide for help with frequently asked questions.

Preparing the Device

If it has not already been performed,

follow the NXPi.MX 6UltraLite Quick

Start Guide to connect all peripherals

to the device appropriately. Verify it

has a micro SD card properly

connected, and power it on.

Make sure the device is connected to

a PC via a micro USB cord inserted

into the “J1901” micro USB port.

Verify that the device has an

Ethernet connection to a local

network with internet, as well.

On the connected computer, verify

that the proper Windows drivers are

installed to interface with this device.

This may be verified in Device

Manager, and the device should have

installed automatically as “Silicon

Labs CP210x USB to UART Bridge

”,

or similar.

If the device does not install

automatically, you will need to

manually locate and install these

drivers.

See the device setup guide at

http://www.nxp.com/products/sensors/gyroscopes/i.mx6ultralite-

evaluation-kit:MCIMX6UL-EVK?

NXP i.MX 6 UltraLite Evaluation Kit Installation and Setup Guide

Note the COM port listed in this

connection. Open a terminal serial

connection program such as PuTTY,

and create a new connection to this

device on the serial port noted. Use

baud rate 115200.

At this point, PuTTY should show a

console with details concerning the

device’s boot-up, or you may see a

prompt. Press “Enter” once.

Following this, type “root” and

press enter again. The screen should

be visible to the one at right:

Enter the command:

ifconfig

To obtain the device’s IP address.

NXP i.MX 6 UltraLite Evaluation Kit Installation and Setup Guide

Download and Install the Edge Microserver

From the PTC Support Site, download

the ThingWorx EMS. Make sure you

download the proper version for your

device (and latest datecode):

“MicroServer-5-3-1-1113-Linux-

ARM”.

Use a program such as WinSCP to copy the EMS to the device under the following directory (create if it

does not exist):

/usr/include/microserver

Set permissions for the “wsems” and “luaScriptResource” to allow for execution (all permissions works)

using chmod:

chmod 777 wsems

chmod 777 luaScriptResource

NXP i.MX 6 UltraLite Evaluation Kit Installation and Setup Guide

Configuration and Connection

Configuring and Setting up a Websocket Connection

Open for editing, using either WinSCP

or the VI editor, the “config.json” file.

Modify the configuration file to suit a connection to a remote ThingWorx Platform server. A valid AppKey is

required.

Note: It is highly recommended to connect to a server using only a secure (https) connection via SSL or TLS.

For additional guidance and examples on setting a configuration file, please refer to

http://support.ptc.com/cs/help/thingworx_hc/thingworx_6.0_hc/ and follow the guide section entitled

“ThingWorx WebSocket-based Edge MicroServer (WSEMS)”

After verifying the connection information (see example below), save and close the file.

Start the EMS using the following command:

./wsems

Verify that the EMS starts, runs, and connects to the remote platform. Look for the message “Websocket

Connected!” to verify a connection was successful.

NXP i.MX 6 UltraLite Evaluation Kit Installation and Setup Guide

Verifying Websocket Connection

From any browser, navigate to the remote

ThingWorx platform server.

Navigate to the “Monitoring > Remote Things” section, and then click the “Unbound” tab. The NXP device,

configured with the name given in the config.json file, should be visible here.

NXP i.MX 6 UltraLite Evaluation Kit Installation and Setup Guide

At this point, the device is connected. You may configure it to push properties to the server and bind them

as remote properties. For more information, follow the examples and guides at

http://support.ptc.com/cs/help/thingworx_hc/thingworx_6.0_hc/.

To properly shut down the device, first stop the EMS (use CTRL+C), and then power down the device using

the command:

shutdown –h now

Power off the power switch, and then remove the power supply.

Troubleshooting

Problem

Solution(s)

Device will not boot up / will not remain running.

Verify that the proper power supply is connected (5V, 3.5A).

Verify that the Ethernet port is connected to a router with an internet

connection.

The SD card must be present on the device with an OS image. Verify

that the SD card is properly imaged and mounted in the device. For

more information in preparing the SD card, visit

http://www.nxp.com/products/sensors/gyroscopes/i.mx6ultralite-

evaluation-kit:MCIMX6UL-EVK

Some devices have trouble holding the SD card firmly against the pins

in the reader on the board. Your device may require repair or

replacement. To confirm this issue, contact NXP; or to confirm this

issue, try applying gentle but firm pressure to the top of the SD card,

against the board, while it is in the reader. If the device boots while

pressure is applied, try to re-seat the SD card or contact NXP for further

assistance.

The SD Card image may be corrupted. Attempt to re-flash.

Verify the USB cable is connected to the proper micro-USB port on the

device (there are two). Refer to the NXP Quick Start Guide for guidance.

The device will not connect to a remote server

or the EMS will not connect.

Carefully check the config.json file for any typos, such as a missing

comma, quotation mark, or an inaccurate AppKey. Look at the EMS

console log while running to determine what the problem is.

If you are connecting via SSL, verify that the server supports such a

connection, that the config.json file is set to use port 443, and a

certificate is provided. Refer to the “config.json.complete” file, included

on the EMS, for example configurations and explanations.

Verify that no firewall or network configuration is preventing the device

from connecting to the server, or the server from accepting connections

from the device.

Attempt to connect to a ThingWorx server on the local network to rule

out other network issues.

Verify that the Standard C++ library is loaded onto the device (libstdc++)

NXP i.MX 6 UltraLite Evaluation Kit Installation and Setup Guide

Compatibility

This guide has been tested for compatibility with the DEVICE and the following ThingWorx platform and

operating system:

ThingWorx Platform Version

ThingWorx 7.0.1

Windows 7, Service Pack 1

EMS

MicroServer-5-3-1-1113-Linux-ARM

Board MFGTOOL

Rev L3.14.38.6ul

Document Revision History

Revision Date

Version

Description of Change

April 15th, 2016

1.0

Initial Release

Andere Handbücher für SABRE i.MX 6 Series

Inhaltsverzeichnis

Andere NXP Semiconductors Computerhardware Handbücher

NXP Semiconductors

NXP Semiconductors i.MX 8QuadXPlus Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors FRDM-K32L2A4S Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors MCIMX8QM-CPU Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors QorIQ LS1028A Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors BFU520 Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors MR-CANHUBK344 Gebrauchsanweisung

NXP Semiconductors

NXP Semiconductors freescale MCF5225X Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors OM13506 Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors AXIOM M52259DEMOCOM Installationshandbuch

NXP Semiconductors

NXP Semiconductors Android Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors i.MX 8M Mini EVK Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors QorIQ LS1046A Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors freescale MC9S12G128 MCU Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors i.MX 6SoloX SABRE-SDB Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors MCIMX93-EVKCM Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors i.MX RT1170 Montage- und Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors MCU-SMHMI-UG Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors UM11768 Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors PowerQUICC MPC8308_RDB Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors QN908 series Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors S32G-VNP-EVB Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors Android i.MX 8M Mini Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors SLN-VIZNLC-IOT Bedienungsanleitung

NXP Semiconductors

NXP Semiconductors HVP-56F80748-UM Bedienungsanleitung

Beliebte Computerhardware Handbücher anderer Marken

EMC2

EMC2 VNX Series Betriebsanleitung

Panasonic

Panasonic DV0PM20105 Bedienungsanleitung

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 Bedienungsanleitung

Gigabyte

Gigabyte B660M DS3H AX DDR4 Bedienungsanleitung

Raidon

Raidon iT2300 Bedienungsanleitung

National Instruments

National Instruments PXI-8186 Bedienungsanleitung

Hauppauge

Hauppauge WinTV-HVR-2250 Bedienungsanleitung

Kontron

Kontron CP6002 Bedienungsanleitung

Manhattan

Manhattan 702843 Bedienungsanleitung

Aphex

Aphex 230 Bedienungsanleitung

AMD

AMD Phenom II Betriebshandbuch

Intel

Intel NUC 12 Pro Bedienungsanleitung

dbx

dbx Zone Pro 1260 Bedienungsanleitung

Galaxy

Galaxy GHDX2-2430S-24F4D Bedienungsanleitung

Intel

Intel AXXRMFBU4 Bedienungsanleitung

Kontron

Kontron DIMM-PC/MD Bedienungsanleitung

ST X-NUCLEO-SAFEA1B Betriebsanleitung

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 Bedienungsanleitung