Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up

An ultra-lightweight Python interpreter that runs with only 4KB of RAM, zero dependencies. It is ready to use out of the box without any configuration required and easy to extend with C. Similar project: MicroPython, JerryScript.

License

NotificationsYou must be signed in to change notification settings

IVOES/PikaPython

 
 

Repository files navigation

logo

PikaPython

Cross platform ultra lightweight embedded Python engine

中文页 |Forum |Documents |Videos |BSP |Package Manager |Contribute |Business

image

1. Abstract

PikaPython is an ultra-lightweight Python interpreter that runs with only 4KB of RAM, zero dependencies. It is ready to use out of the box without any configuration required and easy to extend with C.

PikaPython also known as PikaScript and PikaPy.

It's very easy to bind C function to python module with the help of Pika Pre-compiler.Only write the API of python in.pyi and the bindings are autoly generated by Pre-compiler.

image-20220520233540245

Get pikapython:

Use Online Project Generator

Generator url:http://pikascript.com

Note: You need theCommunity Edition license (Now Free) to build Keil projects, and the version of Keil should be newer than v5.36.

Use Pika package managerPikaPackage.exe

  1. Run thePikaPackage.exe directly, then the pikapython repo would be downloaded auto in the /tmp/pikascript folder of your current disc partition.

  2. Addrequestment.txt to the same folder of PikaPackage.exe then runPikaPackage.exe. Therun-time core,pre-compiler andmoudles would be installed in the current folder.

  3. Released modules:packages.toml

Quick Start

You can usesimulation project to quick start without hardware,or use the out-of-the-box develop boardPika-Pi—Zero.

image

The board based on STM32G030C8T6 MCU, only 64kB Flash, 8kB RAM can run pikapython with total peripheral device (GPIO、TIME、IIC、RGB、KEY、LCD、RGB).CH340 is deployed to support USB to serial with Type-C USB, support download python script py serial, there are 4 RGB on the board and support theLCD.

Open hardware

Related Projects

Document

https://pikadoc.readthedocs.io/en/latest/index.html

How to contribute

https://pikadoc.readthedocs.io/en/latest/%E5%A6%82%E4%BD%95%E5%8F%82%E4%B8%8E%E7%A4%BE%E5%8C%BA%E8%B4%A1%E7%8C%AE.html

Folders

src - core code

bsp - mcu/board support

port - OS and package manager

test - unit test

document - developt document

examples - example scripts

package - packages and moudles

pikaCompiler - pre-compiler write by Rust, used to bind C function to python moudle.

pikaPackageManager - pacakge manager

2.Platform support

MCU support

MCUbspgpiotimeuartpwmadci2cdac
stm32g030c8
stm32g070cB
stm32f103c8
stm32f103rb
stm32f103ze
stm32f103rc
stm32f401cc
stm32f411ce
stm32f407ze
stm32f407zg
stm32h750vb
stm32f051r8
air32f103cb
ch582
ch32v103r8t6
cm32m101a
w806
apm32f030r8
apm32e103vb
bl-602
bl-706
bl-618
Raspberry Pico
ESP32C3
TC264D
devc
visual-studio
EC600N
mm32f5277e9p
xr806(openharmony)

Board support

Boardbspgpiouartpwmadci2crgblcdarm-2d
Pika-Pi-Zero
Boardbsppika_lvgl
lvgl-vs-simu
swm320
Boardbsparm-2d
QEMU-arm2d
BoardbspLEDKEY
SmartLoong

OS support

OSportGPIOTIMEPWM
RT-Thread
vsf
OSportGoogle TestBenchmark
linux

3.Characteristic

(1)Run environment

Support run in mcu without OS or file system. Can run in everywhere withRAM ≥ 4kB andFLASH ≥ 64kB,such as stm32g030, stm32f103c8t6,esp8266.

(2)Develop enviroment

Support REPL by serial.

微信交流群

