Nexcom EBC-3A1 Series User manual

1
EBC-3A1 Series
3.5’’ SBC with NXP i.MX6 Processor
ARM ® Cortex A9 Architecture
User Manual
Ver. 5st

2
Copyright
Copyright ©2015 NEXCOM International Co., Ltd., All rights reserved.
NEXCOM International Co., Ltd. reserves the right to make improvements in the
products described in this manual at any time without notice. No part of this manual
may be reproduced, copied, translated or transmitted in any form or by any means
without prior written permission of NEXCOM International Co., Ltd.
Trademark
The NEXCOM logo is a registered trademark of NEXCOM International Co., Ltd.
All other trademarks or registered marks in this manual belong to their respective
manufacturers.
Disclaimer
Information in this document is subject to change without notice and does not
represent a commitment on the part of NEXCOM.
NEXCOM provides this document as is, without warranty of any kind, either expressed
or implied, including, but not limited to, its particular purpose. NEXCOM reserves the
right to make improvements and/or changes to this manual, or to the products and/or
the programs described in this manual, at any time.
Information provided in this manual is intended to be accurate and reliable. However,
NEXCOM International Co., Ltd. assumes no responsibility for its use, nor for any
infringements of the rights of third parties, which may result from its use.
This product might include unintentional technical or typographical errors. Changes
are periodically made to the information herein to correct such errors, and these
changes are incorporated into new editions of the publication.

3
Declaration of Conformity
FCC Class A
Note: this device has been tested and found to comply with the limits for a Class A
digital device, pursuant to part 15 of the FCC Rules. These limits are designed to
provide reasonable protection against harmful interference in a residential installation.
This device generates, uses and can radiate radio frequency energy and, if not installed
and used in accordance with the instructions, may cause harmful interference to radio
communication. However, there is no guarantee that interference will not occur in a
particular in a particular installation. If this device does cause harmful interference to
radio or television reception, which can be determined by turning the device off and on,
the user is encouraged to try to correct the interference by one or more of following
measures:
◆Reorient or relocate the receiving antenna
◆Increase the separation between the device and receiver
◆Connect the device into an outlet on a circuit different from that to which receiver
is connected
◆Consult the dealer or an experienced radio/TV technician for help
CE Marking
This device has passed the CE test for environmental specifications when shielded
cables are used for external wiring. We recommend the use of shielded cables.
This device has passed the CE test for environmental specifications. Test conditions for
passing included the equipment being operated within an industrial enclosure. In order
to protect the product from being damaged by ESD (Electrostatic Discharge) and EMI
leakage, we strongly recommend the use of CE-compliant industrial enclosure products.

4
Document Amendment History
Revision
Date
Remark
1st
Jan 2016
Initial released
2nd
Mar 2016
Hardware User Guide modified
3rd
Mar 2016
Software User Guide & System Recovery modified
4rd
Aug 2018
Tidy-up full document and add new sections.
5rd
Aug 2019
Modify JCOMA to JCOMD to /dev/ttyXRUSB0 ~
/dev/ttyXRUSB3

5
Table of Contents
1. Product Overview............................................................................................11
1.1. Introduction .................................................................................... 11
1.2. Specification ....................................................................................11
1.3. Block Diagram .................................................................................13
2. Hardware User Guide....................................................................................... 15
................................................................................................................... 15
2.1. DIP Switch Setting and Connector Locations ........................................ 15
2.2. DIP Switch Setting ........................................................................... 16
2.2.1. Boot from eMMC (Default) ............................................................ 16
2.2.2. Boot from SD..............................................................................16
2.2.3. Boot for Serial ROM (Upgrade Image) ............................................ 16
2.3. Connector .......................................................................................17
2.3.1. Connector List............................................................................. 17
2.3.2. Connector Setting .......................................................................18
JAUDIO ...........................................................................18
JBLK ...............................................................................18
JCOM1............................................................................. 18
JCOM4............................................................................. 19
JCOMA ............................................................................19
JCOMB ............................................................................19
JCOMC ............................................................................19
JCOMD ............................................................................20
JDC-IN ............................................................................20
JNEXCOM (MCU) ............................................................. 20
JFP................................................................................21
JGPIO (i.MX6)................................................................. 21
JI2C ..............................................................................21
JLVDS1 ..........................................................................21
JLVDS2 ..........................................................................22
JMISC............................................................................22
JRS-485.........................................................................22
JSPI ..............................................................................22
JSPKR_L ........................................................................23
JSPKR_R ........................................................................23
JUSB .............................................................................23
RS-485 ..........................................................................23

