themactep/thingino-firmware - 快速上手

由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名

项目介绍快速开始学习路径项目截图 1 贡献者 78 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品上榜历史

Thingino 固件 5 分钟快速开始

通过 Docker 快速构建和运行面向 Ingenic SoC IP 摄像头的开源 Thingino 固件。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Docker 最新版本必需

所需工具

Git

克隆项目源码

必需

操作步骤

克隆项目仓库

使用 Git 克隆 Thingino 固件仓库的稳定分支。

克隆项目代码到本地目录

git clone -b stable https://github.com/themactep/thingino-firmware.git

进入项目目录

cd thingino-firmware

预期结果：：显示克隆进度，并成功进入 thingino-firmware 目录。

如果网络不佳，可以尝试使用镜像源或耐心等待。

启动 Docker 构建环境

项目提供了 Docker 环境来简化依赖和工具链管理。此命令将构建 Docker 镜像并启动一个容器，容器内包含所有构建所需工具。

启动构建容器并进入 bash 环境

docker-compose run --rm thingino-build bash

预期结果：：首次运行会下载和构建 Docker 镜像，可能需要几分钟。完成后会进入容器内的 bash 提示符，例如 `root@container-id:/build#`。

确保 Docker 服务正在运行。此步骤首次执行耗时较长，后续会很快。

配置并编译固件

在 Docker 容器内，使用 `make` 命令为一个示例摄像头（如 T20）配置并编译固件。这将下载工具链和依赖项，并开始编译。

为 T20 系列摄像头（如 tplink_c200）加载预设配置

make br-t20zc_config

开始编译整个固件，包括工具链、内核、应用和文件系统

make

预期结果：：配置步骤会生成 `.config` 文件。编译过程会输出大量日志，最终在 `output/images/` 目录下生成固件镜像文件。

编译过程需要较长时间（取决于机器性能），首次编译可能需要1-2小时。可以使用 `make toolchain` 仅构建工具链以节省时间，但完整编译才能看到最终效果。

定位生成的固件

编译完成后，生成的固件文件位于 `output/images/` 目录下。主要的文件是 `.img` 后缀的镜像文件。

列出生成的固件镜像文件及其大小

ls -lh output/images/*.img

预期结果：：显示类似 `thingino-...-t20zc.img` 的文件列表及其大小。

如果只想快速验证构建流程是否成功，看到此步骤的输出即可确认。

验证构建成功

成功编译出固件镜像文件。

在 `output/images/` 目录下存在以 `.img` 结尾的文件

编译过程没有报错并正常退出

快速提示

效率

为了节省时间，可以先只运行 `make` 而不指定具体摄像头配置，它会使用默认配置进行快速验证编译流程。

资源

构建过程需要大量磁盘空间（约15-20GB），请确保有足够的存储空间。

分支选择

项目主分支 (`master`) 包含实验性功能，稳定分支 (`stable`) 更适合快速体验。

常见问题

Docker 命令执行失败

确认 Docker 守护进程正在运行。在 Linux 上，可能需要将用户添加到 `docker` 组或使用 `sudo`。

编译过程中出现 `not found` 或权限错误

请在项目提供的 Docker 容器内执行所有 `make` 命令，而不是在宿主机上。

编译中途失败或中断

可以尝试运行 `make clean` 清理后重新开始，或检查网络连接是否稳定（需下载大量源码包）。

下一步

选择特定摄像头配置

在 `configs/` 目录下查找你拥有的摄像头型号对应的 `_defconfig` 文件，并使用 `make <your_camera>_config` 进行配置。

刷写固件到摄像头

参考项目 Wiki 中的 [Camera Recovery](https://github.com/themactep/thingino-firmware/wiki) 和固件刷写指南，将生成的 `.img` 文件刷入摄像头。

加入社区

加入 [Discord](https://discord.gg/xDmqS944zr) 或 [Telegram](https://t.me/thingino) 群组获取帮助和最新动态。