From 3013343e1922fc4a713f7a64e2603c0a9856aeb2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Sun, 24 Mar 2024 18:46:11 +0000 Subject: [PATCH 01/14] Partially translated README to Simplified Chinese --- README_zhCN.md | 169 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 README_zhCN.md diff --git a/README_zhCN.md b/README_zhCN.md new file mode 100644 index 0000000..7313983 --- /dev/null +++ b/README_zhCN.md @@ -0,0 +1,169 @@ +# fxSDK + +*Planète Casio 上的一个帖子：[fxSDK 是另外一套开发计算器程序的工具链（法语帖子）](https://www.planet-casio.com/Fr/forums/topic13164-last-fxsdk-un-sdk-alternatif-pour-ecrire-des-add-ins.html)* + +fxSDK 是一套开发卡西欧图形计算器里的程序的工具，里面提供了命令行工具、构建系统以及一个跨平台编译器，用来开发程序以及库。这套工具需要和 [gint 内核](/Lephenixnoir/gint) 一起使用，因为这个内核提供的运行时非常之厉害。 + +这个仓库只提供了 SDK 的命令行工具。如果想要构建程序，需要一些其他的组件，比如[跨平台编译器](/Lephenixnoir/sh-elf-gcc)还有 [gint 内核](/Lephenixnoir/gint)。更多信息请移步至[如何安装]()。 + +fxSDK 以 [MIT 协议](LICENSE)发布。 + +## 支持的机型及其兼容性 + +**计算器** + +fxSDK，或者说 gint，支持卡西欧 fx-9860G 系列几乎所有的型号，包括： + +* ![](https://www.planet-casio.com/images/icones/calc/g85.png)（部分支持）基于SH3 的 fx-9860G、fx-9860G SD、以及类似运行 1.xx 版本操作系统的型号，还有 fx-9860G SDK 里的模拟器。 +* ![](https://www.planet-casio.com/images/icones/calc/g95.png) 基于 SH3 的 fx-9750G、fx-9860G II、fx-9860G II SD，以及类似运行 2.xx 版本操作系统的型号。 +* ![](https://www.planet-casio.com/images/icones/calc/g75+.png) 所有基于 SH4 且运行操作系统 2.xx 的型号，包括 fx-9750G II 与 SH4 的 fx-9860G II。 +* ![](https://www.planet-casio.com/images/icones/calc/g35+e2.png) fx-9750G III 与 fx-9860G III。 + +也支持卡西欧 fx-CG 系列的计算器： + +* ![](https://www.planet-casio.com/images/icones/calc/cg20.png) 经典款 fx-CG 10/20。 +* ![](https://www.planet-casio.com/images/icones/calc/g90+e.png) fx-CG 50。 + +**操作系统** + +* Linux 有官方支持。只要装好了依赖，任何的发行版都可以运行。 +* macOS 由于缺少测试，需要进行一些小小的调整才可以运行。 +* Windows 因为有 WSL（Linux 子系统），所以也有官方支持。然而 Windows 本身并不受支持，但如果您想的话可以尝试贡献。 + +**编程语言** + +* C 语言：支持最新版 GCC，目前是 C11 或者 C2X。标准库 [fxlibc](https://gitea.planet-casio.com/Vhex-Kernel-Core/fxlibc/) 是我们自行构建的，大致遵循 C99。使用其他的标准库也是可以的。 +* C++：支持最新版 GCC，目前是 C++20 或者 C++23。标准库 [libstdc++](https://gcc.gnu.org/onlinedocs/libstdc++/) 也是最新的。 +* 汇编语言：卡西欧计算器的处理器为 SuperH 架构，其中数 SH4AL-DSP 最多。二进制工具里面提供的汇编器可供使用。 +* 还想要其他的语言？只要能编译到 C 就行，比如 [fxtran for Fortran](https://www.planet-casio.com/Fr/forums/topic17064-1-fxtran-codez-en-fortran-pour-votre-casio.html)。其他的 GCC 支持的前端语言也可以，比如 [the D compiler builds](https://www.planet-casio.com/Fr/forums/topic17037-last-omegafail-dlang-et-gint.html)。对于那些基于 LLVM 的语言（比如 Rust）不在考虑范围内，因为 LLVM 没有 SuperH 后端。 + +**构建系统** + +fxSDK 主要使用 CMake 来构建程序和库。有个老的 Makefile 模板仍然可以用，而且命令行工具仍有官方支持，但是在更新的时候就得手动修改您自己的构建系统了。 + +## 如何安装 + +The following options are all for installing the entire fxSDK including the cross-compiler, libraries, etc. not just this repository. + +**方法一：使用 GiteaPC（新手推荐，虽然现在不叫这个了）** + +[GiteaPC](https://gitea.planet-casio.com/Lephenixnoir/GiteaPC) is a package-manager-like set of scripts to clone, build and install repositories from Planète Casio's Gitea forge. It automates basically the entire process, and is the recommended way to get the fxSDK up and running. See the instructions on the repository's README. + +**方法二：在 Arch Linux 发行版里使用 AUR** + +[Dark Storm](https://www.planet-casio.com/Fr/compte/voir_profil.php?membre=Dark%20Storm) maintains a package repository for Arch called [MiddleArch](https://www.planet-casio.com/Fr/forums/topic16790-1-middlearch-un-depot-communautaire.html) which includes consistently up-to-date versions of the fxSDK. + +**方法三：手动构建（如果您是专家）** + +You can build the fxSDK and its tools manually by following the instructions in each README file. Please refer to the GiteaPC tutorial for a list of what to install in what order. As a warning: there is quite a lot of stuff (SDK tools, the cross-compiler, a libm, a libc, the libstdc++, the kernel, user libraries and then some) so expect to spend some time installing and updating everything. + +## 命令行工具 + +When developing add-ins with the fxSDK, you mainly interact with command-line tools and the fxSDK's build system. Let's first have a look at the command-line tools. You can get the command-line help for any tool by invoking it without arguments, eg `fxsdk` or `fxgxa`. + +*Note: A tool called `fxos` used to live here and has now moved to [its own repository](/Lephenixnoir/fxos).* + +使用 `fxsdk` 来**管理项目** + +Use the `fxsdk` command to manage projects. You can create an empty add-in project with `fxsdk new` and a name for a new folder: + +``` +% fxsdk new MyAddin +Created a new project MyAddin (build system: CMake). +Type 'fxsdk build-fx' or 'fxsdk build-cg' to compile the program. +``` + +From that folder, you can build the add-in with the `fxsdk build-*` commands: + +```bash +# Build the add-in for fx-98600G-series calculators (.g1a): +% fxsdk build-fx +# Build the add-in for fx-CG-series calculators (.g3a): +% fxsdk build-cg +``` + +You can then send the add-in through your preferred method. Some shortcuts are provided: + +* `fxsdk send-fx` will send the g1a file with [p7](https://gitea.planet-casio.com/cake/p7utils) (which is like FA-124/xfer9860) if it's installed. This works for every fx-9860G-series models except the fx-975G0G III and fx-9860G III. +* `fxsdk send-cg` will send the g3a file with fxlink using UDisks2, replicating the process of copying with the file manager. See below for details about fxlink. + +The command `fxsdk path` reports the folders in which the important files of the SDK (mainly the cross-compiler) are located. + +使用 `fxgxa` 来**生成 G1A 和 G3A 文件** + +`fxgxa` is a versatile g1a/g3a file editor that creates, edits and dumps the header of add-ins files. The build system calls it as part of `fxsdk build-*` so you only need to use it directly when you want to inspect existing add-ins. + +It supports using and dumping PNG icons of any formats, validating header checksums, repairing broken headers and dumping add-in details. Here are the main commands: + +* `fxgxa --g1a|--g3a`: Generate g1a/g3a files +* `fxgxa -e`: Edit g1a/g3a files +* `fxgxa -d`: Dump metadata, checksum, and icon +* `fxgxa -r`: Repair control bytes and checksums for broken files +* `fxgxa -x`: Extract icons into PNG files + +`fxgxa` has an alias, `fxg1a`, for compatibility with fxSDK up to 2.7 for which there was no g3a file editor in the fxSDK. + +使用 `fxconv` 来**转换素材格式** + +`fxconv` is a programmable asset converter that converts images, fonts and other common asset types into data structures usable directly in add-ins. The built-in formats include gint images and fonts, [libimg](/Lephenixnoir/libimg) images, and binary blobs. + +Projects can extend the support to custom types for maps, dialogs, GUI descriptions, or other application-specific assets. Extensions to `fxconv` are implemented in Python within the project. + +`fxconv` is tightly integrated into the build system. Normally you declare assets in a `CMakeLists.txt` file, set their parameters in an `fxconv-metadata.txt` file, and then let the build system do the magic. + +TODO: Link to gint tutorials or better explain how to use fxconv. + +使用 `fxlink` 来**进行 USB 通信** + +`fxlink` is a USB communication tool that can be used to send files to calculators as well as to communicate with gint's USB driver from an add-in. The tool is still it its early stages but already offers two useful features. + +Note: `fxlink` does not work within WSL machines on Windows, see [this bug](https://github.com/Microsoft/WSL/issues/2195). + +The first feature is interactive communication with add-ins using libusb. This allows add-ins to send text, screenshots, and video captures of their output to a computer in real-time. + +The second feature is sending files to fx-CG and G-III calculators (the ones that behave like USB drives) using UDisks2. `fxlink` can mount the calculators, copy files and unmount them from the command-line without root access. + +## 构建系统 + +**使用 CMake** + +The official build system is CMake since fxSDK 2.3. When creating a new project, a default `CMakeLists.txt` is generated. There are few deviations from standard CMake practices; refer to a CMake tutorial for general explanations (there is [an fxSDK-specific one in French on Planète Casio](https://www.planet-casio.com/Fr/forums/topic16647-1-tutoriel-compiler-des-add-ins-avec-cmake-fxsdk.html)). The differences are explained below. + +Because we are using a cross-compiler, we can't just call `cmake` to configure the project; extra parameters are needed. The `fxsdk build-*` commands call CMake for you with the correct parameters. + +The fxSDK provides [a couple of modules](fxsdk/cmake), including: + +* [`FX9860G.cmake`](fxsdk/cmake/FX9860G.cmake) and [`FXCG50.cmake`](fxsdk/cmake/FXCG50.cmake) that are loaded automatically by `fxsdk build-fx` and `fxsdk build-cg` respectively. These are one of the reasons why we don't call `cmake` directly. Anything defined here is available to your `CMakeLists.txt`, which includes a number of variables called `FXSDK_*` to give you information on the target and install. +* [`Fxconv.cmake`](fxsdk/cmake/Fxconv.cmake) which provides functions to use fxconv. `fxconv_declare_assets(... WITH_METADATA)` will mark source files as assets to be converted with fxconv, and `fxconv_declare_converters(...)` declares Python modules containing custom conversion functions. +* [`GenerateG1A.cmake`](fxsdk/cmake/GenerateG1A.cmake) and [`GenerateG3A.cmake`](fxsdk/cmake/GenerateG3A.cmake) wrap `fxgxa` and allow you to generate g1a/g3a files for the add-in. The default `CMakeLists.txt` shows how to use them. +* [`FindSimpleLibrary.cmake`](fxsdk/cmake/FindSimpleLibrary.cmake) and [`GitVersionNumber.cmake`](fxsdk/cmake/GitVersionNumber.cmake) are general utilities for libraries. See the [Lephenixnoir/Template-gint-library](https://gitea.planet-casio.com/Lephenixnoir/Template-gint-library) repository for an example of building a library with the fxSDK. + +**只使用 Makefile** + +The original Makefile used to build add-ins is still available. A Makefile-based project can be created with the `--makefile` option of `fxsdk new`. However that Makefile is rarely tested thus occasionally out-of-date, and in general requires you to maintain it through fxSDK updates. It is only advised to use it if you're experienced with make. + +## 手动构建 + +The following instructions are part of the manual install process for the fxSDK. You should install this repository first. If you previously had an fxSDK setup, cross-compiler, etc. then you should probably remove them before installing the new one to avoid interference. + +这个仓库的依赖: + +* CMake +* libpng ≥ 1.6 +* Python ≥ 3.7（3.6 有可能也可以） +* Python 3 的 Pillow 库 +* libusb 1.0 +* UDisks2 库（在构建工具链的时候如果没用就不用） + +When configuring, you should set an install prefix that you have write access to. I suggest `$HOME/.local`. Note that the cross-compiler *must* be later installed in the path printed by `fxsdk path sysroot`, which is within said prefix. + +* Use `-DCMAKE_INSTALL_PREFIX=...` to change the install folder; +* Use `-DFXLINK_DISABLE_UDISKS2=1` to disable UDisks2 support in `fxlink`, if you don't have UDisks2 or you're using WSL. + +```bash +% cmake -B build [OPTIONS...] +% make -C build +% make -C build install +``` + +You can then proceed to install the cross-compiler. If in doubt about the order in which you need to install repositories, refer to the [GiteaPC README](https://gitea.planet-casio.com/Lephenixnoir/GiteaPC) or check the `giteapc.make` files of each repository, where dependencies are listed. From 82fb8d2716028d41f2cb6bc7ccc44c42baca7285 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Mon, 25 Mar 2024 11:18:11 +0000 Subject: [PATCH 02/14] Add more translation to README_zhCN.md --- README_zhCN.md | 62 ++++++++++++++++++++++++++++---------------------- 1 file changed, 35 insertions(+), 27 deletions(-) diff --git a/README_zhCN.md b/README_zhCN.md index 7313983..1084b83 100644 --- a/README_zhCN.md +++ b/README_zhCN.md @@ -43,15 +43,15 @@ fxSDK 主要使用 CMake 来构建程序和库。有个老的 Makefile 模板仍 ## 如何安装 -The following options are all for installing the entire fxSDK including the cross-compiler, libraries, etc. not just this repository. +这里说明的安装方法不仅仅适用这个仓库，还包括 fxSDK 里的所有东西。 **方法一：使用 GiteaPC（新手推荐，虽然现在不叫这个了）** -[GiteaPC](https://gitea.planet-casio.com/Lephenixnoir/GiteaPC) is a package-manager-like set of scripts to clone, build and install repositories from Planète Casio's Gitea forge. It automates basically the entire process, and is the recommended way to get the fxSDK up and running. See the instructions on the repository's README. +[GiteaPC](https://gitea.planet-casio.com/Lephenixnoir/GiteaPC) 是一个类似包管理器一样的东西，专门用来下载、构建及安装来自 Planète Casio 仓库的东西。整个过程是自动的，所以推荐在安装 fxSDK 的时候使用。 **方法二：在 Arch Linux 发行版里使用 AUR** -[Dark Storm](https://www.planet-casio.com/Fr/compte/voir_profil.php?membre=Dark%20Storm) maintains a package repository for Arch called [MiddleArch](https://www.planet-casio.com/Fr/forums/topic16790-1-middlearch-un-depot-communautaire.html) which includes consistently up-to-date versions of the fxSDK. +[Dark Storm](https://www.planet-casio.com/Fr/compte/voir_profil.php?membre=Dark%20Storm) 为 Arch Linux 维护了一个叫 [MiddleArch](https://www.planet-casio.com/Fr/forums/topic16790-1-middlearch-un-depot-communautaire.html) 的仓库，包含了最新版本的 fxSDK。 **方法三：手动构建（如果您是专家）** @@ -59,49 +59,53 @@ You can build the fxSDK and its tools manually by following the instructions in ## 命令行工具 -When developing add-ins with the fxSDK, you mainly interact with command-line tools and the fxSDK's build system. Let's first have a look at the command-line tools. You can get the command-line help for any tool by invoking it without arguments, eg `fxsdk` or `fxgxa`. +当你用 fxSDK 开发程序的时候，你主要会使用命令行工具和 fxSDK 的构建系统。先来看看命令行工具吧。当你不传任何的参数直接调用工具的时候会显示帮助。例如 `fxsdk` 或 `fxgxa`。 *Note: A tool called `fxos` used to live here and has now moved to [its own repository](/Lephenixnoir/fxos).* 使用 `fxsdk` 来**管理项目** -Use the `fxsdk` command to manage projects. You can create an empty add-in project with `fxsdk new` and a name for a new folder: +你可以用 `fxsdk new` 来创建一个新项目，并指定名字。本例为“MyAddin”： -``` -% fxsdk new MyAddin -Created a new project MyAddin (build system: CMake). -Type 'fxsdk build-fx' or 'fxsdk build-cg' to compile the program. +```sh +fxsdk new MyAddin ``` -From that folder, you can build the add-in with the `fxsdk build-*` commands: +然后进入这个文件夹： ```bash -# Build the add-in for fx-98600G-series calculators (.g1a): -% fxsdk build-fx -# Build the add-in for fx-CG-series calculators (.g3a): -% fxsdk build-cg +cd MyAddin ``` -You can then send the add-in through your preferred method. Some shortcuts are provided: +进入新创建的文件夹之后，就可以用 `fxsdk build-*` 来构建程序： -* `fxsdk send-fx` will send the g1a file with [p7](https://gitea.planet-casio.com/cake/p7utils) (which is like FA-124/xfer9860) if it's installed. This works for every fx-9860G-series models except the fx-975G0G III and fx-9860G III. -* `fxsdk send-cg` will send the g3a file with fxlink using UDisks2, replicating the process of copying with the file manager. See below for details about fxlink. +```bash +# 构建 fx-9860G 系列计算器的程序（后缀 .g1a）： +fxsdk build-fx +# 构建 fx-CG 系列计算器的程序（后缀 .g3a）： +fxsdk build-cg +``` -The command `fxsdk path` reports the folders in which the important files of the SDK (mainly the cross-compiler) are located. +然后你就可以把这个程序用你喜欢的方式发到计算器上了。但是这里有些更简单的方法： + +* `fxsdk send-fx` 会使用 [p7](/cake/p7utils) 来发送 g1a 程序，就像 FA-124 和 xfer9860 那样。除了 fx-975G0G III 和 fx-9860G III，所有 fx-9860G 系列的型号都可以用。 +* `fxsdk send-cg` 会使用 UDisks2 来发送 g3a 程序，其实就相当与您在文件资源管理器里面操作一样。下面具体有写 fxlink 做了什么。 + +`fxsdk path` 会告诉你 SDK 里面的一些重要文件（主要是跨平台编译器）的位置。 使用 `fxgxa` 来**生成 G1A 和 G3A 文件** -`fxgxa` is a versatile g1a/g3a file editor that creates, edits and dumps the header of add-ins files. The build system calls it as part of `fxsdk build-*` so you only need to use it directly when you want to inspect existing add-ins. +`fxgxa` 是一个多功能的 g1a 与 g3a 文件编辑器，可以创建、编辑与导出程序的头部。实际上，在运行 `fxsdk build-*` 这个命令的时候，您也间接调用了 `fxgxa`。所以这个只有在您想要查看已经编译好的程序的内容的时候才会用得到。 -It supports using and dumping PNG icons of any formats, validating header checksums, repairing broken headers and dumping add-in details. Here are the main commands: +这可以用来导出 PNG 格式的图标、执行校验和、修复损坏的头部以及导出程序的其他信息。主要是这些命令： -* `fxgxa --g1a|--g3a`: Generate g1a/g3a files -* `fxgxa -e`: Edit g1a/g3a files -* `fxgxa -d`: Dump metadata, checksum, and icon -* `fxgxa -r`: Repair control bytes and checksums for broken files -* `fxgxa -x`: Extract icons into PNG files +* `fxgxa --g1a|--g3a`：生成 g1a 或 g3a 文件 +* `fxgxa -e`：编辑 g1a 或 g3a 文件 +* `fxgxa -d`：提取元数据、校验和，以及图标 +* `fxgxa -r`：修复破损文件的控制字节与校验和 +* `fxgxa -x`：以 PNG 格式提取图标 -`fxgxa` has an alias, `fxg1a`, for compatibility with fxSDK up to 2.7 for which there was no g3a file editor in the fxSDK. +`fxgxa` 有另一个名字 `fxg1a`。这是为了兼容 2.7 版本以前的 fxSDK，因为在那时还不能生成 g3a 程序。 使用 `fxconv` 来**转换素材格式** @@ -123,6 +127,10 @@ The first feature is interactive communication with add-ins using libusb. This a The second feature is sending files to fx-CG and G-III calculators (the ones that behave like USB drives) using UDisks2. `fxlink` can mount the calculators, copy files and unmount them from the command-line without root access. +## 真的，爽！但是我想要代码提示！ + +[如何在 Visual Studio Code 中获得代码提示](VSCode_zhCN.md) + ## 构建系统 **使用 CMake** @@ -144,7 +152,7 @@ The original Makefile used to build add-ins is still available. A Makefile-based ## 手动构建 -The following instructions are part of the manual install process for the fxSDK. You should install this repository first. If you previously had an fxSDK setup, cross-compiler, etc. then you should probably remove them before installing the new one to avoid interference. +下面是手动安装 fxSDK 的步骤。一开始，您应该先安装本仓库。如果您之前已经安装过 fxSDK 或者跨平台编译器之类的，为了避免冲突，您应该先把它们删掉之后再来安装。 这个仓库的依赖: From 06d5b6f8529314aa4a1730287318d9c01ca3d87e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Mon, 25 Mar 2024 11:20:47 +0000 Subject: [PATCH 03/14] Add a tutorial on using fxSDK in VSCode --- VSCode_zhCN.md | 122 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 122 insertions(+) create mode 100644 VSCode_zhCN.md diff --git a/VSCode_zhCN.md b/VSCode_zhCN.md new file mode 100644 index 0000000..046da44 --- /dev/null +++ b/VSCode_zhCN.md @@ -0,0 +1,122 @@ +# 如何在 Visual Studio Code 中获得代码提示 + +虽然目前您没有办法在电脑上运行程序，更不用说 debug 了，但是您仍然可以享受全方位的代码提示！这已经比卡西欧在 2007 年推出的那个 IDE 好多了。 + +## 下载 + +虽然这个软件很火，但有些人可能真的没听说过，先去 [Visual Studio Code 官网](https://code.visualstudio.com) 下载吧！ + +## 安装插件 + +首先安装来自微软的 [C/C++ 插件](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools)。或者直接在“扩展”中搜索 `C/C++` 也可以。 + +## 告诉插件真正要用的编译器 + +一般情况下，我们是开发在电脑上运行的程序。但是这下不一样了，需要使用 fxSDK 的跨平台编译器。 + +打开命令面板（CTRL/CMD + Shift + P），输入 `C/C++: Edit Configurations (UI)` 并按回车。 + +将下面的路径填入“编译器路径”一栏。 + +``` +/home/你的用户名/.local/bin/sh-elf-gcc +``` + +譬如我的用户名为 `chenzhanming`，我就写： + +``` +/home/chenzhanming/.local/bin/sh-elf-gcc +``` + +## 看看效果 + +打开 `src/main.c` 文件，输入以下代码，看看代码提示是否有正常工作。 + +```c +#include +#include + +int main(void) +{ + // 用白色来清空屏幕 + dclear(C_WHITE); + + // 用黑色在左上角写上 Hello world! + dtext(1, 1, C_BLACK, "Hello world!"); + + // 在检测到下一次按键之前卡在这里。 + // 因为在卡西欧计算器上，程序结束之后将直接返回菜单， + // 所以只有卡在这里不让它结束，才能看到程序运行结果。 + getkey(); + + return 1; +} +``` + +如果一切正常的话你会发现，上方的 `C_WHITE` 的 `C_BLACK` 出现错误，因为目前编辑器不知道您是在给彩屏还是黑白屏的计算器写程序。如果您希望让自己的程序可以在两种屏幕上跑，则需要分别考虑两种情况。现在，姑且先让它在黑白屏上跑吧： + +```c +#include +#include + +int main(void) +{ + // 如果是黑白屏幕 + #ifdef FX9860G + // 用白色来清空屏幕 + dclear(C_WHITE); + + // 用黑色在左上角写上 Hello world! + dtext(1, 1, C_BLACK, "Hello world!"); + #endif + + // 在检测到下一次按键之前卡在这里。 + // 因为在卡西欧计算器上，程序结束之后将直接返回菜单， + // 所以只有卡在这里不让它结束，才能看到程序运行结果。 + getkey(); + + return 1; +} +``` + +然后您会发现没有报错了。因为 gint 内核要求先定义计算器型号，才可以使用颜色。 + +如果您下定决心只在黑白屏或者彩色屏上写程序，那您就可以把这个定义放在程序的最顶端： + +```c +#define FX9860G +#include +#include + +int main(void) +{ + // 用白色来清空屏幕 + dclear(C_WHITE); + + // 用黑色在左上角写上 Hello world! + dtext(1, 1, C_BLACK, "Hello world!"); + + // 在检测到下一次按键之前卡在这里。 + // 因为在卡西欧计算器上，程序结束之后将直接返回菜单， + // 所以只有卡在这里不让它结束，才能看到程序运行结果。 + getkey(); + + return 1; +} +``` + +这样同样也不会有报错。但是如果您实在是不想这么写，可以让告诉编译器，默认使用黑白屏。 + +请再一次用命令面板打开 `C/C++: Edit Configurations (UI)`。 + +在“编译器参数”一栏写下： + +``` +-D FX9860G +``` + +这样一来，最开始的那份代码也不会有报错了。唯一需要注意的是，在调用 `fxsdk` 来编译的时候，这个工具会主动告诉编译器计算器的型号是什么，所以在编译的时候不会报错。这里只是为了在开发的时候能够获取正确的代码提示罢了。 + +## 结语 + +好啦！您已经学会了如何用这个牛逼轰轰的内核来开发计算器程序了，期待您的作品！ From 6632c37e45c3d328ddd98f3c4aa42a21ed935d9d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Mon, 25 Mar 2024 11:23:46 +0000 Subject: [PATCH 04/14] Use relative path --- README_zhCN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_zhCN.md b/README_zhCN.md index 1084b83..a325cab 100644 --- a/README_zhCN.md +++ b/README_zhCN.md @@ -129,7 +129,7 @@ The second feature is sending files to fx-CG and G-III calculators (the ones tha ## 真的，爽！但是我想要代码提示！ -[如何在 Visual Studio Code 中获得代码提示](VSCode_zhCN.md) +[如何在 Visual Studio Code 中获得代码提示](./VSCode_zhCN.md) ## 构建系统 From 274f6aa8c27a752abb4e4546fc0dc35909768537 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Mon, 25 Mar 2024 11:35:49 +0000 Subject: [PATCH 05/14] Use Forgeio style link --- README_zhCN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_zhCN.md b/README_zhCN.md index a325cab..e9afdc0 100644 --- a/README_zhCN.md +++ b/README_zhCN.md @@ -129,7 +129,7 @@ The second feature is sending files to fx-CG and G-III calculators (the ones tha ## 真的，爽！但是我想要代码提示！ -[如何在 Visual Studio Code 中获得代码提示](./VSCode_zhCN.md) +[如何在 Visual Studio Code 中获得代码提示](/src/branch/master/VSCode_zhCN.md) ## 构建系统 From eec1455bfdcbff7728cbf74035295f935a5a5c01 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Mon, 25 Mar 2024 15:12:46 +0000 Subject: [PATCH 06/14] Change the link back --- README_zhCN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_zhCN.md b/README_zhCN.md index e9afdc0..1084b83 100644 --- a/README_zhCN.md +++ b/README_zhCN.md @@ -129,7 +129,7 @@ The second feature is sending files to fx-CG and G-III calculators (the ones tha ## 真的，爽！但是我想要代码提示！ -[如何在 Visual Studio Code 中获得代码提示](/src/branch/master/VSCode_zhCN.md) +[如何在 Visual Studio Code 中获得代码提示](VSCode_zhCN.md) ## 构建系统 From 8e2b1d58b203d06d5759ad6133730e94025345fa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Sun, 24 Mar 2024 18:46:11 +0000 Subject: [PATCH 07/14] Translate README into Simplified Chinese Add a tutorial on how to use fxSDK with VSCode. --- README.md | 2 + README_zhCN.md | 180 +++++++++++++++++++++++++++++++++++++++++++++++++ VSCode_zhCN.md | 122 +++++++++++++++++++++++++++++++++ 3 files changed, 304 insertions(+) create mode 100644 README_zhCN.md create mode 100644 VSCode_zhCN.md diff --git a/README.md b/README.md index 0a05e3a..47588aa 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # fxSDK +🌍 **English** | [简体中文](README_zhCN.md) + *Topic on Planète Casio : [fxSDK, un SDK alternatif pour écrire des add-ins](https://www.planet-casio.com/Fr/forums/topic13164-last-fxsdk-un-sdk-alternatif-pour-ecrire-des-add-ins.html)* The fxSDK is a development kit for CASIO graphing calculators in the fx-9860G and fx-CG series. It provides command-line tools, build systems and a cross-compilation setup for add-ins and libraries. It's designed to be used with the [gint unikernel](/Lephenixnoir/gint) which provides a powerful base runtime to build add-ins from. diff --git a/README_zhCN.md b/README_zhCN.md new file mode 100644 index 0000000..1fab66e --- /dev/null +++ b/README_zhCN.md @@ -0,0 +1,180 @@ +# fxSDK + +🌏 [English](README.md) | **简体中文** + +*Planète Casio 上的一个帖子：[fxSDK 是另外一套开发计算器程序的工具链（法语帖子）](https://www.planet-casio.com/Fr/forums/topic13164-last-fxsdk-un-sdk-alternatif-pour-ecrire-des-add-ins.html)* + +fxSDK 是一套开发卡西欧图形计算器里的程序的工具，里面提供了命令行工具、构建系统以及一个跨平台编译器，用来开发程序以及库。这套工具需要和 [gint 内核](/Lephenixnoir/gint) 一起使用，因为这个内核提供的运行时非常之厉害。 + +这个仓库只提供了 SDK 的命令行工具。如果想要构建程序，需要一些其他的组件，比如[跨平台编译器](/Lephenixnoir/sh-elf-gcc)还有 [gint 内核](/Lephenixnoir/gint)。更多信息请移步至[如何安装]()。 + +fxSDK 以 [MIT 协议](LICENSE)发布。 + +## 支持的机型及其兼容性 + +**计算器** + +fxSDK，或者说 gint，支持卡西欧 fx-9860G 系列几乎所有的型号，包括： + +* ![](https://www.planet-casio.com/images/icones/calc/g85.png)（部分支持）基于SH3 的 fx-9860G、fx-9860G SD、以及类似运行 1.xx 版本操作系统的型号，还有 fx-9860G SDK 里的模拟器。 +* ![](https://www.planet-casio.com/images/icones/calc/g95.png) 基于 SH3 的 fx-9750G、fx-9860G II、fx-9860G II SD，以及类似运行 2.xx 版本操作系统的型号。 +* ![](https://www.planet-casio.com/images/icones/calc/g75+.png) 所有基于 SH4 且运行操作系统 2.xx 的型号，包括 fx-9750G II 与 SH4 的 fx-9860G II。 +* ![](https://www.planet-casio.com/images/icones/calc/g35+e2.png) fx-9750G III 与 fx-9860G III。 + +也支持卡西欧 fx-CG 系列的计算器： + +* ![](https://www.planet-casio.com/images/icones/calc/cg20.png) 经典款 fx-CG 10/20。 +* ![](https://www.planet-casio.com/images/icones/calc/g90+e.png) fx-CG 50。 + +**操作系统** + +* Linux 有官方支持。只要装好了依赖，任何的发行版都可以运行。 +* macOS 由于缺少测试，需要进行一些小小的调整才可以运行。 +* Windows 因为有 WSL（Linux 子系统），所以也有官方支持。然而 Windows 本身并不受支持，但如果您想的话可以尝试贡献。 + +**编程语言** + +* C 语言：支持最新版 GCC，目前是 C11 或者 C2X。标准库 [fxlibc](https://gitea.planet-casio.com/Vhex-Kernel-Core/fxlibc/) 是我们自行构建的，大致遵循 C99。使用其他的标准库也是可以的。 +* C++：支持最新版 GCC，目前是 C++20 或者 C++23。标准库 [libstdc++](https://gcc.gnu.org/onlinedocs/libstdc++/) 也是最新的。 +* 汇编语言：卡西欧计算器的处理器为 SuperH 架构，其中数 SH4AL-DSP 最多。二进制工具里面提供的汇编器可供使用。 +* 还想要其他的语言？只要能编译到 C 就行，比如 [fxtran for Fortran](https://www.planet-casio.com/Fr/forums/topic17064-1-fxtran-codez-en-fortran-pour-votre-casio.html)。其他的 GCC 支持的前端语言也可以，比如 [the D compiler builds](https://www.planet-casio.com/Fr/forums/topic17037-last-omegafail-dlang-et-gint.html)。对于那些基于 LLVM 的语言（比如 Rust）不在考虑范围内，因为 LLVM 没有 SuperH 后端。 + +**构建系统** + +fxSDK 主要使用 CMake 来构建程序和库。有个老的 Makefile 模板仍然可以用，而且命令行工具仍有官方支持，但是在更新的时候就得手动修改您自己的构建系统了。 + +## 如何安装 + +这里说明的安装方法不仅仅适用这个仓库，还包括 fxSDK 里的所有东西。 + +**方法一：使用 GiteaPC（新手推荐，虽然现在不叫这个了）** + +[GiteaPC](https://gitea.planet-casio.com/Lephenixnoir/GiteaPC) 是一个类似包管理器一样的东西，专门用来下载、构建及安装来自 Planète Casio 仓库的东西。整个过程是自动的，所以推荐在安装 fxSDK 的时候使用。 + +**方法二：在 Arch Linux 发行版里使用 AUR** + +[Dark Storm](https://www.planet-casio.com/Fr/compte/voir_profil.php?membre=Dark%20Storm) 为 Arch Linux 维护了一个叫 [MiddleArch](https://www.planet-casio.com/Fr/forums/topic16790-1-middlearch-un-depot-communautaire.html) 的仓库，包含了最新版本的 fxSDK。 + +**方法三：手动构建（如果您是专家）** + +您可以照着 README 文件里的说明来手动构建各个工具。请先看看 GiteaPC 的教程，好知道需要以什么顺序安装哪些东西。在此提醒，要装的东西真的很多（SDK、跨平台编译器、libm、libc、libstdc++、内核、用户库等等），安装和更新都会很花时间。 + +## 命令行工具 + +当你用 fxSDK 开发程序的时候，你主要会使用命令行工具和 fxSDK 的构建系统。先来看看命令行工具吧。当你不传任何的参数直接调用工具的时候会显示帮助。例如 `fxsdk` 或 `fxgxa`。 + +*曾经在这里有一个叫 `fxos` 的工具，现在被移到[它自己的仓库](/Lephenixnoir/fxos)里了。* + +使用 `fxsdk` 来**管理项目** + +你可以用 `fxsdk new` 来创建一个新项目，并指定名字。本例为“MyAddin”： + +```sh +fxsdk new MyAddin +``` + +然后进入这个文件夹： + +```bash +cd MyAddin +``` + +进入新创建的文件夹之后，就可以用 `fxsdk build-*` 来构建程序： + +```bash +# 构建 fx-9860G 系列计算器的程序（后缀 .g1a）： +fxsdk build-fx +# 构建 fx-CG 系列计算器的程序（后缀 .g3a）： +fxsdk build-cg +``` + +然后你就可以把这个程序用你喜欢的方式发到计算器上了。但是这里有些更简单的方法： + +* `fxsdk send-fx` 会使用 [p7](/cake/p7utils) 来发送 g1a 程序，就像 FA-124 和 xfer9860 那样。除了 fx-975G0G III 和 fx-9860G III，所有 fx-9860G 系列的型号都可以用。 +* `fxsdk send-cg` 会使用 UDisks2 来发送 g3a 程序，其实就相当与您在文件资源管理器里面操作一样。下面具体有写 fxlink 做了什么。 + +`fxsdk path` 会告诉你 SDK 里面的一些重要文件（主要是跨平台编译器）的位置。 + +使用 `fxgxa` 来**生成 G1A 和 G3A 文件** + +`fxgxa` 是一个多功能的 g1a 与 g3a 文件编辑器，可以创建、编辑与导出程序的头部。实际上，在运行 `fxsdk build-*` 这个命令的时候，您也间接调用了 `fxgxa`。所以这个只有在您想要查看已经编译好的程序的内容的时候才会用得到。 + +这可以用来导出 PNG 格式的图标、执行校验和、修复损坏的头部以及导出程序的其他信息。主要是这些命令： + +* `fxgxa --g1a|--g3a`：生成 g1a 或 g3a 文件 +* `fxgxa -e`：编辑 g1a 或 g3a 文件 +* `fxgxa -d`：提取元数据、校验和，以及图标 +* `fxgxa -r`：修复破损文件的控制字节与校验和 +* `fxgxa -x`：以 PNG 格式提取图标 + +`fxgxa` 有另一个名字 `fxg1a`。这是为了兼容 2.7 版本以前的 fxSDK，因为在那时还不能生成 g3a 程序。 + +使用 `fxconv` 来**转换素材格式** + +`fxconv` 是一个素材转换器。可以把照片、字体和其他常见的素材变成可以直接在程序中使用的数据结构，包括 gint 图像、gint 字体、[libimg](/Lephenixnoir/libimg) 图像，以及二进制数据。 + +其他项目可以扩展它的功能来生成自定义的素材，比如地图、对话框、GUI 文本。对 `fxconv` 的扩展需要在对应的项目里面用 Python 来实现。 + +`fxconv` 稍微和构建系统集成在一起。通常您只需要在 `CMakeLists.txt` 里面生命有哪些素材，把参数填进 `fxconv-metadata.txt`，然后构建系统自己会把剩下的事情做好。 + +> 未完待续：应该更详细地解释一下怎么使用 fxconv。 + +使用 `fxlink` 来**进行 USB 通信** + +`fxlink` 是一个 USB 通信工具，可以用来往 gint 的 USB 驱动或者计算器里面发送文件。但是这个工具目前还不成熟，不过已经有两个很有用的功能了。 + +注意：`fxlink` 在 Windows 的 WSL 里面不能用，参见[这个 bug](https://github.com/Microsoft/WSL/issues/2195)。 + +第一个功能是使用 libusb 与程序进行交流，可以让程序把文字、照片和截图实时发到电脑上。 + +第二个功能是使用 UDisks2 来往 fx-CG 和 G-III 系列计算器上发文件（像一个 USB 磁盘一样）。`fxlink` 可以把计算器挂在到电脑上，然后传送文件，最后再移除，全程不需要 root 权限。 + +## 代码提示 + +[如何在 Visual Studio Code 中获得代码提示](VSCode_zhCN.md) + +## 构建系统 + +**使用 CMake** + +自从 fxSDK 2.3，官方的构建系统就是 CMake 了。当创建一个新的项目的时候，会生成一个 `CMakeLists.txt`。这个文件和正常的 CMake 有点偏差，在[这篇帖子（法语帖子）](https://www.planet-casio.com/Fr/forums/topic16647-1-tutoriel-compiler-des-add-ins-avec-cmake-fxsdk.html)里解释了。下面也一并解释了它们有什么区别。 + +因为我们需要使用跨平台编译器，所以 `cmake` 没办法弄明白我们要干什么，所以需要传一些额外的参数。`fxsdk build-*` 这个命令会帮你传好正确的参数的。 + +fxSDK 提供了[许多模块](fxsdk/cmake)： + +* [`FX9860G.cmake`](fxsdk/cmake/FX9860G.cmake) 和 [`FXCG50.cmake`](fxsdk/cmake/FXCG50.cmake) 会在运行 `fxsdk build-fx` 和 `fxsdk build-cg` 的时候加载。不直接调用 `cmake` 是有原因的，就是我们会定义一些形似 `FXSDK_*` 的变量，它们指定了有关编译目标的一些信息，且都存在上面的两个文件里面。 +* [`Fxconv.cmake`](fxsdk/cmake/Fxconv.cmake) 提供了一些使用 fxconv 的一些函数。`fxconv_declare_assets(... WITH_METADATA)` 会把一些文件标记为需要转换的素材。然后 `fxconv_declare_converters(...)` 定义了这个项目需要用哪些自定义的 Python 模块来转换自定义素材。 +* [`GenerateG1A.cmake`](fxsdk/cmake/GenerateG1A.cmake) 和 [`GenerateG3A.cmake`](fxsdk/cmake/GenerateG3A.cmake) 帮您调用 `fxgxa` 来生成 g1a/g3a 程序。默认的 `CMakeLists.txt` 说明了它们如何使用. +* [`FindSimpleLibrary.cmake`](fxsdk/cmake/FindSimpleLibrary.cmake) 和 [`GitVersionNumber.cmake`](fxsdk/cmake/GitVersionNumber.cmake) 是一些小工具与库。看看 [Lephenixnoir/Template-gint-library](https://gitea.planet-casio.com/Lephenixnoir/Template-gint-library)，里面讲了如何用 fxSDK 开发一个库。 + +**只使用 Makefile** + +原来的 Makefile 仍然可以用。可以用 `fxsdk new` 的 `--makefile` 选项来创建一个基于 Makefile 的项目。但是由于很少人用，所以可能会过时，而且在更新的时候需要您自己来维护。只有在您对 make 很熟悉的情况下才建议使用。 + +## 手动构建 + +下面是手动安装 fxSDK 的步骤。一开始，您应该先安装本仓库。如果您之前已经安装过 fxSDK 或者跨平台编译器之类的，为了避免冲突，您应该先把它们删掉之后再来安装。 + +这个仓库的依赖: + +* CMake +* libpng ≥ 1.6 +* Python ≥ 3.7（3.6 有可能也可以） +* Python 3 的 Pillow 库 +* libusb 1.0 +* UDisks2 库（在构建工具链的时候如果没用就不用） + +当您在运行 `configure.sh` 的时候，您需要确保您有权限写入安装路径，个人建议使用 `$HOME/.local`。 +需要注意，跨平台编译器**必须**被安装在 `fxsdk path sysroot` 这个命令说的路径下面。 + +* 通过 `-DCMAKE_INSTALL_PREFIX=...` 来改变安装文件夹； +* 当您在使用 WSL 子系统的时候，或者您没有 UDisks2 的时候，通过 `-DFXLINK_DISABLE_UDISKS2=1` 来禁用 `fxlink` 对于 UDisks2 的支持。 + +```bash +% cmake -B build [OPTIONS...] +% make -C build +% make -C build install +``` + +然后您就可以去安装跨平台编译器了。如果您不清楚安装的顺序，看看 [GiteaPC README](https://gitea.planet-casio.com/Lephenixnoir/GiteaPC) 或者 各个仓库里的 `giteapc.make`，里面写明了依赖项。 diff --git a/VSCode_zhCN.md b/VSCode_zhCN.md new file mode 100644 index 0000000..046da44 --- /dev/null +++ b/VSCode_zhCN.md @@ -0,0 +1,122 @@ +# 如何在 Visual Studio Code 中获得代码提示 + +虽然目前您没有办法在电脑上运行程序，更不用说 debug 了，但是您仍然可以享受全方位的代码提示！这已经比卡西欧在 2007 年推出的那个 IDE 好多了。 + +## 下载 + +虽然这个软件很火，但有些人可能真的没听说过，先去 [Visual Studio Code 官网](https://code.visualstudio.com) 下载吧！ + +## 安装插件 + +首先安装来自微软的 [C/C++ 插件](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools)。或者直接在“扩展”中搜索 `C/C++` 也可以。 + +## 告诉插件真正要用的编译器 + +一般情况下，我们是开发在电脑上运行的程序。但是这下不一样了，需要使用 fxSDK 的跨平台编译器。 + +打开命令面板（CTRL/CMD + Shift + P），输入 `C/C++: Edit Configurations (UI)` 并按回车。 + +将下面的路径填入“编译器路径”一栏。 + +``` +/home/你的用户名/.local/bin/sh-elf-gcc +``` + +譬如我的用户名为 `chenzhanming`，我就写： + +``` +/home/chenzhanming/.local/bin/sh-elf-gcc +``` + +## 看看效果 + +打开 `src/main.c` 文件，输入以下代码，看看代码提示是否有正常工作。 + +```c +#include +#include + +int main(void) +{ + // 用白色来清空屏幕 + dclear(C_WHITE); + + // 用黑色在左上角写上 Hello world! + dtext(1, 1, C_BLACK, "Hello world!"); + + // 在检测到下一次按键之前卡在这里。 + // 因为在卡西欧计算器上，程序结束之后将直接返回菜单， + // 所以只有卡在这里不让它结束，才能看到程序运行结果。 + getkey(); + + return 1; +} +``` + +如果一切正常的话你会发现，上方的 `C_WHITE` 的 `C_BLACK` 出现错误，因为目前编辑器不知道您是在给彩屏还是黑白屏的计算器写程序。如果您希望让自己的程序可以在两种屏幕上跑，则需要分别考虑两种情况。现在，姑且先让它在黑白屏上跑吧： + +```c +#include +#include + +int main(void) +{ + // 如果是黑白屏幕 + #ifdef FX9860G + // 用白色来清空屏幕 + dclear(C_WHITE); + + // 用黑色在左上角写上 Hello world! + dtext(1, 1, C_BLACK, "Hello world!"); + #endif + + // 在检测到下一次按键之前卡在这里。 + // 因为在卡西欧计算器上，程序结束之后将直接返回菜单， + // 所以只有卡在这里不让它结束，才能看到程序运行结果。 + getkey(); + + return 1; +} +``` + +然后您会发现没有报错了。因为 gint 内核要求先定义计算器型号，才可以使用颜色。 + +如果您下定决心只在黑白屏或者彩色屏上写程序，那您就可以把这个定义放在程序的最顶端： + +```c +#define FX9860G +#include +#include + +int main(void) +{ + // 用白色来清空屏幕 + dclear(C_WHITE); + + // 用黑色在左上角写上 Hello world! + dtext(1, 1, C_BLACK, "Hello world!"); + + // 在检测到下一次按键之前卡在这里。 + // 因为在卡西欧计算器上，程序结束之后将直接返回菜单， + // 所以只有卡在这里不让它结束，才能看到程序运行结果。 + getkey(); + + return 1; +} +``` + +这样同样也不会有报错。但是如果您实在是不想这么写，可以让告诉编译器，默认使用黑白屏。 + +请再一次用命令面板打开 `C/C++: Edit Configurations (UI)`。 + +在“编译器参数”一栏写下： + +``` +-D FX9860G +``` + +这样一来，最开始的那份代码也不会有报错了。唯一需要注意的是，在调用 `fxsdk` 来编译的时候，这个工具会主动告诉编译器计算器的型号是什么，所以在编译的时候不会报错。这里只是为了在开发的时候能够获取正确的代码提示罢了。 + +## 结语 + +好啦！您已经学会了如何用这个牛逼轰轰的内核来开发计算器程序了，期待您的作品！ From ea871becf57f4ae7ea7c21ecd76b2131e22f13a9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Mon, 25 Mar 2024 21:08:55 +0000 Subject: [PATCH 08/14] Fix a typo in README --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 47588aa..311f005 100644 --- a/README.md +++ b/README.md @@ -78,7 +78,7 @@ Type 'fxsdk build-fx' or 'fxsdk build-cg' to compile the program. From that folder, you can build the add-in with the `fxsdk build-*` commands: ```bash -# Build the add-in for fx-98600G-series calculators (.g1a): +# Build the add-in for fx-9860G-series calculators (.g1a): % fxsdk build-fx # Build the add-in for fx-CG-series calculators (.g3a): % fxsdk build-cg From df05f68c65bdca6a0b4de2b6a9d79db7760640b2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Tue, 26 Mar 2024 08:45:57 +0000 Subject: [PATCH 09/14] Change language suffix to "zh" --- README.md | 2 +- README_zhCN.md => README_zh.md | 0 VSCode_zhCN.md => VSCode_zh.md | 0 3 files changed, 1 insertion(+), 1 deletion(-) rename README_zhCN.md => README_zh.md (100%) rename VSCode_zhCN.md => VSCode_zh.md (100%) diff --git a/README.md b/README.md index 311f005..d2d3bab 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # fxSDK -🌍 **English** | [简体中文](README_zhCN.md) +🌍 **English** | [简体中文](README_zh.md) *Topic on Planète Casio : [fxSDK, un SDK alternatif pour écrire des add-ins](https://www.planet-casio.com/Fr/forums/topic13164-last-fxsdk-un-sdk-alternatif-pour-ecrire-des-add-ins.html)* diff --git a/README_zhCN.md b/README_zh.md similarity index 100% rename from README_zhCN.md rename to README_zh.md diff --git a/VSCode_zhCN.md b/VSCode_zh.md similarity index 100% rename from VSCode_zhCN.md rename to VSCode_zh.md From bc8157c3858e3e45dd454d0ed4f9309ea1d0e641 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Tue, 26 Mar 2024 09:39:49 +0000 Subject: [PATCH 10/14] Fix several issues in VSCode_zh.md --- README_zh.md | 2 +- VSCode_zh.md | 73 +++++++++++++++++++++++++++++++++++++++------------- 2 files changed, 56 insertions(+), 19 deletions(-) diff --git a/README_zh.md b/README_zh.md index 1fab66e..d2c6f90 100644 --- a/README_zh.md +++ b/README_zh.md @@ -131,7 +131,7 @@ fxsdk build-cg ## 代码提示 -[如何在 Visual Studio Code 中获得代码提示](VSCode_zhCN.md) +[如何在 Visual Studio Code 中获得代码提示](VSCode_zh.md) ## 构建系统 diff --git a/VSCode_zh.md b/VSCode_zh.md index 046da44..1c067c9 100644 --- a/VSCode_zh.md +++ b/VSCode_zh.md @@ -43,6 +43,9 @@ int main(void) // 用黑色在左上角写上 Hello world! dtext(1, 1, C_BLACK, "Hello world!"); + + // 将缓冲区的内容更新到屏幕上 + dupdate(); // 在检测到下一次按键之前卡在这里。 // 因为在卡西欧计算器上，程序结束之后将直接返回菜单， @@ -53,7 +56,9 @@ int main(void) } ``` -如果一切正常的话你会发现，上方的 `C_WHITE` 的 `C_BLACK` 出现错误，因为目前编辑器不知道您是在给彩屏还是黑白屏的计算器写程序。如果您希望让自己的程序可以在两种屏幕上跑，则需要分别考虑两种情况。现在，姑且先让它在黑白屏上跑吧： +如果一切正常的话你会发现，上方的 `C_WHITE` 的 `C_BLACK` 出现错误，因为目前编辑器不知道您是在给彩屏还是黑白屏的计算器写程序。如果您希望使用这些颜色，需要用宏定义计算器型号。`FXCG50` 是彩屏计算器，`FX9860G` 是黑白屏计算器。 + +现在，姑且先让它在黑白屏上跑吧。下方的代码如果尝试编译成彩屏计算器的程序，将不会看到任何输出。 ```c #include @@ -63,16 +68,11 @@ int main(void) { // 如果是黑白屏幕 #ifdef FX9860G - // 用白色来清空屏幕 dclear(C_WHITE); - - // 用黑色在左上角写上 Hello world! dtext(1, 1, C_BLACK, "Hello world!"); + dupdate(); #endif - // 在检测到下一次按键之前卡在这里。 - // 因为在卡西欧计算器上，程序结束之后将直接返回菜单， - // 所以只有卡在这里不让它结束，才能看到程序运行结果。 getkey(); return 1; @@ -81,7 +81,51 @@ int main(void) 然后您会发现没有报错了。因为 gint 内核要求先定义计算器型号，才可以使用颜色。 -如果您下定决心只在黑白屏或者彩色屏上写程序，那您就可以把这个定义放在程序的最顶端： +需要注意的是，在调用 `fxsdk` 来编译的时候，**这个工具会主动告诉编译器计算器的型号是什么**，所以在编译的时候，**就算您不定义宏也不会报错**。这里只是为了在开发的时候能够获取正确的代码提示罢了。 + +但是您可能已经发现，不管是黑白屏还是彩色屏，应该都有黑色和白色才对，那为什么还是需要定义宏才可以用呢？这是因为，这两个颜色在不同的宏定义下的枚举里面的值是不一样的。请看下方的内核头文件： + +使用 `FX9860G` 的 `display-fx.h` +```c +typedef enum +{ + /* Opaque colors */ + C_WHITE = 0, + C_LIGHT = 1, + C_DARK = 2, + C_BLACK = 3, + + /* Monochrome operators */ + C_NONE = 4, + C_INVERT = 5, + + /* Gray operators */ + C_LIGHTEN = 6, + C_DARKEN = 7, + +} color_t; +``` + +使用 `FXCG50` 的 `display-cg.h` +```c +enum { + /* Compatibility with fx9860g color names */ + C_WHITE = 0xffff, + C_LIGHT = 0xad55, + C_DARK = 0x528a, + C_BLACK = 0x0000, + + /* Other colors */ + C_RED = 0xf800, + C_GREEN = 0x07e0, + C_BLUE = 0x001f, + + C_NONE = -1, + C_INVERT = -2, +}; +``` + +现在回到一开始的程序上，如果您下定决心只在黑白屏或者彩色屏上写程序，那您就可以把这个定义放在程序的最顶端： ```c #define FX9860G @@ -90,15 +134,10 @@ int main(void) int main(void) { - // 用白色来清空屏幕 dclear(C_WHITE); - - // 用黑色在左上角写上 Hello world! dtext(1, 1, C_BLACK, "Hello world!"); + dupdate(); - // 在检测到下一次按键之前卡在这里。 - // 因为在卡西欧计算器上，程序结束之后将直接返回菜单， - // 所以只有卡在这里不让它结束，才能看到程序运行结果。 getkey(); return 1; @@ -107,15 +146,13 @@ int main(void) 这样同样也不会有报错。但是如果您实在是不想这么写，可以让告诉编译器，默认使用黑白屏。 -请再一次用命令面板打开 `C/C++: Edit Configurations (UI)`。 - -在“编译器参数”一栏写下： +请再一次用命令面板打开 `C/C++: Edit Configurations (UI)`，并在“编译器参数”一栏写下： ``` -D FX9860G ``` -这样一来，最开始的那份代码也不会有报错了。唯一需要注意的是，在调用 `fxsdk` 来编译的时候，这个工具会主动告诉编译器计算器的型号是什么，所以在编译的时候不会报错。这里只是为了在开发的时候能够获取正确的代码提示罢了。 +这样一来，最开始的那份代码也不会有报错了。 ## 结语 From daf69d1898ccca01d494335a1708c39dc3fd3466 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Tue, 26 Mar 2024 09:55:37 +0000 Subject: [PATCH 11/14] Add the date of translation for README_zh.md --- README_zh.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README_zh.md b/README_zh.md index d2c6f90..65ff05b 100644 --- a/README_zh.md +++ b/README_zh.md @@ -2,6 +2,8 @@ 🌏 [English](README.md) | **简体中文** +*Translated by 陈湛明 (Chén Zhànmíng) on 2024-03-26* + *Planète Casio 上的一个帖子：[fxSDK 是另外一套开发计算器程序的工具链（法语帖子）](https://www.planet-casio.com/Fr/forums/topic13164-last-fxsdk-un-sdk-alternatif-pour-ecrire-des-add-ins.html)* fxSDK 是一套开发卡西欧图形计算器里的程序的工具，里面提供了命令行工具、构建系统以及一个跨平台编译器，用来开发程序以及库。这套工具需要和 [gint 内核](/Lephenixnoir/gint) 一起使用，因为这个内核提供的运行时非常之厉害。 From cf0aea6c4cace9c7d0913ae21b9ce8b397d5a380 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Tue, 26 Mar 2024 11:47:42 +0000 Subject: [PATCH 12/14] Remove redundant explanation about macro --- VSCode_zh.md | 124 ++++++++++++--------------------------------------- 1 file changed, 29 insertions(+), 95 deletions(-) diff --git a/VSCode_zh.md b/VSCode_zh.md index 1c067c9..22079f9 100644 --- a/VSCode_zh.md +++ b/VSCode_zh.md @@ -10,25 +10,13 @@ 首先安装来自微软的 [C/C++ 插件](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools)。或者直接在“扩展”中搜索 `C/C++` 也可以。 -## 告诉插件真正要用的编译器 +## 选择计算器型号 -一般情况下，我们是开发在电脑上运行的程序。但是这下不一样了，需要使用 fxSDK 的跨平台编译器。 +我们知道，彩屏计算器可以显示彩色（废话），但是单色屏的计算器只能显示黑白，所以您在写程序的时候，能用的颜色取决于您选择的计算器型号。所以在开始之前，得选择一下： -打开命令面板（CTRL/CMD + Shift + P），输入 `C/C++: Edit Configurations (UI)` 并按回车。 - -将下面的路径填入“编译器路径”一栏。 - -``` -/home/你的用户名/.local/bin/sh-elf-gcc -``` - -譬如我的用户名为 `chenzhanming`，我就写： - -``` -/home/chenzhanming/.local/bin/sh-elf-gcc -``` - -## 看看效果 +1. 打开命令面板 (CTRL/CMD + Shift + P) +2. 输入 `C/C++: Select a Configuration...`，您不需要打得跟这个完全一样，因为 VSCode 会自动补全。如果是我的话，会输入 `c sel a conf`。 +3. 按下回车，然后选择您想要的计算器型号：fx-9860G 或者 fx-CG50。 打开 `src/main.c` 文件，输入以下代码，看看代码提示是否有正常工作。 @@ -56,87 +44,35 @@ int main(void) } ``` -如果一切正常的话你会发现，上方的 `C_WHITE` 的 `C_BLACK` 出现错误，因为目前编辑器不知道您是在给彩屏还是黑白屏的计算器写程序。如果您希望使用这些颜色，需要用宏定义计算器型号。`FXCG50` 是彩屏计算器，`FX9860G` 是黑白屏计算器。 +## 对不同的型号分别考虑 -现在，姑且先让它在黑白屏上跑吧。下方的代码如果尝试编译成彩屏计算器的程序，将不会看到任何输出。 +如果您希望在不同的型号中做一些不同的事，需要使用以下两个宏来判断。 + +* `FX9860G` 黑白屏 +* `FXCG50` 彩屏 + +譬如我想要在不同的型号上显示不同的文字： ```c #include #include -int main(void) -{ - // 如果是黑白屏幕 - #ifdef FX9860G - dclear(C_WHITE); - dtext(1, 1, C_BLACK, "Hello world!"); - dupdate(); - #endif - - getkey(); - - return 1; -} -``` - -然后您会发现没有报错了。因为 gint 内核要求先定义计算器型号，才可以使用颜色。 - -需要注意的是，在调用 `fxsdk` 来编译的时候，**这个工具会主动告诉编译器计算器的型号是什么**，所以在编译的时候，**就算您不定义宏也不会报错**。这里只是为了在开发的时候能够获取正确的代码提示罢了。 - -但是您可能已经发现，不管是黑白屏还是彩色屏，应该都有黑色和白色才对，那为什么还是需要定义宏才可以用呢？这是因为，这两个颜色在不同的宏定义下的枚举里面的值是不一样的。请看下方的内核头文件： - -使用 `FX9860G` 的 `display-fx.h` -```c -typedef enum -{ - /* Opaque colors */ - C_WHITE = 0, - C_LIGHT = 1, - C_DARK = 2, - C_BLACK = 3, - - /* Monochrome operators */ - C_NONE = 4, - C_INVERT = 5, - - /* Gray operators */ - C_LIGHTEN = 6, - C_DARKEN = 7, - -} color_t; -``` - -使用 `FXCG50` 的 `display-cg.h` -```c -enum { - /* Compatibility with fx9860g color names */ - C_WHITE = 0xffff, - C_LIGHT = 0xad55, - C_DARK = 0x528a, - C_BLACK = 0x0000, - - /* Other colors */ - C_RED = 0xf800, - C_GREEN = 0x07e0, - C_BLUE = 0x001f, - - C_NONE = -1, - C_INVERT = -2, -}; -``` - -现在回到一开始的程序上，如果您下定决心只在黑白屏或者彩色屏上写程序，那您就可以把这个定义放在程序的最顶端： - -```c -#define FX9860G -#include -#include - int main(void) { dclear(C_WHITE); - dtext(1, 1, C_BLACK, "Hello world!"); - dupdate(); + + dtext(1, 1, C_BLACK, + // 如果是黑白屏 + #ifdef FX9860G + "9860G: Hello world!" + #endif + // 如果是彩屏 + #ifdef FXCG50 + "CG50: Hello world!" + #endif + ); + + dupdate(); getkey(); @@ -144,15 +80,13 @@ int main(void) } ``` -这样同样也不会有报错。但是如果您实在是不想这么写，可以让告诉编译器，默认使用黑白屏。 +这样，在黑白屏上就会显示 `9860G: Hello world!`，而在彩屏上就会显示 `CG50: Hello world!`。您也许还发现了，这两个字符串有一个的颜色比其他的淡一点，这代表了这个字符串不会在您刚才选择的计算器型号上显示。刚刚讲到了您可以在两种型号之间切换，所以在切换的时候您也应该可以看到两个字符串的颜色深浅发生了变化。 -请再一次用命令面板打开 `C/C++: Edit Configurations (UI)`，并在“编译器参数”一栏写下： +同时，在彩屏和黑白屏上能使用的颜色也是不一样的。感兴趣的话，去看看 `gint/display.h` 里面的定义吧！ -``` --D FX9860G -``` +## 救命！我看不到代码提示！ -这样一来，最开始的那份代码也不会有报错了。 +先检查一下在 `~/.local/bin` 这个文件夹下有没有 `sh-elf-gcc` 这个跨平台编译器。如果没有，您需要重新安装 fxSDK。 ## 结语 From aeb8dda6c8f72a349fc992e648f329551b183417 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Tue, 26 Mar 2024 11:51:51 +0000 Subject: [PATCH 13/14] Add support for VSCode --- fxsdk/assets/vscode/c_cpp_properties.json | 37 +++++++++++++++++++++++ fxsdk/fxsdk.sh | 3 +- 2 files changed, 39 insertions(+), 1 deletion(-) create mode 100644 fxsdk/assets/vscode/c_cpp_properties.json diff --git a/fxsdk/assets/vscode/c_cpp_properties.json b/fxsdk/assets/vscode/c_cpp_properties.json new file mode 100644 index 0000000..e76d046 --- /dev/null +++ b/fxsdk/assets/vscode/c_cpp_properties.json @@ -0,0 +1,37 @@ +{ + "configurations": [ + { + "name": "fx-9860G", + "compilerPath": "~/.local/bin/sh-elf-gcc", + "compilerArgs": [ "-D FX9860G" ], + + "cStandard": "c17", + "cppStandard": "gnu++17", + + "includePath": [], + "intelliSenseMode": "${default}", + "mergeConfigurations": false, + "browse": { + "path": [], + "limitSymbolsToIncludedHeaders": true + } + }, + { + "name": "fx-CG50", + "compilerPath": "~/.local/bin/sh-elf-gcc", + "compilerArgs": [ "-D FXCG50" ], + + "cStandard": "c17", + "cppStandard": "gnu++17", + + "includePath": [], + "intelliSenseMode": "${default}", + "mergeConfigurations": false, + "browse": { + "path": [], + "limitSymbolsToIncludedHeaders": true + } + } + ], + "version": 4 +} \ No newline at end of file diff --git a/fxsdk/fxsdk.sh b/fxsdk/fxsdk.sh index d0f6668..dd87dbf 100755 --- a/fxsdk/fxsdk.sh +++ b/fxsdk/fxsdk.sh @@ -100,7 +100,7 @@ fxsdk_new_project() { # Copy initial files to project folder assets="$PREFIX/share/fxsdk/assets" - mkdir -p "$1"/{,src,assets-fx,assets-cg} + mkdir -p "$1"/{,src,assets-fx,assets-cg,.vscode} case "$generator" in "Makefile") @@ -125,6 +125,7 @@ fxsdk_new_project() { cp "$assets"/icon-fx.png "$1"/assets-fx/icon.png cp "$assets"/icon-cg-uns.png "$1"/assets-cg/icon-uns.png cp "$assets"/icon-cg-sel.png "$1"/assets-cg/icon-sel.png + cp "$assets"/vscode/c_cpp_properties.json "$1"/.vscode/c_cpp_properties.json echo "Created a new project $NAME (build system: $generator)." echo "Type 'fxsdk build-fx' or 'fxsdk build-cg' to compile the program." From 0e2379ea51af4e552781aa30bb9ce261c2f96358 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=99=88=E6=B9=9B=E6=98=8E?= Date: Tue, 26 Mar 2024 21:40:11 +0000 Subject: [PATCH 14/14] Improve the wording in README_zh.md --- README_zh.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README_zh.md b/README_zh.md index 65ff05b..38dda95 100644 --- a/README_zh.md +++ b/README_zh.md @@ -4,6 +4,8 @@ *Translated by 陈湛明 (Chén Zhànmíng) on 2024-03-26* +*下文中的“程序”指的不是 BASIC 程序，而是带有图标且可以在主菜单打开的 add-in。* + *Planète Casio 上的一个帖子：[fxSDK 是另外一套开发计算器程序的工具链（法语帖子）](https://www.planet-casio.com/Fr/forums/topic13164-last-fxsdk-un-sdk-alternatif-pour-ecrire-des-add-ins.html)* fxSDK 是一套开发卡西欧图形计算器里的程序的工具，里面提供了命令行工具、构建系统以及一个跨平台编译器，用来开发程序以及库。这套工具需要和 [gint 内核](/Lephenixnoir/gint) 一起使用，因为这个内核提供的运行时非常之厉害。 @@ -38,7 +40,7 @@ fxSDK，或者说 gint，支持卡西欧 fx-9860G 系列几乎所有的型号， * C 语言：支持最新版 GCC，目前是 C11 或者 C2X。标准库 [fxlibc](https://gitea.planet-casio.com/Vhex-Kernel-Core/fxlibc/) 是我们自行构建的，大致遵循 C99。使用其他的标准库也是可以的。 * C++：支持最新版 GCC，目前是 C++20 或者 C++23。标准库 [libstdc++](https://gcc.gnu.org/onlinedocs/libstdc++/) 也是最新的。 -* 汇编语言：卡西欧计算器的处理器为 SuperH 架构，其中数 SH4AL-DSP 最多。二进制工具里面提供的汇编器可供使用。 +* 汇编语言：卡西欧计算器的处理器为 SuperH 架构，其中数 SH4AL-DSP 最多。binutils 里面提供的汇编器可供使用。 * 还想要其他的语言？只要能编译到 C 就行，比如 [fxtran for Fortran](https://www.planet-casio.com/Fr/forums/topic17064-1-fxtran-codez-en-fortran-pour-votre-casio.html)。其他的 GCC 支持的前端语言也可以，比如 [the D compiler builds](https://www.planet-casio.com/Fr/forums/topic17037-last-omegafail-dlang-et-gint.html)。对于那些基于 LLVM 的语言（比如 Rust）不在考虑范围内，因为 LLVM 没有 SuperH 后端。 **构建系统**