Qeedji TAB10s User manual

Developer manual 001M
AOSP-9.10.10
TAB10s
8:30

2
Legal noces
AOSP-9.10.10 ( 001M_en)
© 2020 Qeedji
R ights and R esponsibilies
All rights reserved. No part of this manual may be reproduced in any form or by any means whatsoever without the wrien permission of the publisher. The products and services
menoned in this document may be trademarks and/or trademarks of their respecve owners. The publisher and the author do not pretend to these brands.
Although every precauon has been taken in the preparaon of this document, the publisher and the author assumes no responsibility for errors or omissions, or for damages
resulng from the use of the informaon contained in this document or the use of programs and source code who can accompany it. Under no circumstances can the publisher and
the author be held responsible for any loss of profits or any other commercial prejudice caused or that would have been caused directly or indirectly by this document.
Product informaon
The concepon and specificaons of the product may change without prior noce, and this applies to hardware, embedded so ware and this guide. Consumable items accessories
may slightly diff er than herein described as Qeedji is depending on the evoluons of its suppliers. This document contains confidenal informaon; it can’ t be disclosed to any third
pares without prior wrien authorizaon of Qeedji.
Safety instrucons
Please read carefully the following instrucons before switching the product on: - WARNING! Correct fi ng and installaon is of the utmost importance. Incorrect fi ng and/or
installaon may result in personal injury or loss. Qeedji disclaims all liability, of whatever kind, if the product is assembled, fied and/or installed in an incorrect manner. - Do not use
the product near a water supply. - Do not pour anything on the product, like fl ammable liquids or material. - Do not expose the product to direct sun, near a heang source or a dust
nor vibraons. - Do not obstruct holes, to be sure that air fl ows freely around the product. - Switch off the product during a storm. - Do not open the product in any circumstances.
G uarantee terms
Qeedji products are eligible for a warranty to cover genuine manufacturing defect for 3 years. Product failure occurring as the result of factors that do not constute genuine
manufacturing defect are not covered under the terms of the warranty and any repairs of this nature would be chargeable. For example: Inappropriate maintenance acon, a non-
authorized modificaon, a not specified environment ulizaon (see ‘ Safety instrucons’ ), or if the product has been damaged a er an impact, a fall, a bad manipulaon or a storm
consequence, an insufficient protecon against heat, moisture or frost. This warranty is not transferrable. In addion, any repairs carried out by non-authorized personnel will
invalidate the warranty.
W E E E Direcve
This symbol means that your end of life equipment must not be disposed of with household waste but must be deposited at a collecon point for waste electrical and electronic
equipment or to your reseller. This will benefit the environment. In this context, a system for collecng and recycling has been implemented by the European Union

3
1.1
1.2
1.3
1.4
1.4.1
1.4.2
1.4.3
1.5
1.6
2.1
Table of content
Part I :
Introducon
APK Development
System APK signing
Qeedji System service
Installaon by USB
Installaon by WebDAV
AOSP device mode
Qeedji preferences
FAQ
Part II :
Contacts

4
1.1 Introducon
This documentaon is intended for ISVs ( Independent Software Vendors ), wishing to develop AOSP APKs on Qeedji TAB10s and who already have Android APK development
skills.
◬ It is recommended to read fi rst the TAB1 0 s user manual.
Demo Package Content
Items Descripon Q uanty
TAB10s Qeedji tablet embedding AOSP 1
Power supply USB Type-C 1
USB Type-C cable Cable - Assembly, Type-C Male to Type-A Male 1
USB hub USB Type-A (2.0), USB Type-C 1

