ExistOS-For-HP39GII

一个开源的HP39GII固件项目

简介

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

目前工作进展

目前工作进展：已经完成了操作系统大部分内核和一些必要的硬件驱动。但由于未弄清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)   #编译固件
make flash (或ninja flash)   #将固件刷入RAM (刷入前请将计算器完全断电(抠电池), 之后在按住ON/C按键的同时插入USB线，即可进入刷写模式)

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

代码提交规范

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

变量
- 变量采用小驼峰命名法命名。例如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

hh127 / existos-for-hp39gii Goto Github PK