https://github.com/chenxuuu/llcom

🛠功能强大的串口工具。支持Lua自动化处理、串口调试、WinUSB、串口曲线、TCP测试、MQTT测试、编码转换、乱码恢复等功能
https://github.com/chenxuuu/llcom

com encoding-decoding ipv6-support libusb lua mqtt-client rs232 serial-port serial-port-monitor ssl-server tcp-client tcp-server udp-client udp-server winusb

Last synced: 7 days ago
JSON representation

🛠功能强大的串口工具。支持Lua自动化处理、串口调试、WinUSB、串口曲线、TCP测试、MQTT测试、编码转换、乱码恢复等功能

• Host: GitHub
• URL: https://github.com/chenxuuu/llcom
• Owner: chenxuuu
• License: apache-2.0
• Created: 2019-04-16T06:38:35.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-10-16T08:09:17.000Z (about 1 month ago)
• Last Synced: 2024-11-06T16:04:02.964Z (14 days ago)
• Topics: com, encoding-decoding, ipv6-support, libusb, lua, mqtt-client, rs232, serial-port, serial-port-monitor, ssl-server, tcp-client, tcp-server, udp-client, udp-server, winusb
• Language: C#
• Homepage: https://llcom.papapoi.com/
• Size: 3.46 MB
• Stars: 851
• Watchers: 19
• Forks: 205
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# LLCOM

[![All Contributors](https://img.shields.io/badge/all_contributors-6-orange.svg?style=flat-square)](#contributors-)

[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`

## 下载

从微软商店安装：



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)):

  

    
whc2001
💻 🐛

    
chenxuuu
📆

    
neomissing
🤔

    
RuoYun
🐛

    
王龙
🤔 🐛 💻

    
linhongz
🤔 🐛

  

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)