5
1.2 APK Development
Prequisite
The so ware developer already knows how to develop Android APK and generate or debug APK with Android Studio.
AOSP Standard API
The standard API of AOSP 9.10.10 is based on the AOSP SDK 28.
The AOSP 9.10.10 for Qeedji embeds Chromium Web engine 83.
The getDeviceId method of the TelephonyManager class allows to get the device idenficaon UUID value.
The getSerial method of the Build class allows to get the raw PSN.
The BASE_OS stac string of the Build.VERSION class allows to get the so ware version.
Q eedji System Java API
The Qeedji github is hosng the tech-qeedji-system-lib-classes.jar Java library.
The tech-qeedji-system-lib-classes.jar Java library exposes an API for specific features.
public class SurroundLight {
public static final int OFF = 0;
public static final int RED = 1;
public static final int GREEN = 2;
public static final int ORANGE = 3;
public SurroundLight();
public void setColor(int color);
public int getColor();
}
public class Rfid125KHz {
public Rfid125KHz(Context c);
public void setEnabled(boolean value);
}
public class DipSwitch {
public DipSwitch(Context c);
public boolean camera();
public boolean microphone();
}
public class SharedPreferenceAPI {
public String getPreferenceAuthority();
public Object[][] initPreferences();
}
Q eedji System Javascript API
The Qeedji github is hosng the tech-qeedji-host-webview.aar Android library.
The tech-qeedji-host-webview.aar Android library exposes an Javascript API for specific funconalies in a WebView.
The tech-qeedji-host-webview.aar Android library embeds the tech-qeedji-system-lib-classes.jar library.
String Host.Bluetooth().getHardwareAddress();
String Host.Device().getModel();
String Host.Device().getManufacturer();
String Host.Device().getSerial();
String Host.Device().getPsn();
String Host.Device().getSoftwareVersion();
String Host.Device().getDeviceName();
String Host.Device().getUUID();
String Host.Device().getHostname();
String Host.Device().getMacId();
String Host.Device().getField1();
String Host.Device().getField2();
String Host.Device().getField3();
String Host.Device().getField4();
String Host.Device().getField5();
boolean Host.DipSwitch().getCamera();
boolean Host.DipSwitch().getMicrophone();
int Host.NetworkInterfaces().length();
NetworkInterface Host.NetworkInterfaces().get(int index);
String NetworkInterface.getName();
String NetworkInterface.getHardwareAddress();
boolean NetworkInterface.isUp();
void Host.NFC().start();
void Host.NFC().stop();
// parameter type is unused
callback : void onHostNFCReading(String type, String id);
void Host.PowerManager().goToSleep();
void Host.PowerManager().wakeUp();
void Host.PowerManager().reboot();
void Host.ProximitySensor().start();
void Host.ProximitySensor().stop();
callback : void onHostProximitySensorReading(float distance);
void Host.Rfid125KHz().start();
void Host.Rfid125KHz().stop();
int Host.SurroundLight().OFF();
int Host.SurroundLight().RED();
int Host.SurroundLight().GREEN();
int Host.SurroundLight().ORANGE();
void Host.SurroundLight().setColor(int color);
int Host.SurroundLight().getColor();
void Host.SystemButton().start();
void Host.SystemButton().stop();
callback : void onHostSystemButtonReading(int count);

6
APK shared preferences handling with configuraon script
An APK can be designed to share some preferences which can be then read or wrien by the Qeedji System service:
either through the configuraon script,
or through the device configuraon Web interface¹.
¹ Should be available Q2 /2 0 2 1 .
The APK must link the tech-qeedji-system-lib-classes.jar Java library.
The APK must also implement a child class of the SharedPreferenceAPI class supported in the tech-qeedji-system-lib-classes.jar Java library.
package tech.qeedji.test1;
import tech.qeedji.system.lib.SharedPreferenceAPI;
public class MySharedPreferenceAPI extends SharedPreferenceAPI {
@Override
public String getPreferenceAuthority() {
return BuildConfig.APPLICATION_ID;
}
@Override
public Object[][] initPreferences() {
Object[][] preferences = {
// filename, key, access, type, default_value
{"test1", "test1Integer", "rw", int.class, 1},
{"test1", "test1Long", "rw", long.class, 10000000L},
{"test1", "test1Float", "rw", float.class, 0.897546F},
{"test1", "test1Boolean", "rw", boolean.class, true},
{"test1", "test1String", "rw", String.class, "test1StringValue"},
{"test1", "test1StringSet", "rw", String[].class, new String[]{"http://Val0", "http://Val1", "http://Val2"}},
};
return preferences;
}
}
The APK must declare a provider in its manifest.
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="tech.qeedji.test1">
<application
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<provider android:name="tech.qeedji.test1.MySharedPreferenceAPI"
android:authorities="tech.qeedji.test1"
android:multiprocess="false"
android:exported="true"
android:singleUser="false"
android:initOrder="100"
android:visibleToInstantApps="true"/>
</application>
</manifest>
Extract example from a configuraon script:
Android.Preferences("SharedPreferences", "tech.qeedji.test1", "test1").setInt("test1Integer", 8);
Android.Preferences("SharedPreferences", "tech.qeedji.test1", "test1").setLong("test1Long", 99999999);
Android.Preferences("SharedPreferences", "tech.qeedji.test1", "test1").setFloat("test1Float", 0.123456);
Android.Preferences("SharedPreferences", "tech.qeedji.test1", "test1").setBoolean("test1Boolean", false);
Android.Preferences("SharedPreferences", "tech.qeedji.test1", "test1").setString("test1String", "Newtest1StringValue");
Android.Preferences("SharedPreferences", "tech.qeedji.test1", "test1").setStringArray("test1StringSet", ["http://NewVal0", "http://NewVal1", "http://NewVal2"]);

