Welcome to ThingWorx Edge SDKs and WebSocket-based Edge MicroServer (WS EMS) Help Center
Welcome to ThingWorx Edge SDKs and WebSocket-based Edge MicroServer (WS EMS) Help Center
ThingWorx logo
This Help Center provides information on ThingWorx WebSocket-based Edge MicroServer (WS EMS) and the ThingWorx Edge SDKs. For information on the ThingWorx Connection Services, see the ThingWorx Connection Services Help Center. For information on ThingWorx Composer, ThingWorx Mashup Builder, the ThingWorx Java API, and more, see the ThingWorx Help Center, at http://support.ptc.com/help/thingworx_hc/thingworx_8_hc/.
To download the latest distribution bundle of an Edge SDK or the WS EMS for your platform, visit the Software Downloads page of the PTC eSupport Portal, https://support.ptc.com/appserver/cs/software_update/swupdate.jsp.
The release notes for each product are cumulative, so that you can find information about a prior release of a product in the release notes topic for that product. For example, the release notes for the C SDK contain information for releases 1.1.0 through 2.2.1. For all release notes, the content of each release is provided in a table.
The main sections for each product in this Help Center address the current release of each product.
How to Connect to ThingWorx
Your edge devices collect data and respond to commands. How do you get that data to the ThingWorx platform? It is possible to use REST Web Services over HTTP/HTTPS. However, that option tends to have a high connection overhead. Another alternative is MQTT, which requires a server and additional open ports.
If you need a fast connection that stays on continuously and is always ready to relay your data to the server and execute commands using existing open ports on your firewall, the ThingWorx Edge SDKs will provide this connection for your devices. These SDKs use the ThingWorx AlwaysOn protocol, which is based on the open WebSockets standard RFC6455 ( https://tools.ietf.org/html/rfc6455). In addition, for a configurable, out-of-the-box solution, consider the ThingWorx WebSocket-based Edge MicroServer (WS EMS).
For a tutorial that shows you how to use the ThingWorx Edge C SDK and ThingWorx Edge Java SDK to communicate with ThingWorx platform, see Tutorial for the Edge SDKs.
ThingWorx WebSocket-based Edge MicroServer (WS EMS)
The ThingWorx WebSocket-based Edge MicroServer works with edge devices or data stores that need to connect to the over the Internet. WS EMS also supports edge devices or data stores that are behind firewalls at a remote site, allowing secure, efficient communication back to the ThingWorx platform.
ThingWorx Edge SDKs
The ThingWorx Edge SDKs are collections of classes, objects, functions, methods, and variables that provide a framework that you can use to develop applications easily. Your applications can send data securely from your edge devices to the ThingWorx platform. Edge SDKs provide tools for developers experienced in C, .NET, Java, Android, and iOS programming languages.
ThingWorx Edge Extensions and ThingWorx SCM Edge Extension for the C SCK
As of v.2.0.0, the ThingWorx Edge C SDK supports Edge Extensions. The basic Edge Extensions are included in the distribution bundle for the C SDK. The Software Content Management (SCM) Edge Extension for the C SDK is available in a separate distribution bundle.This help center provides information for both types of Edge Extensions
Legacy Support
The Legacy Support section contains information about the original ThingWorx Edge XMPP MicroServer.
ThingWorx Edge SDKs and WS EMS Help Center Documentation
This help center contains the latest content for the ThingWorx WebSocket-based Edge MicroServer and the ThingWorx Edge SDKs. PDF documents for these products are available in their distribution packages. These PDF documents and the ThingWorx Edge Requirements and Compatibility Matrix document are also available from the Reference Documentation page on the PTC Support site.
You can find additional information in the ThingWorx Community forum and on the ThingWorx Developer Portal.
We want your feedback
As you use this Help Center, we are interested in your feedback. Please contact us at documentation@ptc.com if you want to provide suggestions or comments about the Help Center, or examples of your use of the ThingWorx WebSocket-based Edge MicroServer or the ThingWorx Edge SDKs.
This Help Center was last updated February 2019.