Advantech Co TREK530LTE Computer User Manual V4 12 EV User Manual

Advantech Co Ltd Computer V4 12 EV User Manual

Contents

User Manual

User Manual
TREK-530
Computer
TREK-530 User Manual
Copyright
The documentation and the software included with this product are copyrighted 2017
by Advantech Co., Ltd. All rights are reserved. Advantech 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 the prior written permission of Advantech Co.,
Ltd. Information provided in this manual is intended to be accurate and reliable. How-
ever, Advantech Co., Ltd. assumes no responsibility for its use, nor for any infringe-
ments of the rights of third parties, which may result from its use.
Acknowledgements
Qualcomm is trademarks of Qualcomm Incorporated.
Android is registered trademarks of Google LLC.
All other product names or trademarks are properties of their respective owners.
Product Warranty (2 years)
Advantech warrants to you, the original purchaser, that each of its products will be
free from defects in materials and workmanship for two years from the date of pur-
chase.
This warranty does not apply to any products which have been repaired or altered by
persons other than repair personnel authorized by Advantech, or which have been
subject to misuse, abuse, accident or improper installation. Advantech assumes no
liability under the terms of this warranty as a consequence of such events.
Because of Advantech’s high quality-control standards and rigorous testing, most of
our customers never need to use our repair service. If an Advantech product is defec-
tive, it will be repaired or replaced at no charge during the warranty period. For out-
of-warranty repairs, you will be billed according to the cost of replacement materials,
service time and freight. Please consult your dealer for more details.
If you think you have a defective product, follow these steps:
1. Collect all the information about the problem encountered. (For example, CPU
speed, Advantech products used, other hardware and software used, etc.) Note
anything abnormal and list any onscreen messages you get when the problem
occurs.
2. Call your dealer and describe the problem. Please have your manual, product,
and any helpful information readily available.
3. If your product is diagnosed as defective, obtain an RMA (return merchandize
authorization) number from your dealer. This allows us to process your return
more quickly.
4. Carefully pack the defective product, a
fully-completed
Repair and Replacement
Order Card and a photocopy proof of purchase date (such as your sales receipt)
in a shippable container. A product returned without proof of the purchase date
is not eligible for warranty service.
5. Write the RMA number visibly on the outside of the package and ship it prepaid
to your dealer.
Part No. Edition 1
Apr 2018
TREK-530 User Manual
Declaration of Conformity
CE
This product 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 enclo-
sure products.
FCC Class B
Note: This equipment has been tested and found to comply with the limits for a Class
B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to
provide reasonable protection against harmful interference in a residential installa-
tion. This equipment generates, uses and can radiate radio frequency energy and, if
not installed and used in accordance with the instructions, may cause harmful inter-
ference to radio communications. However, there is no guarantee that interference
will not occur in a particular installation. If this equipment does cause harmful interfer-
ence to radio or television reception, which can be determined by turning the equip-
ment off and on, the user is encouraged to try to correct the interference by one or
more of the following measures:
Reorient or relocate the receiving antenna
Increase the separation between the equipment and receiver.
Connect the equipment into an outlet on a circuit different from that to which the
receiver is connected.
Consult the dealer or an experienced radio/TV technician for help.
This device complies with Part 15 FCC Rules.
Operation is subject to the following two conditions.
(1) This device may not cause harmful interference , and
(2) The device must accept any interference received, including
interference may cause undesired operation.
FCC Caution :
Any changes or modifications not expressly approved by the party responsible for
compliance could void the user's authority to operate this equipment.
FCC RF Radiation Exposure Statement :
This device meets the government`s requirements for exposure to radio waves.
This device is designed and manufactured not to exceed the emission limits for
exposure to radio frequency(RF) energy set by the Federal Communications
Commission of the U.S. Government.
This device complies with FCC radiation exposure limits set forth for an uncontrolled
environment. In order to avoid the possibility of exceeding the FCC radio frequency
exposure limits, human proximity to the antenna shall not be less than 20cm (8
inches) during normal operation.
Changes or modifications not expressly approved by the party responsible for
compliance could void the user`s authority to operate the equipment.
.
TREK-530 User Manual
Technical Support and Assistance
1. Visit the Advantech web site at
http://support.advantech.com
where you can find
the latest information about the product.
2. Contact your distributor, sales representative, or Advantech's customer service
center for technical support if you need additional assistance. Please have the
following information ready before you call:
Product name and serial number
Description of your peripheral attachments
Description of your software (operating system, version, application software,
etc.)
A complete description of the problem
The exact wording of any error messages
TREK-530 User Manual
Warnings, Cautions and Notes
Warning! Warnings indicate conditions, which if not observed, can cause personal
injury!
Caution! Cautions are included to help you avoid damaging hardware or losing
data. e.g.
There is a danger of a new battery exploding if it is incorrectly installed.
Do not attempt to recharge, force open, or heat the battery. Replace the
battery only with the same or equivalent type recommended by the man-
ufacturer. Discard used batteries according to the manufacturer's
instructions.
Note! Notes provide optional additional information.
Document Feedback
To assist us in making improvements to this manual, we would welcome comments
and constructive criticism. Please send all such - in writing to: support@advan-
tech.com
Packing List
Before setting up the system, check that the items listed below are included and in
good condition. If any item does not accord with the table, please contact your dealer
immediately.
Description
Q`ty
TREK-530 Computer
1
Power cable (2M)
1
LAN adaptor cable
1
Ordering Information
Part Number
TREK-530-GWBADA20
TREK-530-LWBADA20
TREK-530-LWBADB20
Safety Instructions
1. Read these safety instructions carefully.
2. Keep this User Manual for later reference.
3. Disconnect this equipment from any AC outlet before cleaning. Use a damp cloth.
Do not use liquid or spray detergents for cleaning.
4. For plug-in equipment, the power outlet socket must be located near the equip- ment
and must be easily accessible.
5. Keep this equipment away from humidity.
6. Put this equipment on a reliable surface during installation. Dropping it or
letting it
fall
may cause damage.
7. Do not leave this equipment in an environment unconditioned where the storage
temperature under -4 C (-40° F) or above 85° C (185° F), it may damage the
equipment. Operating temperature: -20°C~65°C without battery.
8. Do not operate this equipment in an environment temperature may over
65°C(149° F). The surface temperature of plastic chassis may be hot.
9. Make sure the voltage of the power source is correct before connecting the
equipment to the power outlet.
10. Position the power cord so that people cannot step on it. Do not place anything over
the power cord. The voltage and current rating of the cord should be greater than the
voltage and current rating marked on the product.
11. All cautions and warnings on the equipment should be noted.
12. If the equipment is not used for a long time, disconnect it from the power source to
avoid damage by transient overvoltage.
13. Never pour any liquid into an opening. This may cause fire or electrical shock.
14. Never open the equipment. For safety reasons, the equipment should be
opened only by qualified service personnel.
15. If one of the following situations arises, get the equipment checked by service
personnel:
The power cord or plug is damaged.
Liquid has penetrated into the equipment.
The equipment has been exposed to moisture.
The equipment does not work well, or you cannot get it to work according to
the user's manual.
The equipment has been dropped and damaged.
The equipment has obvious signs of breakage.
16. CAUTION: The computer is provided with a battery-powered real-time clock cir- cuit.
There is a danger of explosion if battery is incorrectly replaced. Replace only with
same or equivalent type recommended by the manufacture. Discard used batteries
according to the manufacturers instructions.
17. This device complies with Part 15 of the FCC rules. Operation is subject to the
following two conditions:
(1) this device may not cause harmful interference, and
(2) this device must accept any interference received, including interference that may
cause undesired operation.
18. CAUTION: Always completely disconnect the power cord from your chassis
whenever you work with the hardware. Do not make connections while the power
is on. Sensitive electronic components can be damaged by sudden power surges.
19. CAUTION: Always ground yourself to remove any static charge before touching the
motherboard, backplane, or add-on cards. Modern electronic devices are very
sensitive to static electric charges. As a safety precaution, use a grounding wrist
strap at all times. Place all electronic components on a static-dissipative surface or in
a static-shielded bag when they are not in the chassis.
20. CAUTION: Any unverified component could cause unexpected damage. To ensure
the correct installation, please always use the components (ex. screws) provided
with the accessory box.
Safety Precaution - Static Electricity
Follow these simple precautions to protect yourself from harm and the products from
damage.
To avoid electrical shock, always disconnect the power from your PC chassis
before you work on it. Don't touch any components on the mainboard or other
cards while the system is on.
Disconnect power before making any configuration changes. The sudden rush
of power as you connect a jumper or install a card may damage sensitive elec-
tronic components.
This product is intended to be supplied by a Listed DC power source, rated 9-
32Vdc, 2A maximum and Tma 65 degree C, if need further assistance with
purchasing the DC power source, please contact Advantech for further information.
Warning! 1. Input voltage rated: 9 - 32 Vdc.
2. Transport: carry the unit with both hands and handle with care.
3. Maintenance: to properly maintain and clean the surfaces, use only
approved products or clean with a dry applicator.
4. SD/SIM card: Turn off the power before inserting or removing
the storage cards.
1. Tension d'entrée nominale: 9 - 32 Vdc.
2. Transport: portez l'appareil avec les deux mains et manipulez-le avec
précaution.
3. Entretien: pour bien entretenir et nettoyer les surfaces, n'utilisez que des
produits approuvés ou nettoyez-les avec un applicateur sec.
4. Carte SD / SIM: Mettez l'appareil hors tension avant de l'insérer ou de le
retirerles cartes de stockage.
Chapter 1
1 General Information
This chapter gives background
information on the TREK-530
Computer
Sections include:
Introduction
General Specifications
Dimensions
Chapter 1
General Information
1.1 Introduction
TREK-530 is a compact RISC-based in-vehicle computing box equipped with a Qualcomm® Snapdragon™ 212
quad-core ARM® Cortex™-A7 SoC, isolated DI/O, and two extension slots for optional expansion. Built-in
WLAN, Bluetooth, and GNSS modules offer enhanced connectivity, while periodic, digital input and WWAN
suspend/resume functionality
Supports remote monitoring, making TREK-530 ideal for logistics and fleet management. Moreover, the
system’s wide operating temperature range (-20 ~ 65 °C), support for 9-32Vdc power input, and compliance
with MIL-STD-810G and 5M3 shock/vibration standards ensures TREK-530 can withstand operation in harsh
environments.
1.2 General Specifications
Features
Qualcomm® Snapdragon™ 212 quad-core ARM® Cortex™-A7 SoC with Android 6.0 Marshmallow
Built-in WLAN, Bluetooth, and GNSS (including BeiDou) modules with external antenna via FAKRA
connector.
Modularized design with two extension slots for optional expansion (such as LTE 4G module or
battery) according to application requirements.
Multiple isolated DI/O; DI supports dry/wet contact and speed sensor inputs for measuring distance.
Compliant with MIL-STD-810G and 5M3 standards for shock/vibration tolerance.
Equipped with Advantech’s industrial Mobile Android Remote General Utilities for remote
management.
Specifications
System
Processor
Qualcomm® Snapdragon™ 212 APQ8009 quad-core ARM® Cortex™-A7
(1.3 GHz) SoC
Memory
2 GB
Storage
16 GB eMCP
1 x Externally accessible MicroSD (push-push type) with cover
Watchdog
Yes
RTC
Yes
O.S
Android 6.0 Marshmallow
RF
WiFi
IEEE 802.11 a/b/g/n dual band (2.4/5 GHz) (with external antenna via
FAKRA connector)
Bluetooth
Bluetooth V4.1 Class 1 (with external antenna via FAKRA connector)
GNSS
GPS, GLONASS, and AGPS (BeiDou upon request) support (with
external antenna via FAKRA connector)
WWAN
Sierra Wireless MC7304 via extension module (EU)
LTE: B1, B3, B7, B8, B20
Sierra Wireless MC7354 via extension module (US)
LTE: B2, B4, B5, B13, B17, B25 (external antenna via FAKRA connector)
WCDMA Band II, Band V, Band IV.
GPRS 850,1900,EGPRS 850,1900
Voice call
N/A
Wake-on-WWAN
N/A
SIM
1 SIM slot
External Antenna
1 x WLAN, 1 x WWAN Main, 1 x WWAN AUX & GPS (FAKRA connector)
Sensor
G-Sensor
Triple-axis accelerometer (±2g/4g/8g)
I/O
Generic I/O Port
(via automotive
connector)
1 x Mic-In, 1 x Line-Out
4 x Isolated DI (dry/wet contact)
2 x Isolated DO (open-collector output with relay driver)
1 x CAN bus (supports raw CAN, J1939, OBD-II/ISO 15765; firmware
configurable)
1 x J1708 (J1587)
1 x USB 2.0 Host
1 x 4-wire RS-232
1 x 4-wire RS-232/RS-485 (software configurable)
Standard I/O Port
1 x Micro USB OTG (Mini USB) with cover (for debugging)
1 x MicroSD slot with cover
Indicator
1x LED (Power)
Button
1x reset button with cover
Power
Reset
Yes
Input Voltage
9-32V DC
Backup Battery
(Optional)
3.6 V 2100 mAh
Mechanical
Dimensions (W x H x D)
140 x 110 x 50 mm (5.51 x 4.33 x 1.96 in)
Weight
410 g
IP Rating
IP54 with I/O cover
Environment
Regulation
E-Mark, ISO 7637-2, SAE J1455, PTCRB
EMC
CE,FCC
Safety
UL/cUL, CB, CCC
Operating Temperature
-20
°
C ~ 65 °C (-4 ~ 149 °F)
-10° C ~ 60° C (with battery discharge)
0° C ~ 45° C (with battery charge)
Storage Temperature
-40~85C (-40~185F) (without battery)
Shock/Vibration
MIL-STD-810G, SAE J1455
Chapter 1
General Information
1.3 Dimensions
Figure 1.1 TREK-530 dimensions
Warning! Use suitable mounting apparatus to avoid risk of injury.ÚTTENTION:
Veuillez utiliser un système de montage approprié afin d'éviter tout risque de
blessure.ÐFixed VESA screw specification: M4 ; Screws depth: 10 mm. (Min)_
Chapter 2
2 System Setup
This chapter details system setup
on TREK-530
Sections include:
A Quick Tour of the Computer
Box
Installation Procedures
Quick Start to access TREK-530
[鍵入文字]
Chapter 2
System Setup
2.1 A Quick Tour of the TREK-530 Computer
Before starting to set up TREK-530, take a moment to become familiar with the
locations and functions of the connectors and ports, which are illustrated in the
figures below.
Figure 2.1 Rear view of TREK-530
2.2 Installation Procedures
2.2.1 Installing SIM card
Remove WWAN extension module enclosed I/O door screw then open the rubber
door on left side. Then can install SIM Card directly.
Figure 2.3 Installing SIM card
2.2.2 Connecting Power
Connect the power cord to the DC inlet of the Computing Box. On the open-wire
end, one pin is reserved for positive voltage and is marked, "+"; one pin is reserved
for ground and is marked, "-"; and, one pin is reserved for the ignition signal with an
“ignition” mark.
Note! Ignition on/off setting: The TREK-530 supports an ignition on/off function
so that you can power on/off the TREK-530 via the ignition signal/volt-
age and connect the TREK-530 ignition switch.
Table 2.1: Pin Definition of Power Cord
Pin Definition Color
1
-
Black
2
+
Red
3
Ignition
Orange
2.2.3 Quick Start to access TREK-530
There are 2 method to access TREK-530, one is through USB cable, the other one is
through WiFi or Ethernet.
2.2.3.1 USB driver installation
Before access TREK-530, you need to install ADB driver on your PC for ADB connection to
TREK-530.
Before TREK-530 power on, unplug USB cable, make sure USB switch are switch to debug
mode, by removing the plate cover and switch to right
Qualcomm ADB driver install
Environment setup
- Windows 7/8 32 / 64bit
- Android_USB_Driver.7z
- Unzip Android_USB_Driver.7z
- [TREK-530] Make sure device is off.
- [TREK-530] Switch USB switch to USB debug side
- Power on device
- After 10 sec, plug-in USB cable
- Check DeviceManager in your PC, found a un-known device as following pic.
Right click it and select “Updated driver” than select Browse my computer…”
Browse to driver folder and click “Next”
Select “Install” and driver will be installed.
Check Device Manager
Open a window console and type “adb device” to confirm TREK-530 recognized.
Establish screencast connection to TREK-530
Run androidscreencast.bat on PC to launch Android screencast. Then you can look the
desktop of TREK-530 remotely.
2.2.3.2 WiFi & Ethernet auto configure
Download a file trek530_adv.cfgfrom Advantech support website.
Change file setting in trek530_adv.cfg
Save trek530_adv.cfg in USB or SDCard storage
Plug storage into TREK530
WiFi Setting
[WIFI] => Setting for WiFi
SSID: => SSID name
WTYPE: => Security Mode
OPEN
WEP
WPAPSK (Include WPA/WPA2 - AES/TKIP)
PW: => Password (No Need if type is “OPEN”)
Ex:
Ethernet Setting
[ETH] => Setting for Ethernet
ETYPE: => Type of Ethernet
STATIC
DHCP (below setting can be ignore)
IP: => STATIC IP
NM: => NetMask
GW: => GateWay
DNS1: => DNS1(Option for static)
DNS2: => DNS2(Option for static)
Ex:
Note :
Line ignore with “#” mark at first character
If there are same setting in file, value of last line will be used.
Ex: Same SSID
[WIFI]
SSID:ABCD
SSID:5678 <- 5678 will be used
WTYPE:WEP
Setting also will be applied when boot up if storage is put in device before power on.
WiFi will be triggered to create connection with dedicated AP, but can’t guarantee the
connection will be successful. Connection can be created or not is depends on the signal
strength in current environment.
Chapter 3
4 I/O Connector
This chapter explains how to set up the
Computing Box hardware, including
instructions on setting.
Sections include:
I/O connectors pin assignment
3.1 I/O Connectors Pin Assignment
3.3.1 Power connector
Pin
Function
1 GND
2
GND
3
GND
4
GND
5 9~32V
6
9~32V
7
9~32V
8
IGNITION
3.3.2 High Density Connector
Pin
Function
Pin
Function
1
ISO Digital Input 1
17
USB D-
2
ISO Digital Input 2
18
GND
3 ISO Digital Input 3
19
RS-232_2 RXD
RS-485 Data +
4 ISO Digital Input 4
20
RS-232_2 DCD
RS-485 Data -
5
GNDof ISO DI/O
21
RS-232_2 CTS
6 ISO Digital Output 1
22
RS-232_2 RTS
7
ISO Digital Output 2
23
RS-232_2 TXD
8
J1708+(J+)
24
GND
9
GND(G)
25
RS-232_1 RTS
10
J1708-(J-)
26
RS-232_1 CTS
11 CAN H
27
RS-232_1 TXD
12
GND(G)
28
RS-232_1 RXD
13
CAN L
29
GND of Audio
14
USB VBUS
30
Line Out
15 GND
31
Line In
16
USB D+
32
MIC Input
3.3.3 LAN Connector
Pin
Function
1 LAN_TX+
2
LAN_TX-
3
LAN_RX+
4
(Pair C+)
5 (Pair C-)
6
LAN_RX-
7
(Pair D+)
8
(Pair D-)
Chapter 4
6 Software Demo Utility
Setup
This chapter explains the soft-
ware demo utility for TREK-530
Sections include:
Introduction
How to Set up Demo Utility
1 MRM SDK Package Contents
The MRM SDK package contains the following contents:
The description of each of the folder at the top level is listed below:
Files/Directori
es
Description
bin/library/
The Java library and native library files.
These libraries should be imported in to your APP project.
bin/service/
The MRM service APK file.
The service APK file must be installed into your device before running your APP or
prebuilt sample APPs.
bin/prebuilt_sa
mple/
The prebuilt APK files of sample codes.
doc
The Documents.
samples
The sample code.
2 MRM SDK Overview
The MRM (Mobile Resource Management) SDK is a set of software libraries which provides APIs for
controlling various functions of the target device.
The following figure describes the software stack of MRM SDK:
MRM SDK is composed of the following function domains:
IVCP (Intelligent Vehicle Co-Processor)
A VPM(Vehicle Power Management) MCU(Micro Controller Unit) is embedded in the device, which
controls the power status of device and peripheral devices such as G-Sensor and P-Sensors.
The IVCP function domain is designed in client-service architecture. The IVCP Service acts as a
proxy to access the VPM MCU and is able to serve multiple APP processes simultaneously. In your
APP, you can use the IVCP APIs exported in the MRM Client APIs Library to communicate with the
IVCP service.
IVCP Service Client API Modules:
o Firmware APIs - Get VPM MCU firmware version. Save/Load default settings
o Power Management APIs - VPM related functions. ex: boot control, Ignition control, event
delay adjustments, low battery protection and etc.
o Battery APIs - Backup battery related information and functions
o Alarm APIs - Internal RTC time setting and device alarm wakeup related functions.
o Watchdog APIs - Watch dog functions.
o Peripheral Control APIs - Power status management of peripheral devices.
o Storage APIs - Internal EEPROM storage access.
o G Sensor APIs - Access G sensor data. G sensor related settings.
o G Sensor Alarm APIs - G sensor device wakeup functions.
o P Sensor APIs - Access P sensor data.
SDP (Smart Display Panel)
Depends on the specific device spec, the device may bundle with a smart display panel module.
The smart display panel module is embedded with a MCU to control functions of the module.
Similar with IVCP function domain, the SDP function domain is also designed in client-service
architecture. You can use the SDP APIs exported in the MRM Client APIs Library to communicate
with the SDP service.
SDP Service Client API Modules:
o Firmware APIs - Get SDP MCU firmware version. Save/Load default settings
o Backlight APIs - Configure brightness of smart display.
o Sensor APIs - Access sensor on smart display
o Hotkey APIs - hotkeys related settings.
o Speaker API - Speaker related settings
o USB API - USB port related settings
VCIL (Vehicle Communication Interface Layer)
A VCIM(Vehicle Communication Interface Module) MCU is embedded in the device for controlling
the vehicle communication protocols (e.g. CAN, J1939, OBD2, J1708, J1587). For the performance
considerations, the VCIL function domain is designed in form of libraries, You can use the VCIL APIs
exported in the VCIL API Library to control the MCU directly. For VCIL does not has service layer,
the VCIL API Library does NOT support multi-process access.
VCIL API Modules:
o VCIL APIs - Get VCIL MCU firmware version. Physical port protocol settings.
o CAN APIs - Read / write data with CAN protocol.
o J1939 APIs - Read / write data with J1939 protocol.
o OBD2 APIs - Read / write data with OBD2 protocol.
o J1708 APIs - Read / write data with J1708 protocol.
o J1587 APIs - Read / write data with J1587 protocol.
3 How MRM SDK Works
IVCP and SDP functions in the MRM SDK for Android is designed in client-service architecture.
To make your APP work with the MRM services to control the device you must first include the Service
Client API library into you APP project. Before calling APIs to control the device, you must first "bind"
you APP process to the MRM service processes. After binding is done, you can then call the IVCP, SDP
APIs to communicate with the services. The MRM services act as proxies for client APP to access the
hardware functions.
Due to the nature of client-service structure, the MRM SDK for Android supports multi-processes
access. It is available for the services to serve multiple application processes at the same time. The
hardware resources are managed by the services and the client application does not need to worry
about hardware resource occupation.
VCIL functions in the MRM SDK for Android is designed in form of libraries.
Before calling APIs to control the device, you must first call the initialization API to make the VCIM
MCU ready to work. After initialization is done, you can then call the VCIL APIs to do operations of
vehicle protocols.
4 Installation of the MRM SDK
You can install SDK(MRM Services) to your device by follow the steps below
1. Unzip the SDK package
Extract the SDK package zip file with password.
The password is same as the filename.
2. Install MRM Services (mrm_service.apk)
( NOTE: This step is only necessary for IVCP and SDP function. You can skip this step if you only
need VCIL functions )
Connect device to you computer with ADB.
Execute the script install_mrm_service.bat in [SDK_Pacakge]/bin/
The script will execute the following ADB command:
adb install -r .\mrm_service.apk
After installed, you will get the following package in your devices
There will also be an MRM Service Console APP named "MRM" in the APP list. This is a utility for
testing MRM Services and checking the basic information.
When MRM is launched, it will try to bind all MRM services. The MRM Services will be started and
initialize related hardware resources.
If initialization failed, you can get message with error code in the notification area (drag down
from left top of screen).
In the MRM, the service status will should be shown with the service process ID. The status will be
one of the followings:
o RUNNING
Service process is working correctly.
ex:
o NOT_INITIALIZED
Service process exists but the hardware resources can not be initialized. In this
status, the IVCP APIs can not work properly.
You can find the error code message in the notification area.
ex:
o UNKNOWN
Service process exists but the initialization status can not be confirmed.
The error code will be also shown. (For the definition of error codes, please refer
to the IVCP, VCIL, SDP User Manual)
ex:
o STOP
Service process does not exist.
ex:
3. Import MRM Service Client APIs Library
( NOTE: This step is only necessary for IVCP and SDP function. You can skip this step if you only
need VCIL functions )
To access MRM Service from your APP, you must import the MRM Service Client API lib into you
project.
Please find the MrmServiceClientAPI.jar and MrmDef.jar in the MRM SDK package. Copy the
libraries to the directory /[Module Name]/libs/ in you Android Studio project (the default
module name might be "app").
Then import the libraries by following the steps below:
o Right click on you APP module. Click "Open module settings"
o Click the "Dependency" tab. Then click "+" -> "File dependency"
o Select the lib file.
o Repeat the above steps to add all libs and you will see all libs are added to the list.
4. Import VCIL APIs Library
( NOTE: This step is only necessary for VCIL functions )
To access VCIL functions from your APP, you must import the VCIL libraries into you project.
Please find the MrmJni.jar, MrmDef.jar and jniLibs/ folder in the MRM SDK package.
Copy the MrmJni.jar, MrmDef.jar to the directory /[Module Name]/libs/ in your Android Studio
project (the default module name might be "app") and copy the jniLibs/ folder to the directory
/[Module Name]/src/main/ .
Then import the Java libraries by following the steps below:
o Right click on you APP module. Click "Open module settings"
o Click the "Dependency" tab. Then click "+" -> "File dependency"
o Select the lib file.
o Repeat the above steps to add all libs and you will see all libs are added to the list.
5 Install Prebuilt Sample Apps
The prebuilt sample is placed in [SDK_Pacakge]/bin/samples/ .
Execute the script install_sample_apps.bat to install to your device.
The script will execute the following ADB command:
adb install -r .\IVCPSample.apk
adb install -r .\SDPSample.apk
adb install -r .\VCILSample.apk
Please note that you must install the MRM Services (mrm_service.apk) fist or the sample APPs will not
work.
6 IVCP Demonstration
The IVCP sample APP (IVCPSample.apk) demonstrates the usage of IVCP APIs. You can tap on the items
in the list to start demo. The following sections show the usage guide line of basic items.
NOTE:
There might be some functions which are not supported on your device.
For the details of supported functions, please refer to the hardware spec.
6.1 Firmware
This page demonstrates the Firmware APIs.
To save/load the default settings of VPM firmware, you can press the corresponding "EXECUTE"
button.
6.2 Power Management
This page demonstrates the Power Management APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
Power Control
o VPM trigger power off event
Power & Battery
o Get/Set power mode and show Power & Battery status
Ignition
o Show ignition status and Control ignition wakeup.
Low Voltage Protection
o Control preboot/postboot low voltage protection and get/set preboot or postboot LVP
threshold. It also can reset low voltage protection to default value and get default range.
NOTE:
The Postboot LVP Threshold voltage must less than or equal to Preboot LVP Threshold
voltage.
Event Delay
o Low Voltage Event Delay:
The delay time before VPM trigger a power off event (i.e. power button press).
o Low Voltage Event Hard Delay:
The delay time counted down after a power off event is triggered. VPM will force power
off the machine if the hard delay time is counted down to zero.
o Ignition Event On Delay:
The delay time before VPM trigger an power on event (power on the machine).
o Ignition Event Off Delay:
The delay time before VPM trigger an power off event (i.e. power button/Ignition off
press).
o Ignition Event Hard Off Delay:
The delay time counted after an power off event is triggered. VPM will force power off the
machine if the hard delay time is counted down to zero.
VPM Mode
o Control Keep Alive and AT mode.
Force Shutdown
o Control force shutdown and get/set force shutdown delay.
Wakeup Source
o Show last wakeup source.
6.3 Battery
This page demonstrates the Battery APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
You can adjust the battery setting of VPM in this page.
6.4 Alarm
This page demonstrates the Alarm APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
You can adjust the RTC time and device alarm wakeup setting of VPM in this page.
6.5 Watchdog
This page demonstrates the Watchdog APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
When the "enable" is pressed, the watch dog will start count down and the count will be updated to
the "watchdog count" row.
You can press "trigger" button to reset the count or press "disable" button to stop watch dog.
6.6 Digital IO
This page demonstrates the Digital IO APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
In the row of "DI Status", the status of each DI pins will be updated periodically to corresponding check
boxes.
In the row of "DI Type", you can adjust the wet/dry contact for all DI pin. In the row of "DI Pin Type",
you can adjust the wet/dry contact for specify DI pin.
6.7 Peripheral Control
This page demonstrates the Peripheral Control APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
6.8 Storage
This page demonstrates the Storage APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
The "data" column in each row is represented in HEX string. To write data, you should input the data in
HEX string format. For example, to write 2 bytes data - "DD" and "EE" - to the storage, you must input
"DDEE" to the data column.
6.9 G Sensor
This page demonstrates the G Sensor APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
The G sensor status is updated periodically in the G sensor data row.
In the row of "G Sensor Offset", you can get/set the G Sensor Offset. Click "Reset" button to reset G
Sensor Offset to default (x=0,y=0,z=0).
In the row of "G Sensor Calibration", the G sensor calibration should be decided by orientation to
gravity. In the front, G sensor data will be x=0, y=0, z=1000 (mg). In the back, G sensor data will be x=0,
y=0 ,z=-1000(mg)
6.10 G Sensor Alarm
This page demonstrates the G Sensor Alarm APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
When G sensor alarm is enabled. The G sensor alarm data will be updated to the row "alarm data"
6.11 P Sensor
This page demonstrates the P Sensor APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
The P sensor status is updated periodically in the pressure row.
6.12 Hotkey
This page demonstrates the Hotkey APIs.
In the "Hoy Key Setting" row, you can set the keycode of corresponding function key on the device.
The keycode list will show the common keycode for easy setting.
In the "Hoy Key Brightness" row, you can set the brightness of LED back light of the function keys.
7 VCIL Demonstration
The VCIL sample APP (VCILSample.apk) demonstrates the usage of VCIL APIs.
In the entry page, you should first set the protocol for each physical port properly in the "module
settings" before you start other VCIL demo. Then, you can scroll to the bottom of the page and tap on
the items in the VCIL demo function list to execute the demos. The following sections show the usage
guide line of each items.
NOTE:
There might be some functions which are not supported on your device.
For the details of supported functions, please refer to the hardware spec.
7.1 CAN
This page demonstrates the CAN APIs.
There are two scrolling areas in this page. The left side contains the demo of CAN port speed setting,
CAN message sending, and CAN port error status getting. The right side contains the demo of CAN
message receiving.
CAN Port Speed Setting
In the "CAN PORT SPEED" area, you can set the bit rate for each CAN port.
Please note that you should also configure the bit rate for CAN port before you start J1939 and
OBD2 demo page.
The CAN, J1939, OBD2 demo may not be operational.
CAN Message Sending
In the "SEND" area, you can set the contents of a CAN message and press "SEND" button to send
the message to CAN bus.
CAN Port Error Status Getting
In the "CAN PORT ERROR STATUS" area, you can press "GET" button to get the error status of
specific CAN port.
CAN Message Receiving
In the "RECEIVE" area, all received CAN messages will be categorized and shown in the list view.
The messages from the same CAN port with same CAN message ID will be updated to the same
row in the list view and the "COUNT" column will increase.
You can press the "SET FILTER" button to enter the CAN Filter demo page.
NOTE:
1. You must properly set the protocol in the entry page or the demo will not be operational.
2. You must set the CAN port speed properly or the sending and receiving function in CAN, J1939,
OBD2 demo page will not be operational.
7.2 CAN Filter
This page demonstrates the CAN APIs related to CAN message filter.
There are two scrolling areas in this page. The left side contains the demo of CAN message filter
settings. The right side shows the filter of specific CAN port.
In the left side you can specify a filter (CAN ID) of specific CAN port and press "SET" button to apply it
or "REMOVE" to remove the filter. To show the filters applied on specific CAN port, you can choose the
CAN port ID and press the "GET" button and all filters will be shown to the right side.
In the right side, you can tap on the row in the list view to load the filter settings to the columns in left
side.
7.3 J1939
This page demonstrates the J1939 APIs.
There are two scrolling areas in this page. The left side contains the demo of J1939 config, and J1939
message sending. The right side contains the demo of J1939 message receiving.
J1939 Config
Press the "CONFIG" button to enter the J1939 config page. You can configure the address and
J1939 NAME in the page.
J1939 Message Sending
In the "SEND" area, you can set the contents of a J1939 message and press "SEND" button to send
the message to CAN bus.
J1939 Message Receiving
In the "RECEIVE" area, all received J1939 messages will be categorized and shown in the list view.
The messages from the same CAN port with same PGN will be updated to the same row in the list
view and the "COUNT" column will increase.
You can press the "SET FILTER" button to enter the J1939 Filter demo page.
NOTE:
1. You must properly set the protocol in the entry page or the demo will not be operational.
2. You must set the CAN port speed properly or the sending and receiving function in CAN, J1939,
OBD2 demo page will not be operational.
7.4 J1939 Config
This page demonstrates the J1939 APIs related to J1939 configuration.
You can set/get the address and J1939 NAME in this page. Please refer to SAE J1939-81 for the
definitions of J1939 NAME.
7.5 J1939 Filter
This page demonstrates the J1939 APIs related to J1939 message filter.
There are two scrolling areas in this page. The left side contains the demo of J1939 message filter
settings. The right side shows the filter of specific J1939 port.
In the left side you can specify a filter (PGN) of specific CAN port and press "SET" button to apply it or
"REMOVE" to remove the filter. To show the filters applied on specific CAN port, you can choose the
CAN port ID and press the "GET" button and all filters will be shown to the right side.
In the right side, you can tap on the row in the list view to load the filter settings to the columns in left
side.
7.6 OBD2
This page demonstrates the OBD2 APIs.
There are two scrolling areas in this page. The left side contains the demo of CAN port speed setting,
OBD2 message sending. The right side contains the demo of OBD2 message receiving.
OBD2 Message Sending
In the "SEND" area, you can set the contents of a OBD2 message and press "SEND" button to send
the message to CAN bus.
OBD2 Message Receiving
In the "RECEIVE" area, all received OBD2 messages will be categorized and shown in the list view.
The messages from the same CAN port with same message type, source address and destination
address will be updated to the same row in the list view and the "COUNT" column will increase.
You can press the "SET FILTER" button to enter the OBD2 Filter demo page.
NOTE:
1. You must properly set the protocol in the entry page or the demo will not be operational.
2. You must set the CAN port speed properly or the sending and receiving function in CAN, J1939,
OBD2 demo page will not be operational.
7.7 OBD2 Filter
This page demonstrates the OBD2 APIs related to OBD2 message filter.
There are two scrolling areas in this page. The left side contains the demo of OBD2 message filter
settings. The right side shows the filter of specific CAN port.
In the left side you can specify a filter (PID, please refer to ISO 15031-5) of specific CAN port and press
"SET" button to apply it or "REMOVE" to remove the filter. To show the filters applied on specific CAN
port, you can choose the CAN port ID and press the "GET" button and all filters will be shown to the
right side.
In the right side, you can tap on the row in the list view to load the filter settings to the columns in left
side.
7.8 J1708
This page demonstrates the J1708 APIs.
There are two scrolling areas in this page. The left side contains the demo of J1708 message sending.
The right side contains the demo of J1708 message receiving.
J1708 Message Sending
In the "SEND" area, you can set the contents of a J1708 message and press "SEND" button to send
the message to J1708 bus.
J1708 Message Receiving
In the "RECEIVE" area, all received J1708 messages will be categorized and shown in the list view.
The messages with same MID will be updated to the same row in the list view and the "COUNT"
column will increase.
You can press the "SET FILTER" button to enter the J1708 Filter demo page.
NOTE:
1. You must properly set the protocol in the entry page or the demo will not be operational.
7.9 J1708 Filter
This page demonstrates the J1708 APIs related to J1708 message filter.
There are two scrolling areas in this page. The left side contains the demo of J1708 message filter
settings. The right side shows the filter of the J1708 port.
In the left side you can specify a filter (MID) and press "SET" button to apply it or "REMOVE" to remove
the filter. To show the filters applied on J1708 port, you can press the "GET" button and all filters will
be shown to the right side.
In the right side, you can tap on the row in the list view to load the filter settings to the columns in left
side.
7.10 J1587
This page demonstrates the J1587 APIs.
There are two scrolling areas in this page. The left side contains the demo of J1587 message sending.
The right side contains the demo of J1587 message receiving.
J1587 Message Sending
In the "SEND" area, you can set the contents of a J1587 message and press "SEND" button to send
the message to J1587 bus.
J1587 Message Receiving
In the "RECEIVE" area, all received J1587 messages will be categorized and shown in the list view.
The messages with same MID will be updated to the same row in the list view and the "COUNT"
column will increase.
You can press the "SET FILTER" button to enter the J1708 Filter demo page.
NOTE:
1. You must properly set the protocol in the entry page or the demo will not be operational.
7.11 J1587 Filter
This page demonstrates the J1587 APIs related to J1587 message filter.
There are two scrolling areas in this page. The left side contains the demo of J1587 message filter
settings. The right side shows the filter of the J1587 port.
In the left side you can specify a filter (PID) and press "SET" button to apply it or "REMOVE" to remove
the filter. To show the filters applied on J1708 port, you can press the "GET" button and all filters will
be shown to the right side.
In the right side, you can tap on the row in the list view to load the filter settings to the columns in left
side.
8 SDP Demonstration
The SDP sample APP (SDPSample.apk) demonstrates the usage of SDP APIs. You can tap on the items
in the list to start demo. The following sections show the usage guide line of basic items.
NOTE:
There might be some functions which are not supported on your device.
For the details of supported functions, please refer to the hardware spec.
8.1 Firmware
This page demonstrates the Firmware APIs.
To save/load the default settings of SDP firmware, you can press the corresponding "EXECUTE" button.
8.2 Backlight
This page demonstrates the Backlight APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
8.3 Alarm
This page demonstrates the Alarm APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
You can adjust the RTC time and device alarm wakeup setting of VPM in this page.
8.4 Sensor
This page demonstrates the Sensor APIs.
The light sensor status is updated periodically.
8.5 Hotkey
This page demonstrates the Hotkey APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
In the row of "Hotkey status", the status of each hotkey will be updated automatically to
corresponding check boxes.
8.6 Speaker
This page demonstrates the Speaker APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
8.7 USB
This page demonstrates the USB APIs.
Each row shows demonstration different APIs. You can press the buttons at the right side to do
corresponding demo actions.
www.advantech.com
Please verify specifications before quoting. This guide is intended for reference
purposes only.
All product specifications are subject to change without notice.
No part of this publication may be reproduced in any form or by any means,
electronic, photocopying, recording or otherwise, without prior written permis-
sion of the publisher.
All brand and product names are trademarks or registered trademarks of their
respective companies.
© Advantech Co., Ltd. 2010

Navigation menu