ExistOS-For-HP39GII

一个开源的HP39GII固件项目

简介

本固件项目由一群计算器爱好者始创，使用了FreeRTOS kernel、TinyUSB、FatFs、dhara、giac等库。我们非常欢迎同好试用和改善本项目的代码，也非常乐意听取您的宝贵意见。期待您的参与！

目前工作进展

目前工作进展：已经完成了操作系统大部分内核和一些必要的硬件驱动。但由于未弄清STMP3770固件刷入机制，因此需要在Win7\WinXP环境下用计算器官方的固件升级软件刷入本固件。同时还没有用户界面，现在的工作重心是实现虚拟内存管理和进程加载。关于用户界面GUI等还在讨论中，如有宝贵意见可于Issues提出。

固件编译

CMake

安装 gcc-arm-none-eabi. Linux系统可以用包管理器安装，Windows系统可以从这里下载. 对于Windows系统,请将安装目录下的./bin路径添加至PATH环境变量.

对于Linux系统, 请将99-hp39gii.rules复制到/etc/udev/rules.d/
之后执行

sudo service udev restart
# 或者
sudo udevadm control --reload-rules
sudo udevadm trigger

对于非Windows系统, 请先编译 /tools/sbtools (无需安装)
对于Windows系统, 下载Ninja并将exe文件添加至PATH变量. 也可以使用GNU Make, 但是编译速度会慢一点并且安装会麻烦一点。

在此文件夹中, 执行

mkdir ./build
cd ./build
cmake .. (或cmake .. -G Ninja)
make (或ninja)   #编译固件

固件安装

注意：HP39GII的相关驱动程序请自行安装。

代码编译完成后，执行以下命令将引导程序刷入计算器的RAM中 (刷入前请将计算器完全断电(抠电池), 之后在按住ON/C按键的同时插入USB线，即可进入刷写模式)

    make flash  (或ninja flash)

等待命令提示符窗口中进度条走完之后，引导程序会开始执行，此时计算器应显示如下界面，若之前已经刷写并安装过Exist OS系统，则可能不会出现该配置界面，只需要正常开机并按住Clear(退格)键即可进入该配置界面。

由于本固件的底层驱动以及闪存的存储结构与原始固件不同，因此在这里会提示磁盘格式错误，因此需要对闪存进行低级格式化之后才可继续安装固件。（注意，接下来的操作将会抹除掉计算器上的所有数据，请先备份好相关文件）

使用方向键将进入Format Flash菜单，该菜单下有两个选项，Erase选项仅会将Flash全片擦除，之后不会写入任何数据，该选项主要用于恢复官方的系统镜像。为了安装新固件，需要进行分区并格式化，故此处选中Format选项之后，按下Enter键，将开始执行格式化操作，该过程需要1~2分钟。

闪存格式化完成之后，将菜单切换至Mount USB MSC界面，通过这个界面可以将计算器刚刚分区并格式化完成后的分区挂载到USB上，以便用电脑直接操作内部Flash并拷贝系统。在这里选中SYS并按下Enter键挂载计算器的系统分区。

挂载SYS分区之后，电脑上会多出一个10MB左右的U盘，接着将刚刚编译出的OSLoader.sb引导文件和ExistOS.sys系统文件拷贝至计算器中。拷贝完成后安全弹出U盘，或者在计算器上将挂载选项设置为None

（弹出磁盘或卸载磁盘之后的某些情况下计算器界面可能会卡住1分钟左右，不用担心，请坐和放宽，此时引导程序正在对磁盘执行Trim操作进行垃圾回收，以加快往后系统运行时的IO速度）

接下来将菜单移动至Install System选项，并按下ENTER键，引导程序会将自己本体给写入计算器的引导扇区中完成最后的安装。

出现以上界面时表示系统已经安装完成，此时可以选中Boot ExistOS直接引导或Reboot重启进入系统。

固件基本使用

系统编译和安装完成后，开机将会见到如下系统界面（默认开启4MB虚拟内存）。

