Cahute：卡西欧计算器的通信和文件格式管理工具

CalcLoverHK

Cahute是一系列命令行工具和函数库，处理卡西欧90年代至今计算器相关的串行及USB通信协议和文件格式，由Cakeisalie5基于其前作libp7和p7utils开发。

目前最新版本（0.5）的Cahute能做到：

• 经USB/串行连接与fx-9860G系列计算器双向传输
• 经USB共享fx-9860G/fx-CG系列计算器画面
• 刷写及备份fx-9860G系统
  

此专案遵循CeCILL 2.1开源协议。

【请在右上角输入要前往的楼层】
1楼：总览
2楼：安装流程
3楼：p7指令概述
4楼：p7screen指令概述
5楼：p7os指令概述
6楼：快速教程：取得计算器信息
7楼：快速教程：传送文件至计算器存储
8楼：快速教程：从计算器存储取得文件
9楼：快速教程：显示计算器画面

计划中的内容：

• 进阶教程：使用p7os将一台9750升级为9860
• 日志记录等级概述
  

相关链接
官方网站 【预览版】
软件仓库
问题报告指南
成为贡献者

CalcLoverHK

Windows/WSL 2
目前Cahute没有官方Windows安装途径，但是你可以在Linux上使用MinGW跨平台编译Windows可执行文件：
https://next.cahuteproject.org/guides/build.html#mingw-w64-windows-xp-and-above-from-linux-distributions

WSL 2原生不支持USB通信，但是可以安装usbipd-win软件以解决这个问题。
由于该项目托管在GitHub上，考虑到此网站在国内的存取问题，本帖会提供其安装包：
usbipd-win_4.3.0.msi (4.55 MB, 下载次数: 1)

6 天前 上传

点击文件名下载附件

微软官网为此软件写了一篇教程，本帖将围绕此文章展开：
https://learn.microsoft.com/zh-cn/windows/wsl/connect-usb#attach-a-usb-device

使用USB连接你的计算器到电脑，然后以管理员模式打开Powershell（命令提示符也可以）并输入以下指令：

1. usbipd list

复制代码

显示的列表应包含以下组合之一：

1. 07cf:6101 CESG502
   
2. 07cf:6102 Casio MassStorage Device
   
3. 07cf:6103 USB Mass Storage Device

复制代码

07cf为卡西欧的厂商识别码，而冒号后面的4位数是其产品识别码。
记下计算器的BUSID，并在WSL实例运行时执行以下指令进行绑定（仅此部分需要管理员权限）：

1. usbipd bind -b <BUSID>

复制代码

最后，同样是在实例运行时执行以下指令将计算器USB设备附加到WSL主机：

1. usbipd attach -w -b <BUSID>

复制代码

值得留意的是断开再重新连接时需要重复上述步骤。要想始终连接到WSL实例，请在此指令后面加上`-a`选项：

1. usbipd attach -w -b <BUSID> -a

复制代码

macOS / OS X
苹果电脑用户可以使用Homebrew安装Cahute。
安装Homebrew后，请先断开所有计算器与电脑的通信再安装Cahute，否则可能会导致安装失败：

1. brew install cahute

复制代码

Arch Linux / Manjaro Linux
Arch用户软件仓库（AUR）提供Cahute软件包，根据你喜好的AUR助手安装Cahute，例如paru或pikaur：

1. paru -S cahute
   
2. pikaur -S cahute

复制代码

安装Cahute后，请将自己的用户名加入到uucp群组，以允许Linux与计算器通信：

1. sudo usermod -a -G uucp <你的用户名>

复制代码

GiteaPC
GiteaPC是一个Python程序工具，实现Planète Casio（卡西欧星球）开发者程序和函数库的自动化安装和更新。
以下指令将安装稳定版本分支（截至2024/10/10，最新稳定版本为0.5）：

1. giteapc install cake/[email protected]

复制代码

如果你想安装开发版本，只需将`@0.5`替换为`@develop`即可。
Cahute的默认日志记录等级为`warning`，即只显示错误信息。想要显示调试信息（即`info`等级），请加上`:contributor`。
由于GiteaPC将udev规则安装在.local目录下，如果你想在整个系统中都能使用Cahute，请移动该规则配置文件到系统目录：

