NXP Semiconductors SABRE i.MX 6 Series Instrucciones de montaje

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

Otros manuales para SABRE i.MX 6 Series

Tabla de contenidos

Otros manuales de Hardware de computadora de NXP Semiconductors

NXP Semiconductors

NXP Semiconductors S32G-VNP-EVB Manual de usuario

NXP Semiconductors

NXP Semiconductors TWR-K60F120M Manual de usuario

NXP Semiconductors

NXP Semiconductors K32W061 Manual de usuario

NXP Semiconductors

NXP Semiconductors UM11673 Manual de usuario

NXP Semiconductors

NXP Semiconductors i.MX 8M Plus Manual de usuario

NXP Semiconductors

NXP Semiconductors QorIQ LS1028A Manual de usuario

NXP Semiconductors

NXP Semiconductors MCF5253 Manual de usuario

NXP Semiconductors

NXP Semiconductors JN516x Manual de usuario

NXP Semiconductors

NXP Semiconductors PN7150 Manual de usuario

NXP Semiconductors

NXP Semiconductors MSC8113 Manual de usuario

NXP Semiconductors

NXP Semiconductors UM10569 Manual de usuario

NXP Semiconductors

NXP Semiconductors UM11620 Manual de usuario

NXP Semiconductors

NXP Semiconductors LPC288 Series Manual de usuario

NXP Semiconductors

NXP Semiconductors RD9Z1-638BJBEVM Manual de usuario

NXP Semiconductors

NXP Semiconductors QorIQ T2080 Manual de usuario

NXP Semiconductors

NXP Semiconductors TWR-SB0410-36EVB Manual de usuario

NXP Semiconductors

NXP Semiconductors AXIOM M52259DEMOCOM Manual de instalación

NXP Semiconductors

NXP Semiconductors MCU-Link Pro Manual de usuario

NXP Semiconductors

NXP Semiconductors i.MX 8MDQLQ Manual de usuario

NXP Semiconductors

NXP Semiconductors Android i.MX 8M Mini Manual de usuario

NXP Semiconductors

NXP Semiconductors HVP-56F80748-UM Manual de usuario

NXP Semiconductors

NXP Semiconductors Freescale TWR-S12G240 Manual de usuario

NXP Semiconductors

NXP Semiconductors MX93AUD-HAT-UM Manual de usuario

NXP Semiconductors

NXP Semiconductors MCU-SMHMI-HDUG Manual de usuario

Manuales populares de Hardware de computadora de otras marcas

EMC2

EMC2 VNX Series Manual del propietario

Panasonic

Panasonic DV0PM20105 Manual de usuario

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 Manual de usuario

Gigabyte

Gigabyte B660M DS3H AX DDR4 Manual de usuario

Raidon

Raidon iT2300 Manual de usuario

National Instruments

National Instruments PXI-8186 Manual de usuario

Hauppauge

Hauppauge WinTV-HVR-2250 Manual de usuario

Kontron

Kontron CP6002 Manual de usuario

Manhattan

Manhattan 702843 Manual de usuario

Aphex

Aphex 230 Manual de usuario

AMD

AMD Phenom II Manual operacional

Intel

Intel NUC 12 Pro Manual de usuario

dbx

dbx Zone Pro 1260 Manual de usuario

Galaxy

Galaxy GHDX2-2430S-24F4D Manual de usuario

Intel

Intel AXXRMFBU4 Manual de usuario

Kontron

Kontron DIMM-PC/MD Manual de usuario

ST X-NUCLEO-SAFEA1B Instrucciones de funcionamiento

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 Manual de usuario