Vantron VT-M2M-BTA-DE ThingWorx
Installation and Setup Guide
October 2015
Copyright © 2015 PTC Inc. and/or Its Subsidiary Companies. All Rights Reserved.
User and training guides and related documentation from PTC Inc. and its subsidiary companies (collectively “PTC”) are subject
to the copyright laws of the United States and other countries and are provided under a license agreement that restricts
copying, disclosure, and use of such documentation. PTC hereby grants to the licensed software user the right to make copies in
printed form of this documentation if provided on software media, but only for internal/personal use and in accordance with
the license agreement under which the applicable software is licensed. Any copy made shall include the PTC copyright notice
and any other proprietary notice provided by PTC. Training materials may not be copied without the express written consent of
PTC. This documentation may not be disclosed, transferred, modified, or reduced to any form, including electronic media, or
transmitted or made publicly available by any means without the prior written consent of PTC and no authorization is granted
to make copies for such purposes.
Information described herein is furnished for general information only, is subject to change without notice, and should not be
construed as a warranty or commitment by PTC. PTC assumes no responsibility or liability for any errors or inaccuracies that
may appear in this document.
The software described in this document is provided under written license agreement, contains valuable trade secrets and
proprietary information, and is protected by the copyright laws of the United States and other countries. It may not be copied
or distributed in any form or medium, disclosed to third parties, or used in any manner not provided for in the software licenses
agreement except with written prior approval from PTC.
UNAUTHORIZED USE OF SOFTWARE OR ITS DOCUMENTATION CAN RESULT IN CIVIL DAMAGES AND CRIMINAL PROSECUTION.
PTC regards software piracy as the crime it is, and we view offenders accordingly. We do not tolerate the piracy of PTC software
products, and we pursue (both civilly and criminally) those who do so using all legal means available, including public and
private surveillance resources. As part of these efforts, PTC uses data monitoring and scouring technologies to obtain and
transmit data on users of illegal copies of our software. This data collection is not performed on users of legally licensed
software from PTC and its authorized distributors. If you are using an illegal copy of our software and do not consent to the
collection and transmission of such data (including to the United States), cease using the illegal version, and contact PTC to
obtain a legally licensed copy.
Important Copyright, Trademark, Patent, and Licensing Information: See the About Box, or copyright notice, of your PTC
software.
UNITED STATES GOVERNMENT RESTRICTED RIGHTS LEGEND
PTC software products and software documentation are “commercial items” as that term is defined at 48 C.F.R. 2.101.
Pursuant to Federal Acquisition Regulation (FAR) 12.212 (a)-(b) (Computer Software) (MAY 2014) for civilian agencies or the
Defense Federal Acquisition Regulation Supplement (DFARS) at 227.7202-1(a) (Policy) and 227.7202-3 (a) (Rights in commercial
computer software or commercial computer software documentation) (FEB 2014) for the Department of Defense, PTC software
products and software documentation are provided to the U.S. Government under the PTC commercial license agreement. Use,
duplication or disclosure by the U.S. Government is subject solely to the terms and conditions set forth in the applicable PTC
software license agreement.
PTC Inc., 140 Kendrick Street, Needham, MA 02494 USA
Vantron VT-M2M-BTA-DE ThingWorx Installation and Setup Guide
Contents
Introduction .................................................................................................................................................. 2
About the Vantron VT-M2M-BTA-DE ........................................................................................................ 2
Installation .................................................................................................................................................... 2
Compile the Vantron lvdemo Executable ................................................................................................. 2
Prerequisites ......................................................................................................................................... 2
Connect the VT-M2M-BTA-DE to a local machine and peripheral ........................................................... 5
Configuration and Setup ............................................................................................................................... 6
Import Demo Entities into your ThingWorx Platform .............................................................................. 6
Set up a WebSocket Connection ............................................................................................................... 7
Troubleshooting .......................................................................................................................................... 10
Compatibility ............................................................................................................................................... 11
Revision History .......................................................................................................................................... 11
Copyright © 2015 PTC Inc. and/or Its Subsidiary Companies. All Rights Reserved. 1
Vantron VT-M2M-BTA-DE ThingWorx Installation and Setup Guide
1. Copy each of the following files from this starter kit package to the Ubuntu machine:
toolchain file, debootstrap-squeeze-i386.tar.bz2
ThingWorx C SDK, tw-c-sdk v1-1-1-38
demo executable, lvdemo_src
Introduction
This document provides installation and usage instructions for setting up the client demo with the
Vantron – VT-M2M-BTA-DE Gateway Device.
About the Vantron VT-M2M-BTA-DE
The VT-M2M-BTA-DE is a multi-port gateway device manufactured by Vantron Corporation. It provides
Wi-Fi-connectivity, WLAN 3G connectivity, supports data encryption, controls serial communication with
other remote devices or computers, and features an Intel ATOM E3845/E3827/E3815 processor and
serial, Ethernet, and USB ports for connections
Installation
Setup of the VT-M2M-BTA-DE device to connect to ThingWorx EMS first requires a connection to the
device from a computer via Serial cable.
Note: This guide was written for a computer running Microsoft Windows. Modify procedures as
needed for your environment.
Refer to the Troubleshooting section of this guide for help with frequently asked questions.
Compile the Vantron lvdemo Executable
This guide explains how to connect ThingWorx to the Vantron VT-M2M-BTA-DE gateway device using a
custom executable that establishes a secure WebSocket connection to the ThingWorx Platform. (These
instructions do not utilize the Edge Microserver.)
Prerequisites
You need access to a computer with Ubuntu 14.04 or later; earlier versions of Ubuntu have not been
tested. You may to run a virtual machine with Ubuntu in order to compile the software.
Note: This guide was written using Ubuntu on a virtual machine. All screen shots and instructions
assume an Ubuntu machine.
Copyright © 2015 PTC Inc. and/or Its Subsidiary Companies. All Rights Reserved. 2
Loading...