Difference between revisions of "Android Thing: Android Hardware Programming"

From FriendlyELEC WiKi
Jump to: navigation, search
(→‎Compile & Deploy Andorid Code(SerialPortDemo))
(→‎Compile & Deploy Andorid Code (SerialPortDemo))
Line 45: Line 45:
 
[[File:AndroidHW03.png|500px]]<br />
 
[[File:AndroidHW03.png|500px]]<br />
  
−
====各个平台开发板的串口设备名称 ====
+
====Serial Device Names under Multiple Platforms====
−
* Allwinner H3/H5平台开发板 (NanoPi M1/NanoPi M1 Plus等)
+
* Allwinner H3/H5 Based Boards (NanoPi M1/NanoPi M1 Plus etc)
 
UART1-> /dev/ttyS1<br />
 
UART1-> /dev/ttyS1<br />
 
UART2 -> /dev/ttyS2<br />
 
UART2 -> /dev/ttyS2<br />
−
UART3 -> /dev/ttyS3 (仅NanoPi M1, NanoPi K1, NanoPi K1 Plus可用)<br />
+
UART3 -> /dev/ttyS3 (Only applies to NanoPi M1, NanoPi K1 and NanoPi K1 Plus)<br />
  
−
* S5P4418平台开发板 (NanoPi Fire2A/NanoPi M2A/NanoPi S2/NanoPC-T2等)
+
* S5P4418 Based Boards (NanoPi Fire2A/NanoPi M2A/NanoPi S2/NanoPC-T2 etc)
−
UART1 -> /dev/ttyAMA1  [注1]<br />
+
UART1 -> /dev/ttyAMA1  [Note 1]<br />
−
UART2 -> /dev/ttyAMA2  [注1]<br />
+
UART2 -> /dev/ttyAMA2  [Note 1]<br />
 
UART3 -> /dev/ttyAMA3<br />
 
UART3 -> /dev/ttyAMA3<br />
 
UART4 -> /dev/ttyAMA4<br />
 
UART4 -> /dev/ttyAMA4<br />
  
−
* S5P6818平台开发板 (NanoPi M3/NanoPC-T3等)
+
* S5P6818 Based Boards (NanoPi M3/NanoPC-T3 etc)
−
UART1 -> /dev/ttySAC1 [注1]<br />
+
UART1 -> /dev/ttySAC1 [Note 1]<br />
−
UART2 -> /dev/ttySAC2  [注1]<br />
+
UART2 -> /dev/ttySAC2  [Note 1]<br />
 
UART3 -> /dev/ttySAC3<br />
 
UART3 -> /dev/ttySAC3<br />
 
UART4 -> /dev/ttySAC4<br />
 
UART4 -> /dev/ttySAC4<br />
 
<br />
 
<br />
−
注1: 仅部分板子可用，具体请查看原理图.
+
Note 1: only applies to specific boards, you need to check if a board has that serial device populated.
  
−
===3) 编译DEMO源代码，并导出apk文件===
+
===Step 3. Compile DEMO's source code and export apk file===
−
在Package Explorer上点击项目名称，保证其处于选中状态:<br />
+
On "Package Explorer" check your project's name:<br />
 
[[File:AndroidHW04.png|500px]]<br />
 
[[File:AndroidHW04.png|500px]]<br />
−
在eclipse菜单File上选择Export...:<br />
+
On eclipse's main menu select "File" and then "Export...":<br />
 
[[File:AndroidHW05.png|500px]]<br />
 
[[File:AndroidHW05.png|500px]]<br />
−
选择Export Android Application:<br />
+
Select "Export Android Application":<br />
 
[[File:AndroidHW06.png|500px]]<br />
 
[[File:AndroidHW06.png|500px]]<br />
−
选择项目SerialPortDemo:<br />
+
Select "SerialPortDemo":<br />
 
[[File:AndroidHW07.png|500px]]<br />
 
[[File:AndroidHW07.png|500px]]<br />
−
这一步，Eclipse要求我们创建或选择自已的签名，这里我们选择Create new keystore, 填写key生成后保存的路径和密码，然后点next:<br />
+
Eclipse requires you to create a new keystore or select an existing keysotre in this step. In this case we selected "Create new keystore", set a path to store the key and created its password and then clicked on "next":<br />
 
[[File:AndroidHW08.png|500px]]<br />
 
[[File:AndroidHW08.png|500px]]<br />
−
继续参考下图完善签名信息，然后点next:<br />
+
Refer to the following screenshot to fill more information and click on "next":<br />
 
[[File:AndroidHW09.png|500px]]<br />
 
[[File:AndroidHW09.png|500px]]<br />
−
接着选择APK文件的保存位置，这里我们选择保存到 signapk-files子目录下，以方便我们稍后要进行的签名操作:<br />
+
Select a path to store your APK file. In this case we set it to a "signapk-files" directory:<br />
 
[[File:AndroidHW10.png|500px]]<br />
 
[[File:AndroidHW10.png|500px]]<br />
−
点Finish完成APK的导出：<br />
+
Click on "Finish" to export an APK file.<br />
 
[[File:AndroidHW11.png|500px]]
 
