Epson Moverio Pro BT-2000 Instruction Manual

MOVERIO Pro Developer's Guide (Rev.1.4)
BT-2000/2200
Developer's Guide
Revision history
SEIKO EPSON CORPORATION

MOVERIO Pro Developer's Guide (Rev.1.4)
Revision
Item
Mainly revised content
Rev.1.3
4.1
Adding caution when changing key assign
6
Adding EDof mode and auto exposure function
11
Adding GPS Assist
Rev.1.4
-
Adding description to support BT-2200
Cautions
BT-2000 and BT-2200 use common system software. This document will be described
hereafter by only BT-2000, but please be aware that it is also common to BT-2200.

MOVERIO Pro Developer's Guide (Rev.1.4)
Note the following points when using this guide.
The content of this guide may change without prior notice.
1. Reprinting part or all of this guide without prior permission from Seiko Epson, or reprinting for any other purposes is
strictly prohibited.
2. Programs and usage instructions used in this guide are for reference only, Seiko Epson cannot be held responsible for
any infringements (including industrial property rights) or damage caused to third parties. Furthermore, this guide
does not imply consent to licensing for third parties or industrial property rights for Seiko Epson.
3. This document does not relate to products that require a high level of reliability, such as life support equipment.
Epson accepts no responsibility if this product is used for such circumstances.
©Seiko Epson Corporation 2017. All right reserved.

MOVERIO Pro Developer's Guide (Rev.1.4)
Contents
1. Introduction_______________________________________________ 1
1.1. Product Summary and Functions _____________________________________________________2
1.2. Main System Specifications __________________________________________________________3
1.3. Basic Information for App Development _______________________________________________4
1.4. Other Main Functions _______________________________________________________________5
2. Developing Apps ___________________________________________ 6
2.1. Pre-Caution for Developing Apps______________________________________________________7
2.2. Summary of Developing Apps_________________________________________________________8
2.3. Introduction to the Android SDK______________________________________________________9
2.4. ADB driver settings _______________________________________________________________ 12
2.5. Connecting the BT-2000 to a computer_______________________________________________ 18
2.6. Including the SDK provided by EPSON______________________________________________ 20
3. Display control ___________________________________________ 24
3.1. Display control summary___________________________________________________________ 25
3.2. Full screen display function ________________________________________________________ 26
3.3. Switch between 2D/3D display function______________________________________________ 27
3.4. Backlight control__________________________________________________________________ 29
3.5. Mute function_____________________________________________________________________ 30
3.6. See-through function ______________________________________________________________ 32
4. UI control ________________________________________________ 33
4.1. UI control summary _______________________________________________________________ 34
4.2. Application interface list ___________________________________________________________ 38
4.3. Application interface details ________________________________________________________ 39
5. Voice commands __________________________________________ 41
5.1. Pre-cautions for developing Voice commands Apps ____________________________________ 42
5.2. Voice commands summary _________________________________________________________ 43
5.3. Application interface function summary _____________________________________________ 44
5.4. Application interface list ___________________________________________________________ 45
5.5. Application interface details ________________________________________________________ 47

MOVERIO Pro Developer's Guide (Rev.1.4)
5.6. Sample code ______________________________________________________________________ 55
5.7. Others ___________________________________________________________________________ 57
6. Camera control ___________________________________________ 64
6.1. Pre-cautions for developing camera Apps_____________________________________________ 65
6.2. Function summary ________________________________________________________________ 66
6.3. Available parameters ______________________________________________________________ 67
6.4. Image organization and format _____________________________________________________ 68
6.5. Depth data characteristics _________________________________________________________ 69
6.6. Application interface function summary _____________________________________________ 71
6.7. Application interface list ___________________________________________________________ 72
6.8. Application interface details ________________________________________________________ 74
6.9. Depth Information Acquisition Flow Details_________________________________________ 104
6.10. Sample Code___________________________________________________________________ 106
6.11. Remarks ______________________________________________________________________ 109
6.12. Android standard camera API Camera.Parameters Class ___________________________ 110
7. Sensor control ___________________________________________ 113
7.1. Sensor control summary __________________________________________________________ 114
7.2. Using the sensor _________________________________________________________________ 117
7.3. Using SensorEventListener _______________________________________________________ 118
7.4. Sample code _____________________________________________________________________ 120
8. Bluetooth/BLE __________________________________________121
8.1. Pre-cautions for developing Apps using BLE_________________________________________ 122
8.2. Summary _______________________________________________________________________ 123
8.3. Usage method ___________________________________________________________________ 125
8.4. Remarks & Restrictions for BLE App Development __________________________________ 131
8.5. Import module ___________________________________________________________________ 132
8.6. Application interface list __________________________________________________________ 133
8.7. Supported GATT procedure table __________________________________________________ 135
8.8. Application interface details _______________________________________________________ 136
8.9. BLE Processing Sample Code______________________________________________________ 168
9. Power control____________________________________________178
9.1. Power control summary ___________________________________________________________ 179
9.2. Acquiring Battery Information_____________________________________________________ 180

