查看“100ask Fire-imx6ull mini”的源代码

=野火imx6ull-mini简介=
EBF6ULL S1 Mini 开发板提供完整的SDK 驱动开发包、核心板封装库，底板应用参考设计原理图，可帮助客户大大缩减产品的开发时间，加快产品上市。<br>
目前提供Linux 4.1.15/4.9.88版本的内核，配套的系统自带python、Qt 等组件。
开发板整板由EBF6ULL S1 核心板模组和底板组成，具体见下图，元件采用工业级选料，其中核心板板载主控芯片512MB DDR3L 内存，256/512MB Nand-FLASH（或8GBeMMC）。
==核心板特征==
[[File:100ask_Fire-imx6ull_mini_001.jpg|400px|right |thumb|frameless|核心板功能示意图]]
核心板PCB 采用8 层黑色沉金设计，单面放元件，整体尺寸39x39mm，共140 个引脚，
引脚间距1.0mm，除了SEMC 总线引脚外，芯片其余IO 均引出。<br>
该核心板适用于工业控制、手持扫码、喷墨打印机、轨道交通、无人机控制和音频输出等领域。<br>

EBF6ULL S1 核心板模组参数如下：
* CPU：NXP MCIMX6Y2CVM08AB 处理器
* 频率：工业级最高可达792MHz
* DDR3L 内存：板载512MB DDR3L
* FLASH 存储器示不同型号的板子，使用以下其中一种配置：
* 板载256MB 或512MB 的 Nand-FALSH
* 板载8GB 的eMMC
* PCB：8 层黑色沉金，尺寸为39 x39mm
* 封装：邮票孔封装，单面元件，背面没有元件，底板不需要挖槽
使用不同存储器版本的开发板时，主要区别在于设置不同的启动方式，以及使用系统
时要注意其容量大小
[[File:100ask_Fire-imx6ull_mini_002.jpg|500px|right|thumb|frameless|底板正面功能示意图]]
[[File:100ask_Fire-imx6ull_mini_003.jpg|500px|right|thumb|frameless|底板反面功能示意图]]
==底板特征介绍==
EBF6ULL S1 Mini 底板参数如下：
*PCB：6 层黑色沉金，尺寸为100x61.8mm
*100M 以太网接口：2 路百兆以太网接口
*5V 电源接口： 使用5V±2%单电源供电
*过压保护指示灯：该灯亮时表示电压超出范围
*USB Device 接口：使用Type C 接口引出
*UART TTL 接口：主控器串口引脚直接引出，TTL 电平
*树莓派接口：包含UART、I2C、SPI、PWM等兼容树莓派的IO 接口
*心跳灯与电源灯：系统运行后心跳灯会持续闪烁
*LCD FPC 接口：含24 位RGB 接口及I2C 触摸屏控制接口
*复位&按键：共4 个按键，分别为复位、ON/OFF、普通按键及Mode 模式切换按键
*USB Host Type A：1 路使用Type A 引出USB Host 接口
*Boot 开关：一个8 位拨码开关，支持切换NAND、eMMC、SD 及USB 启动方式
*GPIO 扩展口：包含主控器的其它GPIO
*RTC 电池接口：可接入型号为CR1220 的电池为RTC 模块供电
*SD 卡槽：micro SD 卡插槽，支持SD 卡3.0
*IO 扩展：包含一个74LV595PW 芯片，把某4 路IO 扩展成8 路

=快速使用=
==准备工作==
要使用你的firefly-rk3288开发板，请提前准备好以下资源：
* 一台可以上网的windows电脑
* firefly-rk3288开发板
* microSD卡/TF卡: Class10或以上的 8GB SDHC卡
* 一个5v/3A的DC接口电源适配器
* VMware-player-15.1.5.exe
* Vmware ubuntu 18.04 64位虚拟机镜像
* win32diskimager-1.0.0-install.exe
* MobaXterm_Portable_v11.0.zip
开发板连接示意图请参考右边的连接方式，连接后用<code>MobaXterm</code>串口工具进行登录。<br>

==更新系统/烧写img镜像文件==
===sd卡启动===
请提前下载好配套的资料(本页最开头有下载链接)，拷贝下列文件到到下载目录：<br>
 <code>Firefly-rk3288_board/firefly-rk3288_视频配套资料_2019.07.16/02_Images/Sdcard_img</code> 目录下的<code>sdcard.img</code>