1. sudo mv ~/.local/lib/udev/rules.d/*.rules /etc/udev/rules.d/

复制代码

然后手动重启udev管理器：

1. sudo udevadm control --reload

复制代码

将自己的用户名加入到uucp群组，然后重启WSL会话：

1. sudo usermod -a -G uucp <你的用户名>

复制代码

自行编译
出于篇幅考虑，本帖只涵盖适用于绝大部分Linux发行版的手动编译过程。其他方法请前往Cahute官方网站查阅：
https://next.cahuteproject.org/guides/build.html

Cahute的依赖项为：

• CMake（3.16+）
• Python（3.8+）及toml模块
• GNU Make及pkg-config
• SDL（2.0+）
• libusb
  

选择以下两种途径之一下载Cahute源代码：

1. curl -o cahute-0.5.tar.gz https://ftp.cahuteproject.org/releases/cahute-0.5.tar.gz
   
2. tar xvaf cahute-0.5.tar.gz

复制代码

1. git clone https://gitlab.com/cahuteproject/cahute.git cahute-0.5

复制代码

然后进行系统升级并安装所有依赖项：

• Debian系发行版
  

1. sudo apt-get update
   
2. sudo apt-get install cmake python3 python3-toml libusb-1.0-0-dev libsdl2-dev

复制代码

• Arch Linux系发行版
  

1. sudo pacman -Sy cmake python python-toml libusb sdl2

复制代码

• Void Linux系发行版
  

1. xbps-install cmake python3 python3-toml libusb-devel sdl2-devel

复制代码

在源代码压缩包的父目录下使用CMake编译Cahute：

1. cmake -B build -S cahute-0.5 -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release

复制代码

如果你想直接安装到系统上，请使用以下指令：

1. sudo cmake --install build --strip

复制代码

或者安装到指定文件夹里：

1. DESTDIR=./<文件夹位置> cmake --install build --strip

复制代码

安装Cahute时CMake会自动配置udev规则，这意味着你需要手动重启udev管理器：

1. sudo udevadm control --reload

复制代码

将自己的用户名加入到uucp群组，然后重启WSL会话：

1. sudo usermod -a -G uucp <你的用户名>

复制代码

CalcLoverHK

完整版（英文）：https://next.cahuteproject.org/cli/p7.html

p7命令用于与计算器存储器的交互。

通用参数
适用于所有子命令的选项：

• -h, --help：显示p7子命令帮助页面。
• -v, --version：显示版本信息及许可证。
• -l, --log <等级>：设置日志记录等级。（info，warning，error，fatal，none）
  参考此章节以知悉各日志记录等级的用途：
  https://next.cahuteproject.org/topics/logging.html
  

串行相关选项：

• --com <串行设备路径>：指定串行设备的位置。如忽略此选项，p7会选取USB模式下的计算器。
• --use <波特率><奇偶校验位><停止位元数>：使用串行参数。
  <波特率>：通常为9600的倍数。默认为9600。
  <奇偶校验位>：O（奇数），E（偶数），N（禁用）
  <停止位元数>：1/2
  如果没有指定--com选项，此选项将被忽略。
• --set <波特率><奇偶校验位><停止位元数>：设置计算器的串行参数。
  如果没有指定--com选项，此选项将被忽略。
• --reset：重置串行参数至9600N2。
• --no-init：当开启连接时禁用起始握手信号。多用于连续执行p7指令。
• --no-exit：当关闭连接时禁用终止握手信号。多用于连续执行p7指令。
  

list-device子命令

1. p7 list-device

复制代码

显示可用串行设备的路径。
例子：

1. $ p7 list-devices
   
2. Available devices:
   
3. 
   
4. - /dev/ttyUSB1
   
5. - /dev/ttyUSB2

复制代码

info子命令

1. p7 info

复制代码

显示已连接计算器的软硬件信息。

idle子命令

1. p7 idle

复制代码

不进行任何p7子命令用途，只用于连续执行命令时初始化、终止或更新串行参数。

send子命令

1. p7 send [选项...] <本地文件位置>

复制代码

传送在当前目录下的文件到计算器上。
可用选项：

• -#：显示进度条。
• -f, --force：如果计算器有相同名字的文件，强制覆写该文件。默认情况下计算器会提示是否进行覆写操作。
• -o, --output <文件名>：指定文件在计算器上的文件名。默认为本地文件位置的基本名称。
• -d, --directory <文件夹>：指定计算器的目的地文件夹。默认为计算器的根目录。
• --storage <存储地>：指定存储地。（fls0：存储内存，crd0：SD卡）
  

get子命令

1. p7 get [选项...] <文件名>

复制代码

取得计算器上的文件。
可用选项：

• -#：显示进度条。
• -o, --output <文件名>：指定文件在电脑上的文件名。如果当前目录上有相同名字的文件，该文件将会被覆写。默认为计算器文件位置的文件名。
• -d, --directory <文件夹>：指定计算器文件所在的文件夹。默认为计算器的根目录。
• --storage <存储地>：指定存储地。（fls0：存储内存，crd0：SD卡）
  

copy子命令

1. p7 copy [选项...] <文件名> <目的地文件名>

复制代码

复制计算器上的文件到其他位置。
可用选项：

• -d, --directory <文件夹>：指定文件名所在的文件夹。默认为计算器的根目录。
• -t, --to <目的地文件夹>：指定目的地文件名所在的文件夹。默认为计算器的根目录。
• --storage <存储地>：指定存储地。（fls0：存储内存，crd0：SD卡）
  

delete子命令

1. p7 delete [选项...] <文件名>

复制代码

删除计算器上的文件。
可用选项：

• -d, --directory <文件夹>：指定计算器文件所在的文件夹。默认为计算器的根目录。
• --storage <存储地>：指定存储地。（fls0：存储内存，crd0：SD卡）
  

list子命令

1. p7 list [选项...]

复制代码

列出计算器上的文件。
可用选项：

• -d, --directory：指定计算器的文件夹。默认为计算器的根目录。
• --storage <存储地>：指定存储地。（fls0：存储内存，crd0：SD卡）
  

reset子命令

1. p7 reset [选项...]

复制代码

初始化计算器的储存。
可用选项：

• --storage <存储地>：指定存储地。（fls0：存储内存，crd0：SD卡）
  

optimize子命令

1. p7 optimize [选项...]

复制代码

优化计算器的储存。
可用选项：

• --storage <存储地>：指定存储地。（fls0：存储内存，crd0：SD卡）
  

CalcLoverHK

完整版（英文）：https://next.cahuteproject.org/cli/p7screen.html

p7screen指令用于投影计算器画面至电脑。

1. p7screen <选项...>

复制代码

可用选项：

• -h, --help：显示p7screen指令帮助页面。
• -v, --version：显示版本信息及许可证。
• -l, --log <等级>：设置日志记录等级。（info，warning，error，fatal，none）
  参考此章节以知悉各日志记录等级的用途：
  https://next.cahuteproject.org/topics/logging.html
  

• --com：指定串行设备的位置。默认情况下p7会选取USB模式下的计算器。
• --use：设置串行参数。格式为<波特率><奇偶校验位><停止位元数>：
  <波特率>：通常为9600的倍数。默认为9600。
  <奇偶校验位>：O（奇数），E（偶数），N（禁用）
  <停止位元数>：1/2
  如果没有指定--com选项，此选项将被忽略。
• --zoom：设置放大倍率，范围为1-16。
  

CalcLoverHK

此部分涉及刷写系统固件，操作不当可能会导致你的计算器变砖和失去保修！请仔细阅读后再进行实际操作。
完整版（英文）：https://next.cahuteproject.org/cli/p7os.html

p7os用于与计算器系统的交互和升级系统。

通用参数

• -h, --help：显示p7os指令帮助页面。
• -v, --version：显示版本信息及许可证。
• -l, --log <等级>：设置日志记录等级。（info，warning，error，fatal，none）
  参考此章节以知悉各日志记录等级的用途：
  https://next.cahuteproject.org/topics/logging.html
• -#：显示进度条。
• --no-prepare：不要上载Update.EXE，取决于该升级程序是否已经上载并在计算器上运行。
• -u, --uexe：使用自定义刷写程序。
  如果未指定--no-prepare，必须要指定此选项。
  

prepare-only子命令

1. p7os prepare-only

复制代码

上载Update.EXE至计算器。

flash子命令

1. p7os flash [--erase-flash] <os.bin>

复制代码

刷写系统驱动。
可用选项：

• --erase-flash：清除储存。
  

get子命令

1. p7os get [-o <os.bin>]

复制代码

取得系统驱动。
可用选项：

• -o, --output <文件名>：指定系统驱动的名称。
  

CalcLoverHK

如果你使用USB...

• 使用mini-B USB电缆连接你的计算器。
• 在计算器的对话框上选择DataTrans。
• 执行p7 info指令。
  

如果你使用串行...

• 使用SB-88或相容电缆连接你的计算器。
• 将计算器的电缆类型设置为3PIN，并进入接收模式。
• 执行p7 list-devices指令找出你的计算器所在的串行设备位置。
• 执行p7 --com <串行设备位置> info指令。
  

执行指令后，你应该能得到类似于以下的信息：

1. Warning: Preprogrammed ROM information looks wiped out!
   
2. Warning: Username is not set.
   
3. CPU ID (probably out of date): RENESAS SH733701
   
4. Environnement ID: Gy363000
   
5. Product ID: kpQMLCpq
   
6. ROM capacity: 4096KiB
   
7. RAM capacity: 128KiB
   
8. Bootcode version: 00.10.0010
   
9. Bootcode size: 64KiB
   
10. OS version: 01.10.0000
    
11. OS offset: 0x00010000
    
12. OS size: 2496KiB

复制代码

CalcLoverHK

此教程假设你需要传送一个名为MYADDIN.G1A的文件。

如果你使用USB...

• 使用mini-B USB电缆连接你的计算器。
• 在计算器的对话框上选择DataTrans。
• 执行p7 send MYADDIN.G1A指令将此文件传送至计算器。
  

如果你使用串行...

• 使用SB-88或相容电缆连接你的计算器。
• 将计算器的电缆类型设置为3PIN，并进入接收模式。
• 执行p7 list-devices指令找出你的计算器所在的串行设备位置。
• 执行p7 --com <串行设备位置> send MYADDIN.G1A指令将此文件传送至计算器。
  

如果计算器上有相同名字的文件，p7会询问你是否覆盖此文件。

• 输入y确定覆盖操作，或；
• 输入n取消传送文件。