MOVERIO Pro Developer's Guide (Rev.1.4)
10.Self-diagnostic function___________________________________181
10.1. Self-diagnostic function _________________________________________________________ 182
11. GPS Assist ______________________________________________185
11.1. GPS Assist function summary ___________________________________________________ 186
11.2. Precaution and limitation of using /developing GPS Assist function __________________ 187
11.3. How to use ____________________________________________________________________ 188
11.4. Setting method ________________________________________________________________ 189
11.5. Application interface function summary __________________________________________ 190
11.6. Application interface detail______________________________________________________ 191
11.7. How to use API for GPS assist ___________________________________________________ 193

MOVERIO Pro Developer's Guide (Rev.1.4)
1
1. Introduction

MOVERIO Pro Developer's Guide (Rev.1.4)
2
1.1. Product Summary and Functions
The BT-2000/2200 is a smart headset for business use. The same optical see-through
technology as the consumer orientated MOVERIO BT-200 has been adopted. This allows
information to be displayed across a wide viewing area while keeping eye movement to a
minimum, thereby reducing fatigue and making it suitable for use at work. This also allows you
to view your surroundings while projecting an image, which adds an aspect of safety.
The weight of the product is supported by the entire head, allowing you to work for long periods
of time without feeling fatigued. You can work while checking images in a hands-free
environment.

MOVERIO Pro Developer's Guide (Rev.1.4)
3
1.2. Main System Specifications
Item
Specifications
Model number
MOVERIO Pro BT-2000/2200
Main processor
OMAP4460 (dual core ARM Cortex A9)
System clock
Max 1.2 GHz (Auto adjusts according to the system load and
temperature)
System software
Android 4.0.4
Internal storage (emmc)
8 GB (2 GB reserved for the system)
Main memory
1 GB
Power
Battery operated/AC power operated
External memory
MicroSD/MicroSDHC supported (32 GB max.)
No. of pixels in LCD panel
960x540 (QHD)/16：9/Refresh rate 60 Hz
Virtual screen size
80" (for virtual viewing distance of 5 m)
Color reproduction
24 bit full color (16,770,000 colors)
3D display
Available (only for side by side)
User interface
Audio commands: supports Japanese and English
Hardware keys: Power, lock, D-pad/OK key and A, B, X, Y keys
Others: Headset tap input function
Camera
Built-in headset, stereo camera
Sensor
IMU (Gyro/acceleration)/geomagnetic built-in headset
Wi-Fi
IEEE 802.11a/b/g/n, Wi-Fi Direct
Wi-Fi Security
WEP
WPA –Enterprise, Personal
WPA2 –Enterprise, Personal
EAP Types
EAP-TLS
EAP-TTLS/MSCHAPv2
PEAPv0/EAP-MSCHAPv2
PEAPv1/EAP-GTC
VPN
PPTP
Bluetooth
A2DP, HSP, HID, OPP, SPP, BLE support
GPS
GPS function, GPS Assist function
*Safety shield is applying ANSI/ISEA Z87.1 (2015 version).

MOVERIO Pro Developer's Guide (Rev.1.4)
4
1.3. Basic Information for App Development
Item
Description
CPU/ABI
ARMv7 armeabi
Android API level
15
Device screen density
mdpi
Screen type
Tablet UI
Screen orientation
Fixed at Landscape (without sensor rotation)
USB vendor ID
0x04B8
■HOME, MENU, and BACK keys are supported by hardware keys
■ Touch screen and track pad are not used
■ Except for Wi-Fi, data communication, such as 3G, is not supported
■ This is not a Google Certified device, meaning the following services which require Google
Certification are not available:
- Google Play
- Google location information service
- Additional services only available on Google Certified devices.

MOVERIO Pro Developer's Guide (Rev.1.4)
5
1.4. Other Main Functions
BT-2000 can use below functions. As well as the standard Android API, there are functions that
need EPSON original API. Please refer below charts.
Chart1.4.1 Table of each function and which API to use
Function
Android standard API
EPSON original API
3.Display control
✔
4.UI control
✔
✔
5.Voice command
✔
6.Camera control
✔
✔
7.Sensor control
✔
8.Bluetooth/BLE
✔
9.Power control
✔
10.Self-Diagnostic
✔
11.GPS Assist
✔
The following chapters explain how to use these from an app.
For EPSON original API that needs special caution, please refer Chapter 2.1. Pre-Caution for
Developing Apps.

