OptConnect ema:Play User manual

OptConnect ema™
ema:Play User Guide
V1.0 Updated May 2020

© OptConnect Management, LLC 2020. All rights reserved. Revision 1.0
2
Table of Contents
Table of Contents 2
1. Introduction 4
1.1 Scope 4
1.2 Contact Information 4
1.3 Orderable Part Numbers 4
1.4 Additional Resources 5
1.5 Activation 5
2. Overview 5
2.1 Contents 5
2.2 Features 5
3. Hardware 7
3.1 At a Glance 7
3.2 System Architecture 9
3.3 Power 9
3.4 Communications 11
3.5 Onboard MCU (U16) 14
3.6 Onboard Programmer/Debugger 15
3.7 User Application Headers and Connectors 15
3.8 Antennas 18
3.9 Mechanical 18
3.9.1 Dimensions 18
4. Software 19
4.1 Native Development Environment 20
4.1.1 Overview 20
4.1.2 Setup and Building 20
4.1.3 Sample Program/Debug Session 25
5. Reference 28
5.1 Schematics 29
5.2 Bill of Materials (BOM) 37
5.3 Assembly Reference 39

© OptConnect Management, LLC 2020. All rights reserved. Revision 1.0
3
5.4 Sample ema:Play configurations 40
5.4.1 On-board MCU control (default) 40
5.4.2 External S2USB control 40
5.4.3 External USB control 41
5.4.4 External MCU control 42
5.4.5 External RS232/RS485/RS422 control 42
5.5 Sample Project –Getting Started with ema 43
5.5.1 Overview 43
5.5.2 Features Supported/Demonstrated 43
5.5.3 Hardware Configuration 43
5.5.4 Software Project Hierarchy 44
5.5.5 Software Configuration 44
5.5.6 Software Architecture & Description 46
5.5.7 Console Debug Output Sample 49
5.5.8 OptConnect Summit Portal 52
5.5.8.1 Overview 52
5.5.8.2 Login and Find ema 52
5.5.8.3 Device Attributes and Location 53
5.5.8.4 Events, Usage and Analytics 54
5.5.9 Board Notify via Summit API 55
5.5.9.1 Overview 55
5.5.9.2 Create a New API Application in Summit 56
5.5.9.3 Authenticate User Application with Summit API 58
5.5.9.4 Send Data to ema Using Board Notify 60
5.5.10 Banyan Hills Canopy IoT™Platform 62
5.5.10.1 Overview 62
5.5.10.2 Login and Find ema:Play 62
5.5.10.3 Device Operations and Leaf Messaging 63
5.5.10.4 Control Actions 64
5.5.10.5 Automation using IoT Campaigns 66
5.5.10.6 Summary 70
6. Revision History 71

© OptConnect Management, LLC 2020. All rights reserved. Revision 1.0
4
1. Introduction
1.1 Scope
The OptConnect ema:Play Evaluation Kit is a hardware platform designed and optimized for evaluating
OptConnect ema™ modems. ema:Play provides easy access to the features of OptConnect ema™
modems, and acts as a launching point for translation into custom IoT/M2M applications using
OptConnect ema™. This document serves as a guide and point of reference for using ema:Play correctly
and efficiently.
1.2 Contact Information
For more information regarding OptConnect ema™ contact OptConnect Sales at 1.877.678.3343 ext. 2020
during normal business hours. For technical support contact OptConnect Customer Care Center at
1.877.678-3343 ext. 2021 from 8 am till 9 pm MST Monday through Saturday.
1.3 Orderable Part Numbers
Orderable Device
Primary
Module
Firmware
Revision
Operating
Temperature
LTE Bands
3G
UMTS
Network
Region
EMA-L4-1-XX-A-A
20.00.505
-40 to +85˚C
FDD B2, B4,
B5, B12, B13
B2, B5
AT&T,
Verizon
North America
EMA-L4-1-US-B-A
20.00.005
-40 to +85˚C
FDD B2, B4,
B5, B12, B13
B2, B5
AT&T,
Verizon
United States
EMA-L4-1-XX-A-A-000
20.00.506
-40 to +85˚C
FDD B2, B4,
B5, B12, B13
B2, B5
AT&T,
Verizon
North America
EMA-L4-1-US-B-A-000
20.00.006
-40 to +85˚C
FDD B2, B4,
B5, B12, B13
B2, B5
AT&T,
Verizon
United States
Unless instructed otherwise EMA-L4-1-XX…will utilize AT&T as the primary carrier and Verizon as the
secondary carrier. Unless instructed otherwise, EMA-L4-1-US…will utilize Verizon as the primary carrier and
AT&T as the secondary carrier.
Orderable
Device
Description
Operating
Temperature
Region
EMA-ZZ-1-XX-Z-B
ema:Play Evaluation Kit, OptConnect ema™ evaluation
platform
-40 to +85˚C
North America
EMA-L4-1-XX-A-B
ema:Play Evaluation Kit, OptConnect ema™ evaluation
platform, EMA-L4-1-XX ema modem included
-40 to +85˚C
North America
EMA-L4-1-US-B-B
ema:Play Evaluation Kit, OptConnect ema™ evaluation
platform, ema EMA-L4-1-US ema modem included
-40 to +85˚C
United States

