GHI electronics EMX User manual

GHI Electronics
EMX SoM User Manual
Rev. 0.02 December 16, 2014 User Manual
EMX Module Top EMX Module Bottom
Document Information
Information Descri tion
Abstract This document covers information about the EMX Module,
s ecifications, tutorials and references.

GHI Electronics,LLC EMX SoM User Manual
Rev. 0.02 Page 2 of 69 www.GHIElectronics.com
Revision History
Rev No. Date Modification
Rev. 0.02 12/16/14 Misc ty os, etc.
Rev. 0.01 8/27/14 Preliminary version

GHI Electronics,LLC EMX SoM User Manual
Table of Contents
Table of Contents
1.Introduction...................................................................................4
1.1.The .NET Micro Framework................................................4
1.2.GHI Electronics and NETMF...............................................5
1.3.EMX Module Key Features.................................................6
1.4.Exam le A lications..........................................................6
2.The Hardware...............................................................................7
2.1.LPC2478 Microcontroller.....................................................7
2.2.SDRAM................................................................................7
2.3.FLASH.................................................................................7
3.Pin-Out Descri tion.......................................................................8
3.1.Pin-out Table........................................................................8
4.EMX on boot u ..........................................................................13
4.1.Boot Mode Pins.................................................................13
4.2.GHI Boot Loader vs. TinyBooter vs. EMX Firmware
(NETMF/TinyCLR)...................................................................15
4.3.The Loader and Firmware Debug Access Interface..........15
5.The GHI Boot Loader..................................................................16
5.1.The Commands.................................................................16
5.2.U dating TinyBooter..........................................................16
U dating TinyBooter using FEZ Config.............................17
U dating EMX Manually....................................................18
Loading using XMODEM...................................................18
5.3.TinyBooter.........................................................................21
5.4.TinyCLR (firmware) U date Using FEZ Config.................22
5.5.Firmware U date Using MFDe loy...................................23
6.NETMF TinyCLR (firmware).......................................................26
6.1.Assemblies Version Matching...........................................26
6.2.De loying to the Emulator.................................................27
6.3.De loying to the EMX Module...........................................28
6.4.Targeting Different Versions of the Framework.................30
7.The Libraries...............................................................................31
7.1.Finding NETMF Library Documentation............................32
7.2.Loading Assemblies...........................................................33
7.3.Im ortant Information for the Following Exam les............34
7.4.Digital In uts/Out uts (GPIO)............................................34
Out uts..............................................................................35
In uts.................................................................................37
Interru t Pins.....................................................................38
7.5. Analog In uts/Out uts......................................................39
7.6.PWM..................................................................................39
7.7.Signal Generator...............................................................40
7.8.Signal Ca ture...................................................................41
7.9.Serial Port (UART).............................................................42
7.10.SPI...................................................................................43
7.11.I2C...................................................................................44
7.12.CAN.................................................................................45
7.13.One-wire..........................................................................46
7.14.Gra hics..........................................................................47
Fonts..................................................................................48
Glide..................................................................................48
Touch Screen....................................................................49
7.15.USB Host.........................................................................50
7.16.Accessing Files and Folders...........................................51
SD/MMC Memory..............................................................53
USB Mass Storage............................................................53
7.17.Secure Networking (TCP/IP)...........................................53
The Extensions..................................................................53
MAC address setting.........................................................53
IP address (DHCP or static):.............................................54
Ethernet.............................................................................55
Wireless LAN WiFi............................................................56
7.18.PPP..................................................................................57
7.19.USB Client (Device) ........................................................57
7.20.Extended Weak References (EWR)................................59
7.21.Real Time Clock..............................................................59
7.22.Watchdog.........................................................................61
7.23.Power Control..................................................................61
7.24.In-Field U date................................................................63
7.25.SQLite Database.............................................................63
8.Advanced use of the Micro rocessor ........................................65
8.1.Register.............................................................................65
8.2.AddressS ace...................................................................65
8.3.Battery RAM......................................................................65
8.4.Runtime Loadable Procedure............................................66
9.design Consideration..................................................................67
Required Pins....................................................................67
Interru t Pins.....................................................................67
...........................................................................................67
10.Soldering EMX..........................................................................68
Legal Notice...................................................................................69
Licensing..................................................................................69
Disclaimer................................................................................69
EMX Module Page 3 of 69 www.ghielectronics.com