MOVERIO Pro Developer's Guide (Rev.1.4)
6
2. Developing Apps

MOVERIO Pro Developer's Guide (Rev.1.4)
7
2.1. Pre-Caution for Developing Apps
BT-2000 is using Android platform, but considering the product’s use purpose, it is applying own
functions. Therefore it is necessary to control by EPSON own API. There are some cases that
Android emulator or Android applications that operated with Android Smartphones may not
operate. Please take attention when transplanting APK or diverting source code. Below API needs
attention specially, please refer details at each chapter.
Module lists that need attention for developing Apps.
Camera ・・・ Chapter 6 Camera control
BLE ・・・ Chapter 8 Bluetooth/BLE

MOVERIO Pro Developer's Guide (Rev.1.4)
8
2.2. Summary of Developing Apps
The BT-2000 has adopted Android as the system software. Therefore, you can develop apps for
the BT-2000 in the same environment as developing apps for Android smartphones. However,
when connecting the BT-2000 with the app development computer, or when using functions
unique to the BT-2000, you need to have the PC settings compatible with BT-2000.
This chapter explains the following procedures necessary to develop apps for the BT-2000.
■ Introduction to the Android SDK
■ ADB driver settings
■Connecting the BT-2000 to a computer
■ Including the SDK provided by EPSON

MOVERIO Pro Developer's Guide (Rev.1.4)
9
2.3. Introduction to the Android SDK
The introduction to the Android SDK assumes the following steps will be performed in a
Windows7 environment.
2.3.1. Acquiring Android Studio
Download Android Studio from the following Website.
https://developer.android.com/sdk/index.html
2.3.2. Acquiring and installing JDK
Download the JDK (7 or later) from the following Website, and then install.
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
(Not sure if it’s a good idea to include the link above as it may change over time)
2.3.3. Installing Android Studio
Follow the directions provided by the installer to install Android Studio.
Example) C:\Users\User name\AppData\Local\Android\sdk
* From here on, instructions assume Android Studio is installed in the folder above.

MOVERIO Pro Developer's Guide (Rev.1.4)
10
2.3.4. Installing Platform-tools, SDK Platform, and USB Driver
Execute "C:\Users\User name\AppData\Local\Android\sdk\SDK Manager.exe".
* When you start SDK Manager, the dialog "No packages found" may be displayed.
This occurs when the proxy is not set correctly, and information cannot be updated.
Close all dialogs except for "Android SDK Manager", and then set the proxy in [Tools] -
[Options]. When Proxy settings are unknown, please contact network administrator for
“Connecting method to external network using Proxy”

MOVERIO Pro Developer's Guide (Rev.1.4)
11
Select the following necessary files in the SDK Manager, and then install.
■ [Tools] - [Android SDK Platform-tools]
■ [Android 4.0.3] - [SDK Platform]
■ [Extras] - [Google USB Driver」
Select the above, click [Install], and then select ‘Accept’all.
This completes the introduction to the Android SDK.
Next, we will explain how to connect the BT-2000 to the app development computer, and setting
up the ADB driver.

MOVERIO Pro Developer's Guide (Rev.1.4)
12
2.4. ADB driver settings
Here we will explain how to connect the BT-2000 to the app development computer, and set the
ADB driver.
When using Windows8 OS or later, it is required to operate by test mode to install ADB driver.
When using Windows7 OS or before, proceed to “2.4.2 When using Windows7 OS or before”.
2.4.1. When using Windows8 OS or later
2.4.1.1. Operate by test mode
1) Run the command prompt as administrator, and run below command.
※When below error occur by running above command, please refer to
”2.4.1.2 When failing test mode command”.
2) Select 「Setting」→「Change PC Setting」from the charm.
3) Select 「Update and recovery」→「Recovery」→「Restart now」.
4) Select 「Trouble shoot」→「Advanced options」from the menu.
> bcdedit -set testsigning on
Select→
Select→
Select→

MOVERIO Pro Developer's Guide (Rev.1.4)
13
5) It will reboot after selecting Windows [Startup Settings].
6) [Startup Settings] screen will show after reboot, so select [Disable Driver Signature
Enforcement].
For procedure from here, please proceed to next chapter“2.4.2When using When using Windows
7 OS or before”.
Select→

MOVERIO Pro Developer's Guide (Rev.1.4)
14
2.4.1.2. When failing test mode command
Test mode command failure is due to lock by Secure Boot.
Please disable Secure Boot by below method.
1)Select 「Settings」→「Change PC Settings」from charm.
2)Select 「Update and recovery」→「Recovery」→「Restart now」.
3)Select 「Trouble shoot」→「Advanced options」→「UEFI firmware Settings」.
4) Find Secure Boot Control and change to Disabled.
Select→
Select→
Select→
Select→