clockworkpi/uConsole
GitHub: clockworkpi/uConsole
uConsole 是一款便携式 Linux 掌上终端设备的官方代码与资源仓库，提供多型号 OS 镜像、内核补丁、硬件原理图及固件等全套技术文档。
Stars: 957 | Forks: 116
# uConsole
## uConsole OS 镜像
|产品 | 镜像名称 |发布日期 | 系统 | 内核 |大小| 下载 | MD5sum |
|--------|:----------|:------------|:--------|:--------------|:------------|:--------------|:---------:|
|uConsole CM4 | uConsole_CM4_v3.1_64bit.img.bz2| 2026年4月14日 | 64-bit| Linux 6.12.62| 2.1G | [下载](http://dl.clockworkpi.com/uConsole_CM4_v3.1_64bit.img.bz2 ) ([镜像站](https://drive.google.com/file/d/17OFCPCBwddaqQ957R4vbY-3KzugGtaU-/view?usp=drive_link )) | 1b31b501d11d95da7f1380d50d47a8a9 |
|uConsole CM4 | uConsole_CM4_v0.1b_xfce_64bit.img.7z| 2023年4月5日 | 64-bit| Linux 5.10.17| 1.2G | [下载](http://dl.clockworkpi.com/uConsole_CM4_v0.1b_xfce_64bit.img.7z ) ([镜像站](https://drive.google.com/file/d/1gBpVK1rMM5zmq5z4-DlKlDmTFJQvwMFz/view?usp=drive_link )) | a191603d7da0f826d347f1bb8d525687 |
|uConsole A06 | uConsole_A06_v1.1e.img.7z| 2023年7月1日 | 64-bit| Linux 5.15.119| 1.4G | [下载]( http://dl.clockworkpi.com/uConsole_A06_v1.1e.img.7z) ([镜像站](https://drive.google.com/file/d/1H5wdB_cCSW-qbf6Ijgcn-Uw4EQQkWrP1/view?usp=drive_link )) | 56bbb623f41bf6327d408fb415052819 |
|uConsole R01 | uConsole_R01_v1.3b.img.7z| 2023年6月13日 | 64-bit| Linux 5.4.61| 1.4G | [下载](http://dl.clockworkpi.com/uConsole_R01_v1.3b.img.7z ) ([镜像站](https://drive.google.com/file/d/1lDdO3-aj8zeO6JDJVBaCgNkehhffdNm1/view?usp=drive_link )) | 53ca37ccc0333436d06fb5978ac699fd |
uConsole_CM4_v0.1b_xfce_64bit.img.7z （基于 [RPI-lite](https://downloads.raspberrypi.org/raspios_lite_armhf/images/raspios_lite_armhf-2023-05-03/2023-05-03-raspios-bullseye-armhf-lite.img.xz) 并带有 xfce）
此版本专为沉浸式写作优化，并预装了 [Obsidian](https://obsidian.md/)。
## 镜像站
* 社区驱动的下载镜像站：[http://dl.clockworkpi.io](http://dl.clockworkpi.io)
下载文件后，您将需要提取或解压它们。请注意，解压 7z 文件需要 MacOS 11.6 或更高版本。
您可以使用以下工具刷写 OS 镜像：
- Windows 和 macOS 用户可以使用 [Etcher](https://etcher.balena.io/) 来刷写镜像。
- Linux 用户可以使用 "dd" 命令来刷写镜像。
要了解如何创建镜像，请参阅我们的 [Wiki](https://github.com/clockworkpi/uConsole/wiki)。
如果您想使用 4G 扩展模块，可以在 [uConsole Wiki](https://github.com/clockworkpi/uConsole/wiki/How-to-use-the-4G-extension) 上找到相关的使用提示。
## uConsole 键盘固件
uConsole 键盘固件刷写程序已发布。您可以从以下链接下载：[uConsole 键盘固件刷写程序](https://github.com/clockworkpi/uConsole/raw/master/Bin/uconsole_keyboard_flash.tar.gz)。
以下是在 uConsole（A06 或 CM4）或运行 Ubuntu 22.04 的 PC 上刷写固件的方法：
1. 下载 uconsole_keyboard_flash.tar.gz 文件。
2. 解压压缩包内容：`tar zxvf uconsole_keyboard_flash.tar.gz`。
3. 使用以下命令安装所需的软件包：`sudo apt install -y dfu-util`。
4. 进入解压后的目录：`cd uconsole_keyboard_flash`。
5. 使用 root 权限执行刷写脚本：`sudo ./flash.sh`。
6. 如果一切顺利，您将看到一个指示刷写过程的进度条。
7. 如果出现任何问题或键盘失去控制（这种情况不太可能发生），只需重启 uConsole 即可解决。
8. 请放心，此刷写程序不会让您的键盘变砖。
## 4G 扩展模块固件
[升级 4G 扩展模块固件](https://github.com/clockworkpi/uConsole/wiki/How-to-upgrade-4G-extension-firmware)
## 组装指南
* [组装指南](https://github.com/clockworkpi/uConsole/blob/master/Clockwork_uConsole_Assembly_Guidelines.pdf)
## 原理图
* [A06 核心主板 v3.14 原理图](https://github.com/clockworkpi/uConsole/blob/master/clockwork_DevTerm_A06_Core_for_Mainboard_V3.14_Schematic.pdf)
* [R01 核心主板 v3.14 原理图](https://github.com/clockworkpi/uConsole/blob/master/clockwork_DevTerm_R01_Core_for_Mainboard_V3.14_Schematic.pdf)
* [主板 v3.14 原理图](https://github.com/clockworkpi/uConsole/blob/master/clockwork_Mainboard_V3.14_Schematic.pdf)
* [主板 v3.14-V5 原理图](https://github.com/clockworkpi/uConsole/blob/master/clockwork_Mainboard_V3.14_V5_Schematic.pdf)
* [CM4 适配器原理图](https://github.com/clockworkpi/uConsole/blob/master/clockwork_Adapter_CM4_Schematic.pdf)
* [4G 扩展原理图](https://github.com/clockworkpi/uConsole/blob/master/clockwork_UC_4G_Schematic.pdf)
## Gearbox
### A06
Gearbox 是一个用于调整 A06 芯片 big.LITTLE 架构的脚本工具。
您可以通过运行以下命令来获取它：
```
sudo apt update
sudo apt install -y devterm-gearbox-a06
```
在最新的 A06 OS 镜像中，默认的 Gearbox 设置为使用 4 个运行在 816Mhz 的 LITTLE 核心，GPU 运行在 400Mhz。
您可以运行 `a06-gearbox` 来查看当前的核心状态。
```
Current Status:
+-----------------------------------+-----------------+-----------+
| Cortex-A53 | Cortex-A72 | Mali-T860 |
+--------+--------+--------+--------+--------+--------+-----------+
| CPU 0 | CPU 1 | CPU 2 | CPU 3 | CPU 4 | CPU 5 | GPU |
+--------+--------+--------+--------+--------+--------+-----------+
| 816Mhz | 816Mhz | 816Mhz | 816Mhz | OFF | OFF | 400MHz |
+--------+--------+--------+--------+--------+--------+-----------+
CPU Governor: schedutil GPU Governor: simple_ondemand
```
运行 `sudo a06-gearbox -s [GEAR]` 来设置档位，GEAR 可以是 1, 2, 3, 4, 5, 6。
Gearbox 中共有 6 个档位。
```
1 for simple writing tasks with long battery life.
2 for browsing most websites with long battery life.
3 for most 2D games and emulators.
4 for playing videos and 3D games.
5 for performance-first tasks.
6 for max performance, max power (usage).
```
## 社区
请访问我们的 [Github Wiki](https://github.com/clockworkpi/uConsole/wiki) 和 https://forum.clockworkpi.com 获取更多信息。
标签：Cutter, 嵌入式Linux, 掌上主机, 操作系统镜像, 硬件图纸, 硬件支持, 驱动与固件