目前的版本中设置了两个输入界面，按下F1进入系统自带的Shell，可以执行系统控制相关的命令（目前暂无）。按下F2将切换至CAS计算模式，进入CAS模式之前系统会对giac运行环境进行初始化，需要几秒钟的时间。

初始化完成后便可以进行一些相关的计算。

计算的结果会保存在上方的历史记录框内，可以通过上下光标键进行选择，选择需要的表达式按下COPY(F4)键可将该表达式复制到输入框中，并可对其进行修改作为下一次计算的输入。

计算过程中可按下ON键中断正在计算的表达式。

由于使用的giac代数运算系统体积相对来说较为庞大(约6MB)，而该计算器仅有500KB左右的运行内存，因此在进行计算时需要频繁的IO操作，从而导致其在某些复杂问题求解时会出现计算十分缓慢的问题。

代码提交规范

如果您想贡献代码，请遵守以下规范

变量
- 变量采用小驼峰命名法命名。例如windowHeight。
- 函数参数的命名与变量相同。
- 不应使用单个字符命名。临时变量，循环变量除外，允许使用i，j，k等。
- 可考虑在名称前加适当有意义的前缀，如p代表指针。
- 不得在一行内同时定义变量和指针，如 char *p, q;。
函数
- 函数采用下划线命名法命名。例如get_window_width。
- 函数的命名应遵循动宾关系。
- 可考虑在名称前加适当有意义的前缀，如is代表返回值为bool类型。
- 短小的函数可以定义为inline，函数的参数和返回值应尽量使用指针而非变量。
- 应尽量避免使用递归，而应考虑重构为循环。
常量，宏及硬件相关
- 常量及宏采用下划线分隔大写字母的方式命名。例如MAX_WIDTH。
自定义类型
- 自定义类型采用下划线命名法命名（暂定）。
- 用struct定义非单例对象时，必须使用typedef语句先定义自定义类型。
运算符及其他符号
- 一元运算符应紧贴变量，如c++，*p。
- 二元运算符两侧都应空格，如i == 1，a += 3。例外：->运算符。
- 三元运算符同二元运算符，如isLeft ? 1 : 0。
- 逗号后应空格。
- 在不易理解的地方应适当加注括号。
伪类

若确有面向对象的必要的，可以考虑用typedef struct实现伪类。
- 伪类采用大驼峰（帕斯卡）命名法命名。
- 伪类中保存属性，其命名与一般变量相同。
- 伪类的方法不保存在伪类中，而采用全局函数。方法采用下划线法命名。
  - 一般方法命名为ClassName_method_name，其第一个参数始终应为一个指向该类型对象的指针并命名为this（即使不需要）。
  - 静态方法命名为ClassName_static_method_name。
  - 命名为ClassName_initializer的一般方法应在伪类的对象定义后立即调用。

代码部分

7.1

if (a == 1) {                          // 关键字与括号间应空格，括号与花括号间应空格
    // code here
}else{                                 // 采用Java风格
    // code here
}
if (b == 1) return;                    // 块中只有一句代码时，可以不打花括号并不换行，空一格即可

7.2

while (true)
    ;                                  // 使用空循环时，应将分号换行并缩进

7.3

(a) 一般for循环的循环变量定义在for循环中：

    for (int i = 0; i < l; i++) {
        // code here
    }

(b) 外部使用循环变量的情况，也应在此处赋初值：

    int i;
    for (i = 0; i < l; i++) {
            // code here
    }
    return i;

7.4 禁止在需要判断语句的地方进行赋值操作，如 if (a = 1)，(a = 1) ? a : 0 等。

7.5 应尽量避免使用goto语句。

7.6 应多用switch，少用else if。switch语句中，每一个case中都最好有一个break/return语句，多个case共用完全相同的一段代码时除外。使用switch穿越时应分外小心并最好加注注释。

贡献者

协议

GPL-3.0

wtbdev/ExistOS-For-HP39GII