6
2.4. Mechanical Drawing..........................................................................24
3. Software User Guide........................................................................................ 26
................................................................................................................... 26
3.1. Introduction .................................................................................... 26
3.2. Development Environment ................................................................ 26
3.2.1. How to Install Toolchain ...............................................................26
3.2.2. RS232 Debug Console..................................................................27
Debug Console Information................................................ 27
Debug Console Device Node...............................................27
Boot Message...................................................................27
3.2.3. Networking Settings ....................................................................28
3.2.4. Firmware Version ........................................................................29
Embux Image Version ....................................................... 29
Linux Kernel Image Version ...............................................29
3.2.5. Editor Utility ...............................................................................29
VI Editor.......................................................................... 29
NANO Editor..................................................................... 29
3.3. Interface Introduce ..........................................................................31
3.3.1. RS232 .......................................................................................31
RS232 Interface ...............................................................31
RS232 Specification .......................................................... 31
RS232 Device Node........................................................... 31
RS232 Sample Code.......................................................... 31
3.3.2. RS485 .......................................................................................32
RS485 Information............................................................32
RS485 Specification .......................................................... 32
RS485 Device Node........................................................... 32
RS485 Sample Code.......................................................... 32
3.3.3. CAN bus (Controller Area Network)................................................33
CAN bus Information......................................................... 33
CAN bus Specification........................................................33
CAN bus Device Node........................................................ 33
CAN bus Sample Code .......................................................33
3.3.4. GPIO .........................................................................................34
GPIO Information .............................................................34
GPIO Specification ............................................................34
GPIO Device Node ............................................................34
GPIO Example .................................................................. 35

7
3.3.5. RTC & Watchdog .........................................................................36
RTC & Watchdog Information .............................................36
RTC & Watchdog Specification ............................................36
RTC & Watchdog Device Node ............................................36
RTC & Watchdog Example..................................................36
3.3.6. I2C bus (Inter-Integrated Circuit)..................................................37
I2C bus Information ..........................................................37
I2C bus Specification......................................................... 37
I2C bus Device Node ......................................................... 37
I2C bus Example .............................................................. 38
3.3.7. SPI bus (Serial Peripheral Interface) .............................................. 39
SPI bus Information .......................................................... 39
SPI bus Specification.........................................................39
SPI bus Device Node .........................................................39
SPI bus Example...............................................................39
3.3.8. Audio.........................................................................................40
Audio Information............................................................. 40
Audio Example .................................................................41
3.3.9. Display ......................................................................................42
Display Information...........................................................42
Display Command.............................................................42
3.4. Service Introduce............................................................................. 43
3.4.1. SSH/SFTP Service .......................................................................43
Service Information .......................................................... 43
SSH/SFTP Configure file ....................................................43
Remote connection ........................................................... 43
3.4.2. Web Service ...............................................................................44
Service Information .......................................................... 44
Webserver Directory Path .................................................. 45
Webserver Configure file....................................................45
3.4.3. RC.LOCAL...................................................................................46
RC.LOCAL Information....................................................... 46
RC.LOCAL Configure file.....................................................47
3.5. Utilities ........................................................................................... 48
3.5.1. OPKG Package Management ......................................................... 48
OPKG Information............................................................. 48
OPKG Software Source ...................................................... 48
OPKG Commands..............................................................49

8
3.5.2. Storage Filesystem ......................................................................50
Formats...........................................................................50
SPI Flash Storage ............................................................. 50
3.5.3. System Time Utility .....................................................................51
ntpdate - Utility Information............................................... 51
Timezone.........................................................................51
3.5.4. MQTT......................................................................................... 52
mosquitto Information.......................................................52
3.6. Program Languages..........................................................................53
Program Languages Information .........................................53
Program Languages Example ............................................. 53
4. System Recovery ............................................................................................ 56
................................................................................................................... 56
4.1. Working with the EBC-3A1 Board and Platform .................................... 56
4.1.1. Board hardware ....................................................................... 56
4.1.2. Board images ........................................................................... 56
4.1.3. Downloading board images ......................................................57
4.2. Download the SD image....................................................................60
4.3. Write an SD/MMC Card using Linux (Ubuntu).......................................60
4.4. Write an SD/MMC Card using Windows ...............................................61
4.4.1. Introduction ...............................................................................61
4.4.2. Preparations ...............................................................................61
4.4.3. Create SD-Card...........................................................................61
4.5. Write an SD/MMC Card using MAC OS X..............................................62
4.5.1. Graphical interface ......................................................................62
4.5.2. Command line ............................................................................62
4.5.3. Alternative method...................................................................... 63
5. BSP ...............................................................................................................66
................................................................................................................... 66
5.1. Yocto 1.6.2......................................................................................66
5.2. Linux Kernel ....................................................................................66
5.2.1. Source Code ............................................................................... 66
5.2.2. Commands .................................................................................66
Loading Default Configure File ............................................ 66
Configure Linux Source...................................................... 66
Compile uImage ...............................................................67
Compile Device Tree ......................................................... 67
Update Device Tree and Linux Kernel .................................. 67

9

10
Chapter 1
Product Overview
This chapter provides background information of EBC-3A1.