Skip to content

oblonka/pikascript

 
 

Repository files navigation

微信交流群

来颗Star求求了~ Star please~

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.

output_Kgj52R

2.驱动适配进度

Device PikaPi-Zero STM32G030C8 STM32G070CB STM32F103C8
Time OK OK OK OK
GPIO OK OK OK OK
UART OK OK OK OK
PWM OK OK Not yet OK
ADC OK OK OK OK
I2C Not yet Not yet Not yet Not yet
SPI Not yet Not yet Not yet Not yet
RGB OK - - -

3.特性

(1)运行环境

支持裸机运行,可运行于 RAM ≥ 4kBFLASH ≥ 32kB 的mcu中,如stm32g030, stm32f103c8t6,esp8266。

(2)开发环境

支持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例程

pikascript-stm32-demo

(6)开发手册

1. PikaScript-三分钟快速上手

2. PikaScript-架构与原理

3. PikaScript-十分钟快速部署

4. PikaScript-标准开发流程

5. PikaScript-Demo展示

(7)架构示意图

微信交流群

4.stm32教程视频

手把手PikaScript教程合集

5.交流与技术支持:

微信交流群

微信截图_20210917133247

群已经满啦,加我QQ拉你进群~ qq: 645275593

Tencent QQ: 645275593

6.贡献者

内容 贡献者
捐赠:中国移动CM32M101A 开发板 孟巍(微信名)
捐赠:APM32F030R8 开发板 极海半导体 陈成
捐赠:APM32E103VB 开发板 极海半导体 陈成
捐赠:APEX-Link仿真器 极海半导体 陈成
源码格式化 Meco Jianting Man
demo/simulation-keil 千帆(微信名)
demo/stm32f103zet6/demo01-led-stm32f103zet6 甜航
demo/stm32f103zet6/demo02-led-stm32f103zet6_tworoot 甜航
demo/stm32f407zgt/demo01-led-stm32f407vgt 甜航

7.Demo展示:我就要用最便宜的单片机来跑python,还要用MDK开发,怎么地吧!

我就想用单片机跑个Python,得用linux虚拟机+交叉编译工具链+命令行编译micropython固件,还得用DfuSe工具烧录固件,烧录完还不能用C的调试器来调试。

我想拓展个自己的C模块,还要学着用一些完全看不懂的宏函数,还得手动注册,还得编写makeFile,编译完照样不能调试C。

我穷,买不起STM32F4,想买个STM32F103C8T6的micropython开发板,淘宝一搜,好像没有。

现在C8T6贵了,我还想用F0,用G0,能行吗?

好像,给G0移植micropython,不是很容易。

那?有没有另一种玩法?

换句话说,我想用Keil开发,用Keil调试,我还想用最便宜的单片机。

这,能玩Python吗?

output_Kgj52R

要不,试试PikaScript?

啥是PikaScript?

PikaScript可以为资源受限的mcu提供极易部署和拓展的Python脚本支持。

PikaScript支持裸机运行,最低可运行于 RAM ≥ 4kB ,FLASH ≥ 32kB 的mcu中,推荐配置为 RAM ≥ 10kB, FLASH ≥ 64kB,像是stm32f103c8t6、stm32g070RBT6这些完全没有压力,甚至已经满足了推荐配置。

而且支持Keil、IAR、rt-thread studio、segger embedded studio等IDE开发,零依赖,零配置,开箱即用,极易集成进已有的C工程。

说了这么多,刘华强就有疑问了,你说这脚本,保熟吗?

QQ截图20210911174834

我这开水果脚本摊儿的,能买你生脚本蛋子?

这就挑点儿Demo给哥儿几个瞧瞧。

这可都是STM32G070RBT6的Demo。

Demo 01 万物起源点个灯

mmexport1631351506111

看看这脚本,可都是如假包换的Python3标准语法。

这灯不就闪起来了吗。

Hnet-image (2)

Demo 02 串口测试

mmexport1631351902469

开个串口,读俩字符试试

Hnet-image (3)

非常顺滑

Demo 03 读个ADC试试

mmexport1631351527609

同样几行脚本搞定。

mmexport1631351523907

这是输出的结果。

Demo 04 PWM输出

image

Demo 05 RGB流水灯

image

这几个Demo占用的RAM最大值只有3.56K,把1K的堆栈也算上就是4.56K,Flash最大占用是30.4K,以STM32F103C8T6的20K RAM和64K Flash为标准,RAM才用掉不到25%,Flash才用掉不到50%,简直是资源多到不知道咋霍霍。

同样跑Python,我们可以简单对比一下micropython的常用芯片STM32F405RG和这次跑PikaScript的芯片STM32G070CB

RAM资源对比

image

Flash资源对比

image

参考价对比(以2021年9月11日立创商城10片售价为参考)

image

拓展能力如何呢?

除了设备驱动之外,为mcu开发自定义的python脚本绑定在pikascript的开发框架下非常轻松,下面两个Demo就是自定义的C模块拓展,这个Demo基于ARM-2D图像驱动库开发了一些python脚本接口。

几个小方块~

Hnet-image (7)

几个旋转太阳~

Hnet-image (6)

那,PikaScript是开源的吗?

当然,这个就是PikaScript的github主页: https://github.com/pikasTech/pikascript

开发难不难?

PikaScript为开发者准备了丰富的Demo和由浅入深的开发指南,指南还会持续完善和维护。 image

可以商用吗?

当然!PikaScript采用MIT协议,允许修改和商用,但是要注意保留原作者的署名。

6.内核测试与开发

linux下测试pikascript内核(推荐ubuntu20.04):

step1: 拉取项目

git clone https://github.com/mimilib/pikascript
cd pikascript

step2: 编译项目

sh init.sh # 第一次编译前运行,之后就不用运行了 
sh make.sh # 编译项目

step3: 运行单元测试

sh test

step4: 运行基准测试

sh test-banchmark

step5: 运行demo

./build/src/boot/demo06-pikamain/pikascript_demo06-pikamain

Packages

No packages published

Languages

  • C++ 83.1%
  • Python 9.4%
  • C 4.1%
  • Rust 1.2%
  • CMake 1.1%
  • Starlark 0.7%
  • Other 0.4%