[[File:AndroidHW11.png|500px]]
 
===4) 使用系统证书对APK进行重新签名===
 
===4) 使用系统证书对APK进行重新签名===

Revision as of 08:23, 18 December 2017

查看中文


1 Introduction

FriendlyElec developed a library called “libfriendlyarm-hardware.so”, for android developer to access the hardware resources on the development board in their android apps, the library is based on Android NDK.

2 Accessible Interfaces & Ports

  • Serial Port
  • PWM
  • EEPROM
  • ADC
  • LED
  • LCD 1602 (I2C)
  • OLED (SPI)

I2C, SPI, GPIO are accessible.

  • Smart4418SDK+OLED
  • NanoPCT3-I2C-LCD1602

3 Available OS & Boards

  • Android 2.3: Mini6410, Tiny6410
  • Android 4.2: Mini210S, Smart210 with SDK, Tiny210 with SDK, Tiny4412 with SDK
  • Android 4.4: NanoPi M2, NanoPi S2, NanoPC-T2, Smart4418 with SDK
  • Android 5: NanoPi M3, NanoPi-T3, Tiny4412 with SDK


4 Code Samples

5 Compile & Deploy Andorid Code (SerialPortDemo)

5.1 Step 1. Import source code in eclipse (SerialPortDemo)

Start eclipse, click on "Import" on its main window's File menu and then select "Existing Android Code Into Workspace" to import your source code
We name this project as "SerialPortDemo"

  • AndroidHW01.png
  • AndroidHW02.png

5.2 Step 2. Edit source code

The names of serial devices this DEMO accesses are listed in this file: src/com/friendlyarm/SerialPortDemo/SerialPortDataProcessView.java
Make changes according to your devices' names:
AndroidHW03.png

5.2.1 Serial Device Names under Multiple Platforms

  • Allwinner H3/H5 Based Boards (NanoPi M1/NanoPi M1 Plus etc)

UART1-> /dev/ttyS1
UART2 -> /dev/ttyS2
UART3 -> /dev/ttyS3 (Only applies to NanoPi M1, NanoPi K1 and NanoPi K1 Plus)

  • S5P4418 Based Boards (NanoPi Fire2A/NanoPi M2A/NanoPi S2/NanoPC-T2 etc)

UART1 -> /dev/ttyAMA1 [Note 1]
UART2 -> /dev/ttyAMA2 [Note 1]
UART3 -> /dev/ttyAMA3
UART4 -> /dev/ttyAMA4

  • S5P6818 Based Boards (NanoPi M3/NanoPC-T3 etc)

UART1 -> /dev/ttySAC1 [Note 1]
UART2 -> /dev/ttySAC2 [Note 1]
UART3 -> /dev/ttySAC3
UART4 -> /dev/ttySAC4

Note 1: only applies to specific boards, you need to check if a board has that serial device populated.

5.3 Step 3. Compile DEMO's source code and export apk file

On "Package Explorer" check your project's name:
AndroidHW04.png
On eclipse's main menu select "File" and then "Export...":
AndroidHW05.png
Select "Export Android Application":
AndroidHW06.png
Select "SerialPortDemo":
AndroidHW07.png
Eclipse requires you to create a new keystore or select an existing keysotre in this step. In this case we selected "Create new keystore", set a path to store the key and created its password and then clicked on "next":
AndroidHW08.png
Refer to the following screenshot to fill more information and click on "next":
AndroidHW09.png
Select a path to store your APK file. In this case we set it to a "signapk-files" directory:
AndroidHW10.png
Click on "Finish" to export an APK file.
AndroidHW11.png

5.4 4) 使用系统证书对APK进行重新签名

因为访问硬件需要APK有system权限，所以需要使用系统证对APK进行重新签名，
在命令行下进入signapk-files子目录，然后执行以下命令签名即可： 

cd signapk-files/
java -jar ./signapk.jar platform.x509.pem platform.pk8 ./SerialPortDemo.apk SerialPortDemo-Signed.apk

其中，signapk.jar以及签名文件platform.x509.pem和platform.pk8可在开发板资源下载目录的android-platform-key-files目录下找到。

5.5 5) 运行与调试

5.1) 安装APK，用microUSB线将电脑与开发板连接，用adb命令安装SerialPortDemo-Signed.apk： 

adb install SerialPortDemo-Signed.apk

5.2) 调试： 运行 SerialPortDemo后，在adb shell命令行模式下执行： 

ps -Z

然后找到com.friendlyarm.SerialPortDemo这个进程，如果前面的权限是如下所示，表明程序已经获得了 system 权限: 

u:r:system_app:s0              system    1610  112   com.friendlyarm.SerialPortDemo

以上是Android4的，如果是Android5，则略有不同，不过都表示已经是 system 权限: 

u:r:platform_app:s0            u0_a60    1905  138   com.friendlyarm.SerialPortDemo

如果程序没有获得 system 权限，则打开串口设备会失败。

6 Resources

7 Update Log

7.1 March-2-2017

  • Released English version
Retrieved from "https://wiki.friendlyelec.com/wiki/index.php?title=Android_Thing:_Android_Hardware_Programming&oldid=12544"