pikapython/README.md

# 1.简介
PikaScript可以为资源受限的mcu提供极易部署和拓展的Python脚本绑定。

支持裸机运行，可运行于RAM > 8kB的mcu中，如stm32f103c8t6，esp32。

使用python3标准语法的子集。

在编译时支持python类和方法定义(基于[Pika预编译器](https://github.com/mimilib/pikascript-compiler-rust))。

在运行时支持python方法调用、变量定义、对象构造、对象释放(基于[Pika运行时内核](https://github.com/mimilib/pikascript-core))。

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

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

完整的googletest单元测试。

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

源码命名规范，可读性强。

## 开发手册
[1. PikaScript-三分钟快速上手](doc/1.三分钟快速上手.md)

[2. PikaScript-十分钟快速部署](doc/2.十分钟快速部署.md)
## stm32例程
[pikascript-stm32-demo](../../../pikascript-demo-stm32)

# 2.stm32教程视频

[手把手PikaScript教程合集](https://www.bilibili.com/video/BV1mg411L72e)

# 3.原理解析：

## 架构示意图
![K9C)%CZO)X`8VFBKCE8(9@W](https://user-images.githubusercontent.com/88232613/127806449-b476b2fd-9f40-4c53-94a0-e1e965c046c3.png)

## 解析文章
[单片机运行python脚本，不移植micropython也行吗？](https://mp.weixin.qq.com/s?__biz=MzU4NzUzMDc1OA==&mid=2247484127&idx=1&sn=f66cff49c488e48c52570c7bb570328f&chksm=fdebd5b6ca9c5ca0707fd221c32f3ad63e94aeb6f917a92774b89ea042381ea261990f5cca3c&token=2045971639&lang=zh_CN#rd)

## 微信交流群
![微信图片_20210825171046](https://user-images.githubusercontent.com/88232613/130763024-c57106f5-0d46-43d8-99e3-c331ae2594b5.jpg)

## 官方公众号
![image](https://user-images.githubusercontent.com/88232613/128301451-f0cdecea-6457-4925-b084-42e7796a856e.png)

# 4.内核测试与开发

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

step1: 拉取项目
``` shell
git clone https://github.com/mimilib/pikascript
cd pikascript
```

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

step3: 运行单元测试
``` shell	
sh test
```

step4: 运行基准测试
``` shell
sh test-banchmark
```

step5: 运行demo
``` shell
./build/src/boot/demo06-pikamain/pikascript_demo06-pikamain
```

step6: 提交修改
``` shell
sh commit.sh
```