© OptConnect Management, LLC 2020. All rights reserved. Revision 1.0
5
1.4 Additional Resources
OptConnect ema™ is supported by a full range of documentation, including User Guides and Application
Notes as well as related code samples. The latest versions of these resources can be found at
http://optconnect.com/ema . Suggested prerequisites for this document are the following:
-OptConnect ema™ Hardware Guide
-OptConnect ema™ Getting Started
-OptConnect ema™ emaLink AT Command Manual
1.5 Activation
If ema is not activated/registered upon receipt, please visit https://summit.optconnect.com/ema to
activate/register ema. Once activated, ema:Play includes a free trial period that will last for three months,
with 1 GB of data being available per month. Please contact OptConnect (see section 1.2) for further
questions and requests in regard to the trial period.
2. Overview
2.1 Contents
The ema:Play Evaluation Kit is shipped as a ready to use, “all-in-one” platform for evaluating OptConnect
ema™ modems for IoT/M2M applications. The contents of the kit are listed below.
1. ema:Play Evaluation Kit with/without ema installed (see section 1.3 for device p/n’s)
2. OptConnect Gemini MIMO Antenna
3. 5VDC Power Supply
4. 2 x USB cables
2.2 Features
•On-Board Microcontroller Unit (MCU)
oMicrochip ATSAME51J20A.
o120MHz Core Processor
o1 MB Flash, 256 KB Ram
oOn Board programmer/debugger
JLink OB Technology
Cortex SWD Connector for external programmers/debuggers
oDebug Port
UART to USB access
External Header access
oVoltage Monitors
Input Voltage
ema Voltage
•Configurable Power Supply
oWide input voltage range 4.5V –30V
oExternal power input terminal for other sources (Battery, benchtop, etc.)
oStandard barrel connector input
oUSB power input (excludes powering ema)

© OptConnect Management, LLC 2020. All rights reserved. Revision 1.0
6
oema load switch for low power applications
•Configurable ema Communication Interfaces
oModem UART interface access
RS485/422 full-Duplex
RS485 half-Duplex with Auto Direction Control
On-Board MCU
External header access
Serial 2 USB (S2USB) for computer terminal access
oemaLink interface access
On-Board MCU
External header access
oema USB interface
oScrew terminal block access for wire to board
oShrouded connector access for board to board
•Built in sensors and feedback
oTemperature and humidity
oLight/photo
o2 user push buttons
oLED cellular signal array (Blue)
o2 x LEDs (Red)
•User Application Headers
oInput/Output Application Header
Access to On-Board MCU
•1 x i2c
•1 x CAN bus
•4 x UART
•1 x Analog to Digital (ADC)
•1 x Digital to Analog (DAC)
•6 x General Purpose Input Output (GPIO)
Access to ema communication interfaces
•Modem UART
•emaLink
oPower Application Header
ema power control
3.3V power control
ema IOVREF control
ema Reset Request control
ema On/Off control
3.3V, 4.0V for external usage
•Easy grab test points for measurements
•Efficient design
oCost and availability optimized
•Antenna adaptors built in
oU.FL to SMA for both main and diversity
•Electrical design CAD available for reference