7
E xamples
The Qeedji github for TAB10s is hosng APK examples using the AOSP SDK for TAB10s:
proximity_sensor APK: displays a message Hello Qeedji when a person is detected, or displays a message Nobody detected when no one is detected.
This APK uses the SensorManager API with a default sensor of type Sensor.TYPE_PROX IMITY.
rfid_tag_reader APK: detects NFC tags or RFID 125KHz tags and print their values (type and ID).
This APK uses the NfcAdapter API for NFC tags and the KeyEvent.Callback for RFID 125KHz tags.
The NFC permission and the android.hardware.nfc feature API are required.
surround_light APK: allows to set the surround light color and state with steady/green, steady/orange, steady/red, off .
This APK uses the SurroundLight class described in the specific API.
device_info APK: displays device informaons.
This APK uses the android.os.Build APIs, NetworkInterface and the DipSwitch class described in the specific API.
These permissions are required: READ_PHONE_STATE, READ_PRIVILEGED_PHONE_STATE, INTERNET, ACCESS_NETWORK_STATE, BLUETOOTH, BLUETOOTH_ADMIN,
BLUETOOTH_PERM and LOCAL_MAC_ADDRESS_PERM.
This APK has system privileges.
autorestart APK: is launched automacally a er a device reboot. It is relaunched also automacally a er it crashes.
This APK uses the BroadcastReceiver and Thread.UncaughtExceponHandler APIs.
The RECEIVE_BOOT_COMPLETED permission is required.

8
Device Power Standby: allows to go into (or exit from) Android sleep mode (display off , touch screen off ).
This APK uses the PowerManager API.
The DEVICE_POWER and WAKE_LOCK permissions are required.
This APK has system privileges.
System Buon: print a noficaon message when a short press on the system buon, lower than two seconds, is detected.
This APK uses the BroadcastReceiver API.
URL Launcher: load an URL.
This APK uses the WebView API and the tech-qeedji-host-webview.aar Android library for Qeedji.
The RECEIVE_BOOT_COMPLETED and INTERNET permissions are required.
This APK has system privileges.
A specific 000000000000.js configuraon script allows to configure the URL launcher APK (set URL, set login credenals, ...).
Several websites examples are available on Qeedji github for TAB10s.
◬ Designing an APK having system privileges may require for ISV to sign its APK with a Java Keystore having a certificate signed by Qeedji . For further informaon,
refer to the chapter § System APK signing.

9
APK debug
AOSP for TAB10s is compable with Android Studio and Android Debug Bridge (ADB)² so ware development suite.
²ADB is included in the Android SDK Pla orm- Tools package.
You can debug with ADB using USB or WLAN . In case you have an USB hub with an Ethernet to USB bridge, you can also debug with ADB using LAN .
USB debug
Connect a cable between the TAB10s USB-C connector and the USB 2.0 connector of your computer.
Then wait for the TAB10s is boong up.
Unlike an Android Mobile tablet, the TAB1 0 s has no baery and is completely powered by the USB- C connector. Before supply the TAB1 0 s with the USB connector of your
computer, check with your computer' s manufacturer that its USB connectors are protected against over- intensity to warranty that its USB output will be never damaged.
Check also that the USB output is able to deliver a suffi cient power else the TAB1 0 s may not stop reboong.
W LAN debug
Connect the cable of the USB-C wall plug to the TAB10s USB-C connector.
Then wait for the TAB10s is boong up.
Go in the Settings applicaon and configure the WLAN.
LAN debug
Prerequisite: have a suitable Ethernet to USB (USB-C or POGO type connector) bridge which is connected to the LAN network.
Connect the Ethernet to USB bridge to on the TAB10s (USB-C or POGO type connector).
Debug mode se ng
Launch the Settings applicaon:
press on the About tablet (TAB10s) menu,
press 5 mes on the buon Build number (9.yy.zz release keys) . The message Y ou are now a developer should appear showing that the debug mode is acvated,
go in the Advanced menu. The Developer options menu is now available,
acvate Network debugging or USB debugging according to your needs.
☛It is possible to acvate or inacvate the debug mode on the TAB1 0 s by using the confi guraon script. In the confi guraon- by- script, uncomment the line
disableA llo w D ebug g ing ( ) ; .
Network access permissions
To access the network, an APK needs to declare INTERNET and ACCESS_NETWORK_STATE permissions in its manifest:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

