前言
概述
为方便广大客户使用,本WIKI网站主要介绍 TQT113_CORE开发板从入门到开发的指引。力求以最简洁的语言,让您能在最短时间内快速入门,逐步熟悉 TQT113_CORE 产品的硬件特性、使用及开发方法,提高开发效率。
文档修订记录
修订日期 | 修订人 | 修订记录 | 备注 |
2023-6-16 | Tanya | 初版 | 修订仅针对本网站文档 |
产品介绍
核心板简介
天嵌科技 TQT113_CORE 核心板是天嵌科技基于 Allwinner T113 系列 CPU 开发的解决方案,搭载集成了双核Cortex -A7cpu 和单核 Hifi4 DSP 的 T113 -s3,是全志推出搭载集成了双核 Cortex -A7cpu 和单核 Hifi4 DSP,主频 800MHz,内置 128M DDR3,可选配 EMMC5.1 4G/8G/16G/32G;工作温度范围-25~75℃,支持 Linux 系统,是一款 1080p 支持全格式解码和全志 Smart Color 2.0 显示增强技术,为用户提供卓越的视频体验,拥有 RGB/LVDS/DSI/CVBS OUT 等丰富的显示输出接口,满足差异化市场对屏幕显示的需求,低电压、低漏电的先进工艺设计,针对典型场景的功率优化设计,增强的散热封装,提升了产品的加热体验。
核心板采用邮票孔形式,尺寸仅 38mm x 38mm,共引出 128Pin,将 T113 的所有功能接口保留下来。支持全格式解码,如 H.265,H.264、mpeg - 1/2/3 /4、JPEG、VC1 等等。独立的硬件编码器可以使用 JPEG 或 MJPEG 进行编码。集成多个 adc / dac 和 I2S/PCM/DMIC/OMA 音频接口,可便于提供完美的语音交互解决方案。具有广泛的连接性,便于产品扩展,如 CAN、USB、SDIO、EMAC、TWI、UART、SPI、PWM、GPADC、IRTX&RX 等。可应用于各种复杂的使用场景。
详细核心板参数介绍请查看:01_产品介绍资料/《TQT113_CORE核心板规格书.pdf》
底板介绍
为了方便广大用户对T113核心板的功能进行快速了解,提高产品开发的速度,我司提供配套的底板。
详细底板参数介绍请查看:01_产品介绍资料/《TQT113_CORE开发板硬件手册-20230802.pdf》。
底板原理图参考:TQ_T113-S3_BASIC_V2.pdf
套板支持的配件
模块名称 | 模块参数 | 规格型号 | Linux5.4.61 +Qt5.12.5 |
---|---|---|---|
10.1寸LVDS电容显示模组 | 1280x800 | 京东方 | 支持 |
10.1LVDS电容显示模组 | 1280x800 | 群创VI101IA14 | 支持 |
10.1LVDS电容显示模组 | 1280x800 | 京东方 | 支持 |
美格4G-750模块(数据版本)(含天线) | 美格4G模块(数据版本)+天线(750-C7C) | 支持 |
说明:该章节配件支持基于本网站最新系统镜像文件测试,其他版本镜像仅做参考。
入门指南
登录目标板系统
连接调试串口线
通过PC-Windows或者PC-Linux系统登录请连接调试串口线,接线如下:
通过PC-Windows系统
在这里我们介绍在window平台下如何测试评估套版,首先需要在PC机安装一个串口终端,这里以Putty调试串口工具作为示范,您可以自行下载SecureCRT、xshell等工具进行调试串口的设置与连接。
08_开发板配套工具/Windows平台工具/Putty.exe
一般需要设置端口、校验位、波特率,RTS/CTS等,常用串口工具配置说明如下:
(1)端口选项根据您的实际使用的端口进行配置:计算机->设备管理器->端口
(2)校验位在串口通信中一种简单的检错方式,一般选择8位
(3)波特率需根据实际使用平台的串口配置进行选择
(4)RTS/CTS一定不能选,否则可能出现串口有输出,没法输入的情况
Putty的配置如下:
协议选择Serial、设置端口为COM16(这个根据自己实际的端口选择)、波特率为115200
点击连接后进入Putty界面,正常情况下上电即可以看到开发板的启动打印信息,如下图所示:
说明:
1.如果没有串口打印信息,检查数据线有没有损坏
2.确认使用串口线是否为TTL电平
目标板正常启动打印信息如下,敲Enter可进入系统串口终端 #
通过PC-Linux系统登录
如果您已经熟悉使用Linux系统开发,可以使用Linux终端工具minicom进行连接目标板,minicom使用基于PC-Linux环境下进行,以下是安装及配置过程:
(1)安装minicom工具
#sudo apt-get install minicom
(2)配置minicom
安装minicom完成后,输入命令minicom -s启动,将出现配置菜单:使用PC键盘的上下键选中serial port setup选项后,用回车键进入串口配置。
进入串口配置界面,输入A配置串口驱动为/dev/ttyS0(不管在windows中是COMn(n可以是任意数),在虚拟机的Ubuntu下均是ttyS0)后回车,如果是usb转串口设备名应该作用/dev/ttyUSBn(n为数字,视实际而定,一般为0)。输入E配置速率为115200 8N1输入F将Hardware Flow Control设为NO,回车退出。
由于我们使用minicom是作为超级终端连接评估套件的, 而不是控制modem,所以需要修改modem and dialing。
将Modem and dialing配置单中得Init string、 Reset string、Hang-up string设置为空。
设置完成后选择Save setup as dfl选项将当前设置保存为默认设置;在配置菜单上选择Save setup as dfl保存配置单(一定要做这一步,否则下次启动minicom时还需要重新配置);选择Exit退出配置并进入minicom的操作界面。
(3)配置完成,输入minicom可以直接启动,此时上电即可以看到开发板的启动打印信息。
说明1:如果您是在虚拟机中使用minicom,您需要在启动虚拟机中的Ubuntu之前先在您的虚拟机中添加串口设备,然后再启动虚拟机中的Ubuntu。特别注意一点:当Windows中使用了串口设备(比如启动了SecureCRT软件,并且已经使用COM3这个串口端口),然后如果在虚拟机中设置的也是COM3这个端口,那么在虚拟机中的Ubuntu启动后,在minicom中是没法使用串口的,只能选择关闭SecureCRT软件,释放COM3,然后虚拟机中的Ubuntu才能够使用该串口。
说明 2:输入sudo minicom -D /dev/ttyUSB0可以直接指定USB串口设备。
通过PC-Linux系统登录
如果您已经熟悉使用Linux系统开发,可以使用Linux终端工具minicom进行连接目标板,minicom使用基于PC-Linux环境下进行,以下是安装及配置过程:
(1)安装minicom工具
#sudo apt-get install minicom
(2)配置minicom
安装minicom完成后,输入命令minicom -s启动,将出现配置菜单:使用PC键盘的上下键选中serial port setup选项后,用回车键进入串口配置。
进入串口配置界面,输入A配置串口驱动为/dev/ttyS0(不管在windows中是COMn(n可以是任意数),在虚拟机的Ubuntu下均是ttyS0)后回车,如果是usb转串口设备名应该作用/dev/ttyUSBn(n为数字,视实际而定,一般为0)。输入E配置速率为115200 8N1输入F将Hardware Flow Control设为NO,回车退出。
由于我们使用minicom是作为超级终端连接评估套件的, 而不是控制modem,所以需要修改modem and dialing。
将Modem and dialing配置单中得Init string、 Reset string、Hang-up string设置为空。
设置完成后选择Save setup as dfl选项将当前设置保存为默认设置;在配置菜单上选择Save setup as dfl保存配置单(一定要做这一步,否则下次启动minicom时还需要重新配置);选择Exit退出配置并进入minicom的操作界面。
(3)配置完成,输入minicom可以直接启动,此时上电即可以看到开发板的启动打印信息。
说明1:如果您是在虚拟机中使用minicom,您需要在启动虚拟机中的Ubuntu之前先在您的虚拟机中添加串口设备,然后再启动虚拟机中的Ubuntu。特别注意一点:当Windows中使用了串口设备(比如启动了SecureCRT软件,并且已经使用COM3这个串口端口),然后如果在虚拟机中设置的也是COM3这个端口,那么在虚拟机中的Ubuntu启动后,在minicom中是没法使用串口的,只能选择关闭SecureCRT软件,释放COM3,然后虚拟机中的Ubuntu才能够使用该串口。
说明 2:输入sudo minicom -D /dev/ttyUSB0可以直接指定USB串口设备。
ARM-Linux系统基础操作
登录到目标板系统之后,您可以通过Linux常用命令对目标板进行查看、修改等操作:
查看系统版本信息
cat /proc/version
查看CPU信息
cat /proc/cpuinfo
查看内存使用情况
free -m
查看磁盘使用情况
df -hT
查看分区信息
fdisk -l
获取和保存系统log信息
ls -l /var/log/messages
获取内核启动参数
cat /proc/cmdline
目标板系统更新
出厂默认期待Linux系统,如果需要更换为自己定制的系统镜像文件,则需要使用USB、SD卡等方式重新烧录板子。
USB更新
1.安装USB更新工具:08_开发板配套工具/Windows平台工具/AllwinnertechPhoeniSuit.zip
2.下载镜像文件:05_开发板配套镜像
3.参考:04_开发板配套教材集/TQT113_Linux_使用手册_20230627.pdf
SD卡/TF卡更新
1.安装SD卡更新工具:08_开发板配套工具\Windows平台工具/PhoenixCard4.2.4.zip
2.下载镜像文件:05_开发板配套镜像
3.参考:04_开发板配套教材集/ TQT113_Linux_使用手册_20230627.pdf
常规功能测试
评估板常规功能测试
关于TQT113_CORE评估套板外设功能测试参照手册:04_开发板配套教材集/ TQT113_Linux_使用手册_20230627.pdf
Linux系统开发指南
说明1:以下环境是在ubuntu16.04、64bit系统下搭建,其他系统或其他版本仅供参考。进行Linux系统开发之前请先参考《PC开发环境搭建》章节搭建开发环境。
说明2:详细的编译步骤请参考手册:04_开发板配套教材集/TQT113_Linux_编译手册_20230627.pdf
说明3:由于版本持续更新,以下涉及到源码及镜像版本请以实际使用版本为准。
解压Linux源码包
Linux源码下载:06_开发板配套源码/Linux资源/TQT113_core_linux_V1.0.tar.bz2。
Linux源码中包含u-boot、内核、文件系统。解压之前请先对比一下md5的值。以免后面解压与编译中浪费不必要的时间。
网盘如果是单个压缩包,TQT113_core_linux_V1.0.tar.bz2,解压命令:
tar jxvf TQT113_core_linux_V1.0.tar.bz2
源码会被解压到/opt/t113-s3_linux-sdk-v1.1目录下。解压前请保证/opt目录下有权限。用户可在根目录下执行以下命令对/opt目录赋予权限。
sudo chown embedsky:embedsky /opt
源码编译说明
解压后TQT113_core_linux_V1.0.tar.bz2文件夹为Linux系统的源码,含buildroot、内核与u-boot的源码。具体编译过程可参考04_开发板配套教材集/TQT113_Linux_编译手册_20230627.pdf
编译脚本说明
编译系统时使用源码目录下的build.sh脚本。常用编译选项有:
配置 | 用途 |
---|---|
uboot | 编译u-boot,不带参数 |
kernel | 编译内核,不带参数 |
buildroot | 编译buildroot源码, 不带参数 |
cleanall | 清除uboot, kernel, rootfs, |
例如:
./build.sh kernel # 编译内核
./build.sh # 编译u-boot,内核源码,buidlroot并打包成t113_linux_evb1_auto_uart0.img
镜像说明
使用build.sh 脚本生成的镜像都会放到rockdev/中,最后烧写也是烧写这里面的镜像。
系统开发
Kernel源码简介
暂缺
Linux应用开发指南
说明1:该部分例程属于通用接口例程,Linux系统下如需操作各外设接口可以参考该部分例程代码。
应用开发例程
天嵌硬件操作库
1.天嵌硬件操作库下载链接: 07_开发板配套例程/二次封装库/TQT113_TaLib_V1.0.0.zip
2.天嵌硬件操作库使用跳转链接:http://wiki.armbbs.net/tqwiki/public/info/index.html
Qt例程
1.Qt5.15.4开发例程:07_开发板配套例程/TQT113_PDA_V1.0.0.zip
PC开发环境搭建
PC-Linux平台环境搭建
说明1:以下环境是在ubuntu16.04、64bit系统下搭建,其他系统或其他版本仅供参考。
说明2:详细的环境搭建请参考手册:04_开发板配套教材集/TQT113_Linux_开发环境搭建手册_20230627.pdf
交叉编译器安装
解压
交叉编译器默认在光盘的:“08_开发板配套工具\Linux平台/gcc-linaro-5.3-2016.02-X86_64_arm-linux-gnueabihf5.12.5.tar.bz2”。复制到电脑的ubuntu系统中。解压:(用户可以根据需要解压到自己想要的目录下)
tar jxvf gcc-linaro-5.3-2016.02-X86_64_arm-linux-gnueabihf5.12.5.tar.bz2 -C /
默认会解压到/opt/EmbedSky/gcc-linaro-5.3-2016.02-x86_64_arm-linux-gnueabihf5.12.5目录下。
说明:编译用户应用与驱动模块时可以使用这个编译器,编译buildroot,内核,u-boot,默认会使用buildroot重新生成的。
常用开发工具安装
以下服务安装非必需,请跟据实际使用安装需要的开发工具。
搭建nfs服务器
在PC-Linux系统中执行以下命令,可以搭建nfs服务器:
#apt-get install nfs-common
#mkdir /opt/nfs
#echo "/opt/nfs *(rw,sync,no_root_squash,no_subtree_check)" >> /etc/exports
#/etc/init.d/nfs-kernel-server restart
搭建tftp服务器
在PC-Linux中执行以下命令,可以在搭建tftp服务器:
#apt-get install tftp-hpa tftpd-hpa
#mkdir /opt/tftp
#echo "TFTP_USERNAME=\"tftp\"" > /etc/default/tftpd-hpa
#echo "TFTP_DIRECTORY=\"/opt/tftp\"" >> /etc/default/tftpd-hpa
#echo "TFTP_ADDRESS=\"0.0.0.0:69\"" >> /etc/default/tftpd-hpa
#echo "TFTP_OPTIONS=\"-l -c -s\"" >> /etc/default/tftpd-hpa
#service tftpd-hpa restart ;注此命令需要每次开机执行一次才能使用
搭建ftp服务器
在PC-Linux中执行以下命令,可以搭建ftp服务器:
#apt-get install vsftpd
#mkdir /opt/ftp
#useradd -d /opt/ftp -s /bin/bash ftpname
#passwd ftpname ;设置密码,例如设置为123
#service vsftpd start
使用方法:
在开发板中执行ftpget -u ftpname -p 123 192.168.1.xxx zImage获取电脑中/opt/ftp目录下的zImage文件
PC-Windows平台环境搭建
安装串口工具
Putty为串口调试、ssh连接常用工具,下载链接:08_开发板配套工具/Windows平台工具/Putty.exe
此软件无需要安装,只要将它解压后即可使用。
安装WinSCP
WinSCP为ssh连接常用工具,下载链接:08_开发板配套工具/Windows平台工具/WinSCP.zip
此软件无需要安装,只要将它解压后即可使用。
安装USB下载工具
Usb下载工具,下载链接:08_开发板配套工具/Windows平台工具/download/FactoryTool_1.66.zip
此软件无需要安装,只要将它解压后即可使用。
Usb下载工具需要安装驱动,下载链接:08_开发板配套工具/Windows平台工具/DriverAssitant_v4.91.zip
此压缩包解压后双击打开DriverInstall.exe,即可安装驱动。
安装SD制卡工具
SD制卡工具,下载链接:08_开发板配套工具/Windows平台工具/SDDiskTool_v1.61.zip
此软件无需要安装,只要将它解压后即可使用。
资料下载链接
01_产品介绍资料
02_开发板配套硬件资料
03_开发板配套器件资料
04_开发板配套教材集
05_开发板配套镜像
06_开发板配套源码
07_开发板配套例程
08_开发板配套工具
09_开发板配套测试报告
天嵌产品使用必读
常见问题解答
FAQ
FAQ详细信息,请查看《TQT113_FAQ》(暂缺)文档,文档总结了使用T113平台所遇到的部分问题及解决方法,如果查看文档仍未解决问题,请拨打技术支持电话或者发送邮件到技术支持邮箱寻求技术支持。
技术支持说明
天嵌科技致力于高科技产业发展提供技术与服务,为广大客户提供嵌入式技术软硬件开发工具与解决方案,致力于ARM内核系列CPU的开发和应用,提供低功耗、高性价比的嵌入式产品,提供针对性强、量身定制的客户化设计;无论是新设计还是对现有产品的改型设计,我们都会为您提供高品质的开发服务。 由于时间有限,手册难免存在纰漏和错误,诚恳的希望各位读者批评和指正。关于修改的bug,我们会在第一时间在论坛上更新,论坛建有技术支专区,欢迎大家遇到问题去里面寻找解决方法。还可以通过邮件(support@embedsky.net)与我们联系(为了能够方便跟进记录,
请参照邮件落款模板发送邮件)。希望能结识更多的朋友,大家一起共同进步。
- 官方网站:http://www.embedsky.com
- 论坛:http://www.armbbs.net
- 淘宝店铺:https://embedsky.taobao.com
- 技术支持邮件:support@embedsky.net
- 技术支持电话:020-38373101-817 020-38373101-810(IMX6Q) 020-38373101-814(IMX6UL) 020-38373101-818(335X)
邮件落款模板
烧写镜像文件版本号:xxx (例如:V2.0_R1.0,版本号在文件名后面有) 使用板卡、系统:xxx (例如:e9 android 4.3) 联系人:xxxxx 联系方式:xxxxx 公司:xxxxxx (例如:天嵌科技、学校等等)
常规技术支持范围
1.使用我司的镜像与开发板。 2.系统或硬件出现问题时(不包含客户自行开发)