8,460
个编辑
更改
创建页面，内容为“== 介绍 == === 什么是 Orange Pi 3G-IoT === 香橙派是一款开源的单板电脑，新一代的 ARM 开发板，它可以运行 Android4.4、Linux等操作系…”
== 介绍 ==
=== 什么是 Orange Pi 3G-IoT ===
香橙派是一款开源的单板电脑，新一代的 ARM 开发板，它可以运行 Android4.4、Linux等操作系统。香橙派开发板（Orange Pi 3G-IOT）使用MTK系列MT6572 CPU。<br>
=== Orange Pi 3G-IoT 的用途 ===
我们可以用它搭建：<br>
* 一台计算机
* 一个无线网络服务器
* 游戏机
* 音乐播放器
* 高清视频播放器
* 扬声器
* Android <br><br>
当然还有其他更多的功能，因为Orange Pi 3G-IoT是开源的<br>
=== Orange Pi 3G-IoT 是为谁设计的 ===
Orange Pi 3G-IOT 不仅仅是一款消费品，同时也是给任何想用技术进行创作创新的人设计的。它是一款非常简单、有趣、实用的工具，你可以用它去打造你身边的世界。<br>
=== Orange Pi 3G-IoT 的硬件特性 ===
<br>
<table border="1" bordercolor="#d8d8d8" cellspacing="0" cellpadding="0" style="width:800px; line-height:20px;">
<tr>
<td style="padding:10px 0">主控芯片</td>
<td style="padding:10px 0"><p >MT6572</p></td>
</tr>
<tr>
<td style="padding:10px 0">处理器</td>
<td style="padding:10px 0"><p >双核ARM® Cortex-A7，主频高达 1.2GHz</p></td>
</tr>
<tr>
<td style="padding:10px 0">图形处理器</td>
<td style="padding:10px 0"><p >ARM Mali-400</p></td>
</tr>
<tr>
<td style="padding:10px 0">内存+存储</td>
<td style="padding:10px 0">版本A：256MB DDR2+512MB EMMC Flash<br>版本B：512MB DDR2+4GB EMMC Flash</td>
</tr>
<tr>
<td style="padding:10px 0">无线网络</td>
<td style="padding:10px 0">WIFI / BT / FM / GPS 四合一</td>
</tr>
<tr>
<td rowspan="4">
<div style="display: flex;align-items: center;">
<div class="td-left" style="flex: 1;">射频频率</div>
<div class="td-right" style="flex: 1; border-left: 1px solid #000;">
<p style="border-bottom: 1px solid #000;padding:10px 0">GSM</p>
<p style="border-bottom: 1px solid #000;padding:10px 0">WCDMA</p>
<p style="border-bottom: 1px solid #000;padding:10px 0">TD-CDMA</p>
<p style="border-bottom: 1px solid #000;padding:8px 0">CDMA2000</p>
</div>
</div>
</td>
<td style="padding:5px 0">850/900/1800/1900</td>
</tr>
<tr>
<td style="padding:5px 0">B1+B2+B5+B8</td>
</tr>
<tr>
<td style="padding:5px 0">/</td>
</tr>
<tr>
<td style="padding:5px 0">/</td>
</tr>
<tr>
<td style="padding:10px 0">显示屏</td>
<td style="padding:10px 0"><p >FWVGA(FPC 转接到小板 zif)</p></td>
</tr>
<tr>
<td style="padding:10px 0">电容触摸</td>
<td style="padding:10px 0"><p >支持(FPC 转接到小板 共用屏 zif)</p></td>
</tr>
<tr>
<td style="padding:10px 0">摄像头</td>
<td style="padding:10px 0"><p >MIPI 接口</p></td>
</tr>
<tr>
<td style="padding:10px 0">SIM卡</td>
<td style="padding:10px 0">mini单SIM卡</td>
</tr>
<tr>
<td style="padding:10px 0">TF卡</td>
<td style="padding:10px 0">支持热插拔</td>
</tr>
<tr>
<td rowspan="2">
<div style="display: flex;align-items: center;">
<div class="td-left" style="flex: 1;">音频</div>
<div class="td-right" style="flex: 1; border-left: 1px solid #000;">
<p style="border-bottom: 1px solid #000;padding:10px 0;">耳机</p>
<p style="padding:10px 0">麦克风</p>
</div>
</div>
</td>
<td style="padding:10px 0">用于音频输入/输出</td>
</tr>
<tr>
<td style="padding:10px 0">用于音频输入</td>
</tr>
<tr>
<td style="padding:10px 0">USB</td>
<td style="padding:10px 0">USB Host*1, Micro USB*1</td>
</tr>
<tr>
<td style="padding:10px 0">LED 信号灯</td>
<td style="padding:10px 0">USB Host*1, Micro USB*1</td>
</tr>
<tr>
<td style="padding:10px 0">按键</td>
<td style="padding:10px 0">电源键(SW602)</td>
</tr>
<tr>
<td style="padding:10px 0">Low-level peripherals</td>
<td style="padding:10px 0">40pin 扩展口：GPIO 1.8V； 1 组SPI； 2 组 I2C； 2 组Uart； 16 个gpio</td>
</tr>
<tr>
<td style="padding:10px 0">电源</td>
<td style="padding:10px 0">Micro USB(5V 2A) 通过焊盘连接</td>
</tr>
<tr>
<td style="padding:10px 0">系统</td>
<td style="padding:10px 0">Android 4.4</td>
</tr>
<tr>
<td style="padding:10px 0">编程语言支持</td>
<td style="padding:10px 0">C、C++、Kotlin、Java、Shell、Pyhon 等</td>
</tr>
<tr>
<td colspan="2">外观规格</td>
</tr>
<tr>
<td>PCB 尺寸</td>
<td>52.4mm*68.8mm</td>
</tr>
<tr>
<td>重量</td>
<td>24g</td>
</tr>
<tr>
<td colspan="2" style="padding:10px 0;">Orange Pi™ 是深圳市迅龙软件有限公司的注册商标</td>
</tr>
</table>
<br><br>
<big>'''256MB DDR2 + 512MB EMMC规格接口详情视图：'''</big><br><br>
[[Image:3G-iot-1.png]]<br><br>
[[Image:3G-iot-2.png]]<br><br>
<big>'''512MB DDR2 + 4GB EMMC规格接口详情视图：'''</big><br><br>
[[Image:3G-iot-3.png]]<br><br>
[[Image:3G-iot-4.png]]<br><br>
=== GPIO 规格 ===
<br>
<div class="table-3g-iot">
<table style="width: 800px; line-height:35px; text-align:center; border-color:#CCCCCC;" border="1" bordercolor="#d8d8d8" cellspacing="0" cellpadding="0">
<tr>
<td width="119" style="font-weight:700;">PIN1</td>
<td width="216">VIO28 PMU</td>
<td width="68" style="font-weight:700;"> </td>
<td width="166" style="font-weight:700;">PIN21</td>
<td width="219">GPIO24</td>
</tr>
<tr>
<td style="font-weight:700;">PIN2</td>
<td>DC5V</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN22</td>
<td>GPIO109</td>
</tr>
<tr>
<td style="font-weight:700;">PIN3</td>
<td>SDA_1</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN23</td>
<td>GPIO25</td>
</tr>
<tr>
<td style="font-weight:700;">PIN4</td>
<td>DC5V</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN24</td>
<td>GPIO139</td>
</tr>
<tr>
<td style="font-weight:700;">PIN5</td>
<td>SCL_1</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN25</td>
<td>GND</td>
</tr>
<tr>
<td style="font-weight:700;">PIN6</td>
<td>GND</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN26</td>
<td>EINT0/GPIO30/PWM B</td>
</tr>
<tr>
<td style="font-weight:700;">PIN7</td>
<td>EINT4/GPIO26</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN27</td>
<td>SDA_0</td>
</tr>
<tr>
<td style="font-weight:700;">PIN8</td>
<td>UTXD2</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN28</td>
<td>SCL_0</td>
</tr>
<tr>
<td style="font-weight:700;">PIN9</td>
<td>GND</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN29</td>
<td>SPI_CS</td>
</tr>
<tr>
<td style="font-weight:700;">PIN10</td>
<td>URXD2</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN30</td>
<td>GND</td>
</tr>
<tr>
<td style="font-weight:700;">PIN11</td>
<td>URXD1</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN31</td>
<td>SPI_CK</td>
</tr>
<tr>
<td style="font-weight:700;">PIN12</td>
<td>EINT10/GPIO56</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN32</td>
<td>EINT15/GPIO90</td>
</tr>
<tr>
<td style="font-weight:700;">PIN13</td>
<td>UTXD1</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN33</td>
<td>SPI_MO</td>
</tr>
<tr>
<td style="font-weight:700;">PIN14</td>
<td>GND</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN34</td>
<td>GND</td>
</tr>
<tr>
<td style="font-weight:700;">PIN15</td>
<td>EINT2/GPIO128/PW A</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN35</td>
<td>SPI_MI</td>
</tr>
<tr>
<td style="font-weight:700;">PIN16</td>
<td>EINT12/GPIO58</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN36</td>
<td>GPIO145/PWMBL</td>
</tr>
<tr>
<td style="font-weight:700;">PIN17</td>
<td>VIO28 PMU</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN37</td>
<td>EINT3/GPIO27</td>
</tr>
<tr>
<td style="font-weight:700;">PIN18</td>
<td>EINT14/GPIO89</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN38</td>
<td>EINT5/GPIO144/PWM B</td>
</tr>
<tr>
<td style="font-weight:700;">PIN19</td>
<td>GPIO140</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN39</td>
<td>GND</td>
</tr>
<tr>
<td style="font-weight:700;">PIN20</td>
<td>GND</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN40</td>
<td>GPIO141</td>
</tr>
</table>
</div>
<br>
== 快速入门 ==
=== 准备硬件与软件工具 ===
硬件需求：<br>
* Orange Pi 3G-IoT 开发板<br>
* 一台编译用的主机，配置最好满足以下条件：<br>
64 位 CPU<br>
16GB 内存<br>
40GB 以上的空闲磁盘空间<br>
操作系统为 Ubuntu12.04 以上，最好为 Ubuntu14.04<br>
更详细的内容可以参考 Google 文档 https://source.android.com/source/building<br><br>
软件需求：<br>
* Orange Pi 3G-IoT SDK<br>
* Orange Pi 3G-IoT 固件<br>
* Android 烧录工具<br>
以上软件均可以通过 Mega、百度云盘 的方式获取，详情参见中英文官网：<br>
http://www.orangepi.org/downloadresources/<br>
http://www.orangepi.cn/downloadresourcescn/<br><br>
=== 开发板的供电方式 ===
开发板的供电方式有两种：<br>
* Micro USB（5V 2A）供电：插入 Micro USB 适配器后即可开机。<br>
* 电池供电：常用 4.2V 电池，在背面有预留外接电池焊盘点 需要客户自己焊接, 接上电池之后按开机键即可启动。<br>
=== 拆包说明 ===
收到产品后请将产品的天线从图 1 的位置放到图 2 的位置（或者放到板子外面的位置），不能贴在板子上面以免影响信号。<br><br>
[[Image:3G-iot-5.png]]<br><br>
== Android 编译环境搭建 ==
=== 获取 SDK 源码压缩包 ===
为方便客户快速进行开发，OrangePi 有提供不同版本的 SDK 初始压缩包。下载压缩包，分别对应 OrangePi_3G-IoT_Android4.4.tar.gz00, OrangePi_3G-IoT_Android4.4.tar.gz01, <br>
...OrangePi_3G-IoT_Android4.4.tar.gz00 总共8 个分卷压缩包。获取到分卷压缩包后，把所有的压缩包放在一个同一目录下，如：<br>
创建目录<br>
mkdir OrangePi_3G-IOT_Android4.4<br>
拷贝分卷压缩包<br>
cp -rf OrangePi_3G-IoT_Android4.4.tar.gz* OrangePi_3G-IOT_Android4.4/ <br>
合并压缩包<br>
cat OrangePi_3G-IoT_Android4.4.tar.gz*>OrangePi_3G-IOT_Android4.4.tar.gz <br>
解压<br>
tar xzvf OrangePi_3G-IOT_Android4.4.tar.gz
=== 搭建编译环境 ===
可以参考 Google 官方文档： http://source.android.com/source/initializing.html<br>
* '''安装 JDK'''
Android4.4 系统编译依赖于 JAVA6。编译前需要安装 OpenJDK，gcc4.4 版本安装命令如下。<br>
sudo apt-get install openjdk-6-jdk sudo apt-get install gcc-4.4<br>
配置 JAVA 环境变量，比如安装路径为 /usr/lib/jvm/jdk1.6.0_31<br>
可以在终端执行如下命令配置环境变量。<br>
export JAVA_HOME=/usr/lib/jvm/jdk1.6.0_31<br>
export PATH=$JAVA_HOME/bin:$PATH<br>
export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar
* '''安装软件包'''<br>
对于 Ubuntu12.04：<br>
sudo apt-get update<br>
sudo apt-get install git-core gnupg flex bison ccache gperf libsdl1.2-dev libesd0-dev<br>
libwxgtk2.6-dev build-essential zip curl libncurses5-dev zlib1g-dev valgrind libc6-dev lib32ncurses5-dev x11proto-core-dev<br>
libx11-dev lib32readline-gplv2-dev lib32z1-dev libgl1-mesa-dev gcc-4.4<br>
g++-4.4 g++-4.4-multilib g++-multilib mingw32 tofrodos python-markdown libxml2-utils xsltproc wine
对于 Ubuntu14.04：<br>
sudo apt-get update<br>
sudo apt-get install git-core gnupg flex bison ccache gperf libsdl1.2-dev libesd0-dev<br>
libwxgtk2.8-dev build-essential zip curl libncurses5-dev zlib1g-dev valgrind libc6-dev lib32ncurses5-dev x11proto-core-dev<br>
libx11-dev lib32readline-gplv2-dev lib32z1-dev libgl1-mesa-dev g++-multilib g++-4.8-multilib mingw32 tofrodos python-markdown<br>
libxml2-utils xsltproc libc6-dev-i386 lib32z1 lib32ncurses5 lib32bz2-1.0 lib32readline-gplv2-dev wine
至此，我们可以开始进行 SDK 源码的编译。<br><br>
=== 编译 SDK 源码 ===
<big>'''全部编译'''</big><br>
为方便客户进行开发，Orange Pi 提供了一系列的编译脚本。<br>
目录为 SDK/code/orangepi/scripts<br>
$ cd code/orangepi/scripts<br>
$ ls anr_LM.sh auto.sh clean.sh codegen.sh init_project.sh tar_img.sh
auto.sh 为自动编译脚本<br>
clean.sh 为自动清除编译结果脚本<br>
tar_img.sh 为打包脚本<br><br>
在 code/orangepi/scripts 目录下，我们执行自动编译脚本：<br>
板子是：32g4g
$ ./auto.sh IoT03_mt6572_emmc_b1258_32g4g_ry_smt_v1.1 v00 eng<br>
板子是：4g2g
$ ./auto.sh IoT03L_mt6572_lca_b1258_wg_4g2g_ry_smt_v1.1 v00 eng
传入的三个参数含义如下：<br>
#$1 project_info [eg: IoT03L_mt6572_lca_b1258_wg_4g2g_ry_smt_v1.1]<br>
#$2 version_info [eg: v00 v01 ...]<br>
#$3 compile_mode [eng:user userdebug eng]<br>
auto.sh带的三个参数含义，在脚本开头部分有详细说明。<br><br>
<big>'''模块编译'''</big><br>
最常用的修改了kernel部分的文件，可以采用如下命令：<br>
./mk -o=TARGET_BUILD_VARIANT=[user/userdebug/eng] projName n K && ./mk -o=TARGET_BUILD_VARIANT=[user/userdebug/eng] projName r bootimage<br><br>
比如：工程是 hexing72_cwet_kk<br>
{| class="wikitable" style="width:800px;"
|-
| ./mk -o=TARGET_BUILD_VARIANT=eng || hexing72_cwet_kk || n k &&
|-
| ./mk -o=TARGET_BUILD_VARIANT=eng || hexing72_cwet_kk || r bootimage
|}
<br>
其中驱动部分修改编译，详细可以参考文档：MT6592_Driver_All_In_One_Part.pdf<br><br>
== Android 固件烧录 ==
'''Orange Pi 3G-IoT 开发板''' <br><br>
烧录相关按键与接口如下：<br><br>
[[Image:3G-iot-6.png]]<br><br>
编译完成后固件将汇总在code/IoT03_b1258_32g4g_ry_smt_v1.1或code/IoT03L_b1258_wg_4g2g_ry_smt_v1.1 目录中，<br>
并打包形如 IoT03L_b1258_wg_4g2g_ry_smt_v1.1_20180403182516_v00_eng.zip 名字的压缩包。<br><br>
<div style="background:#f1f1f1;border:1px solid #ddd;padding:5px;width:800px; ">
IoT03L_b1258_wg_4g2g_ry_smt_v1.1<br>
├── images<br>
│ ├── boot.img<br>
│ ├── lk.bin<br>
│ ├── logo.bin<br>
│ ├── MT6572_Android_scatter.txt<br>
│ ├── preloader_hexing72_cwet_lca.bin<br>
│ ├── ramdisk.img<br>
│ ├── ramdisk-recovery.img<br>
│ ├── recovery.img<br>
│ ├── secro.img<br>
│ ├── system.img<br>
│ └── userdata.img<br>
└── modem<br>
├── APDB_MT6572_S01_MAIN2.1_W10.24<br>
├── _APDB_MT6572_S01_MAIN2.1_W10.24.check<br>
├── APDB_MT6572_S01_MAIN2.1_W10.24_ENUM<br>
├── BPLGUInfoCustomAppSrcP_MT6572_S00_MOLY_WR8_W1315_MD_WG_MP_V47_1_wg_n<br>
├── catcher_filter_1_wg_n.bin<br>
├── DbgInfo_WR8.W1315.MD.WG.MP_HEXING72_CWET_KK_HSPA_MOLY_WR8_W1315_MD_WG_MP
_V47_2017_10_26_22_35_1_wg_n<br>
├── modem_1_wg_n.img<br>
└── modem_1_wg_n.mak
<br></div><br><br>
此后，请参照执行完 《OrangePi 3G-IoT Android 固件烧录指南》完成固件的烧录。<br>
我们提供已经编译且打包好的镜像分区文件，请根据自身的需求自行下载：<br>
http://www.orangepi.cn<br>
通过如下命令进行Android 4.4 镜像解压<br>
$ rar x IoT03L_b1258_wg_4g2g_ry_smt_v1.1.rar<br>
即可得到上文中固件清单中的文件。或者也可以参照Android 环境搭建及固件编译部分自行编译。<br>
<big>'''主机操作系统支持：'''</big><br>
* Windows 10<br>
* Windows 7 (32/64 位)<br>
* Windows 8 (32/64 位)<br>
* Ubuntu10.04 / 12.04 / 14.04 (32/64 位)<br>
=== 烧录工具介绍 ===
烧录工具为 '''Smart Phone Flash Tool'''请前往 OrangePi官方网站中 3G-IoT 版块下载。<br><br>
本工具有 Windows 和 Linux 版。请根据自己的主机环境选取合适的版本。界面如下：<br><br>
[[Image:4G-Iot-5.png]]<br><br>
Windows 和 Linux 版的使用方法完全一样。本手册将以 Linux 版为例进行烧录说明。<br>
=== 镜像烧录方法 ===
{| class="wikitable" style="width:800px;"
|-
|连不上电脑，则需要：<br>
$sudo apt-get remove modemmanager<br>
$sudo /etc/init.d/udev retstart<br>
然后重启电脑<br><br>
Window 下根据相应的系统下载 MTK 驱动<br>
解压 Driver_Auto_Installer_EXE_v5.1453.03.rar<br>
然后安装。
|}
<br>
* <big>'''解压并打开烧录工具'''</big><br>
{| class="wikitable" style="width:800px;"
|-
|$ unzip SP_Flash_Tool_v5.1644_Linux.zip<br>
$ cd SP_Flash_Tool_v5.1644_Linux<br>
$ sudo ./flash_tool.sh
|}
<br>
如果你是第一次打开软件，可能会出现 警告显示 scatter file 文件未找到 ：<br>
[[Image:3G-iot-7.png]]<br><br>
这是正常的。后面我们将手动指定 Scatter File 的路径。点击 OK 后我们进入软件。<br><br>
* <big>'''进入烧录模式'''</big><br>
a.首先切换到 Download 标签页，显示如下：
[[Image:3G-iot-8.png]]<br><br>
b.我们点击 Scatter-loading File 一栏的最右侧的 choose并且选择 Scatter File 的路径，如下图
[[Image:3G-iot-9.png]]<br><br>
c.双击选择后，在下面的'''分区信息显示部分'''将会自动填充各个分区文件所在的路径，以及他们将要被烧录的绝对起始地址，如下图:
[[Image:3G-iot-10.png]]<br><br>
d.在分区信息显示部分的左上角有一个下拉菜单其中有三个选项<br>
Format All + Download //擦除机器内的全部分区信息，并且重新下载选中分区<br>
Firmware Upgrade //更新选中分区中有差异的部分<br>
Download Only //无论是否有差异都重新下载
<span style="color:red;">注意</span>，一般情况下固件更新只需要选择 Firmware Upgrade，<span style="color:red;">切勿选择</span> Format All +Download。<br>
因为我们的每台机器在出厂的时候都有针对于进行各项参数的校准，在 Format All后会丢失校准信息。<br>
如果不慎出现此情况请联系售后并根据指导通过机器码获取校准参数，并按照《4G-IOT 校准参数导入导出工具和说明》重新烧录校准参数。<br>
e.戴上跳线帽，具体如下图所示：<br>
[[Image:3G-iot-11.png]]<br><br>
f.接下来使用 USB 下载线，连接主机的 USB 与机器的 MircoUSB 接口。右上角红灯亮点击 Download 按钮进行下载 [[Image:4G-Iot-34.png]]<br>
g.下载完成后界面如下
[[Image:4G-Iot-35.png]]<br>
h.拔掉USB线。插上 Mirco USB 电源。。
等待5秒将会显示关机充电界面。<br>
长按Power按键5秒后松开，会开机进入系统。<br>
当更新的分区比较多时，第一次开机也会时间稍长（全分区更新的情况开机需要8min），请耐心等待。<br><br>
Window 系统需要下载 SP_Flash_Tool_v5.1644_Win.zip，然后解压安装，就可以烧录固件了。操作方法和 Linux 的一样。<br><br>
== linux 编译环境搭建 ==
=== 获取linux 源码 ===
* <big>'''OrangePi 源码下载器'''</big><br>
$ sudo apt-get install git<br>
$ git clone https://github.com/orangepi-xunlong/OrangePi_Build.git<br>
$ cd OrangePi_Build<br>
$ ls<br>
Build_OrangePi.sh lib README.md
<br>
* <big>'''运行下载器'''</big><br>
$ ./Build_OrangePi.sh
输入 root 密码,然后回车<br>
[[Image:4G-Iot-52.png]]<br><br>
选择 0 Build system with kernel/uboot/rootfs,进入开发板型号选择界面。<br>
[[Image:4G-Iot-53.png]]<br><br>
选择 22 orangepi 3G-iot，回车后将会开始下载 Orange Pi 3G-iot 的 Linux 源码<br>
[[Image:3G-iot-13.png]]<br><br>
下载的源码会存放在 OrangePi_Build 的同级目录下。<br><br>
OrangePi 3G-IoT 的 Linux 源码目录结构如下所示<br>
<div style="background:#f1f1f1;border:1px solid #ddd;padding:5px; width:800px;">
├── bootloader<br>
├── build.sh -> scripts/build.sh 编译启动脚本<br>
├── external <br>
├── kernel<br>
├── output<br>
├── scripts<br>
└── toolchain<br>
<br>6 directories, 1 file
</div>
<br>
=== 编译linux 源码 ===
* <big>'''执行编译启动脚本'''</big><br>
$ cd OrangePi3G-iot
$ ./build.sh
根据板子型号选择并回车<br><br>
[[Image:3G-iot-14.png]]<br><br>
输入 root 密码并回车,然后选择需要执行的功能<br><br>
[[Image:4G-Iot-39.png]]<br><br>
[[Image:4G-Iot-40.png]]<br><br>
其中各选项的功能如下：<br>
* '''0 Build Release Image 编译 ubuntu 和 debian 发行版'''
* '''1 Build Rootfs 编译 Rootfs'''
* '''2 Build Uboot 编译 preloader 和 lk'''
* '''3 Build Linux 编译内核源码'''<br>
以 A 板为例，选择 0 Build Release Image，会生成以下完整的固件包<br><br>
<div style="background:#f1f1f1;border:1px solid #ddd;padding:5px;width:800px;">
output/images/<br>
├── OrangePi_3g-iot-A_ubuntu_xenial_server_linux3.4.67_v1.1<br>
│ ├── boot.img<br>
│ ├── boot_nand.img<br>
│ ├── boot_sd.img<br>
│ ├── lk.bin<br>
│ ├── logo.bin<br>
│ ├── MT6572_Android_scatter.txt<br>
│ ├── preloader_hexing72_cwet_lca.bin<br>
│ ├── rootfs.img<br>
└── OrangePi_3g-iot-A_ubuntu_xenial_server_linux3.4.67_v1.1.tar.gz<br>
<br>
</div>
<br>
== Linux 系统的烧录 ==
目前 Linux 系统不支持 modem、LCD 屏。<br>
只能通过串口登录系统，连接 wifi 后，可通过 ssh 登录。<br>
烧录系统时，跳线帽接法如下。<br>
[[Image:3G-iot-16.png]]<br><br>
=== 3G-IoT-A 的linux 固件烧录 ===
通过烧录工具把 preloader、lk、boot.img 烧录到板载 nand flash 上。<br>
<div style="border:1px solid #dddddd;background:#f1f1f1;padding:5px;">
├── boot.img<br>
├── boot_nand.img<br>
├── boot_sd.img<br>
├── lk.bin<br>
├── logo.bin<br>
├── MT6572_Android_scatter.txt<br>
├── preloader_hexing72_cwet_lca.bin<br>
└── rootfs.img
</div><br><br>
前面的《安卓固件烧录》已经介绍了如何使用烧录工具了，这里不再赘述，直接打开烧录工具。<br>
a.我们点击Scatter-loading File一栏的最右侧的choose并且选择Scatter File的路径，如下图
[[Image:3G-iot-17.png]]<br><br>
b.先断开板子与 PC 的连接，点击 Download 按钮
[[Image:3G-iot-18.png]]<br><br>
c.接下来使用 USB 下载线，连接主机的 USB 与机器的 MircoUSB 接口。
[[Image:3G-iot-19.png]]<br><br>
d.前面仅烧录了lk 和 kernel，由于 3G-iot-A 只有 512M 的板载存储，存在空间不足的问题，所以需要把 rootfs 烧录到 TF 卡上，准备一张 8G 以上，class10 的 TF 卡。格式化后。按照以下方法烧录 roofs.img<br>
pv rootfs.img | sudo dd of=/dev/sdb bs=1M
sdb 是 TF 卡对应的设备文件<br>
如果是在 windows 系统，也可以用 Win32DiskImager 软件烧录。<br>
e.将 tf 卡插入板子，上电即可启动。
[[Image:3G-iot-20.png]]<br><br>
=== 3G- IoT -B 的 linux 固件烧录 ===
该板子有 4G 的板载存储，所以可以直接将所有镜像烧到板载 EMMC 上。<br><br>
a.我们点击 Scatter-loading File 一栏的最右侧的 choose 并且选择 Scatter File 的路径，如下图
[[Image:3G-iot-21.png]]<br><br>
b.先断开板子与 PC 的连接，点击 Download 按钮
[[Image:3G-iot-22.png]]<br><br>
c.接下来使用 USB 下载线，连接主机的 USB 与机器的 MircoUSB 接口。烧录完成
[[Image:3G-iot-23.png]]<br><br>
d.启动系统。 将板子连接 5V2A 的电源适配器。连接串口可以看到系统启动。
[[Image:3G-iot-24.png]]<br><br>
'''如果板载空间不够，可以将 rootfs 烧录到 TF 卡上。步骤如下。'''
a.烧录支持挂载 TF 卡 rootfs 的 boot.img
点击下图框中内容<br><br>
[[Image:3G-iot-25.png]]<br><br>
弹出窗口选择 boot_sd.img。<br><br>
[[Image:3G-iot-26.png]]<br><br>
下载完成<br>
[[Image:3G-iot-27.png]]<br><br>
b.烧录 rootfs 到 TF 卡中
准备一张 8G 以上，class10 的 TF 卡。格式化后。按照以下方法烧录 roofs.img<br>
pv rootfs.img | sudo dd of=/dev/sdb bs=1M
sdb 是 TF 卡对应的设备文件<br>
如果是在 windows 系统，也可以用 Win32DiskImager 软件烧录。<br>
c.启动系统
将 tf 卡插入板子，上电即可启动。<br><br>
== 串口调试工具 ==
首先需要准备一根 USB 转 TTL 串口线，需要支持 921600 波特率。3G-iot 的调试串口为串口 1，已引出到 40pin，波特率为 921600 。按下图接好串口线，不同颜色的线对应的功能如下:<br>
* 黑色——GND
* 绿色——RX
* 白色——TX
[[Image:3G-iot-15.png]]<br><br>
=== 基于Windows 平台的使用 ===
在使用 OrangePi 做项目开发过程中,为了获得更多的调试信息,OrangePi 默认支持串口信息调试。对于开发者而言,只需准备上面提到的材料,即可简单的获得串口调试信息。<br>
不同的上位机使用的串口调试工具大同小异,基本可以参考下文的方法进行部署。使用 Windows 平台进行串口调试的工具很多,通常使用的工具是putty。本节以 putty 作为例子进行部署讲解。<br><br>
* <big>'''安装 USB 驱动'''</big><br>
下载最新版的驱动 PL2303_Prolific_DriverInstaller_v130.zip,下载解压<br><br>
[[Image:4G-Iot-45.png]]<br><br>
以管理员身份选择应用程序安装<br><br>
[[Image:4G-Iot-46.png]]<br><br>
等待安装完成<br><br>
[[Image:4G-Iot-47.png]]<br><br>
* <big>'''下载安装 Putty'''</big><br>
Putty 可从下面的地址下载,请选择适合自己开发环境的版本。<br>
https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
直接双击下载的 putty.exe 即可打开 putty,软件界面如下图所示。<br>
[[Image:4G-Iot-48.png]]<br><br>
* <big>'''设备信息的获取'''</big><br>
在 Windows7 中,我们可以通过设备管理器查看串口连接是否正常以及串口的设备号。如果设备没有正常识别,请检查驱动是否安装成功。<br>
如果驱动安装有问题, 可以尝试使用 360 驱动大师扫描安装驱动。<br>
[[Image:4G-Iot-49.png]]<br><br>
* <big>'''Putty配置'''</big><br>
串行口设置成相应的端口号(COM4),关闭流控,速度设置成 921600<br><br>
[[Image:4G-Iot-50.png]]<br><br>
* <big>'''启动调试串口输出'''</big><br>
OrangePi上电开机,putty将会自动打印串口log信息<br>
=== 基于 Linux 平台的使用 ===
在 Linux 平台使用 putty 和 Windows 平台区别不太,下面主要说明有差异地方的操作步骤。所有操作都是基于 Ubuntu 14.04 系统。<br><br>
* <big>'''安装并启动 Putty'''</big><br>
$ sudo apt-get install putty<br>$ sudo putty
* <big>'''配置 Putty'''</big><br>
串口号可以通过 ls '''/dev/ttyUSB*''' 查看波特率需要设置为 921600 并且关闭流控<br><br>
[[Image:4G-Iot-51.png]]<br><br>
== 其他设置 ==
=== 连接wifi 上网 ===
配置无线,首先要知道 ssid 和 psk(账号,密码),输入对应的 wlan*,ssid,psk <br>
$ sudo vi /etc/network/interfaces (添加如下内容)<br><br>
auto wlan0<br>
iface wlan0 inet dhcp wpa-ssid xxxx<br>
wpa-psk xxxx<br>
之后执行/etc/init.d/networking restart,无线即可连接上<br><br>
=== GPIO 操作 ===
<br>
MTK 用 ADB 修改和显示 GPIO 状态<br>
获取 GPIO 的状态， cat /sys/devices/virtual/misc/mtgpio/pin<br>
在 adb 下面直接执行 cat /sys/devices/virtual/misc/mtgpio/pin 命令则显示： pin: [mode] [pull_sel] [din] [dout] [pull en] [dir] [ies] [smt] <br>
0:11101010<br>
1:01101010<br>
、、、、、、<br>
22:1-100-10-1-1<br>
、、、、、、、<br>
42：00000110<br><br>
每行分别对应：<br>
IO 编号：模式，输入上拉选择，输入值，输出值，输入上拉使能，方向 direction， 输入翻转<br><br>
修改 GPIO 的状态：<br><br>
40pin GPIO 口，可通过原理图或手册获取，如 40pin 的第 37 个 pin 脚是 GPIO123, <br>
echo -wdout123 1 > pin 即设置该 GPIO 输出高电平<br>
echo -wdout123 0> pin 即设置该 GPIO 输出低电平<br><br>
== 版本历史 ==
{| class="wikitable" style="width:800px;"
|-
! 版本 !! 日期 !! 作者 !! 摘要 !! 发布 !! 备忘录
|-
| 1.1 || 2018-05-25 || 潘明敏 || 创建文档 || 2018-6-14 ||
|-
| 1.2 || 2018-10-18 || 潘明敏 || GPIO 调试 || 2018-10-19 ||
|-
| 1.4 || 2019-04-15 || Csy || Linux 源码编译及串口调试 || ||
|-
| 1.5 || 2020-3-18 || Csy || Linux 固件烧录 || ||
|}
=== 什么是 Orange Pi 3G-IoT ===
香橙派是一款开源的单板电脑，新一代的 ARM 开发板，它可以运行 Android4.4、Linux等操作系统。香橙派开发板（Orange Pi 3G-IOT）使用MTK系列MT6572 CPU。<br>
=== Orange Pi 3G-IoT 的用途 ===
我们可以用它搭建：<br>
* 一台计算机
* 一个无线网络服务器
* 游戏机
* 音乐播放器
* 高清视频播放器
* 扬声器
* Android <br><br>
当然还有其他更多的功能，因为Orange Pi 3G-IoT是开源的<br>
=== Orange Pi 3G-IoT 是为谁设计的 ===
Orange Pi 3G-IOT 不仅仅是一款消费品，同时也是给任何想用技术进行创作创新的人设计的。它是一款非常简单、有趣、实用的工具，你可以用它去打造你身边的世界。<br>
=== Orange Pi 3G-IoT 的硬件特性 ===
<br>
<table border="1" bordercolor="#d8d8d8" cellspacing="0" cellpadding="0" style="width:800px; line-height:20px;">
<tr>
<td style="padding:10px 0">主控芯片</td>
<td style="padding:10px 0"><p >MT6572</p></td>
</tr>
<tr>
<td style="padding:10px 0">处理器</td>
<td style="padding:10px 0"><p >双核ARM® Cortex-A7，主频高达 1.2GHz</p></td>
</tr>
<tr>
<td style="padding:10px 0">图形处理器</td>
<td style="padding:10px 0"><p >ARM Mali-400</p></td>
</tr>
<tr>
<td style="padding:10px 0">内存+存储</td>
<td style="padding:10px 0">版本A：256MB DDR2+512MB EMMC Flash<br>版本B：512MB DDR2+4GB EMMC Flash</td>
</tr>
<tr>
<td style="padding:10px 0">无线网络</td>
<td style="padding:10px 0">WIFI / BT / FM / GPS 四合一</td>
</tr>
<tr>
<td rowspan="4">
<div style="display: flex;align-items: center;">
<div class="td-left" style="flex: 1;">射频频率</div>
<div class="td-right" style="flex: 1; border-left: 1px solid #000;">
<p style="border-bottom: 1px solid #000;padding:10px 0">GSM</p>
<p style="border-bottom: 1px solid #000;padding:10px 0">WCDMA</p>
<p style="border-bottom: 1px solid #000;padding:10px 0">TD-CDMA</p>
<p style="border-bottom: 1px solid #000;padding:8px 0">CDMA2000</p>
</div>
</div>
</td>
<td style="padding:5px 0">850/900/1800/1900</td>
</tr>
<tr>
<td style="padding:5px 0">B1+B2+B5+B8</td>
</tr>
<tr>
<td style="padding:5px 0">/</td>
</tr>
<tr>
<td style="padding:5px 0">/</td>
</tr>
<tr>
<td style="padding:10px 0">显示屏</td>
<td style="padding:10px 0"><p >FWVGA(FPC 转接到小板 zif)</p></td>
</tr>
<tr>
<td style="padding:10px 0">电容触摸</td>
<td style="padding:10px 0"><p >支持(FPC 转接到小板 共用屏 zif)</p></td>
</tr>
<tr>
<td style="padding:10px 0">摄像头</td>
<td style="padding:10px 0"><p >MIPI 接口</p></td>
</tr>
<tr>
<td style="padding:10px 0">SIM卡</td>
<td style="padding:10px 0">mini单SIM卡</td>
</tr>
<tr>
<td style="padding:10px 0">TF卡</td>
<td style="padding:10px 0">支持热插拔</td>
</tr>
<tr>
<td rowspan="2">
<div style="display: flex;align-items: center;">
<div class="td-left" style="flex: 1;">音频</div>
<div class="td-right" style="flex: 1; border-left: 1px solid #000;">
<p style="border-bottom: 1px solid #000;padding:10px 0;">耳机</p>
<p style="padding:10px 0">麦克风</p>
</div>
</div>
</td>
<td style="padding:10px 0">用于音频输入/输出</td>
</tr>
<tr>
<td style="padding:10px 0">用于音频输入</td>
</tr>
<tr>
<td style="padding:10px 0">USB</td>
<td style="padding:10px 0">USB Host*1, Micro USB*1</td>
</tr>
<tr>
<td style="padding:10px 0">LED 信号灯</td>
<td style="padding:10px 0">USB Host*1, Micro USB*1</td>
</tr>
<tr>
<td style="padding:10px 0">按键</td>
<td style="padding:10px 0">电源键(SW602)</td>
</tr>
<tr>
<td style="padding:10px 0">Low-level peripherals</td>
<td style="padding:10px 0">40pin 扩展口：GPIO 1.8V； 1 组SPI； 2 组 I2C； 2 组Uart； 16 个gpio</td>
</tr>
<tr>
<td style="padding:10px 0">电源</td>
<td style="padding:10px 0">Micro USB(5V 2A) 通过焊盘连接</td>
</tr>
<tr>
<td style="padding:10px 0">系统</td>
<td style="padding:10px 0">Android 4.4</td>
</tr>
<tr>
<td style="padding:10px 0">编程语言支持</td>
<td style="padding:10px 0">C、C++、Kotlin、Java、Shell、Pyhon 等</td>
</tr>
<tr>
<td colspan="2">外观规格</td>
</tr>
<tr>
<td>PCB 尺寸</td>
<td>52.4mm*68.8mm</td>
</tr>
<tr>
<td>重量</td>
<td>24g</td>
</tr>
<tr>
<td colspan="2" style="padding:10px 0;">Orange Pi™ 是深圳市迅龙软件有限公司的注册商标</td>
</tr>
</table>
<br><br>
<big>'''256MB DDR2 + 512MB EMMC规格接口详情视图：'''</big><br><br>
[[Image:3G-iot-1.png]]<br><br>
[[Image:3G-iot-2.png]]<br><br>
<big>'''512MB DDR2 + 4GB EMMC规格接口详情视图：'''</big><br><br>
[[Image:3G-iot-3.png]]<br><br>
[[Image:3G-iot-4.png]]<br><br>
=== GPIO 规格 ===
<br>
<div class="table-3g-iot">
<table style="width: 800px; line-height:35px; text-align:center; border-color:#CCCCCC;" border="1" bordercolor="#d8d8d8" cellspacing="0" cellpadding="0">
<tr>
<td width="119" style="font-weight:700;">PIN1</td>
<td width="216">VIO28 PMU</td>
<td width="68" style="font-weight:700;"> </td>
<td width="166" style="font-weight:700;">PIN21</td>
<td width="219">GPIO24</td>
</tr>
<tr>
<td style="font-weight:700;">PIN2</td>
<td>DC5V</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN22</td>
<td>GPIO109</td>
</tr>
<tr>
<td style="font-weight:700;">PIN3</td>
<td>SDA_1</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN23</td>
<td>GPIO25</td>
</tr>
<tr>
<td style="font-weight:700;">PIN4</td>
<td>DC5V</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN24</td>
<td>GPIO139</td>
</tr>
<tr>
<td style="font-weight:700;">PIN5</td>
<td>SCL_1</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN25</td>
<td>GND</td>
</tr>
<tr>
<td style="font-weight:700;">PIN6</td>
<td>GND</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN26</td>
<td>EINT0/GPIO30/PWM B</td>
</tr>
<tr>
<td style="font-weight:700;">PIN7</td>
<td>EINT4/GPIO26</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN27</td>
<td>SDA_0</td>
</tr>
<tr>
<td style="font-weight:700;">PIN8</td>
<td>UTXD2</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN28</td>
<td>SCL_0</td>
</tr>
<tr>
<td style="font-weight:700;">PIN9</td>
<td>GND</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN29</td>
<td>SPI_CS</td>
</tr>
<tr>
<td style="font-weight:700;">PIN10</td>
<td>URXD2</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN30</td>
<td>GND</td>
</tr>
<tr>
<td style="font-weight:700;">PIN11</td>
<td>URXD1</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN31</td>
<td>SPI_CK</td>
</tr>
<tr>
<td style="font-weight:700;">PIN12</td>
<td>EINT10/GPIO56</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN32</td>
<td>EINT15/GPIO90</td>
</tr>
<tr>
<td style="font-weight:700;">PIN13</td>
<td>UTXD1</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN33</td>
<td>SPI_MO</td>
</tr>
<tr>
<td style="font-weight:700;">PIN14</td>
<td>GND</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN34</td>
<td>GND</td>
</tr>
<tr>
<td style="font-weight:700;">PIN15</td>
<td>EINT2/GPIO128/PW A</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN35</td>
<td>SPI_MI</td>
</tr>
<tr>
<td style="font-weight:700;">PIN16</td>
<td>EINT12/GPIO58</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN36</td>
<td>GPIO145/PWMBL</td>
</tr>
<tr>
<td style="font-weight:700;">PIN17</td>
<td>VIO28 PMU</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN37</td>
<td>EINT3/GPIO27</td>
</tr>
<tr>
<td style="font-weight:700;">PIN18</td>
<td>EINT14/GPIO89</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN38</td>
<td>EINT5/GPIO144/PWM B</td>
</tr>
<tr>
<td style="font-weight:700;">PIN19</td>
<td>GPIO140</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN39</td>
<td>GND</td>
</tr>
<tr>
<td style="font-weight:700;">PIN20</td>
<td>GND</td>
<td style="font-weight:700;"> </td>
<td style="font-weight:700;">PIN40</td>
<td>GPIO141</td>
</tr>
</table>
</div>
<br>
== 快速入门 ==
=== 准备硬件与软件工具 ===
硬件需求：<br>
* Orange Pi 3G-IoT 开发板<br>
* 一台编译用的主机，配置最好满足以下条件：<br>
64 位 CPU<br>
16GB 内存<br>
40GB 以上的空闲磁盘空间<br>
操作系统为 Ubuntu12.04 以上，最好为 Ubuntu14.04<br>
更详细的内容可以参考 Google 文档 https://source.android.com/source/building<br><br>
软件需求：<br>
* Orange Pi 3G-IoT SDK<br>
* Orange Pi 3G-IoT 固件<br>
* Android 烧录工具<br>
以上软件均可以通过 Mega、百度云盘 的方式获取，详情参见中英文官网：<br>
http://www.orangepi.org/downloadresources/<br>
http://www.orangepi.cn/downloadresourcescn/<br><br>
=== 开发板的供电方式 ===
开发板的供电方式有两种：<br>
* Micro USB（5V 2A）供电：插入 Micro USB 适配器后即可开机。<br>
* 电池供电：常用 4.2V 电池，在背面有预留外接电池焊盘点 需要客户自己焊接, 接上电池之后按开机键即可启动。<br>
=== 拆包说明 ===
收到产品后请将产品的天线从图 1 的位置放到图 2 的位置（或者放到板子外面的位置），不能贴在板子上面以免影响信号。<br><br>
[[Image:3G-iot-5.png]]<br><br>
== Android 编译环境搭建 ==
=== 获取 SDK 源码压缩包 ===
为方便客户快速进行开发，OrangePi 有提供不同版本的 SDK 初始压缩包。下载压缩包，分别对应 OrangePi_3G-IoT_Android4.4.tar.gz00, OrangePi_3G-IoT_Android4.4.tar.gz01, <br>
...OrangePi_3G-IoT_Android4.4.tar.gz00 总共8 个分卷压缩包。获取到分卷压缩包后，把所有的压缩包放在一个同一目录下，如：<br>
创建目录<br>
mkdir OrangePi_3G-IOT_Android4.4<br>
拷贝分卷压缩包<br>
cp -rf OrangePi_3G-IoT_Android4.4.tar.gz* OrangePi_3G-IOT_Android4.4/ <br>
合并压缩包<br>
cat OrangePi_3G-IoT_Android4.4.tar.gz*>OrangePi_3G-IOT_Android4.4.tar.gz <br>
解压<br>
tar xzvf OrangePi_3G-IOT_Android4.4.tar.gz
=== 搭建编译环境 ===
可以参考 Google 官方文档： http://source.android.com/source/initializing.html<br>
* '''安装 JDK'''
Android4.4 系统编译依赖于 JAVA6。编译前需要安装 OpenJDK，gcc4.4 版本安装命令如下。<br>
sudo apt-get install openjdk-6-jdk sudo apt-get install gcc-4.4<br>
配置 JAVA 环境变量，比如安装路径为 /usr/lib/jvm/jdk1.6.0_31<br>
可以在终端执行如下命令配置环境变量。<br>
export JAVA_HOME=/usr/lib/jvm/jdk1.6.0_31<br>
export PATH=$JAVA_HOME/bin:$PATH<br>
export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar
* '''安装软件包'''<br>
对于 Ubuntu12.04：<br>
sudo apt-get update<br>
sudo apt-get install git-core gnupg flex bison ccache gperf libsdl1.2-dev libesd0-dev<br>
libwxgtk2.6-dev build-essential zip curl libncurses5-dev zlib1g-dev valgrind libc6-dev lib32ncurses5-dev x11proto-core-dev<br>
libx11-dev lib32readline-gplv2-dev lib32z1-dev libgl1-mesa-dev gcc-4.4<br>
g++-4.4 g++-4.4-multilib g++-multilib mingw32 tofrodos python-markdown libxml2-utils xsltproc wine
对于 Ubuntu14.04：<br>
sudo apt-get update<br>
sudo apt-get install git-core gnupg flex bison ccache gperf libsdl1.2-dev libesd0-dev<br>
libwxgtk2.8-dev build-essential zip curl libncurses5-dev zlib1g-dev valgrind libc6-dev lib32ncurses5-dev x11proto-core-dev<br>
libx11-dev lib32readline-gplv2-dev lib32z1-dev libgl1-mesa-dev g++-multilib g++-4.8-multilib mingw32 tofrodos python-markdown<br>
libxml2-utils xsltproc libc6-dev-i386 lib32z1 lib32ncurses5 lib32bz2-1.0 lib32readline-gplv2-dev wine
至此，我们可以开始进行 SDK 源码的编译。<br><br>
=== 编译 SDK 源码 ===
<big>'''全部编译'''</big><br>
为方便客户进行开发，Orange Pi 提供了一系列的编译脚本。<br>
目录为 SDK/code/orangepi/scripts<br>
$ cd code/orangepi/scripts<br>
$ ls anr_LM.sh auto.sh clean.sh codegen.sh init_project.sh tar_img.sh
auto.sh 为自动编译脚本<br>
clean.sh 为自动清除编译结果脚本<br>
tar_img.sh 为打包脚本<br><br>
在 code/orangepi/scripts 目录下，我们执行自动编译脚本：<br>
板子是：32g4g
$ ./auto.sh IoT03_mt6572_emmc_b1258_32g4g_ry_smt_v1.1 v00 eng<br>
板子是：4g2g
$ ./auto.sh IoT03L_mt6572_lca_b1258_wg_4g2g_ry_smt_v1.1 v00 eng
传入的三个参数含义如下：<br>
#$1 project_info [eg: IoT03L_mt6572_lca_b1258_wg_4g2g_ry_smt_v1.1]<br>
#$2 version_info [eg: v00 v01 ...]<br>
#$3 compile_mode [eng:user userdebug eng]<br>
auto.sh带的三个参数含义，在脚本开头部分有详细说明。<br><br>
<big>'''模块编译'''</big><br>
最常用的修改了kernel部分的文件，可以采用如下命令：<br>
./mk -o=TARGET_BUILD_VARIANT=[user/userdebug/eng] projName n K && ./mk -o=TARGET_BUILD_VARIANT=[user/userdebug/eng] projName r bootimage<br><br>
比如：工程是 hexing72_cwet_kk<br>
{| class="wikitable" style="width:800px;"
|-
| ./mk -o=TARGET_BUILD_VARIANT=eng || hexing72_cwet_kk || n k &&
|-
| ./mk -o=TARGET_BUILD_VARIANT=eng || hexing72_cwet_kk || r bootimage
|}
<br>
其中驱动部分修改编译，详细可以参考文档：MT6592_Driver_All_In_One_Part.pdf<br><br>
== Android 固件烧录 ==
'''Orange Pi 3G-IoT 开发板''' <br><br>
烧录相关按键与接口如下：<br><br>
[[Image:3G-iot-6.png]]<br><br>
编译完成后固件将汇总在code/IoT03_b1258_32g4g_ry_smt_v1.1或code/IoT03L_b1258_wg_4g2g_ry_smt_v1.1 目录中，<br>
并打包形如 IoT03L_b1258_wg_4g2g_ry_smt_v1.1_20180403182516_v00_eng.zip 名字的压缩包。<br><br>
<div style="background:#f1f1f1;border:1px solid #ddd;padding:5px;width:800px; ">
IoT03L_b1258_wg_4g2g_ry_smt_v1.1<br>
├── images<br>
│ ├── boot.img<br>
│ ├── lk.bin<br>
│ ├── logo.bin<br>
│ ├── MT6572_Android_scatter.txt<br>
│ ├── preloader_hexing72_cwet_lca.bin<br>
│ ├── ramdisk.img<br>
│ ├── ramdisk-recovery.img<br>
│ ├── recovery.img<br>
│ ├── secro.img<br>
│ ├── system.img<br>
│ └── userdata.img<br>
└── modem<br>
├── APDB_MT6572_S01_MAIN2.1_W10.24<br>
├── _APDB_MT6572_S01_MAIN2.1_W10.24.check<br>
├── APDB_MT6572_S01_MAIN2.1_W10.24_ENUM<br>
├── BPLGUInfoCustomAppSrcP_MT6572_S00_MOLY_WR8_W1315_MD_WG_MP_V47_1_wg_n<br>
├── catcher_filter_1_wg_n.bin<br>
├── DbgInfo_WR8.W1315.MD.WG.MP_HEXING72_CWET_KK_HSPA_MOLY_WR8_W1315_MD_WG_MP
_V47_2017_10_26_22_35_1_wg_n<br>
├── modem_1_wg_n.img<br>
└── modem_1_wg_n.mak
<br></div><br><br>
此后，请参照执行完 《OrangePi 3G-IoT Android 固件烧录指南》完成固件的烧录。<br>
我们提供已经编译且打包好的镜像分区文件，请根据自身的需求自行下载：<br>
http://www.orangepi.cn<br>
通过如下命令进行Android 4.4 镜像解压<br>
$ rar x IoT03L_b1258_wg_4g2g_ry_smt_v1.1.rar<br>
即可得到上文中固件清单中的文件。或者也可以参照Android 环境搭建及固件编译部分自行编译。<br>
<big>'''主机操作系统支持：'''</big><br>
* Windows 10<br>
* Windows 7 (32/64 位)<br>
* Windows 8 (32/64 位)<br>
* Ubuntu10.04 / 12.04 / 14.04 (32/64 位)<br>
=== 烧录工具介绍 ===
烧录工具为 '''Smart Phone Flash Tool'''请前往 OrangePi官方网站中 3G-IoT 版块下载。<br><br>
本工具有 Windows 和 Linux 版。请根据自己的主机环境选取合适的版本。界面如下：<br><br>
[[Image:4G-Iot-5.png]]<br><br>
Windows 和 Linux 版的使用方法完全一样。本手册将以 Linux 版为例进行烧录说明。<br>
=== 镜像烧录方法 ===
{| class="wikitable" style="width:800px;"
|-
|连不上电脑，则需要：<br>
$sudo apt-get remove modemmanager<br>
$sudo /etc/init.d/udev retstart<br>
然后重启电脑<br><br>
Window 下根据相应的系统下载 MTK 驱动<br>
解压 Driver_Auto_Installer_EXE_v5.1453.03.rar<br>
然后安装。
|}
<br>
* <big>'''解压并打开烧录工具'''</big><br>
{| class="wikitable" style="width:800px;"
|-
|$ unzip SP_Flash_Tool_v5.1644_Linux.zip<br>
$ cd SP_Flash_Tool_v5.1644_Linux<br>
$ sudo ./flash_tool.sh
|}
<br>
如果你是第一次打开软件，可能会出现 警告显示 scatter file 文件未找到 ：<br>
[[Image:3G-iot-7.png]]<br><br>
这是正常的。后面我们将手动指定 Scatter File 的路径。点击 OK 后我们进入软件。<br><br>
* <big>'''进入烧录模式'''</big><br>
a.首先切换到 Download 标签页，显示如下：
[[Image:3G-iot-8.png]]<br><br>
b.我们点击 Scatter-loading File 一栏的最右侧的 choose并且选择 Scatter File 的路径，如下图
[[Image:3G-iot-9.png]]<br><br>
c.双击选择后，在下面的'''分区信息显示部分'''将会自动填充各个分区文件所在的路径，以及他们将要被烧录的绝对起始地址，如下图:
[[Image:3G-iot-10.png]]<br><br>
d.在分区信息显示部分的左上角有一个下拉菜单其中有三个选项<br>
Format All + Download //擦除机器内的全部分区信息，并且重新下载选中分区<br>
Firmware Upgrade //更新选中分区中有差异的部分<br>
Download Only //无论是否有差异都重新下载
<span style="color:red;">注意</span>，一般情况下固件更新只需要选择 Firmware Upgrade，<span style="color:red;">切勿选择</span> Format All +Download。<br>
因为我们的每台机器在出厂的时候都有针对于进行各项参数的校准，在 Format All后会丢失校准信息。<br>
如果不慎出现此情况请联系售后并根据指导通过机器码获取校准参数，并按照《4G-IOT 校准参数导入导出工具和说明》重新烧录校准参数。<br>
e.戴上跳线帽，具体如下图所示：<br>
[[Image:3G-iot-11.png]]<br><br>
f.接下来使用 USB 下载线，连接主机的 USB 与机器的 MircoUSB 接口。右上角红灯亮点击 Download 按钮进行下载 [[Image:4G-Iot-34.png]]<br>
g.下载完成后界面如下
[[Image:4G-Iot-35.png]]<br>
h.拔掉USB线。插上 Mirco USB 电源。。
等待5秒将会显示关机充电界面。<br>
长按Power按键5秒后松开，会开机进入系统。<br>
当更新的分区比较多时，第一次开机也会时间稍长（全分区更新的情况开机需要8min），请耐心等待。<br><br>
Window 系统需要下载 SP_Flash_Tool_v5.1644_Win.zip，然后解压安装，就可以烧录固件了。操作方法和 Linux 的一样。<br><br>
== linux 编译环境搭建 ==
=== 获取linux 源码 ===
* <big>'''OrangePi 源码下载器'''</big><br>
$ sudo apt-get install git<br>
$ git clone https://github.com/orangepi-xunlong/OrangePi_Build.git<br>
$ cd OrangePi_Build<br>
$ ls<br>
Build_OrangePi.sh lib README.md
<br>
* <big>'''运行下载器'''</big><br>
$ ./Build_OrangePi.sh
输入 root 密码,然后回车<br>
[[Image:4G-Iot-52.png]]<br><br>
选择 0 Build system with kernel/uboot/rootfs,进入开发板型号选择界面。<br>
[[Image:4G-Iot-53.png]]<br><br>
选择 22 orangepi 3G-iot，回车后将会开始下载 Orange Pi 3G-iot 的 Linux 源码<br>
[[Image:3G-iot-13.png]]<br><br>
下载的源码会存放在 OrangePi_Build 的同级目录下。<br><br>
OrangePi 3G-IoT 的 Linux 源码目录结构如下所示<br>
<div style="background:#f1f1f1;border:1px solid #ddd;padding:5px; width:800px;">
├── bootloader<br>
├── build.sh -> scripts/build.sh 编译启动脚本<br>
├── external <br>
├── kernel<br>
├── output<br>
├── scripts<br>
└── toolchain<br>
<br>6 directories, 1 file
</div>
<br>
=== 编译linux 源码 ===
* <big>'''执行编译启动脚本'''</big><br>
$ cd OrangePi3G-iot
$ ./build.sh
根据板子型号选择并回车<br><br>
[[Image:3G-iot-14.png]]<br><br>
输入 root 密码并回车,然后选择需要执行的功能<br><br>
[[Image:4G-Iot-39.png]]<br><br>
[[Image:4G-Iot-40.png]]<br><br>
其中各选项的功能如下：<br>
* '''0 Build Release Image 编译 ubuntu 和 debian 发行版'''
* '''1 Build Rootfs 编译 Rootfs'''
* '''2 Build Uboot 编译 preloader 和 lk'''
* '''3 Build Linux 编译内核源码'''<br>
以 A 板为例，选择 0 Build Release Image，会生成以下完整的固件包<br><br>
<div style="background:#f1f1f1;border:1px solid #ddd;padding:5px;width:800px;">
output/images/<br>
├── OrangePi_3g-iot-A_ubuntu_xenial_server_linux3.4.67_v1.1<br>
│ ├── boot.img<br>
│ ├── boot_nand.img<br>
│ ├── boot_sd.img<br>
│ ├── lk.bin<br>
│ ├── logo.bin<br>
│ ├── MT6572_Android_scatter.txt<br>
│ ├── preloader_hexing72_cwet_lca.bin<br>
│ ├── rootfs.img<br>
└── OrangePi_3g-iot-A_ubuntu_xenial_server_linux3.4.67_v1.1.tar.gz<br>
<br>
</div>
<br>
== Linux 系统的烧录 ==
目前 Linux 系统不支持 modem、LCD 屏。<br>
只能通过串口登录系统，连接 wifi 后，可通过 ssh 登录。<br>
烧录系统时，跳线帽接法如下。<br>
[[Image:3G-iot-16.png]]<br><br>
=== 3G-IoT-A 的linux 固件烧录 ===
通过烧录工具把 preloader、lk、boot.img 烧录到板载 nand flash 上。<br>
<div style="border:1px solid #dddddd;background:#f1f1f1;padding:5px;">
├── boot.img<br>
├── boot_nand.img<br>
├── boot_sd.img<br>
├── lk.bin<br>
├── logo.bin<br>
├── MT6572_Android_scatter.txt<br>
├── preloader_hexing72_cwet_lca.bin<br>
└── rootfs.img
</div><br><br>
前面的《安卓固件烧录》已经介绍了如何使用烧录工具了，这里不再赘述，直接打开烧录工具。<br>
a.我们点击Scatter-loading File一栏的最右侧的choose并且选择Scatter File的路径，如下图
[[Image:3G-iot-17.png]]<br><br>
b.先断开板子与 PC 的连接，点击 Download 按钮
[[Image:3G-iot-18.png]]<br><br>
c.接下来使用 USB 下载线，连接主机的 USB 与机器的 MircoUSB 接口。
[[Image:3G-iot-19.png]]<br><br>
d.前面仅烧录了lk 和 kernel，由于 3G-iot-A 只有 512M 的板载存储，存在空间不足的问题，所以需要把 rootfs 烧录到 TF 卡上，准备一张 8G 以上，class10 的 TF 卡。格式化后。按照以下方法烧录 roofs.img<br>
pv rootfs.img | sudo dd of=/dev/sdb bs=1M
sdb 是 TF 卡对应的设备文件<br>
如果是在 windows 系统，也可以用 Win32DiskImager 软件烧录。<br>
e.将 tf 卡插入板子，上电即可启动。
[[Image:3G-iot-20.png]]<br><br>
=== 3G- IoT -B 的 linux 固件烧录 ===
该板子有 4G 的板载存储，所以可以直接将所有镜像烧到板载 EMMC 上。<br><br>
a.我们点击 Scatter-loading File 一栏的最右侧的 choose 并且选择 Scatter File 的路径，如下图
[[Image:3G-iot-21.png]]<br><br>
b.先断开板子与 PC 的连接，点击 Download 按钮
[[Image:3G-iot-22.png]]<br><br>
c.接下来使用 USB 下载线，连接主机的 USB 与机器的 MircoUSB 接口。烧录完成
[[Image:3G-iot-23.png]]<br><br>
d.启动系统。 将板子连接 5V2A 的电源适配器。连接串口可以看到系统启动。
[[Image:3G-iot-24.png]]<br><br>
'''如果板载空间不够，可以将 rootfs 烧录到 TF 卡上。步骤如下。'''
a.烧录支持挂载 TF 卡 rootfs 的 boot.img
点击下图框中内容<br><br>
[[Image:3G-iot-25.png]]<br><br>
弹出窗口选择 boot_sd.img。<br><br>
[[Image:3G-iot-26.png]]<br><br>
下载完成<br>
[[Image:3G-iot-27.png]]<br><br>
b.烧录 rootfs 到 TF 卡中
准备一张 8G 以上，class10 的 TF 卡。格式化后。按照以下方法烧录 roofs.img<br>
pv rootfs.img | sudo dd of=/dev/sdb bs=1M
sdb 是 TF 卡对应的设备文件<br>
如果是在 windows 系统，也可以用 Win32DiskImager 软件烧录。<br>
c.启动系统
将 tf 卡插入板子，上电即可启动。<br><br>
== 串口调试工具 ==
首先需要准备一根 USB 转 TTL 串口线，需要支持 921600 波特率。3G-iot 的调试串口为串口 1，已引出到 40pin，波特率为 921600 。按下图接好串口线，不同颜色的线对应的功能如下:<br>
* 黑色——GND
* 绿色——RX
* 白色——TX
[[Image:3G-iot-15.png]]<br><br>
=== 基于Windows 平台的使用 ===
在使用 OrangePi 做项目开发过程中,为了获得更多的调试信息,OrangePi 默认支持串口信息调试。对于开发者而言,只需准备上面提到的材料,即可简单的获得串口调试信息。<br>
不同的上位机使用的串口调试工具大同小异,基本可以参考下文的方法进行部署。使用 Windows 平台进行串口调试的工具很多,通常使用的工具是putty。本节以 putty 作为例子进行部署讲解。<br><br>
* <big>'''安装 USB 驱动'''</big><br>
下载最新版的驱动 PL2303_Prolific_DriverInstaller_v130.zip,下载解压<br><br>
[[Image:4G-Iot-45.png]]<br><br>
以管理员身份选择应用程序安装<br><br>
[[Image:4G-Iot-46.png]]<br><br>
等待安装完成<br><br>
[[Image:4G-Iot-47.png]]<br><br>
* <big>'''下载安装 Putty'''</big><br>
Putty 可从下面的地址下载,请选择适合自己开发环境的版本。<br>
https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
直接双击下载的 putty.exe 即可打开 putty,软件界面如下图所示。<br>
[[Image:4G-Iot-48.png]]<br><br>
* <big>'''设备信息的获取'''</big><br>
在 Windows7 中,我们可以通过设备管理器查看串口连接是否正常以及串口的设备号。如果设备没有正常识别,请检查驱动是否安装成功。<br>
如果驱动安装有问题, 可以尝试使用 360 驱动大师扫描安装驱动。<br>
[[Image:4G-Iot-49.png]]<br><br>
* <big>'''Putty配置'''</big><br>
串行口设置成相应的端口号(COM4),关闭流控,速度设置成 921600<br><br>
[[Image:4G-Iot-50.png]]<br><br>
* <big>'''启动调试串口输出'''</big><br>
OrangePi上电开机,putty将会自动打印串口log信息<br>
=== 基于 Linux 平台的使用 ===
在 Linux 平台使用 putty 和 Windows 平台区别不太,下面主要说明有差异地方的操作步骤。所有操作都是基于 Ubuntu 14.04 系统。<br><br>
* <big>'''安装并启动 Putty'''</big><br>
$ sudo apt-get install putty<br>$ sudo putty
* <big>'''配置 Putty'''</big><br>
串口号可以通过 ls '''/dev/ttyUSB*''' 查看波特率需要设置为 921600 并且关闭流控<br><br>
[[Image:4G-Iot-51.png]]<br><br>
== 其他设置 ==
=== 连接wifi 上网 ===
配置无线,首先要知道 ssid 和 psk(账号,密码),输入对应的 wlan*,ssid,psk <br>
$ sudo vi /etc/network/interfaces (添加如下内容)<br><br>
auto wlan0<br>
iface wlan0 inet dhcp wpa-ssid xxxx<br>
wpa-psk xxxx<br>
之后执行/etc/init.d/networking restart,无线即可连接上<br><br>
=== GPIO 操作 ===
<br>
MTK 用 ADB 修改和显示 GPIO 状态<br>
获取 GPIO 的状态， cat /sys/devices/virtual/misc/mtgpio/pin<br>
在 adb 下面直接执行 cat /sys/devices/virtual/misc/mtgpio/pin 命令则显示： pin: [mode] [pull_sel] [din] [dout] [pull en] [dir] [ies] [smt] <br>
0:11101010<br>
1:01101010<br>
、、、、、、<br>
22:1-100-10-1-1<br>
、、、、、、、<br>
42：00000110<br><br>
每行分别对应：<br>
IO 编号：模式，输入上拉选择，输入值，输出值，输入上拉使能，方向 direction， 输入翻转<br><br>
修改 GPIO 的状态：<br><br>
40pin GPIO 口，可通过原理图或手册获取，如 40pin 的第 37 个 pin 脚是 GPIO123, <br>
echo -wdout123 1 > pin 即设置该 GPIO 输出高电平<br>
echo -wdout123 0> pin 即设置该 GPIO 输出低电平<br><br>
== 版本历史 ==
{| class="wikitable" style="width:800px;"
|-
! 版本 !! 日期 !! 作者 !! 摘要 !! 发布 !! 备忘录
|-
| 1.1 || 2018-05-25 || 潘明敏 || 创建文档 || 2018-6-14 ||
|-
| 1.2 || 2018-10-18 || 潘明敏 || GPIO 调试 || 2018-10-19 ||
|-
| 1.4 || 2019-04-15 || Csy || Linux 源码编译及串口调试 || ||
|-
| 1.5 || 2020-3-18 || Csy || Linux 固件烧录 || ||
|}
