Luatools下载调试工具
作为由合宙所提供的单机版调试工具,Luatools支持最新固件获取、固件打包、trace打印、单机烧录等功能
此工具适用于合宙的SoC、cat1模块、cat4模块、2G模块
环境要求
此工具运行于win7及以上系统,不支持mac和linux
注:EC618(例:Air780E)、EC7XX(例:Air780EP/Air780EQ/Air700ECQ/Air201)芯片平台的模块由于USB驱动适配,不支持在win10以下系统上使用
下载与安装
Luatools下载
- 直接下载:Luatools下载调试工具
- 工具大全:LuatOS工具大全
Luatools安装
- 工具下载后的文件名为:Luatools_v2.exe
![wKgZomajO5uAR2_lAAAUYi1fKAQ529.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajO5uAR2_lAAAUYi1fKAQ529.png)
2.在win系统--D盘(或其他盘)推荐在根目录下新建文件名并重命名为 LuaTools,目录太深可能会导致工具某些功能会出问题。
![wKgZomajO6SATKjnAAAJpMCR474578.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajO6SATKjnAAAJpMCR474578.png)
3.将下载的Luatools_v2.exe拷贝或移动到新建的LuaTools文件夹内 注意:若出现危险提醒,无需理会,继续下载即可
![wKgZomajO6yAU_YnAAAo5fLPaBk455.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajO6yAU_YnAAAo5fLPaBk455.png)
4.鼠标左键单击Luatools_v2.exe后右键发送快捷方式到桌面即可
![wKgZomajO8iAcRSxAAED51j8ZdU065.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajO8iAcRSxAAED51j8ZdU065.png)
5.双击Luatools_v2.exe启动程序并更新 注意:如果有杀软拦截,请务必通过!!!务必通过!!!务必通过!!!
![wKgZomajO_OAca-bAAAfyxpVMYU599.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajO_OAca-bAAAfyxpVMYU599.png)
6.更新完成后,LuaTools文件夹会生成几个文件夹
![wKgZomajO_uARvzJAABMpCbCJbY375.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajO_uARvzJAABMpCbCJbY375.png)
功能介绍
文件夹功能介绍
- _temp 文件夹:临时文件
![wKgaomajPAOATKAPAABdvn9VSew897.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPAOATKAPAABdvn9VSew897.png)
- config 文件夹:对Luatools_v2进行的一些配置会存放到这个文件夹
![wKgZomajPAuAD9lpAAA7TrdxU9w424.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPAuAD9lpAAA7TrdxU9w424.png)
- log 文件夹:里面存放有模块输出的各种日志信息,当模块出现问题需要向合宙技术人员寻求技术支持的时候,就需要提交这个目录下的文件
- resource 文件夹:合宙模块相关的AT固件,LuaTask开发的Core底层固件,Lib库和demo脚本
- aa_bb_lod 文件夹:aa表示芯片平台,bb表示开发方式(at / lua)
- 8910_script 文件夹:展锐8910平台的demo和Lib
- soc_script 文件夹:gitee luatos主仓库更新的demo和Lib
![wKgZomajPBWAQ-g3AACUwDHCQ84051.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPBWAQ-g3AACUwDHCQ84051.png)
- project 文件夹:使用项目管理后会自动生成这个目录,用于管理下载项目
![wKgaomajPByAclj_AAApgxglG6A714.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPByAclj_AAApgxglG6A714.png)
主界面介绍
- 账户
- 登录:使用购买时销售为你自动创建的erp账号登陆,可以在技术人员(FAE)远程支持客户时协助抓取本机log
- 合宙商城:链接至合宙商城
- Luat物联平台:远程升级或debug时用,链接至合宙云平台
- 经纬度查询:开发基站定位时会用到,链接至定位查询
- 模块生产信息查询:查询模块出厂信息时用,链接至合宙售后管理系统
- 官方淘宝店:合宙官方的淘宝店,链接至上海合宙LuatOS官方企业店
- DTU管理平台:链接至DTU管理系统
- Exit:退出工具
![wKgZomajPCSAbm9aAACxdJ_E8tU325.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPCSAbm9aAACxdJ_E8tU325.png)
固件相关
- 4G-Cat.1:4G-Cat.1模组固件相关的操作
![wKgaomajPGuAfyJ4AACwh3LPpTM617.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPGuAfyJ4AACwh3LPpTM617.png)
![wKgZomajPHSAYnTYAACahhLmLLQ963.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPHSAYnTYAACahhLmLLQ963.png)
![wKgaomajPIeAF8gKAACZFm57R64139.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPIeAF8gKAACZFm57R64139.png)
选项与工具
- 工具配置:点击log,当配合技术人员抓取bug日志时在此页面打开log功能,例如AP与CP日志,若使用工具经常遇到蓝屏,可先关闭底层日志的抓取
![wKgaomajPKWAInV1AADULVKO7VE501.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPKWAInV1AADULVKO7VE501.png)
- SOC差分/整包升级包制作工具:可生成差分包或整包,用于FOTA远程升级使用,由于部分模块不支持在该工具上生成,具体以各模块FOTA远程升级例程上的要求为准
![wKgZomajPLWAWcixAAEUxU5Q2r8037.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPLWAWcixAAEUxU5Q2r8037.png)
- 固件合并文件工具:固件合入bin文件,EC618(例如780E等)使用xxx.binpkg,EC7XX(例如780EP等)使用xxx.soc
![wKgZomajPMWAbWASAAEDF-trFRk516.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPMWAbWASAAEDF-trFRk516.png)
- Soc转binpkg量产文件:
![wKgaomajPNOAdlvrAADT07YYjfs726.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPNOAdlvrAADT07YYjfs726.png)
- 内置串口调试工具(简约)
![wKgaomajPOKAXXgNAAD75IgCROc361.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPOKAXXgNAAD75IgCROc361.png)
合宙特色服务
- ERP模块生产记录:输入IMEI号可直接查询模块生产信息
![wKgaomajPPKAdTzwAAE0jBD7JjM106.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPPKAdTzwAAE0jBD7JjM106.png)
- FOTA远程升级服务:在IOT平台通过一系列操作后可对模块进行FOTA远程升级操作,与之同时还可以进行实时调试等操作。链接至:合宙云平台
![wKgZomajPQWAfwCcAADUYnOiHXc814.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPQWAfwCcAADUYnOiHXc814.png)
- LBS基站定位服务:
![wKgaomajPROALz33AADSn7Dkq78448.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPROALz33AADSn7Dkq78448.png)
- NetLab公网透传调试:可进行TCP/UDP透传测试。链接至:LuatOS 网络测试工具
![wKgaomajPR2Af5tQAADU82qD-6w477.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPR2Af5tQAADU82qD-6w477.png)
- Air7xxUx系列差分服务:用于Air7xxUx系列差分包生成服务。链接至:差分包服务
![wKgaomajPSqANUcZAADUFziYSuQ490.png](https://file1.elecfans.com/web2/M00/FF/92/wKgaomajPSqANUcZAADUFziYSuQ490.png)
- DTU透传固件(iRTU):链接至:iRTU
![wKgaomajPY-AM8MxAADbE-Y-ynw996.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPY-AM8MxAADbE-Y-ynw996.png)
- IotProxy云平台密钥分发服务:各云平台密钥分发。链接至:iot-regproxy
![wKgZomajPTSAdsOJAADTTIHApeE142.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPTSAdsOJAADTTIHApeE142.png)
资源目录
- 固件和demo目录:[文件夹功能介绍](# 文件夹功能介绍)中所提及的resource文件夹
- 本地日志目录:[文件夹功能介绍](# 文件夹功能介绍)中所提及的log文件夹
- 本地项目目录:[文件夹功能介绍](# 文件夹功能介绍)中所提及的project文件夹
- Iot自助绑定固件:
- 历史版本工具和固件下载:工具、固件、文档等一系列资料。链接至:合宙云盘目录
![wKgaomajPa6AWZQwAADSaA0R3dE298.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPa6AWZQwAADSaA0R3dE298.png)
- 帮助
![wKgaomajPb-AQ5cxAADa0250f5Y714.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPb-AQ5cxAADa0250f5Y714.png)
日志打印窗口
![wKgZomajPceAAkODAADBksRcmrw417.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPceAAkODAADBksRcmrw417.png)
![wKgZomajPgGAXv2rAAJlIsEp780390.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPgGAXv2rAAJlIsEp780390.png)
- 开始/停止打印可以暂停文本区的自动滚动打印
- 清除打印可以清空文本区的打印日志,但是不会删除log文件夹下的文件内容
模块状态显示窗口
- 启动原因:模块开机原因
- 系统状态:如果文本区中存在对应的日志,这里会显示SIM卡、网络注册等信息
- 固件版本:这里仅仅显示core的版本信息,例如AT或者Luat的版本信息,不显示Lib和用户脚本的版本号
- 小区信号:显示模块接入主小区 RSRQ、RSRP、SNR 信号值
- 信号强度:这里显示GSM的信号强度。信号强度与卡是否欠费无关,不插卡也可以有信号强度
- 当前网络:网络类型,例如 4G网络
- 软件类型:这里是指Core的类型,例如Luatask或者AT
- 小区ID:显示模块接入主小区的cellid
![wKgZomajPhaAJLM9AADfT4PXZz4020.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPhaAJLM9AADfT4PXZz4020.png)
- 下载固件入口
- 除第二步点击选择文件后选择固件外,也可以直接拖动固件至该界面
- 除AT固件外,可根据自己需要选择是否操作第三步,不需要可跳过第三步
![wKgaomajPiaAC0T7AAF03khx4Sc813.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPiaAC0T7AAF03khx4Sc813.png)
- 项目管理入口
- 详细操作教程在[项目管理](# 项目管理)
![wKgZomajPi-AbGE_AAHPlZ6CW6A847.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPi-AbGE_AAHPlZ6CW6A847.png)
- 搜索打印
- 通过关键词搜索可直接跳转到与之相匹配内容行
![wKgaomajPjmASrHaAAEw0NnI1ic910.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPjmASrHaAAEw0NnI1ic910.png)
- 底部链接
- 鼠标悬停至窗口四个边或四个角,可对窗口进行大小缩放
![wKgZomajPkKAQJ-SAADbQ0r8l7A793.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPkKAQJ-SAADbQ0r8l7A793.png)
日志查看
使用Luatools文本区查看日志
![wKgZomajPkuAHTVZAAFBSwbAyNw874.png](https://file1.elecfans.com/web2/M00/FE/A9/wKgZomajPkuAHTVZAAFBSwbAyNw874.png)
使用文本编辑器直接查看log日志
- LuaTools 的日志是 USB-TTL 或者 USB-VCOM 提供的,因此可能会独占串口
- 用文本编辑器打开 log的时候,注意生成的 Log 文件时间,必要时,先关闭 LuaTools 再使用文本编辑器查看日志
![wKgaomajPnSAfx2uAABfNbVFlxY424.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPnSAfx2uAABfNbVFlxY424.png)
![wKgZomajPoWAY5eWAAC4J4-RqWc725.png](https://file1.elecfans.com/web2/M00/FE/AA/wKgZomajPoWAY5eWAAC4J4-RqWc725.png)
项目管理
在使用LuaTools下载源码时,强烈建议使用项目管理来进行下载,每个下载都用一个项目来区分。
新建项目
创建项目
![wKgaomajPpmAQMoPAADdul9DuJ8560.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPpmAQMoPAADdul9DuJ8560.png)
输入TestSocket然后确定
![wKgZomajPqiAFyr2AACuoChf4tc559.png](https://file1.elecfans.com/web2/M00/FE/AA/wKgZomajPqiAFyr2AACuoChf4tc559.png)
单击TestSocket项目,在右侧分别填入
- 底层Core:Lua开发的底层Core
- 增加脚本或资源文件:添加用户脚本、数据及Lib库
- 默认USB打印trace,trace三个选项是用来选择打印输出方式的
- 添加默认lib:不建议勾选
- 升级文件包含core:用于项目打包,可按需选择
- 升级文件包含脚本:用于项目打包,建议直接勾选
- 升级文件无资源文件:用于项目打包,不选
- USB BOOT下载:使用Boot模式下载
- 下载脚本:只下载脚本列表中的数据
- 下载底层和脚本:底层core和脚本列表中的数据都下载
- 语法检查:单独检查用户编写的脚本有无语法错误
注意,首次下载时,强烈建议直接下载底层和脚本
固件烧录(USB烧录)
首先USB连接PC,保持上电不开机状态
AT开发
![wKgaomajPsOANnpcAADEJkgaZi4387.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPsOANnpcAADEJkgaZi4387.png)
![](../image/%E5%BC%80%E5%8F%91%E5%B7%A5%E5%85%B7%E5%8F%8A%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/Luatools%E4%B8%8B%E8%BD%BD%E8%B0%83%E8%AF%95%E5%B7%A5%E5%85%B7/20221009110353731_image.png)
点击下载固件按钮。
选中要下载的AT固件
如果是开发板按住下载模式按键(boot 键)不放,同时再长按开机键开机,这时开发板会进入下载模式,Luatools下载进度条会开始跑,这时可以松开 boot 按键。直到工具提示下载完成。
如果是自己画板,需要将模块boot引脚按照对应硬件手册要求,拉高到对应电平,再按住boot按键,上电开机,这时板子会进入下载模式,Luatools下载进度条会开始跑,这时可以松开 boot 按键。直到工具提示下载完成。
LuatOS开发
![wKgaomajPtWANUJWAAWc2JahJrw808.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPtWANUJWAAWc2JahJrw808.png)
在Luatools工具主界面点击"项目管理测试"
如果没有新建过项目,需要先建立一个项目
选择底层固件 .soc文件
添加脚本以及资源文件
勾选添加默认lib
如果模块是第一次还没有烧录过固件,或固件更换过,需要点击"下载固件和脚本"进行烧录。如果固件不需要更改,只有脚本变动,只需要点击"下载脚本"烧录即可。
如果是开发板按住下载模式按键(boot 键)不放,同时再长按开机键开机,这时开发板会进入下载模式,Luatools下载进度条会开始跑,这时可以松开 boot 按键。直到工具提示下载完成。
如果是自己画板,需要将模块boot引脚按照对应硬件手册要求,拉高到对应电平,再按住boot按键,上电开机,这时板子会进入下载模式,Luatools下载进度条会开始跑,这时可以松开 boot 按键。直到工具提示下载完成。
如果,未能成功进入下载模式,而是进入正常开模式,这时可以按住 boot 键,再短按复位按键,让开发板重启,重新进入下载模式。
如何判断有没有进入下载模式:可以通过 PC 端的设备管理器中虚拟出来的 USB 断开数量来判断:
- 正常开机模式:
![wKgaomajPuSAPZ-3AABZ3wC76Dg384.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPuSAPZ-3AABZ3wC76Dg384.png)
- 下载模式:
![wKgaomajPuuAFT3YAABHnRXhc0s791.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPuuAFT3YAABHnRXhc0s791.png)
视频烧录教程
【LuatOS-Air】Air780E烧录教程
固件烧录(Uart烧录)
注意事项
- Cat.1模块只有780E/780EP/780EQ/700ECQ...移芯芯片平台的支持串口烧录,也只能通过main_uart(uart1)串口进行烧录,其他串口不行
- 使用串口的前提是模块可以正常工作,所以串口烧录不能救砖。需要救砖还是要用usb+boot的方式烧录
- AT开发如果main_uart可以通过115200波特率正常通讯AT指令,那么可以不用重启,只点击下载,模块会自动进入下载模式。
- LuatOS开发串口烧录时需要重启下,才可进入下载模式。
AT开发
![wKgaomajPvSASL3VAAEkK1DJC7s653.png](https://file1.elecfans.com/web2/M00/FF/93/wKgaomajPvSASL3VAAEkK1DJC7s653.png)
- 获取对应模块的AT固件 获取方式(其一):[文件夹功能介绍](# 文件夹功能介绍)中的resource文件夹
- 勾选通用串口打印
- 选择对应的串口号
- 打开串口
- 开始打印
- 点击下载固件
- 点击选择文件,选择对应的AT固件
- 如果main_uart可以通过115200波特率正常通讯AT指令,点击下载,模块会自动进入下载模式。
- 如果不能通讯,请确保模块复位或者下上电通过main_uart 115200波特率可以看到"RDY"的URC上报(串口功能正常),随后点击下载,如果模块没有进入下载状态,则按下复位或者重新上下电开机,则可以进入下载状态。
LuatOS开发
- 选择开发用到的core+脚本+lib后,生成LuatOS量产固件(后缀为 .soc)
- 8910平台量产固件生成路径在 "Luatools工具目录\4G量产文件"
- 618/718P/716E/716S平台量产固件生成路径在 "Luatools工具目录\SOC量产及远程升级文件\xxx对应芯片平台文件夹内"
- 得到固件之后,仿照AT开发的固件烧录教程进行烧录即可
-
soc
+关注
关注
38文章
4002浏览量
216850 -
烧录
+关注
关注
8文章
245浏览量
35361 -
合宙通信
+关注
关注
0文章
145浏览量
1649
发布评论请先 登录
相关推荐
入网模组 |合宙Air 202 GPRS模组接入机智云(硬件开发平台)
【合宙Air820开发板免费试用】+开发环境的构建与程序下载
【合宙Air551G双频定位开发板试用体验】NaviTrack工具使用
【合宙Air105开发板试用体验】Ari105开发板开箱,及摄像头使用
android fastboot/adb 驱动调试工具
AIR202Luat系列教程之下载调试工具LuaTools的使用指南资料免费下载
![AIR202Luat系列教程之<b class='flag-5'>下载</b><b class='flag-5'>调试工具</b><b class='flag-5'>LuaTools</b>的使用指南资料免费<b class='flag-5'>下载</b>](https://file.elecfans.com/web1/M00/85/33/o4YBAFxtGyiAbpKoAAHtoy3mR88194.png)
凭借低价就能横扫市场?合宙超值MCU的实用【刷机】命令行
![凭借低价就能横扫市场?<b class='flag-5'>合</b><b class='flag-5'>宙</b>超值MCU的实用【刷机】命令行](https://file.elecfans.com/web2/M00/43/7B/pYYBAGJ-B6aAHuNPAAAf8J1Ebk4778.jpg)
评论