<br>
然后通过如下操作进行烧写更新系统。<br>

===烧写nandflash系统===
*1.安装资料光盘下<code>01_tools\SD Card Formatter 5.0.1 Setup.exe</code>软件，安装完成后打开！<br>
*2.使用'''SdCardFormatter'''格式化SD卡，格式化步骤如下如所示!
{| class="wikitable"  style="text-align: center;  background-color: rgba(255,255,255,0.2)"
|-
| [[image:100ask_am335x_SD_P_004.png | 300px ]]
| [[image:100ask_am335x_SD_P_005.png  | 300px]]
| [[image:100ask_am335x_SD_P_006.png | 300px ]]
|-
| (1)选择要格式化的SD卡，选中Quick format，点击Format	|| (2)在弹出的对话框中点击是(Y)	|| (3)等待格式化完成，在弹出的对话框中点击确定	
|}

*3.安装资料光盘下<code>01_tools/ win32diskimager-1.0.0-install.exe</code>软件，安装完成后打开！<br>
*4.使用'''wind32diskimage'''烧写存放在下载目录的<code> sdcard.img</code> 系统镜像文件，烧写步骤如下所示！<br>

===烧写emmc系统===

==体验Arduino编程==
在过去十年的教育培训中，遇到很多程序员、计算机软硬件爱好者。他们对硬件、驱动并不了解，<br>
希望通过简单的学习就能控制硬件，实现自己创意想法，而不是看硬件芯片手册、编写驱动、应用程序。<br>
为此，我们在产品上编写了一套基于Arduino的应用程序库，让用户可以通过几行简单的代码，实现对各种硬件模块的控制。<br>
<br>
介绍了LED灯、按键、红外遥控、温湿度传感器、人体红外检测、超声波测距、步进电机控制、OLED显示、三轴加速度计、<br>
实时时钟、数模/模数转换、GPS模块等的基本使用，最后再示例了两个实战项目供读者参考。<br>
<br>
*使用方法请参考该链接，使用GIT下载文档:[[BeginnerLearningRoute | 初学者学习路线 ]]。
*使用GIT下载文档后，请参考 '''01_使用Arduino操作体验简单开发/Firefly-RK3288开发板Arduino使用手册.pdf'''

=编译100ask linux sdk系统=
<div style="color:#F00; font-size: 1.1em">注意：此章节操作均在我们提供的资料光盘以及vmware ubuntu18.04进行过测试，确保其可用。如需自行安装配置vmware ubuntu开发环境请参考[[Configuring_ubuntu ]]</div>

简介:以下资源仅限于在百问网官方购买及百问网授权店铺购买的开发板上使用，我们在官方的基础上做了大量的定制化修改，精简了系统，简化下载以及编译流程，更大的提升开发效率，系统不同于野火官方系统。<br>

==获取源码==
{|  class="wikitable" style="text-align: left;  background-color: rgba(255,255,255,0.2)"
|-
! 类别 !! 国内coding仓库 !! 国外github仓库 
|-
|u-boot|| https://git.dev.tencent.com/weidongshan/imx6ulx_uboot.git || 
|-
|linux kernel|| https://git.dev.tencent.com/weidongshan/imx6ulx_kernel.git|| 
|-
|根文件系统|| https://git.dev.tencent.com/weidongshan/imx6ul_buildroot.git || 
|}
git邮箱账号和用户名配置
<syntaxhighlight lang="bash">
book@100ask:~$  git config --global user.email "you@example.com"
book@100ask:~$  git config --global user.name "Your Name"
</syntaxhighlight>
初次使用，需要配置用户名和密码才可以进行代码同步，用户名和密码根据自己情况设定，也可以随意设定

考虑到代码仓库过多，特使用repo工具管理代码<br>
*repo工具获取sdk
<syntaxhighlight lang="bash">
book@100ask:~$  git clone  https://git.dev.tencent.com/codebug8/repo.git
book@100ask:~$  mkdir -p fire-imx6ull_mini && cd fire-imx6ull_mini
book@100ask:~/fire-imx6ull_mini$ ../repo/repo init -u https://dev.tencent.com/u/weidongshan/p/manifests/git -b linux-sdk -m imx6ull/fire-imx6ull_mini_linux_release_v1.0.xml --no-repo-verify
book@100ask:~/fire-imx6ull_mini$ ../repo/repo sync -j4
</syntaxhighlight>
上面使用的repo管理为国内coding仓库
==设置工具链==
交叉编译工具链主要是用于在ubuntu主机上编译并声称可以在其它平台上运行的系统。设置交叉编译工具主要是设置PATH， ARCH和CROSS_COMPILE三个环境变量，下面介绍具体设置方法。