© OptConnect Management, LLC 2020. All rights reserved. Revision 1.0
7
3. Hardware
Section 3 outlines the hardware of ema:Play from a user perspective. Figures 1-3 can be used as quick
reference guides for navigating the various components and features of ema:Play. The hardware is
designed for flexibility and configurability to support different user IoT/M2M applications and integration
architectures, and to also serve as a reference for custom hardware designs integrating ema.
3.1 At a Glance
Figure 1

© OptConnect Management, LLC 2020. All rights reserved. Revision 1.0
8
Figure 2

© OptConnect Management, LLC 2020. All rights reserved. Revision 1.0
9
3.2 System Architecture
Figure 3
3.3 Power
ema:Play can be powered through multiple connectors and/or ports. Furthermore, depending on which
connector/port is powering ema:Play, will also determine which sub systems of the hardware are powered.
There are various feedback LED’s that are provided to let the user know which sub systems are currently
powered. In addition to power input configurations, ema:Play also offers power output for applications
requiring off board power:
Table 1 summarizes the power input architecture and configurations.
Table 2 summarizes related power control signals.

© OptConnect Management, LLC 2020. All rights reserved. Revision 1.0
10
Description
Voltage (ref)
Sources
Inputs Ports (ref)
Outputs Ports (ref)
Systems
Powered
Feedback
(ref)
Main Power
Input
Min 4.5V (VIN)
Max 30V (VIN)
Min 6.75W
External
Source
Barrel Connector (J9)
External VIN (J2/J1)
Test Hook (J9+)
Test Hook (ExtVIN, VIN)
4V,
4VMOD(ema),
3.3V
4V (D5)
4VMOD (D6)
3.3V (D7)
S2USB USB
5V (5V_S2USB)
External USB
Port
S2USB Port (J10)
Test Hook (5vS2USB)
3.3V, S2USB
3.3V (D7)
S2USB (D9)
JLink USB
5V (5V_USBJL)
External USB
Port
JLink USB Port (J13)
Test Point (TP76)
3.3V, JLink
3.3V(D7)
JLink (D28)
Main
Regulator
(U5) Output
4V (4V0)
Max 3A
Main Power
Input
na
Test Hook (4V0)
Pwr App Hdr (J4.1)
4V,
4VMOD(ema),
3.3V
4V (D5)
4VMOD (D6)
3.3V (D7)
Load Switch
(U6) Output
4V (4VMOD)
Max 2A
4V (4V0)
na
Test Hook (4VMOD1,
4VMOD2)
Pwr App Hdr (J4.7)
4VMOD(ema)
4VMOD (D6)
MCU &
Interface
Power (U7)
3.3V (3V3)
Max 1A
4V (4V0)
5V (5V_S2USB)
5V (5V_USBJL)
na
Test Hook (3.3V)
Pwr App Hdr (J4.3)
IO App Hdr (J5.12)
3.3V
3.3V (D7)
ema IOVREF
Min 1.8V
(IO_VREF)
*Max 5.5V
(IO_VREF)
3.3V (3V3)
External via
Pwr App Hdr
(J4.9)
Pwr App Hdr (J4.9)
Test Hook (VIOREF1,
VIOREF2)
ema IO
interface
na
Table 1 * Onboard MCU (U16) must be held in reset if IOVREF is supplied as >4.1V
Description
Signal (ref)
Systems Disabled
Notes
ema Power disable
4VMOD_DIS (J4.2)
ema Power
This signal can be driven high to disable ema’s
power for power sensitive applications
MCU & interface Power
disable
3V3_DIS (J4.4)
3.3V Power rail
This signal can be driven high to disable the entire
3.3V power rail. Typically, this would be used if an
external host embedded system is interfacing to ema
using the Application headers
Onboard IOVREF
disable
OB_uP_IOVREF_DIS (J5.28)
Onboard 3.3V IOVREF
This signal can be used to set ema’s IOVREF level
from an external source
Table 2