pikapython/README.md

下载PikaScript

https://github.com/mimilib/pikascript/releases/download/v0.3.1/pikascript.v0.3.1.zip

stm32例程

https://github.com/mimilib/pikascript-demo-stm32

gitee 镜像：https://gitee.com/Lyon1998/pikascript-demo-stm32

1.简介

pikascript可以为mcu裸机c开发提供面向对象的脚本绑定。

支持裸机运行，可运行于内存8Kb以上的mcu中，如stm32f103c8t6，esp32。

官方支持api源码生成器

https://github.com/mimilib/pikascript-compiler-rust

支持跨平台，可在linux环境开发、测试内核。

开箱即用，零配置，仅使用C标准库，几乎不使用宏，几乎不使用全局变量。

完整的单元测试。

堆空间零占用，栈空间少量占用，内存信息可观测。

尽可能的结构清晰（尽我所能）。

2.stm32教程视频

https://www.bilibili.com/video/BV1mg411L72e

3.原理解析：

架构示意图

内核源码

https://github.com/mimilib/pikascript-core

解析文章

单片机运行python脚本，不移植micropython也行吗？

https://mp.weixin.qq.com/s?__biz=MzU4NzUzMDc1OA==&mid=2247484127&idx=1&sn=f66cff49c488e48c52570c7bb570328f&chksm=fdebd5b6ca9c5ca0707fd221c32f3ad63e94aeb6f917a92774b89ea042381ea261990f5cca3c&token=2045971639&lang=zh_CN#rd

微信交流群

官方公众号

4.内核测试与开发

windows下测试PikaScript内核：

step1: 下载源码

https://github.com/mimilib/PikaScript/releases/download/v1.0/PikaScript-v1.0.zip

step2: 下载安装codeblocks

https://download.fosshub.com/Protected/expiretime=1628119786;badurl=aHR0cHM6Ly93d3cuZm9zc2h1Yi5jb20vQ29kZS1CbG9ja3MuaHRtbA==/9bc1258414546cedb7b0774846ec773613a89ed715964c9a3239fab0465f014d/5b85805cf9ee5a5c3e979f1b/5e80624f7d74bb810359a46c/codeblocks-20.03-setup.exe

step3: 打开winproject文件夹下的demoXX/demoXX.cbs编译运行

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

step1: 拉取项目

git clone https://github.com/mimilib/pikascript
cd PikaScript
git submodule init && git submodule update

step2: 安装编译链

sudo apt update
sudo apt install -y clang llvm cmake zlib1g-dev

step3: 编译项目

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

step4: 运行demo

bin/demo01-led.bin

用法示例：

#include "sysObj.h"

/* 
    被绑定的方法 
    self 是对象指针，指向执行方法的对象
    args 是参数列表，用于传入传出参数
    （所有被绑定的方法均使用此形参）
*/
void add(PikaObj *self, Args *args) 
{
    /* 
        参数传递 
        从参数列表中取出输入参数val1和val2
    */
    int val1 = args_getInt(args, "val1");
    int val2 = args_getInt(args, "val2");
    
    /* 实现方法的功能 */
    int res = val1 + val2;
    
    /* 将返回值传回参数列表 */
    method_returnInt(args, res);
}

/* 
    定义测试类的构造器，一个构造器对应一个类
    通过构造器即可新建对象
    args是构造器的初始化参数列表
    PikaObj*是新建对象的指针
    （所有构造器均使用此形参）
*/
PikaObj *New_PikaObj_test(Args *args)
{
    /* 
        继承sys类
        只需要直接调用父类的构造器即可
    */
    PikaObj *self = New_PikaObj_sys(args);
    
    /* 
        为test类绑定一个方法（支持重载）
        1.入口参数self：对象指针，指向当前对象
        2.传入的第二参数是被绑定方法的接口定义
        （此处使用typescript语法，简单的修改即可支持python格式）
        3.传入的第三个参数是被绑定方法的函数指针
    */
    class_defineMethod(self, "add(val1:int, val2:int):int", add); 


    /* 返回对象 */
    return self;
}

void main()
{
    /* 
        新建根对象，对象名为“sys”
        传入对象名和构造器的函数指针
    */
    PikaObj *sys = newRootObj("sys", New_PikaObj_sys);

    /* 
        新建test对象
        test对象作为子对象挂载在sys对象下（对象树）
    */
    obj_newObj(sys, "test", New_PikaObj_test);
    
    /*  
        运行单行脚本。
        因为test对象挂在在sys对象下，
        因此可以通过test.add调用test对象的方法
        运行后会动态新建res属性，该属性属于sys对象
    */
    obj_run(sys, "res = test.add(val1 = 1, val2 = 2)");
    /*
        (也支持 "res = test.add(1, 2)"的调用方式)
    */
    
    /* 从sys对象中取出属性值res */
    int res = obj_getInt(sys, "res");
    
    /* 
        析构对象
        所有挂载在sys对象下的子对象都会被自动析构
        本例中挂载了test对象，因此在析构sys对象前，
        test对象会被自动析构
    */
    obj_deinit(sys);
    
    /* 打印返回值 res = 3*/
    printf("%d\r\n", res);    
}

5. PikaScript-compiler

将pyton编译为PikaScript的C源码