# LightCommunication **Repository Path**: thinsnow/light-communication ## Basic Information - **Project Name**: LightCommunication - **Description**: # 计算机网络课程实验一——利用可见光传输信息 ## 技术 - Python - **Primary Language**: Python - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 4 - **Created**: 2026-03-31 - **Last Updated**: 2026-04-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # CNI-Lab1 可见光信息传输 基于 Python + OpenCV + FFmpeg 的可见光文件传输实验工程,包含编码器(发送端)与解码器(接收端)。 ## 方案概述 - 灰度大块差分编码(左亮右暗=1,左暗右亮=0) - 3 个标准定位点 + 1 个自定义定位点,支持透视矫正与方向识别 - 帧内亮度参考块(黑/灰/白)用于动态阈值 - 分组传输:块级 CRC + Reed-Solomon 外层纠删码 - UEP:前 20% 数据使用更强纠错参数 - 保守三态判决:低置信度位标记为无效,优先避免漏检错误 ## 系统依赖 - Python 3.11,建议使用miniconda管理虚拟环境 - 安装 `ffmpeg 8.0.1 essentials`,注意添加/bin至Path > 具体可见[[ffmpeg安装](https://www.gyan.dev/ffmpeg/builds/)] --- **注意以下所有提到的内容需要切换至所在目录才能运行成功!!!** **注意以下所有提到的内容需要切换至所在目录才能运行成功!!!** --- ## 项目依赖 ```bash pip install -r requirements.txt ``` 说明: - 如果本机缺少 `cv2` / `reedsolo` / `ffmpeg`,集成测试会跳过或失败,请先安装依赖。 ## 命令行接口 编码: ```bash python encode.py in.bin out.mp4 1000 ``` - `in.bin`:输入二进制文件(<=10MB) - `out.mp4`:输出视频文件 - `1000`:最大时长(ms),输出视频不会超过该上限 解码: ```bash python decode.py recorded.mp4 out.bin vout.bin ``` - `recorded.mp4`:拍摄后回传的视频 - `out.bin`:解码输出 - `vout.bin`:每字节有效性位掩码(与 `out.bin` 等长;`0xFF` 表示该字节位全有效,`0x00` 表示无效) ## 项目结构 ```text encode.py / decode.py # 题目要求的入口脚本 src/entry # CLI 路由 src/services # 编码/解码编排 src/domain # 协议、FEC、调制核心规则 src/adapters # ffmpeg 与图像读写适配层 tests/ # 单元与集成测试 logs/project_journal.yaml # workflow 任务日志 ``` ## 测试 ```bash python -m pytest ``` 如果出现报错``pyproject.toml: Invalid statement (at line 1, column 1)`` 输入 ```bash type pyproject.toml ``` 如果出现乱码,可能是toml编码错误,比如``UTF-8 with BOM``,请重新编码至UTF-8 ## 测评 将[测评项目](https://gitee.com/whuangxm/cni-prj1-aux)clone至本地,然后使用Visual Studio打开auxtools.sln 点击生成-生成解决方案,即可在/x64/Debug得到auxtool.exe 在PowerShell进行以下步骤(假设clone至./.tmp_cni_prj1_aux): ``` powershell cd .tmp_cni_prj1_aux &&^ x64/Debug/auxtool msg 5 1048576 &&^ cd .. $N = 5 for ($i=1; $i -le $N; $i++) { python encode.py ".tmp_cni_prj1_aux/e$($i).bin" ".tmp_eval/tx$($i).mp4" 1000 } ``` 或者: ```bash python encode.py ".tmp_cni_prj1_aux/e1.bin" ".tmp_eval/tx1.mp4" 30000 &&^ python encode.py ".tmp_cni_prj1_aux/e2.bin" ".tmp_eval/tx2.mp4" 30000 &&^ python encode.py ".tmp_cni_prj1_aux/e3.bin" ".tmp_eval/tx3.mp4" 30000 &&^ python encode.py ".tmp_cni_prj1_aux/e4.bin" ".tmp_eval/tx4.mp4" 30000 &&^ python encode.py ".tmp_cni_prj1_aux/e5.bin" ".tmp_eval/tx5.mp4" 30000 ``` 上面的数字1到5试一遍 ### 直通自测(不经过手机) 如果只想验证编解码主链路,请先把同一次编码得到的 `tx` 复制为 `rec`,再解码,避免混入历史文件: ```powershell $N = 5 for ($i=1; $i -le $N; $i++) { Copy-Item -Force ".tmp_eval/tx$($i).mp4" ".tmp_eval/rec$($i).mp4" } ``` 注意:默认参数 `1000ms` 且 `20fps` 时,每个视频只有约 `20` 帧,传输位数本身会很有限;若做容量测试,请增大 `max_ms`(例如 `30000`)。 - 手动步骤:播放 .tmp_eval/tx$i.mp4,用手机录制并拷回为 .tmp_eval/rec$i.mp4 ```powershell $N = 5 for ($i=1; $i -le $N; $i++) { python decode.py ".tmp_eval/rec$($i).mp4" ".tmp_cni_prj1_aux/$i.bin" ".tmp_cni_prj1_aux/v$($i).bin" } ``` 或者 ```bash python decode.py ".tmp_eval/rec1.mp4" ".tmp_cni_prj1_aux/1.bin" ".tmp_cni_prj1_aux/v1.bin" &&^ python decode.py ".tmp_eval/rec2.mp4" ".tmp_cni_prj1_aux/2.bin" ".tmp_cni_prj1_aux/v2.bin" &&^ python decode.py ".tmp_eval/rec3.mp4" ".tmp_cni_prj1_aux/3.bin" ".tmp_cni_prj1_aux/v3.bin" &&^ python decode.py ".tmp_eval/rec4.mp4" ".tmp_cni_prj1_aux/4.bin" ".tmp_cni_prj1_aux/v4.bin" &&^ python decode.py ".tmp_eval/rec5.mp4" ".tmp_cni_prj1_aux/5.bin" ".tmp_cni_prj1_aux/v5.bin" ``` - 最后跑 benchmark: ```powershell Push-Location .tmp_cni_prj1_aux ./bin/auxtool bench 5 1048576 Pop-Location ``` 或者 ```bash cd .tmp_cni_prj1_aux x64\Debug\auxtool bench 5 1048576 cd .. ``` 它会输出每组和平均的 `Val.(b) / All(b) / Err.(%) / Lost(%)`。 ### 梁宁炜本地记录流程 1. 在终端输入命令`./auxtool/auxtool.exe msg 5 1048576`生成e1.bin到e5.bin 2. 在终端输入命令 ``` $N = 5 for ($i=1; $i -le $N; $i++) { python encode.py ".tmp_cni_prj1_aux/e$($i).bin" ".tmp_eval/tx$($i).mp4" 1000 } ``` 生成tx1.mp4到tx5.mp4 3. 在终端输入命令 ``` $N = 5 for ($i=1; $i -le $N; $i++) { Copy-Item -Force ".tmp_eval/tx$($i).mp4" ".tmp_eval/rec$($i).mp4" } ``` 生成rec1.mp4到rec5.mp4 4. 解码输入命令 ``` $N = 5 for ($i=1; $i -le $N; $i++) { python decode.py ".tmp_eval/rec$($i).mp4" ".tmp_cni_prj1_aux/$i.bin" ".tmp_cni_prj1_aux/v$($i).bin" } ``` 生成v1.bin到v5.bin 5. 跑bench `./auxtool/auxtool.exe bench 5 1048576` 生成结果