diff --git a/bsp/x1000/README.md b/bsp/x1000/README.md index 4a0af7c70a..b6562a8abe 100644 --- a/bsp/x1000/README.md +++ b/bsp/x1000/README.md @@ -1 +1,178 @@ -# RT-Thread for Ingenic X1000 porting. \ No newline at end of file +# 君正X1000处理器板级支持包 + +--- + +## 1. 简介 + +X1000 是 君正 Ingenic 公司的一款面向 智能音频、图像识别、智能家电、智能家居 等领域的高性能物联网芯片。包括如下硬件特性: + +| 硬件 | 描述 | +| -- | -- | +|芯片型号| X1000/X1000E | +|CPU| MIPS32, XBurst | +|主频| 1GHz | +|片内LPDDR| 32MB | + +***注:*** X1000E携带64MB片内LPDDR; + +![此处输入图片的描述][1] + +这个板级支持包是一份君正X1000处理器的完整移植。 + +## 2. 编译说明 + +X1000处理器是一款MIPS32兼容处理器,由于[RT-Thread/ENV][2]工具中并未默认携带MIPS的工具链,可以按照自己开发PC类别到以下地方下载工具链: + +* [Windows环境版本GCC][3] +* [Linux环境版本GCC][4] + +安装好工具链后,假设使用的是Windows版本,工具链安装在`D:\Tools\mips-2016.05`目录下。使用env工具,打开console后,进入到命令行环境中,需要手动设置工具链的环境变量`RTT_EXEC_PATH`: + + set RTT_EXEC_PATH=d:\Tools\mips-2016.05\bin + +然后在console中进入到`rt-thread\bsp\x1000`目录中,执行以下命令编译RT-Thread: + + scons + +来编译这个板级支持包。如果编译正确无误,会产生rtthread.elf、rtthread.bin文件。其中rtthread.bin需要烧写到设备中进行运行。 + +也可以在ENV中使用 + + menuconfig + +来配置RT-Thread。当前这份BSP支持多种板卡类型,包括哈雷2,凤凰板以及睿赛德提供的RealBoard X1000开发板。 + +## 3. 烧写及执行 + +在烧写前,请使用两条micro-b的USB线连接到电脑上,一个是USB转UART,一个是USB接口(用于烧写固件)。烧写需要使用君正提供的[cloner工具软件][5]。请按照下面的方式设置cloner工具软件。 + +其中, + +* uboot.bin烧写地址是0x0 +* rtthread.bin烧写地址是0x80000 +* rootfs烧写地址是0x400000 + +> uboot.bin请使用bsp/x1000中附带的uboot.bin文件 +> 关于rootfs文件生成,请见第5节 + +在连接好USB后,如果是RT-Thread RealBoard/X1000开发板,可以同时按住 `Reset + Boot` 按键,然后先释放`Reset`按键,然后再释放`Boot`按键。这个时候cloner软件会进入烧写模式,烧写固件到板子上。 + +连接好串口,可以使用putty以115200-N-8-1的配置方式连接到设备上。开发板复位后首先运行的是u-boot引导程序,然后再由u-boot跳转到flash中的rtthread.bin固件中。 + +### 3.1 运行结果 + +如果编译 & 烧写无误,当复位设备后,会在串口上看到RT-Thread的启动logo信息: + +![启动信息][6] + +## 4. 驱动支持情况及计划 + +| 驱动 | 支持情况 | 备注 | +| ------ | ---- | :------ | +| UART | 支持 | UART0/1 | +| Clock | 支持 | | +| pinmux | 支持 | | +| SPI | 支持 | | +| IIC | 支持 | 以IO模拟方式 | +| SFC Flash | 支持 | 支持四线模式挂载文件系统 | +| WDT | 支持 | | +| SLCD | 支持 | | +| MMC | 支持 | MMC0/1 | +| EMAC | 支持 | 测试未充分 | +| USB | 有限度支持device | USB device还未完全稳定 | +| Camera | 不支持 | N/A | + +### 4.1 IO在板级支持包中的映射情况 + +| IO号 | 板级包中的定义 | +| -- | -- | +| 调试串口 | PD2/3 | + +## 5. 生成flash中的文件系统镜像 + +在这份BSP中,默认把flash偏移0x400000后的空间划分为文件系统使用(即Flash中4MB以后的空间做为文件系统使用),并且以FAT文件系统方式来使用(RT-Thread本身并无一些文件系统上文件的依赖,不过第6节中提及的Wi-Fi功能固件是放于文件系统跟目录的)。 + +这部分文件系统空间,可以在系统启动后使用mkfs命令来格式化,然后装载;也可以在PC上预先生成,然后通过cloner工具烧写到flash上。如果是预先生成的方式,可以使用env/tools/fatdisk工具进行生成。fatdisk工具类似于把一个目录下的所有文件及子目录都转换成一个FAT文件系统的映像,至于如何转换,相对应的参数是什么样的,主要由fatdisk.xml配置文件来控制,例如: + +```xml + + + 4096 + 4096 + root + sd.bin + 1 + +``` + +disk_size代表了这个文件系统映像的最大容量是多少,单位是kBytes;sector_size代表着扇区大小,对于X1000分支,这个大小必须是4096。root_dir则表示转换的目录,是针对fatdisk.exe可执行文件的相对目录;output代表生成的文件系统映像文件的文件名称。strip代表文件系统后面的全0数据是否移除,0代表不移除,1代表移除; + +***注:*** +在BSP中也可以更改这个flash偏移点,它是由如下分区代码所决定: + +`文件:bsp/x1000/drivers/sfc/drv_sfc_gd25qxx_mtd_partition.c` + +```C +static struct rt_mtd_nor_partition _sf_gd25_parts[] = +{ + { + /* sf01 u-boot 512K */ + .name = "uboot", + .offset = 0x0, + .size = (0x80000), + .mask_flags = PART_FLAG_RDONLY | PART_TYPE_BLK, /* force read-only */ + }, + ... + { + /* rootfs */ + .name = "rootfs", + .offset = 0x400000, + .size = 0x800000, + .mask_flags = PART_FLAG_RDONLY | PART_TYPE_BLK, /* force read-only & Block device */ + }, + ... +}; +``` + +当前BSP中,这个分区配置是这样: + +| 名称 | 起始地址 | 大小 | 属性 | +| -- | -- | -- | -- | +| uboot | 0x0 | 512KBytes | 只读 | +| kernel | 0x80000 | 3.5MBytes | 只读 | +| rootfs | 0x400000 | 8MBytes | 只读 | +| appfs | 0xE00000 | 2MBytes | 读写 | + +## 6. 使用哈雷2核心板子上的Wi-Fi功能 + +在RT-Thread package上已经包含了哈雷2核心板带的BCM43438的Wi-Fi驱动,可以在menuconfig中打开以下选项: + + RT-Thread online packages ---> + IoT - internet of things ---> + Wi-Fi ---> + Wiced WiFi ---> + [*] Wiced WiFi driver for rt-thread + wiced wifi version (latest version) + +然后在console命令下执行`pkgs --update`,它会下载Wi-Fi驱动package,并部署到这个板级支持包中。 + +当编译成功,并烧写到板子上,系统运行起来后,使用以下命令行关联到Wlan网络中: + + wifi w0 join YOUR_SSID YOUR_PASSWD + +其中, + +* YOUR_SSID 请使用你的wlan AP名称代替; +* YOUR_PASSWD 请使用你的wlan设备密码代替; + +## 6. 参考 + +* 芯片[数据手册][7] + + [1]: http://www.ingenic.cn/~editor/eweditor/uploadfile/20160615102142861.png + [2]: https://www.rt-thread.org/page/download.html + [3]: https://sourcery.mentor.com/GNUToolchain/package14477/public/mips-sde-elf/mips-2016.05-7-mips-sde-elf-i686-mingw32.tar.bz2 + [4]: https://sourcery.mentor.com/GNUToolchain/package14476/public/mips-sde-elf/mips-2016.05-7-mips-sde-elf-i686-pc-linux-gnu.tar.bz2 + [5]: http://pan.baidu.com/s/1eSObOkU + [6]: images/startup.jpg + [7]: ftp://ftp.ingenic.com/SOC/X1000/X1000_DS.pdf