10
1.3 System APK signing
☛ When the ISV wants to design, on the TAB10s, some APK not requiring system rights to be executed, in this case no APK signing is required.
To design an APK having system privileges like the surround light driving, reboot control or URL launcher, the ISV needs to sign its APK with a Java Keystore having a
certificate signed by Qeedji .
☛ The ISV may use his Java Keystore for all its system applicaons and the same cerficate for all the ISV TAB10s devices. When APK signing is required, each ISV must
apply this procedure once.
Procedure to create a system Java Keystore
☛ In the example, it is considered that the company name is Contoso. ISD means IT Service Department. In the procedure, it is required to use the generic email of the
Chief Informaon Security Officer (CISO) of the company, for example [email protected] .
◬ In the following procedure, the following example values have been used.
Label type Label value examples
C US
ST California
L San-Francisco
O Contoso
OU Contoso_ISD
CN CISO
E [email protected]
Passphrase 1234
Java_keystore basename file contoso_qeedji_java_keystore
Java_keystore password 567890
Friendly_name / name / key_alias qeedji_aosp_key
1 . GENERATE YOUR PRIVATE KEY
◬ Y ou are responsible for your private key storing which has to be never communicated to a third party.
Generate your private key with a length of 2048 bits with the R SA 2 0 4 8 Bits key type.
For example:
openssl genrsa -f4 2048 > contoso_private_key_for_android.key
2 . GENERATE YOUR OWN CSR (CERTIFICATE SIGNING REQUEST)
Generate your own .csr cerficate signing request thanks to your private key and some applicant idenficaon used to digitally sign the request. Thanks to match the
filename paern by replacing contoso by your own organizaon name.
For example:
openssl req -new -key contoso_private_key_for_android.key -subj '/C=US/ST=California/L=San-
Francisco/O=Contoso/OU=Contoso_ISD/CN=CISO/[email protected]' > contoso-for_qeedji_aosp.csr
3 . SEND YOUR CSR TO QEEDJI
Once generated, send a email to the csr@ qeedji.tech with your CSR ( contoso-for_qeedji_aosp.csr file for example) in aachment.
4 . WAIT FOR THE QEEDJI ANSWER
Qeedji should then return an answer within 7 days.
◬ Qeedji will send its answer to the email defi ned into the CSR fi le ( ciso@ contoso.com for example) , which may be not the same email used to send the CSR to Qeedji.
Qeedji sends 2 files: the signed cerficate (extension .crt) and the CA file (extension .pem).
For example:
contoso-qeedji_aosp-certificate-001A.crt ,
contoso-qeedji_aosp-certificate_authority-001A.pem
5 . GENERATE YOUR PUBLIC CERTIFICATE KEY
You have first to generate your public cerficate key. For example:
openssl pkcs12 -export -in contoso-qeedji_aosp-cerficate-001A.crt -inkey contoso_private_key_for_android.key -out
contoso_cerficate_and_key_for_qeedji_aosp.pk12 -password pass:1234 -name qeedji_aosp_key -chain -CAfile contoso-qeedji_aosp-cerficate_authority-001A.pem
6 . GENERATE THE JAVA KEYSTORE
Generate then a Java Keystore from your public cerficate key with the keytool ¹ toolbox.
The Java Keystore system is now usable in Android Studio .
For example:
keytool -importkeystore -deststorepass 567890 -destkeystore contoso_qeedji_java_keystore.jks -srckeystore contoso_cerficate_and_key_for_qeedji_aosp.pk12 -
srcstoretype PKCS12 -srcstorepass 1234
¹ Keytool is a toolbox to handle cerfi cates for J ava products. It is provided by default in the J DK since version 1 .1 .