* 永久生效
如需永久修改，请修改用户配置文件, Ubuntu系统下，修改如下：
<syntaxhighlight lang="bash">
 vim ~/.bashrc
</syntaxhighlight>
在行尾添加或修改：
 export ARCH=arm
 export CROSS_COMPILE=arm-linux-gnueabihf-
 export PATH=$PATH:/home/book/fire-imx6ull_mini/ToolChain/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf/bin

* 临时生效
执行完“export”命令后，该设置只对当前终端有效
<syntaxhighlight lang="bash">
book@100ask:~$ export PATH=$PATH:/home/book/fire-imx6ull_mini/ToolChain/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf/bin
book@100ask:~$ export ARCH=arm
book@100ask:~$ export CROSS_COMPILE=arm-linux-gnueabihf-
</syntaxhighlight>
* 手动指定
Make编译时指定ARCH架构 CROSS_COMPILE交叉编译工具链
<syntaxhighlight lang="bash">
book@100ask:~$ export PATH=$PATH:/home/book/fire-imx6ull_mini/ToolChain/gcc-linaro-6.2.1-2016.11-x86_64_arm-linux-gnueabihf/bin
book@100ask:~$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf-
</syntaxhighlight>
==编译uboot==
准备工作
安装TFTP NFS服务请参考[[Configuring_ubuntu#.E7.8E.AF.E5.A2.83.E9.85.8D.E7.BD.AE | Ubuntu环境配置]]，设置如下参数让系统通过网络挂载方式启动，方便调试。<br>
其中TFTP目录假设为<code> /home/book/tftpboot</code> NFS目录假设为<code> /home/book/nfs_rootfs</code><br>
'''注意：以下操作会破坏SD卡的数据，请先进行备份。'''
*编译野火imx6ull_mini开发板uboot命令
<syntaxhighlight lang="bash">
book@100ask:~$  cd ~/fire-imx6ull_mini/uboot2017.03
book@100ask: ~/fire-imx6ull_mini/uboot2017.03 $ make distclean
book@100ask: ~/fire-imx6ull_mini/uboot2017.03 $ make  mx6ull_14x14_evk_defconfig
book@100ask: ~/fire-imx6ull_mini/uboot2017.03 $ make
</syntaxhighlight>
*单独烧写uboot
使用dd命令烧写img镜像文件到TF卡中。
 book@100ask:~/fire-imx6ull_mini/uboot2017.03 $   dd if=u-boot-dtb.imx of=/dev/sdb bs=1k seek=1 conv=fsync

* nfs启动系统
注意: '''serverip'''为你的ubuntu IP 地址  '''ipaddr '''为你给开发板设置的IP地址，设置IP完成后可以通过 ping  命令来确认是否连通。
其中'''rootpath '''指定的是ubuntu下解压的firefly-rk3288文件系统所在目录。
 => setenv ipaddr 192.168.1.112
 => ping 192.168.1.111
 => setenv serverip 192.168.1.132
 => setenv nfsroot /home/book/nfs_rootfs
执行''' run netboot 命令后，uboot会自动根据设置的参数，下载复制到<code> /home/book/tftpboot</code>目录下的设备树文件和内核文件以及挂载nfs文件系统。

==编译linux kernel==
*准备工作
安装TFTP NFS服务请参考[[Configuring_ubuntu#.E7.8E.AF.E5.A2.83.E9.85.8D.E7.BD.AE | Ubuntu环境配置]]，设置如下参数让系统通过网络挂载方式启动，方便调试。<br>
其中TFTP目录假设为<code> /home/book/tftpboot</code> NFS目录假设为<code> /home/book/nfs_rootfs</code><br>

*编译野火imx6ull_mini开发板内核
<syntaxhighlight lang="bash">
book@100ask:~/fire-imx6ull_mini$ cd linux-4.9.88
book@100ask:~/fire-imx6ull_mini/linux-4.9.88$ make mrproper
book@100ask:~/fire-imx6ull_mini/linux-4.9.88$ make imx_v7_ebf_defconfig
book@100ask:~/fire-imx6ull_mini/linux-4.9.88$ make zImage -jN //这里可以根据CPU个数，来加速编译系统。 
book@100ask:~/fire-imx6ull_mini/linux-4.9.88$ make dtbs
</syntaxhighlight>
*编译内核模块
<syntaxhighlight lang="bash"> 
book@100ask:~/fire-imx6ull_mini/linux-4.9.88$ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- modules
</syntaxhighlight>
安装内核模块到nfs根文件系统
<syntaxhighlight lang="bash">
book@100ask:~/fire-imx6ull_mini/linux-4.9.88$ sudo make ARCH=arm INSTALL_MOD_PATH=/media/rootfs  modules_install
</syntaxhighlight>
*uboot通过tftp方式下载内核
将编译成功的'''zImage'''文件和设备树'''imx6ull-14x14-ebf-mini.dtb'''文件，拷贝到ubuntu的<code>/home/book/tftpboot</code> 目录下，<br>
用以uboot通过tftp 方式进行下载并启动系统。

==编译根文件系统==
准备工作
安装TFTP NFS服务请参考[[Configuring_ubuntu#.E7.8E.AF.E5.A2.83.E9.85.8D.E7.BD.AE | Ubuntu环境配置]]，设置如下参数让系统通过网络挂载方式启动，方便调试。<br>
其中TFTP目录假设为<code> /home/book/tftpboot</code> NFS目录假设为<code> /home/book/nfs_rootfs</code><br>

*文件系统特征
{| class="wikitable"
|-
! 配置文件	!! 含义
|-
| ebf6ull-mini_defconfig	|| 文件系统版本(再默认版本支持了qt)
|}

*编译步骤
<syntaxhighlight lang="bash">
book@100ask:~/fire-imx6ull_mini$ cd buildroot2019.02
book@100ask:~/fire-imx6ull_mini/buildroot2019.02$ make clean
book@100ask:~/fire-imx6ull_mini/buildroot2019.02$ make ebf6ull-mini_defconfig
book@100ask:~/fire-imx6ull_mini/buildroot2019.02$ make menuconfig
book@100ask:~/fire-imx6ull_mini/buildroot2019.02$ make –jN		 /* N表示CPU的线程数，比如可以写4、8等以加快编译速度 */
</syntaxhighlight>
'''注意：机器性能不同，编译时间不同。性能差的电脑，有可能需要等待1 ~ 2个小时。'''
*编译后生成文件介绍
<syntaxhighlight lang="bash" > 
buildroot2018.02	
	├── output
		├── images	
			├── idbloader.img				<--u-boot镜像
			├── nfs_rootfs					<--打包并压缩的根文件系统，适用于NFSROOT启动	
			│   └── rootfs.tar.gz	
			├── rk3288-firefly.dtb  			<--设备树文件
			├── rootfs.ext2
			├── rootfs.ext4 -> rootfs.ext2		<--ext2格式根文件系统
			├── rootfs.tar					<--打包后的根文件系统
			├── sdcard.img					<--完整的SD卡系统镜像
			├── trust.img					<--u-boot镜像
			├── u-boot.bin
			├── u-boot-dtb.img
			├── uboot.img					<--u-boot镜像
			└── zImage					<--内核镜像

 </syntaxhighlight>
buildroot详细的使用介绍请参考[[Buildroot]]

*解压文件系统nfs目录
把使用buildroot构建得到的根文件系统nfs_rootfs/rootfs.tar.gz，复制、解压到ubuntu的/etc/exports文件中指定的目录里，即复制到/home/book目录下，得到/home/book/nfs_rootfs下众多文件：
<syntaxhighlight lang="bash">
book@100ask:~/fire-imx6ull_mini/buildroot2019.02/output/images$ cp -rf nfs_rootfs/  ~ 
book@100ask:~/fire-imx6ull_mini/buildroot2019.02/output/images$ cd ~/nfs_rootfs
book@100ask:~/nfs_rootfs$ sudo tar -zxvf rootfs.tar.gz
</syntaxhighlight>

=获取帮助与反馈建议=