9.7 KiB
来颗Star求求了~ Star please~
issue, pr请往主仓库：Github/pikastech/pikascript
视频教程
入门篇 - 面向单片机Python编程用户
中级篇 - 面向驱动开发者
PikaScript中级 RISC-V部署PikaScript CH32V103R8
进阶篇 - 面向编译器爱好者和开源项目维护者
PikaScript进阶-Github自动测试-Github Actions CI
获取PikaScript:
使用Pika包管理器PikaPackage.exe
-
直接运行PikaPackage.exe, 自动下载并更新pikaScript主仓库(文件在当前磁盘的/tmp/pikaScript文件夹)
-
将requestment.txt放在PikaPackage.exe同一文件夹下, 运行pikaPackage.exe, 自动在当前目录下安装内核、预编译器与模块。
-
已发布的模块列表：packages.toml
1.简介
PikaScript是一个完全重写的超轻量级python引擎，零依赖，零配置，可以在少于4KB的RAM下运行(如stm32g030c8和stm32f103c8)，极易部署和扩展。
PikaScript is an ultra lightweight Python engine with zero dependencies and zero configuration, that can run with 4KB of RAM (such as STM32G030C8 and STM32F103C8), and very easy to deploy and expand.
文件目录
src - 内核源码
bsp - 裸机芯片/板卡支持
port - 操作系统支持
document - 开发文档
examples - 示例脚本
package - 模块目录
pikaCompiler - 使用rust编写的预编译器
pikaPackageManager - 使用go编写的模块管理器
2.驱动适配进度
| MCU/Board | gpio | uart | pwm | adc | rgb | i2c | spi |
|---|---|---|---|---|---|---|---|
| PikaPi Zero | √ | √ | √ | √ | √ | ||
| stm32g030c8 | √ | √ | √ | √ | - | ||
| stm32g070cB | √ | √ | √ | √ | - | ||
| stm32f103c8 | √ | √ | √ | √ | - |
3.特性
(1)运行环境
支持裸机运行，可运行于 RAM ≥ 4kB ，FLASH ≥ 32kB 的mcu中，如stm32g030, stm32f103c8t6，esp8266。
(2)开发环境
支持串口下载Python脚本。
支持Keil、IAR、rt-thread studio、segger embedded studio等IDE开发。
支持CMake、makeFile、Scons等构建工具
零依赖，零配置，开箱即用，极易集成进已有的C工程。
极易拓展自定义的C原生函数。
支持跨平台，可在linux环境开发内核。
(3)语法特性
使用python3标准语法的子集。
在编译时支持python类和方法定义，完整支持封装、继承、多态、模块功能 - 基于Pika预编译器。
在运行时支持python方法调用、变量定义、对象构造、对象释放、控制流(if\while) - 基于Pika运行时内核。
(4)源码规范
注重源码可读性，命名规范，标准统一，完全不使用宏，几乎不使用全局变量。
完整的googletest单元测试。
(5)stm32例程
(6)开发手册
4.交流与技术支持：
微信交流群
群已经满啦，加我QQ拉你进群~ qq: 645275593
Tencent QQ： 645275593
E-mail: 645275593@qq.com
5.贡献者
| 内容 | 贡献者 |
|---|---|
| 捐赠：GD32E103TB芯片2片 | 信息牛(微信名) |
| Rt-thread 支持包模板 | Meco Jianting Man |
| 捐赠：移远EC600S-CN 4G模块 | 移远模块 |
| 捐赠：博流BL706 开发板 | 博流智能 bouffalolab |
| 捐赠：中国移动CM32M101A 开发板 | 孟巍(微信名) |
| 捐赠：APM32F030R8 开发板 | 极海半导体 陈成 |
| 捐赠：APM32E103VB 开发板 | 极海半导体 陈成 |
| 捐赠：APEX-Link仿真器 | 极海半导体 陈成 |
| 源码格式化，增加git属性文件 | Meco Jianting Man |
| demo/simulation-keil | 千帆(微信名) |
| demo/stm32f103zet6/demo01-led-stm32f103zet6 | 甜航 |
| demo/stm32f103zet6/demo02-led-stm32f103zet6_tworoot | 甜航 |
| demo/stm32f407zgt/demo01-led-stm32f407vgt | 甜航 |
6.内核测试与开发
linux下测试pikascript内核(推荐ubuntu20.04)：
step1: 拉取项目
git clone https://github.com/pikastech/pikascript
cd pikascript/src
step2: 编译项目
sh init.sh # 第一次编译前运行，之后就不用运行了
sh make.sh # 编译项目
step3: 运行单元测试
sh test.sh
step4: 运行基准测试
sh test-banchmark.sh
step5: 运行demo
./build/src/boot/demo06-pikamain/pikascript_demo06-pikamain
7.Demo展示
Demo 01 万物起源点个灯
Demo 02 串口测试
Demo 03 读个ADC试试
Demo 04 PWM输出
Demo 05 RGB流水灯
这几个Demo占用的RAM最大值只有3.56K，把1K的堆栈也算上就是4.56K，Flash最大占用是30.4K，以STM32F103C8T6的20K RAM和64K Flash为标准，RAM才用掉不到25%，Flash才用掉不到50%。
我们可以简单对比一下micropython的常用芯片STM32F405RG和这次跑PikaScript的芯片STM32G070CB
RAM资源对比
Flash资源对比
参考价对比(以2021年9月11日立创商城10片售价为参考）
拓展能力如何呢？
除了设备驱动之外，为mcu开发自定义的python脚本绑定在pikascript的开发框架下非常轻松，下面两个Demo就是自定义的C模块拓展，这个Demo基于ARM-2D图像驱动库开发了一些python脚本接口。
几个小方块~
几个旋转太阳~
