From 4e880767728a0e334bee9311a0d621aeccf00eb0 Mon Sep 17 00:00:00 2001 From: YuzukiTsuru Date: Sun, 31 Dec 2023 20:33:31 +0800 Subject: [PATCH] [version] bump version to 0.2.1 --- CMakeLists.txt | 2 +- README.md | 163 ++++++------------------------------------------- config.h.in | 1 + src/common.c | 2 +- 4 files changed, 23 insertions(+), 145 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 55182594..e596daa2 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -66,7 +66,7 @@ else () endif () # Define the project name and languages used -project(SyterKit C CXX ASM) +project(SyterKit VERSION 0.2.1 LANGUAGES C CXX ASM) # Include other CMake modules include(cmake/add_syterkit_app.cmake) diff --git a/README.md b/README.md index 56acb2f1..dd9680d0 100644 --- a/README.md +++ b/README.md @@ -1,24 +1,17 @@ # SyterKit -- [中文版](#syterkit-1) - -SyterKit is a bare-metal framework designed for development boards like TinyVision or other chips such as v851se/v851s/v851s3/v853. SyterKit utilizes CMake as its build system and supports various applications and peripheral drivers. Additionally, SyterKit also has bootloader functionality, which enables it to replace U-Boot for fast booting (standard Linux 6.7 mainline boot time of 1.02s, significantly faster than traditional U-Boot's 3s boot time). - -## App - -| Name | Function | Path | -| --------------- | ------------------------------------------------------------ | --------------------- | -| hello world | Minimal program example, prints Hello World | `app/hello_world` | -| init dram | Initializes the serial port and DRAM | `app/init_dram` | -| read chip efuse | Reads chip efuse information | `app/read_chip_efuse` | -| read chipsid | Reads the unique ID of the chip | `app/read_chipsid` | -| load e907 | Reads the e907 core firmware, starts the e907 core, and uses V851s as a large RISC-V microcontroller (E907 @ 600 MHz with 64MB memory) | `app/load_e907` | -| syter boot | Bootstrapping function that replaces U-Boot, enabling fast system startup for Linux | `app/syter_boot` | -| syter amp | Reads the e907 core firmware, starts the e907 core, loads the kernel, and runs Linux simultaneously on both e907 and a7 systems, which are heterogeneously integrated | `app/syter_amp` | -| fdt parser | Reads the DTB and Parser Print out | `app/fdt_parser` | -| fdt cli | Reads the DTB with a CLI support uboot fdt command | `app/fdt_cli` | -| syter bootargs | Bootstrapping function that replaces U-Boot, enabling fast system startup for Linux, Within a CLI to change bootargs | `app/syter_bootargs` | -| cli test | Test baisc CLI function | `app/cli_test` | +SyterKit is a bare-metal framework designed for Allwinner platform. SyterKit utilizes CMake as its build system and supports various applications and peripheral drivers. Additionally, SyterKit also has bootloader functionality, which enables it to replace U-Boot for fast booting (standard Linux 6.7 mainline boot time of 1.02s, significantly faster than traditional U-Boot's 3s boot time). + +## Support list + +| Board | Manufacturer | Platform | Spec | Details | Config | +| ------------------------------------------------------------ | ------------ | -------- | --------------------------------- | ------------------------------------------ | --------------------- | +| [Yuzukilizard](https://github.com/YuzukiHD/Yuzukilizard) | YuzukiHD | V851s | Cortex A7 | [board/yuzukilizard](board/yuzukilizard) | `yuzukilizard.cmake` | +| [TinyVision](https://github.com/YuzukiHD/TinyVision) | YuzukiHD | V851se | Cortex A7 | [board/tinyvision](board/tinyvision) | `tinyvision.cmake` | +| 100ask-t113s3 | 100ask | T113-S3 | Dual-Core Cortex A7 | [board/100ask-t113s3](board/100ask-t113s3) | `100ask-t113s3.cmake` | +| 100ask-t113i | 100ask | T113-I | Dual-Core Cortex A7 + C906 RISC-V | [board/100ask-t113i](board/100ask-t113i) | `100ask-t113i.cmake` | +| [longanpi-3h](https://wiki.sipeed.com/hardware/zh/longan/H618/lpi3h/1_intro.html) | sipeed | H618 | Quad-Core Cortex A53 | [board/longanpi-3h](board/longanpi-3h) | `longanpi-3h.cmake` | +| longanpi-4b | sipeed | T527 | Octa-Core Cortex A55 | [board/longanpi-4b](board/longanpi-3h) | `longanpi-4b.cmake` | ## Getting Started @@ -46,13 +39,18 @@ cd build Finally, run the following commands to compile SyterKit: ```shell -cmake .. +cmake -DCMAKE_BOARD_FILE={Board_config_file.cmake} .. make ``` -The compiled executable files will be located in `build/app`. +For example, if you want to compile SyterKit for the TinyVision platform, you need the following command: + +```bash +cmake -DCMAKE_BOARD_FILE=tinyvision.cmake .. +make +``` -![image-20231206212123866](assets/post/README/image-20231206212123866.png) +The compiled executable files will be located in `build/board/{board_name}/{app_name}`. The SyterKit project will compile two versions: firmware ending with `.elf` is for USB booting and requires bootloading by PC-side software, while firmware ending with `.bin` is for flashing and can be written into storage devices such as TF cards and SPI NAND. @@ -118,124 +116,3 @@ Use the xfel tool to flash the created firmware into SPI NOR: ```shell xfel spinor write 0x0 spi.img ``` - - -# SyterKit - -SyterKit 是一个纯裸机框架，用于 TinyVision 或者其他 v851se/v851s/v851s3/v853 等芯片的开发板，SyterKit 使用 CMake 作为构建系统构建，支持多种应用与多种外设驱动。同时 SyterKit 也具有启动引导的功能，可以替代 U-Boot 实现快速启动（标准 Linux6.7 主线启动时间 1.02s，相较于传统 U-Boot 启动快 3s）。 - -## 应用 - -| 名称 | 功能 | 路径 | -| --------------- | ------------------------------------------------------------ | --------------------- | -| hello world | 最小程序示例，打印 Hello World | `app/hello_world` | -| init dram | 初始化串行端口和 DRAM | `app/init_dram` | -| read chip efuse | 读取芯片 efuse 信息 | `app/read_chip_efuse` | -| read chipsid | 读取芯片的唯一 ID | `app/read_chipsid` | -| load e907 | 读取 e907 核心固件，启动 e907 核心，并使用 V851s 作为大型 RISC-V 微控制器（E907 @ 600 MHz，64MB 内存） | `app/load_e907` | -| syter boot | 替代 U-Boot 的引导函数，为 Linux 启用快速系统启动 | `app/syter_boot` | -| syter amp | 读取 e907 核心固件，启动 e907 核心，加载内核，并在 e907 和 a7 系统上同时运行 Linux，系统是异构集成运行的 | `app/syter_amp` | -| fdt parser | 读取设备树二进制文件并解析打印输出 | `app/fdt_parser` | -| fdt cli | 使用支持 uboot fdt 命令的 CLI 读取设备树二进制文件 | `app/fdt_cli` | -| syter bootargs | 替代 U-Boot 引导，为 Linux 启用快速系统启动，支持在 CLI 中更改启动参数 | `app/syter_bootargs` | -| cli test | 测试基本 CLI 功能 | `app/cli_test` | - -## 开始使用 - -### 从零构建 SyterKit - -构建 SyterKit 非常简单，只需要在 Linux 操作系统中安装配置环境即可编译。SyterKit 需要的软件包有： - -- `gcc-arm-none-eabi` -- `CMake` - -对于常用的 Ubuntu 系统，可以通过如下命令安装 - -```shell -sudo apt-get update -sudo apt-get install gcc-arm-none-eabi cmake build-essential -y -``` - -然后新建一个文件夹存放编译的输出文件，并且进入这个文件夹 - -```shell -mkdir build -cd build -``` - -然后运行命令编译 SyterKit - -```shell -cmake .. -make -``` - -编译后的可执行文件位于 `build/app` 中 - -![image-20231206212123866](assets/post/README/image-20231206212123866.png) - -同一个项目工程 SyterKit 会编译两个版本，`elf` 结尾的固件为 USB 引导固件，需要电脑上位软件进行引导加载，`bin` 结尾的固件为刷写固件，可以刷入 TF 卡，SPI NAND 等储存器。 - -- 对于 SD 卡，你需要刷写 `xxx_card.bin` 文件。 -- 对于 SPI NAND/SPI NOR，你需要刷写 `xxx_spi.bin` 文件。 - - -### 制作 TF 卡启动固件 - -固件可以刷入TF卡内使用，对于 V851s 平台，可以将其写入 8K 偏移位或者 128K 偏移位。一般来说如果TF卡使用的是 MBR 格式，写 8K 偏移，如果是 GPT 格式，写128K 偏移。这里假设 `/dev/sdb` 是目标 TF 卡。写入 8K 偏移位 - -```shell -sudo dd if=syter_boot_bin_card.bin of=/dev/sdb bs=1024 seek=8 -``` - -如果是 GPT 分区表，需要写入 128K 偏移量 - -```shell -sudo dd if=syter_boot_bin_card.bin of=/dev/sdb bs=1024 seek=128 -``` - -#### 制作 SPI NAND 启动固件 - -制作 SPI NAND 的固件，需要将 SyterKit 写入对应位置制作固件 - -```shell -dd if=syter_boot_bin_spi.bin of=spi.img bs=2k -dd if=syter_boot_bin_spi.bin of=spi.img bs=2k seek=32 -dd if=syter_boot_bin_spi.bin of=spi.img bs=2k seek=64 -``` - -同时也可以把 Linux 内核与设备树一同写入固件中 - -```shell -dd if=sunxi.dtb of=spi.img bs=2k seek=128 # DTB on page 128 -dd if=zImage of=spi.img bs=2k seek=256 # Kernel on page 256 -``` - -制作完成的固件可以使用 xfel 工具刷入 SPI NAND - -```shell -xfel spinand write 0x0 spi.img -``` - -#### 制作 SPI NOR 启动固件 - -制作 SPI NOR 的固件，需要将 SyterKit 写入对应位置制作固件 - -```shell -dd if=syter_boot_bin_spi.bin of=spi.img bs=2k -dd if=syter_boot_bin_spi.bin of=spi.img bs=2k seek=32 -dd if=syter_boot_bin_spi.bin of=spi.img bs=2k seek=64 -``` - -同时也可以把 Linux 内核与设备树一同写入固件中 - -```shell -dd if=sunxi.dtb of=spi.img bs=2k seek=128 # DTB on page 128 -dd if=zImage of=spi.img bs=2k seek=256 # Kernel on page 256 -``` - -制作完成的固件可以使用 xfel 工具刷入 SPI NOR - -```shell -xfel spinor write 0x0 spi.img -``` diff --git a/config.h.in b/config.h.in index 902614bd..9c6ef30c 100644 --- a/config.h.in +++ b/config.h.in @@ -5,6 +5,7 @@ // Project Info #define PROJECT_NAME "@PROJECT_NAME@" +#define PROJECT_VERSION "@CMAKE_PROJECT_VERSION@" #define PROJECT_GIT_HASH "@PROJECT_GIT_HASH@" #define PROJECT_C_COMPILER "@COMPILER_NAME@" diff --git a/src/common.c b/src/common.c index 14b72f16..18349343 100644 --- a/src/common.c +++ b/src/common.c @@ -12,7 +12,7 @@ void show_banner(void) { printk(LOG_LEVEL_INFO, "|_____|_ |_| |___|_| |__|__|_|_| \n"); printk(LOG_LEVEL_INFO, " |___| \n"); printk(LOG_LEVEL_INFO, "***********************************\n"); - printk(LOG_LEVEL_INFO, " %s V0.2.0 Commit: %s\n", PROJECT_NAME, PROJECT_GIT_HASH); + printk(LOG_LEVEL_INFO, " %s v%s Commit: %s\n", PROJECT_NAME, PROJECT_VERSION, PROJECT_GIT_HASH); printk(LOG_LEVEL_INFO, " Built by: %s\n", PROJECT_C_COMPILER); printk(LOG_LEVEL_INFO, "***********************************\n"); printk(LOG_LEVEL_INFO, "\n");