# micronorth

**Repository Path**: cxy_kevin/micronorth

## Basic Information

- **Project Name**: micronorth
- **Description**: northstar-micronorth计划主仓库
- **Primary Language**: Python
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-01-06
- **Last Updated**: 2023-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: ESP32

## README

# micronorth

#### 介绍
micronorth的目的是编写在esp32上的微型OS，目标兼容northstar程序

#### 软件架构
+ ~~fimeware：定制固件（无需上传）~~
+ font：字体目录
    + system-12.fon：中文字体
    + clock.csf：时钟csf字体（暂时未使用）
+ libs：库文件
    + **northstar.py：系统主库文件（不开放）** 
+ system：系统文件
    + cn.kbw：中文字典文件（中文输入法字库）
    + **init.py：系统启动文件**
    + loadinggui.py：启动动画
    + recovery.py：恢复功能程序
    + security.py：内核安全模块
+ system_app：rec工具目录
    + test_btn.py：测试按钮
    + wsc.py：网络控制功能
+ **main.py：入口文件** 
+ **storage：主系统及文件目录**
    + system：系统目录
        + libs：库文件
            + **ns.py：系统主库文件** 
        + config：系统配置文件
            + permissions.cfg：权限设置文件
        + **northstart.py：系统启动文件** 
    + data：用户文件目录
        + NorthStar：系统保留目录
            + data：应用文件目录
            + appdata：程序及"伪沙盒"目录


#### 安装教程

> 此处仅为软件部分的安装，硬件请参考 嘉立创EDA 内提供的帮助

1.  clone本仓库/下载发行版
2.  进入boot模式，使用esp32官方提供的 esptool 或 thonny 刷入fimeware下的对应固件（为了支持中文）
3.  使用任意软件（推荐fileuploader或thonny）上传除 `.git` 和 `fimeware` 的所有文件/文件夹
4.  重启esp

#### 使用说明

+ 系统部分
    预告
+ rec部分
    1. 开机/重启时长按 `[A]` 键，松手进入rec
    2. 上下键切换选项，带有箭头的是菜单， `[A]` 键进入， `[B]` 键返回
    3. wifi菜单需连接wifi，支持手动输入密码，也支持配置（配置无效仍需手动连接），可输入密码，详情见 `“键盘输入指南”` ，可使用`webrepl`或`wsc`（微信小程序远程控制）

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

#### 版本迭代
|  版本  |   日期     |                    更新内容                 |
| :----: | :-------: | :----------------------------------------- |
| v0.0.0 | 2022.7.X  | 项目立项                                    |
| v0.0.1 | 2022.8.X  | 项目开始开发，完成northstart库部分内容        |
| v0.0.2 | 2022.9.X  | 项目完成引导及rec部分                        |
| v0.0.3 | 2022.10.X | 项目完成远控功能，更新停滞                    |
| v0.0.4 | 2023.1.6  | 整理并发布，整合readme、固件、许可            |
| v0.1.0 | 2023.1.7  | 完成引导部分，添加动画等                      |
| v0.1.1 | 2023.1.15 | 补充readme和添加安全模块，确定应用程序运行架构 |
| v0.1.2 | 2023.1.21 | 补充安全模块，权限系统初步成效                |