Support run and program python scripts by serial.

微信交流群

Support IDEs like Keil, IAR, RT-Thread studio and segger embedded studio to develop C moudle.

Support build tools like CMake, makeFile and Scons.

Zero dependencies, zero configuration, out-of-the-box, easy to integrated into privious C projcet.

Eazy to extern customized C moudles.

Support linux.

(3)Syntax

Support subaggregate of python 3 standard syntax.

Support class and method define, encapsulation-inheritance-polymorphism and moudles in.pyi of C module.

More Details About Syntax Support
SyntaxCompile-TimeRun-TimeShell
Module Define--
Module Import
Class Define
Class Inherit
Method Define
Method Override
Method Invoke
Argument Define
Argument Assignment
Object New
Object Free
Object Nest
Control flow

Operator

+-*/==><>=<=%**//!=&>><<andornotin+=-=*=/=

Control flow

SyntaxState
if
while
for in [list]
for in range(a, b)
for in [dict]
if elif else
for break/continue
while break/continue

Module

SyntaxPython ModuleC Module
import [module]
import [module] as-
from [module] import [class/function>]-
from [module] import [class/function>] as-
from [module] import *-PikaObj Module Only

List/Dict

SyntaxState
l = list()
l = [a, b, c]
d = dict()
d = {'a':x, 'b':y, 'c':z}

Exception

SyntaxState
try:
except:
except [Exception]:-
except [Exception] as [err]:-
except: ... else:-
raise:
raise [Exception]:-
finally:-

Slice

Syntaxstrbyteslist
test[i]
test[a : b]
test[a :]

Other keywords/Syntax

yieldiscomprehensions
--

(4)Develop standard.

Readability first, nearly never use macro function and global argument.

Complete unit testes based on google test.

4.Both talk and show the code:

5.Demo

The scripts in demos are in theexamples folder.

Demo 01 GPIO

View Code
importPikaStdLibimportSTM32G0mem=PikaStdLib.MemChecker()io1=STM32G0.GPIO()time=STM32G0.Time()io1.setPin('PA8')io1.setMode('out')io1.enable()io1.low()print('hello pikapython')print('mem.max :')mem.max()print('mem.now :')mem.now()whileTrue:io1.low()time.sleep_ms(500)io1.high()time.sleep_ms(500)

Hnet-image (2)

Demo 02 USART

View Code
importPikaStdLibimportSTM32G0time=STM32G0.Time()uart=STM32G0.UART()uart.setId(1)uart.setBaudRate(115200)uart.enable()whileTrue:time.sleep_ms(500)readBuff=uart.read(2)print('read 2 char:')print(readBuff)

Hnet-image (3)

Demo 03 ADC

View Code
importPikaStdLibimportSTM32G0time=STM32G0.Time()adc1=STM32G0.ADC()adc1.setPin('PA1')adc1.enable()whileTrue:val=adc1.read()print('adc1 value:')print(val)time.sleep_ms(500)

mmexport1631351523907

Demo 04 PWM output

View Code
importPikaStdLibimportSTM32G0time=STM32G0.Time()pwm=STM32G0.PWM()pwm.setPin('PA8')pwm.setFrequency(2000)pwm.setDuty(0.5)pwm.enable()whileTrue:time.sleep_ms(500)pwm.setDuty(0.5)time.sleep_ms(500)pwm.setDuty(0.001)

Demo 05 RGB

View Code
importSTM32G0importPikaPiZeroimportPikaStdLibrgb=PikaPiZero.RGB()mem=PikaStdLib.MemChecker()rgb.init()rgb.enable()print('hello 2')print('mem used max:')mem.max()whileTrue:print('flowing')rgb.flow()

Demo 06 Snake(Need LCD)

