base on 🛠功能强大的串口工具。支持Lua自动化处理、串口调试、WinUSB、串口曲线、TCP测试、MQTT测试、编码转换、乱码恢复等功能 # LLCOM <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --> [![All Contributors](https://img.shields.io/badge/all_contributors-6-orange.svg?style=flat-square)](#contributors-) <!-- ALL-CONTRIBUTORS-BADGE:END --> [English readme click here](/README_EN.md) ![icon](/llcom/llcom.ico) [![Build status](https://ci.appveyor.com/api/projects/status/telji5j8r0v5001c?svg=true)](https://ci.appveyor.com/project/chenxuuu/llcom) [![MIT](https://img.shields.io/static/v1.svg?label=license&message=Apache+2&color=blue)](https://github.com/chenxuuu/llcom/blob/master/LICENSE) [![code-size](https://img.shields.io/github/languages/code-size/chenxuuu/llcom.svg)](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测试功能 - 集成串口监听功能,可监听其他软件的串口通信数据 ![screen](/image/screen.png) ![screen3](/image/screen3.png) ![screen2](/image/screen2.jpg) ## 特色功能示范 ### 使用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 /><sub><b>whc2001</b></sub></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 /><sub><b>chenxuuu</b></sub></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 /><sub><b>neomissing</b></sub></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 /><sub><b>RuoYun</b></sub></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 /><sub><b>王龙</b></sub></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 /><sub><b>linhongz</b></sub></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! ## 特别感谢 [![icon-resharper](/image/icon-resharper.svg)](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":39,"name":"3d-generation","display_name":"3D generation","slug":"3d-generation"},{"id":3,"name":"ai-agent","display_name":"AI agent","slug":"ai-agent"},{"id":8,"name":"ai-coding","display_name":"AI coding assistant","slug":"ai-coding"},{"id":5,"name":"ai-image","display_name":"AI image generation","slug":"ai-image"},{"id":9,"name":"ai-infrastructure","display_name":"AI infrastructure","slug":"ai-infrastructure"},{"id":10,"name":"ai-memory","display_name":"AI memory","slug":"ai-memory"},{"id":11,"name":"ai-skills","display_name":"AI skills","slug":"ai-skills"},{"id":12,"name":"ai-translation","display_name":"AI translation","slug":"ai-translation"},{"id":6,"name":"ai-video","display_name":"AI video generation","slug":"ai-video"},{"id":4,"name":"ai-voice","display_name":"AI voice","slug":"ai-voice"},{"id":7,"name":"ai-workflow","display_name":"AI workflow","slug":"ai-workflow"},{"id":22,"name":"audio-processing","display_name":"Audio processing","slug":"audio-processing"},{"id":29,"name":"authentication","display_name":"Authentication","slug":"authentication"},{"id":51,"name":"bundler","display_name":"Bundler","slug":"bundler"},{"id":41,"name":"chatbot","display_name":"Chatbot","slug":"chatbot"},{"id":27,"name":"cloud-native","display_name":"Cloud native","slug":"cloud-native"},{"id":1,"name":"computer-vision","display_name":"Computer vision","slug":"computer-vision"},{"id":37,"name":"crypto-trading","display_name":"Crypto trading","slug":"crypto-trading"},{"id":57,"name":"curated-list","display_name":"Curated list","slug":"curated-list"},{"id":54,"name":"data-streaming","display_name":"Data streaming","slug":"data-streaming"},{"id":35,"name":"data-visualization","display_name":"Data visualization","slug":"data-visualization"},{"id":16,"name":"database-backup","display_name":"Database backup","slug":"database-backup"},{"id":49,"name":"design-system","display_name":"Design system","slug":"design-system"},{"id":38,"name":"digital-human","display_name":"Digital human","slug":"digital-human"},{"id":34,"name":"document-processing","display_name":"Document processing","slug":"document-processing"},{"id":44,"name":"ecommerce","display_name":"E-commerce","slug":"ecommerce"},{"id":45,"name":"emulator","display_name":"Emulator","slug":"emulator"},{"id":46,"name":"file-management","display_name":"File management","slug":"file-management"},{"id":32,"name":"fintech","display_name":"Fintech","slug":"fintech"},{"id":31,"name":"game-development","display_name":"Game development","slug":"game-development"},{"id":24,"name":"headless-browser","display_name":"Headless browser","slug":"headless-browser"},{"id":52,"name":"headless-cms","display_name":"Headless CMS","slug":"headless-cms"},{"id":36,"name":"home-automation","display_name":"Home automation","slug":"home-automation"},{"id":20,"name":"image-editing","display_name":"Image editing","slug":"image-editing"},{"id":28,"name":"iot","display_name":"IoT","slug":"iot"},{"id":13,"name":"local-llm","display_name":"Local LLM","slug":"local-llm"},{"id":17,"name":"mcp","display_name":"MCP","slug":"mcp"},{"id":47,"name":"monitoring","display_name":"Monitoring","slug":"monitoring"},{"id":2,"name":"nlp","display_name":"NLP","slug":"nlp"},{"id":26,"name":"observability","display_name":"Observability","slug":"observability"},{"id":40,"name":"pentesting","display_name":"Pentesting","slug":"pentesting"},{"id":48,"name":"programming-examples","display_name":"Programming examples","slug":"programming-examples"},{"id":42,"name":"proxy","display_name":"Proxy","slug":"proxy"},{"id":14,"name":"rag","display_name":"RAG","slug":"rag"},{"id":56,"name":"resume-building","display_name":"Resume building","slug":"resume-building"},{"id":33,"name":"robotics","display_name":"Robotics","slug":"robotics"},{"id":30,"name":"search","display_name":"Search","slug":"search"},{"id":43,"name":"self-hosted","display_name":"Self-hosted","slug":"self-hosted"},{"id":50,"name":"static-analysis","display_name":"Static analysis","slug":"static-analysis"},{"id":18,"name":"synthetic-data","display_name":"Synthetic data","slug":"synthetic-data"},{"id":19,"name":"text-to-speech","display_name":"Text to speech","slug":"text-to-speech"},{"id":53,"name":"ui-components","display_name":"UI components","slug":"ui-components"},{"id":15,"name":"vector-database","display_name":"Vector database","slug":"vector-database"},{"id":21,"name":"video-editing","display_name":"Video editing","slug":"video-editing"},{"id":25,"name":"web-scraping","display_name":"Web scraping","slug":"web-scraping"},{"id":55,"name":"webassembly","display_name":"WebAssembly","slug":"webassembly"},{"id":23,"name":"workflow-automation","display_name":"Workflow automation","slug":"workflow-automation"}]" returns me the "expected json"