base on 🛠功能强大的串口工具。支持Lua自动化处理、串口调试、WinUSB、串口曲线、TCP测试、MQTT测试、编码转换、乱码恢复等功能 # LLCOM <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --> [](#contributors-) <!-- ALL-CONTRIBUTORS-BADGE:END --> [English readme click here](/README_EN.md)  [](https://ci.appveyor.com/project/chenxuuu/llcom) [](https://github.com/chenxuuu/llcom/blob/master/LICENSE) [](https://github.com/chenxuuu/llcom/archive/master.zip) 可运行lua脚本的高自由度串口调试工具。使用交流群：`931546484` ## 下载 从微软商店安装： <a href='//www.microsoft.com/store/apps/9PMPB0233S0S?cid=storebadge&ocid=badge'><img src='https://developer.microsoft.com/store/badges/images/Chinese_Simplified_get-it-from-MS.png' alt='Chinese badge' width='160'/></a> exe便携版：[国内用户点我下载](https://llcom.papapoi.com/llcom.zip) CI快照版：[Appveyor Artifacts](https://ci.appveyor.com/project/chenxuuu/llcom/build/artifacts) 所有正式版本：[GitHub Releases](https://github.com/chenxuuu/llcom/releases/latest) ## 功能列表 - 其他串口调试功能具有的功能 - 收发日志清晰明了，可同时显示HEX值与实际字符串 - 自动保存串口与Lua脚本日志，并附带时间 - 串口断开后，如果再次连接，会自动重连 - 发送的数据可被用户自定义的Lua脚本提前处理 - 右侧快捷发送栏，快捷发送条目数量不限制 - 右侧快捷发送栏，支持10页数据，互相独立 - 可独立运行Lua脚本，并拥有定时器与协程任务特性（移植自[合宙Luat Task架构](http://wiki.openluat.com/doc/luatFramework/)） - 可选文字编码格式 - 终端功能，直接敲键盘发送数据（包含ctrl+字母键） - 可单独隐藏发送数据 - 集成TCP、UDP、SSL测试服务端/客户端功能，并且支持IPV6 - 集成各种编码互转功能 - 集成乱码恢复功能 - 集成mqtt测试功能 - 集成串口监听功能，可监听其他软件的串口通信数据    ## 特色功能示范 ### 使用Lua脚本提前处理待发送的数据 1. 结尾加上换行回车 ```lua return uartData.."\r\n" ``` 2. 发送16进制数据 ```lua return uartData:fromHex() ``` 此脚本可将形如`30313233`发送数据，处理为`0123`的结果 3. 更多玩法等你发现 ```lua json = require("JSON") t = uartData:split(",") return json:encode({ key1 = t[1], key2 = t[2], key3 = t[3], }) ``` 此脚本可将形如`a,b,c`发送数据，处理为`{"key1":"a","key2":"b","key3":"c"}`的结果 **此处理脚本，同样对右侧快捷发送区域有效。** ### 独立的Lua脚本自动处理串口收发 右侧的Lua脚本调试区域，可直接运行你写的串口测试脚本，如软件自带的： ```lua --注册串口接收函数 uartReceive = function (data) log.info("uartReceive",data) sys.publish("UART",data)--发布消息 end --新建任务，等待接收到消息再继续运行 sys.taskInit(function() while true do local _,udata = sys.waitUntil("UART")--等待消息 log.info("task waitUntil",udata) local sendResult = apiSendUartData("ok!")--发送串口消息 log.info("uart send",sendResult) end end) --新建任务，每休眠1000ms继续一次 sys.taskInit(function() while true do sys.wait(1000)--等待1000ms log.info("task wait",os.time()) end end) --1000ms循环定时器 sys.timerLoopStart(log.info,1000,"timer test") ``` 甚至你可以利用xlua框架的特性，调用C#接口完成任何你想做的事情 ```lua request = CS.System.Net.WebRequest.Create("http://example.com") request.ContentType = "text/html;charset=UTF-8"; request.Timeout = 5000;--超时时间 request.UserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36 Vivaldi/2.2.1388.37"; response = request:GetResponse():GetResponseStream() myStreamReader = CS.System.IO.StreamReader(response, CS.System.Text.Encoding.UTF8); print(myStreamReader:ReadToEnd())--打印获取的body内容 myStreamReader:Close() response:Close() ``` 使用此功能，你可以完成大部分的自动化串口调试操作。 ## 接口文档 接口文档可以在[这个页面](https://github.com/chenxuuu/llcom/blob/master/LuaApi.md)查看 ## 已知问题与待添加的功能（请大家反馈，谢谢！） - [x] ~~bug：某些条件下（比如Air720重启），COM口消失后不会被释放，导致无法再次开启该COM口，只能重启软件（[.net 框架的bug，微软的人在看了](https://github.com/dotnet/corefx/issues/39464)）~~（已解决 #2f26e68） ## 开源 如果各位大佬不觉得麻烦的话，欢迎对本项目进行pr或直接重构。 本项目在前期只是为了实现功能，代码相当零散，所以不太适合阅读我的源码进行学习，等我有空的时候会重构代码。 本项目采用Apache 2.0协议，如有借用，请保留指向该项目的链接。 ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): <!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tr> <td align="center"><a href="https://github.com/whc2001"><img src="https://avatars2.githubusercontent.com/u/16266909?v=4?s=100" width="100px;" alt=""/><br />_{<b>whc2001</b>}</a><br /><a href="https://github.com/chenxuuu/llcom/commits?author=whc2001" title="Code">💻</a> <a href="https://github.com/chenxuuu/llcom/issues?q=author%3Awhc2001" title="Bug reports">🐛</a></td> <td align="center"><a href="https://www.chenxublog.com/"><img src="https://avatars3.githubusercontent.com/u/10357394?v=4?s=100" width="100px;" alt=""/><br />_{<b>chenxuuu</b>}</a><br /><a href="#projectManagement-chenxuuu" title="Project Management">📆</a></td> <td align="center"><a href="https://github.com/neomissing"><img src="https://avatars0.githubusercontent.com/u/22003930?v=4?s=100" width="100px;" alt=""/><br />_{<b>neomissing</b>}</a><br /><a href="#ideas-neomissing" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://github.com/RYLF"><img src="https://avatars3.githubusercontent.com/u/28991981?v=4?s=100" width="100px;" alt=""/><br />_{<b>RuoYun</b>}</a><br /><a href="https://github.com/chenxuuu/llcom/issues?q=author%3ARYLF" title="Bug reports">🐛</a></td> <td align="center"><a href="http://www.diycms.com"><img src="https://avatars.githubusercontent.com/u/13432299?v=4?s=100" width="100px;" alt=""/><br />_{<b>王龙</b>}</a><br /><a href="#ideas-wanglong126" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/chenxuuu/llcom/issues?q=author%3Awanglong126" title="Bug reports">🐛</a> <a href="https://github.com/chenxuuu/llcom/commits?author=wanglong126" title="Code">💻</a></td> <td align="center"><a href="https://github.com/linhongz"><img src="https://avatars.githubusercontent.com/u/49241612?v=4?s=100" width="100px;" alt=""/><br />_{<b>linhongz</b>}</a><br /><a href="#ideas-linhongz" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/chenxuuu/llcom/issues?q=author%3Alinhongz" title="Bug reports">🐛</a></td> </tr> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END --> This project follows the [all-contributors](htts://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! ## 特别感谢 [](https://www.jetbrains.com/?from=LLCOM) ", Assign "at most 3 tags" to the expected json: {"id":"8293","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"