View Code
fromPikaObjimport*importPikaStdLibimportPikaPiZeroimportSTM32G0# hardware initlcd=PikaPiZero.LCD()lcd.init()lcd.clear('white')key=PikaPiZero.KEY()key.init()time=STM32G0.Time()x_max=120y_max=150# snake inits=PikaPiZero.Point()w=9h=9s.x=50s.y=10len=0whilelen<3:b=si=0whilei<len:b=b.nexti=i+1b.next=PikaPiZero.Point()b.next.x=b.x-10b.next.y=b.yb.next.prev=blen=len+1# ring linkb.next=ss.prev=bi=0b=swhilei<len:lcd.fill(b.x,b.y,w,h,'blue')b=b.nexti=i+1print('snake lengh')print(len)# fruit initf=PikaPiZero.Point()f.x=30f.y=20lcd.fill(f.x,f.y,w,h,'green')# memory checkmem=PikaStdLib.MemChecker()print('mem used max:')mem.max()# main loopd=0isUpdate=1isEat=0whileTrue:ifisUpdate:# isUpdate = 0# check eat fruitiff.x==s.xandf.y==s.y:# have eat fruitisEat=1f.x=f.x+30iff.x>x_max:f.x=f.x-x_maxf.y=f.y+30iff.y>y_max:f.y=f.y-y_maxlcd.fill(f.x,f.y,w,h,'green')# move snake by the directionifd==0:x_new=s.x+10y_new=s.yifx_new>x_max:x_new=0elifd==1:x_new=s.xy_new=s.y-10ify_new<0:y_new=y_maxelifd==2:x_new=s.xy_new=s.y+10ify_new>y_max:y_new=0elifd==3:x_new=s.x-10y_new=s.yifx_new<0:x_new=x_maxifisEat:isEat=0b_new=PikaPiZero.Point()b_new.x=x_newb_new.y=y_newb_new.prev=s.prevb_new.next=ss.prev.next=b_news.prev=b_news=b_newlen=len+1print('snake lengh')print(len)print('mem used max:')mem.max()# drow the snake and fruit# clear last bodylcd.fill(s.prev.x,s.prev.y,w,h,'white')# new bodys.prev.x=x_news.prev.y=y_new# head is last bodys=s.prevlcd.fill(s.x,s.y,w,h,'blue')b=si=0# scan keykey_val=key.get()ifkey_val==0:d=0isUpdate=1elifkey_val==1:d=1isUpdate=1elifkey_val==2:d=2isUpdate=1elifkey_val==3:d=3isUpdate=1

image

The maximum RAM usage of these demos is only 3.56K, which is 4.56K if the 1K stack is included, and the maximum Flash usage is 30.4K. Refer to the 20K RAM and 64K Flash of STM32F103C8T6, less than 25% RAM and less than 50% Flash are used.

About the custom extern module ?

In addition to device drivers, developing custom Python modules for MCU is very easy. The following two demos are extensions of the custom module, which developed python interfaces for the ARM-2D image driver library.

Boxes~

Hnet-image (7)

Rotating suns~

Hnet-image (6)

6.Test and develop Core

Test core in docker (recommend)

get start with docker

✨ Contributors

ContributerAchivements
甜航26
千帆(微信名)26
Meco Jianting Man122623151541
liuduanfei26
sjy2613
沧御26
versaloon2613
刘延(微信名)3641
GorgonMeducer2522213341
unsigned2623
梦程MI362341
Maximilian Gerhardt12
purewind724313341
onceday2413

Contribute Log On 2023