GHI Electronics,LLC EMX SoM User Manual
Introduction
1. Introduction
The EMX Module is a owerful, yet low-cost, surface-mount System on Module (SoM)
running the .NET Micro Framework software, which enables the SoM to be rogrammed from
Microsoft's Visual Studio, by sim ly using a USB cable. Programming in a modern managed
language, such as C# and Visual Basic, allows develo ers to accom lish much more work in
less time by taking advantage of the extensive built-in libraries for networking, file systems,
gra hical interfaces and many eri herals.
With just ower and some connectors, develo ers can utilize the EMX Module to bring the
latest technologies to any roducts. There are no additional licensing or fees and all the
develo ment tools and SDKs are rovided freely.
1.1. T e .NET Micro Framework
Ins ired by its full .NET Framework, Microsoft develo ed a lightweight version called .NET
Micro Framework (NETMF).
NETMF focuses on the s ecific requirements of resource-constrained embedded systems.
Develo ment, debugging and de loyment is conveniently erformed using Microsoft's
owerful Visual Studio tools, all through standard USB cable.
Programming is done in C# or Visual Basic. This includes libraries to cover sockets for
networking, modern memory management with garbage collector and multitasking services.
In addition to su orting standard .NET features, NETMF has embedded extensions
su orting:
●General Pur ose IO (GPIO with interru t handling
●Analog in ut/out ut
●Standard buses such I2C, SPI, USB, Serial (UART)
●PWM
●Networking
●File System
●Dis lay gra hics, su orting images, fonts and controls.
Rev. 0.02 Page 4 of 69 www.GHIElectronics.com

GHI Electronics,LLC EMX SoM User Manual
Introduction
1.2. GHI Electronics and NETMF
For years, GHI Electronics has been the lead Microsoft artner on .NET Micro Framework
(NETMF). The core NETMF was also extended with new exclusive libraries for an additional
functionality, such as database, USB Host and WiFi.
One of the im ortant extensions by GHI Electronics is Runtime Loadable Procedures (RLP),
allowing native code (Assembly/C) to be com iled and loaded right from withing managed
code (C#/Visual Basic) to handle time critical and rocessor intensive tasks. IT can also be
used to add new native extensions to the system.
As for networking, WiFi and PPP libraries are added by GHI Electronics to the NETMF core.
Combined with Ethernet and the other managed services, it is a com lete toolbox for the
internet of things.
All the mentioned features are loaded and tested on the EMX Module. GHI Electronics
continuously maintains, u grades and solves any of the issues on the EMX Module firmware,
to rovide regular and free releases. Users can sim ly load the new software on the EMX
Module using USB or Serial, and even use the in-field-u date feature. This feature allows the
u grade to be done through any of the available interface, including file system and
networking.
Rev. 0.02 Page 5 of 69 www.GHIElectronics.com

GHI Electronics,LLC EMX SoM User Manual
Introduction
1.3. EMX Module Key Features
●.NET Micro Framework
●72 Mhz 32-bit ARM7
●16 MB RAM
●4.5 MB FLASH
●Embedded LCD controller
●76 GPIO Pins
●43 Interru t In uts
●2 SPI
●I2C
●4 UART
●2 CAN Channels
●7 10-Bit Analog In ut
●10-Bit Analog Out ut
●4Bit SD/MMC Memory card interface
●6 PWM
●Power 200 / 160 / 40 mA
●-40ºC to +85ºC O erational
●RoHS Lead Free
●45.75 x 39.4 x 4.4 mm
●TCP/IP Stack (.NET sockets)
●SSL secure networking
●WiFi
●PPP
●USB Host & Client
●Gra hics (image, font and controls)
●SQLite database
●File System (SD and USB Sticks)
●Native extensions RLP
1.4. Example Applications
●Vending machines, POS Terminals
●Measurement tools and testers
●Networked sensors
●Robotics
●Central alarm system
●Smart a liances
●Industrial automation devices
●Designs with intensive rocessing or time-critical routines (using RLP)
●GPS navigation
●Medical instrument (with a color touch screen dis lay).
Rev. 0.02 Page 6 of 69 www.GHIElectronics.com

GHI Electronics,LLC EMX SoM User Manual
The Hardware
2. The Hardware
The EMX Module core com onents includes the rocessor, 4.5MB flash, and 16MB RAM.
The small, 38.1 x 26.7 x 3.55 mm (only 1 x 1.5 inches), module contains everything needed to
run a com lex embedded-system in a cost-effective and flexible solution. All needed is a 3.3V
ower source and some connections to take advantage of the EMX Module's long list of
available features.
2.1. LPC2478 Microcontroller
The LPC2478 microcontroller in the EMX Module is an 72Mhz, 32Bit, ARM7. The LPC2478
contains a memory acceleration interface with 128Bit internal FLASH memory. This lets the
rocessor core run with zero wait states. Com aring to executing code from 16Bit external
FLASH we see over 10 times the execution s eed. The internal FLASH is 0.5MB that is used
to run the com lete .NET Micro Framework core very efficiently. Also, the rocessor includes
an RTC that can o erate while while the rocessor is off. The EMX Module already has the
needed circuitry to run the RTC. Users only need to add a battery or a su er ca acitor to
VBAT in.
The LPC2478 has a wide range of eri herals that adds a lot of functions and features to
EMX such as PWM, GPIO, LCD Controller, USB HC, etc.
The NETMF core libraries, combined with the GHI Electronics extensions, rovide a long list
of methods to access the available eri herals.
2.2. SDRAM
16MB of SDRAM comes standard with the EMX Module.
2.3. FLASH
4.5MB of external flash is available on the EMX Module. The fast zero-wait-state internal
0.5MB is used to execute the core services of the system to achieve the highest ossible
erformance. The remaining 4MB of external memory is used to hold more extensions and to
store the user's end a lication. About 1MB of the external FLASH is used for boot loader,
system assemblies and other internal GHI resources. About 3MB is reserved for de loyed
managed a lications, including resources. 256KB is reserved for two EWR (Extended Week
References) regions, each region being 128KB and one of them is reserved for CLR use.
One of GHI's extensions allows a lications to be u dated in field, even remotely.
Rev. 0.02 Page 7 of 69 www.GHIElectronics.com

GHI Electronics,LLC EMX SoM User Manual
Pin-Out Descri tion
3. Pin-Out Description
Many signals on the EMX Module are multi lexed to offer multi le functions on a single in.
Develo ers can decide on the in functionality through the rovided libraries. These are some
im ortant facts ertaining to the available ins:
●Pins with GPIO feature default to in uts with internal weak ull-u resistors
●GPIO ins are 3.3V levels but 5V tolerant
●Pins with analog feature are not 5V tolerant when the analog function is used
●Only GPIO ins on orts 0 and 2 are interru t ca able
●Advanced details on all ins can be found in the LPC2478 datasheet
Most signals on EMX are multi lexed to offer more than one function for every in. It is u to
the develo er to select which one of the functions to use. GHI drivers and .NET Micro
Framework does checking to make sure the user is not trying to use two functions on the
same in. The develo er should still understand what functions are multi lexed so there is no
conflict. For exam le, analog channel 3 (ADC3) and the analog out ut (AOUT) are on the
same in IO7.
3.1. Pin-out Table
No. LPC2478
H/W Name
EMX IO 2nd Feature EMX Module
Pin Descri tion
1 3.3V Connect to 3.3 volt source.
2 GND Connect to Ground.
3 P0.4 IO0* CAN2/
Boot control
RD CAN Channel 2 Data Receive in (In). TinyBooter/Firmware Control (with 7, and 53)
4 P0.5 IO1* CAN2 TD CAN Channel 2 Data Transmit in (Out).
5 P0.3 IO2 * COM1 Serial ort (UART) RXD receive signal (In) for COM1.
6 P0.2 IO3* COM1 Serial ort (UART) TXD transmit signal (Out) for COM1.
7 P2.5 IO4* Boot Control General ur ose digital I/O. TinyBooter/Firmware Control (with 3, and 53)
8 P0.24 IO5* ADC1/
Touch_Y_UP
ADC1 (10Bit Analog to Digital In ut)
or Touch Screen Y-axis U analog signal.
Rev. 0.02 Page 8 of 69 www.GHIElectronics.com

GHI Electronics,LLC EMX SoM User Manual
Pin-Out Descri tion
No. LPC2478
H/W Name
EMX IO 2nd Feature EMX Module
Pin Descri tion
1 3.3V Connect to 3.3 volt source.
9 P0.25 IO6* ADC2/
COM4
ADC2 (10Bit Analog to Digital In ut)
or Serial ort (UART) TXD transmit signal (Out) for COM4.
10 P0.26 IO7* ADC3/ DAC/
COM4
ADC3 (10Bit Analog to Digital In ut) or DAC (Digital to Analog Out ut)
or Serial ort (UART) RXD receive signal (In) for COM4.
11 P0.23 IO8* ADC0/
Touch_X_Lef
t
ADC0 (10Bit Analog to Digital In ut)
or Touch Screen X-axis Left analog signal.
12 P4.29 IO9 N/A General ur ose digital I/O
13 P4.28 IO10
14 P0.28 IO11* I2C (open drain pin) I2C Interface SCL
15 P0.27 IO12* I2C (open drain pin) I2C Interface SDA
16 P3.16 IO13 PWM0 PWM0 (Pulse Width Modulation Out ut) LPC2478 PWM Timer 0.
17 P3.24 IO14 PWM1 PWM1 (Pulse Width Modulation Out ut) LPC2478 PWM Timer 1.
18 P3.25 IO15 N/A General ur ose digital I/O
19 P1.19 IO16 N/A General ur ose digital I/O
20 P2.21 IO17* N/A General ur ose digital I/O
21 P0.11 IO18* N/A General ur ose digital I/O
22 P2.22 IO19* N/A General ur ose digital I/O
23 P0.1 IO20* CAN1 TD CAN Channel 1 Data Transmit in (Out)
24 P0.10 IO21* N/A General ur ose digital I/O.
25 P0.0 IO22* CAN1 RD CAN Channel 1 Data Receive in (In)
26 P1.30 N/A USB_VBUS1USB device ower detect signal. Connect to ower in on USB device.
27 P2.10 IO23* N/A General ur ose digital I/O
28 RTC_VBAT Connect to 3.3 volt backu battery to kee the real-time clock running.
29 USBD- USB Host Feature USB negative data line of the USB hosting feature.
30 USBD+ USB Host Feature USB ositive data line of the USB hosting feature.
31 P0.12 IO45* ADC6 ADC6 (10Bit Analog to Digital In ut).
32 P0.13 IO46* ADC7 ADC7 (10Bit Analog to Digital In ut).
33 P1.31 IO47 ADC5 ADC5 (10Bit Analog to Digital In ut).
34 3.3V Connect to 3.3 volt source.
35 P3.27 IO48 PWM4 PWM4 (Pulse Width Modulation Out ut) LPC2478 PWM Timer 1.
36 GND Connect to Ground.
37 3.3V Connect to 3.3 volt source.
Rev. 0.02 Page 9 of 69 www.GHIElectronics.com

GHI Electronics,LLC EMX SoM User Manual
Pin-Out Descri tion
No. LPC2478
H/W Name
EMX IO 2nd Feature EMX Module
Pin Descri tion
1 3.3V Connect to 3.3 volt source.
38 N/C Not Connected.
39 P3.26 IO49 PWM3 PWM3 (Pulse Width Modulation Out ut) LPC2478 PWM Timer 1.
40 P3.17 IO50 PWM2 PWM2 (Pulse Width Modulation Out ut) LPC2478 PWM Timer 0.
41 USBD- device USB negative data line of the USB debugging interface and for the USB client feature.
42 USBD+ device USB ositive data line of the USB debugging interface and for the USB client feature.
43 Ethernet RD- Ethernet receive data minus.
Recommended Ethernet connector is
J0011D01BNL.
Ethernet PHY is not needed since it is
embedded in EMX hardware.
44 Ethernet RD+ Ethernet receive data lus.
45 Ethernet TD- Ethernet transmit data minus.
46 Ethernet TD+ Ethernet transmit data lus.
47 P0.18 IO24* SPI1 SPI master bus interface MOSI signal (Master Out Slave In) for SPI1.
48 P0.17 IO25* SPI1 SPI master bus interface MISO signal (Master In Slave Out) for SPI1.
49 P0.16 IO26* N/A General ur ose digital I/O.
50 P0.15 IO27* SPI1 SPI master bus interface SCK signal (Clock)for SPI1.
51 P4.23 IO28 COM3 Serial ort (UART) RXD receive signal (In) for COM3.
52 P4.22 IO29 COM3 Serial ort (UART) TXD transmit signal (Out) for COM3.
53 P2.11 IO30* Boot Control General ur ose digital I/O. TinyBooter/Firmware Control (with 7, and 3)
54 P3.30 IO31 COM2 Serial ort (UART) RTS hardware handshaking signal for COM2.
55 P2.1 IO32* COM2 Serial ort (UART) RXD receive signal (IN) for COM2.
56 P0.6 IO33* N/A General ur ose digital I/O.
57 P3.18 IO34 COM2 Serial ort (UART) CTS hardware handshaking signal for COM2.
58 P0.7 IO35* SPI2 SPI master bus interface SCK signal (Clock)for SPI2.
59 P0.9 IO36* SPI2 SPI master bus interface MOSI signal (Master Out Slave In) for SPI2.
60 P2.0 IO37* COM2 Serial ort (UART) TXD transmit signal (Out) for COM2.
61 P0.8 IO38* SPI2 SPI master bus interface MISO signal (Master In Slave Out) for SPI2.
62 P1.12 IO39 SD_DAT3 SD card 4Bit data bus, data line no. 3.
63 P1.11 IO40 SD_DAT2 SD card 4Bit data bus, data line no. 2.
64 P1.7 IO41 SD_DAT1 SD card 4Bit data bus, data line no. 1.
65 P1.2 IO42 SD_CLK SD card 4Bit data bus, clock line.
66 P1.6 IO43 SD_DAT0 SD card 4Bit data bus, data line no. 0.
67 P1.3 IO44 SD_CMD SD card 4Bit data bus, command line.
68 SD_PWR SD memory ower (connect directly to SD socket ower in).
69 GND Connect to Ground.
Rev. 0.02 Page 10 of 69 www.GHIElectronics.com