Contribute logContributer
support PIKA_UNBUFFERD_ENABLE config itemSeny Lee
addthis moduleblueloveTH
Fix memory leak in event queuerandyscott
Fix a bug of _OP_POWblueloveTH
fix bsp/esp32/README.mderzongxie
Fixed a bug where help("modules") crashed when no lib was loaded梦程MI
support GPIO driver for rt-threadsupperthomas
Fixed a typoJ. Neuschäfer
codecov CI supportRenzhihan
rt-thread build script fix and improvesupperthomas
support pikafs pack and unpack to pathsjy
fix pika_platform_get_tick() in linux port梦程MI
CH307开发板、BL618开发板VeriMake
VM instruction extension frameworkGorgonMeducer
iotcloud module梦程MI
implement shell filterGorgonMeducer
修复socket模块在lwip中fcntl的参数数量错误梦程MI
support GPIO pika_hal for BLMCUcodercmd
Fix Typo on PikaVM.cIkko Eltociear Ashimine
Fix type assert on dataArgs.citschina
add examples/Device/KEY_POLL.PYcodercmd
hmac hashlib base64 aes modules梦程MI
fix pikaCompiler build error on macos梦程MI
Contribute Log On 2022
Contribute logContributer
request moduleonceday
mqtt moduleFlintJ
Donate:500¥hardsofttech
Donate:500¥edmund_wz
Donate:500¥Meco Jianting Man
Donate:500¥hardsofttech
PikaNN moduleRenzhihan
re moduleeglwang
PikaMath.Quaternion()purewind7
contrubute to PikaCVpurewind7
xr806(openharmony) bspsjy
ESP32 package沧御
MM32F5277E9P packageunsigned
mm32f5277e9p BSPunsigned
AddCMSIS-PACKGorgonMeducer
donate: air32f103 board * 20合宙xinxi204
contrubute to PikaMath.Math()onceday
add support for Unix Timeonceday
contrubute to PikaStdLib.String()purewind7
AddPLOOC support for pikapython CoreGorgonMeducer
Donate:500¥ (ctypes 相关)蒋太平
fix linux install scriptMaximilian Gerhardt
ch582 package梦程MI
ch582 BSP梦程MI
Donate:EC600X QuecPython Develop board移远通信 武加玉
Performance Point: 900->1400GorgonMeducer
stm32f051r8 BSPunsigned
stm32f407ze BSPunsigned
devc BSPunsigned
TC264D BSPunsigned
PikaVM improvementGorgonMeducer
W801Device package刘延(微信名)
W806 bsp刘延(微信名)
Donate:ESP32C3 5pic,linker启明云端 沧御
Donate:LS1C101 mcu 10pic, LS1c101 develop board,debuger龙芯俱乐部 石南
PikaVSF OS packageversaloon
ESP32C3 BSP沧御
Contribute Log On 2021
Contribute logContributer
Donate:ESP32 board、ink lcd*4name(微信名)
Donate:smartloong board龙芯俱乐部 石南
package/STM32F1sjy
package/STM32F103RBBootersjy
bsp/stm32f103rbsjy
QEMU ARM-2D simulation proejctliuduanfei
Donate:GD32E103TB2 2 pic信息牛(微信名)
Rt-thread bsp、port、moduleMeco Jianting Man
Donate:EC600S-CN 4G移远模块
Donate:BL706 board博流智能bouffalolab
Donate:CM32M101A 开发板孟巍(微信名)
Donate:APM32F030R8 board极海半导体 陈成
Donate:APM32E103VB board极海半导体 陈成
Donate:APEX-Link极海半导体 陈成
corde format,add gitattributesMeco Jianting Man
demo/simulation-keil千帆(微信名)
demo/stm32f103zet6/demo01-led-stm32f103zet6甜航
demo/stm32f103zet6/demo02-led-stm32f103zet6_tworoot甜航
demo/stm32f407zgt/demo01-led-stm32f407vgt甜航

Star History

Star History Chart

About

An ultra-lightweight Python interpreter that runs with only 4KB of RAM, zero dependencies. It is ready to use out of the box without any configuration required and easy to extend with C. Similar project: MicroPython, JerryScript.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C98.1%
  • Assembly1.0%
  • Python0.5%
  • C++0.2%
  • Shell0.1%
  • Makefile0.1%

[8]ページ先頭

©2009-2025 Movatter.jp