pikapython/document/2.十分钟快速部署.md

89 lines
3.2 KiB
Markdown
Raw Normal View History

2021-08-26 21:25:22 +08:00
## 2.十分钟快速部署
2021-08-26 20:26:22 +08:00
在本篇文档中将会介绍为已有的keil工程部署PikaScript的方法。
PikaScript几乎没有全局变量和宏仅依赖标准库因此为已有的工程部署PikaScript是非常容易的。
下面是部署PikaScript的具体步骤。
### (1)下载PikaScript源码
进入PikaScript主仓库
https://github.com/mimilib/pikascript
2021-08-26 21:01:12 +08:00
打开发布页面
2021-08-26 20:26:22 +08:00
![image](https://user-images.githubusercontent.com/88232613/130962133-d7984e05-da83-4ac6-bec6-ff603ce058f1.png)
2021-08-26 21:01:12 +08:00
下载最新发布的PikaScript软件包
2021-08-26 20:26:22 +08:00
![image](https://user-images.githubusercontent.com/88232613/130962168-91045ccc-3c6d-434c-b147-30b298025822.png)
2021-08-26 21:01:12 +08:00
解压后得到一个pikascript文件夹直接将这个文件夹复制到keil工程里面
![image](https://user-images.githubusercontent.com/88232613/130965530-d2f0fe25-2a4b-4286-b3ed-c534ac182e35.png)
例如可以复制到keil工程的根目录
![image](https://user-images.githubusercontent.com/88232613/130965822-754a5495-00c8-4f1f-b7bb-d1755d56c6fe.png)
2021-08-26 21:07:07 +08:00
### (2)调整堆栈
打开工程的启动文件
2021-08-26 21:01:12 +08:00
![image](https://user-images.githubusercontent.com/88232613/130966276-24014a0a-90a6-4bd7-96b7-fde54806b8c3.png)
建议分配4K的栈空间和16K的堆空间最少也需要分配2K的栈空间和8K的堆空间
4K栈空间对应0x1000, 16K堆空间对应0x4000如下图所示
2021-08-25 16:05:04 +08:00
2021-08-26 21:01:12 +08:00
![image](https://user-images.githubusercontent.com/88232613/130967178-a985a4f5-730c-47fd-9317-68f33bc00066.png)
2021-08-26 21:07:07 +08:00
### (3)添加源码
2021-08-26 21:31:29 +08:00
在Project中新建三个group建议命名为pikascript-core,pikascript-api和pikascript-lib
2021-08-26 21:07:07 +08:00
![image](https://user-images.githubusercontent.com/88232613/130967351-597b8f6b-cc4e-4bc3-9cb6-2f335e5dccea.png)
然后将pikascript文件夹内的三个子文件夹下的.c文件全部添加到keil工程里
2021-08-26 21:32:26 +08:00
![image](https://user-images.githubusercontent.com/88232613/130971776-41d8c940-42d0-407d-872e-53525ce299a6.png)
2021-08-26 21:07:07 +08:00
2021-08-26 21:32:26 +08:00
再然后为pikascript-core和pikascript-api文件夹添加include路径
2021-08-26 21:07:07 +08:00
![image](https://user-images.githubusercontent.com/88232613/130967813-94016b8a-e408-4b49-b1e1-76a5df5fe984.png)
![image](https://user-images.githubusercontent.com/88232613/130967949-8399c65b-5584-4674-a947-e40103d953ea.png)
2021-08-26 21:12:58 +08:00
2021-08-26 21:17:25 +08:00
### (4)初始化PikaScript
在初始化代码中添加PikaScript通常是在main.c中
1) 添加 #include "pikascript.h"
![image](https://user-images.githubusercontent.com/88232613/130969048-4def9902-5f36-4798-9eac-ebbb1441087f.png)
2) 初始化pikaScript并得到pikascript主对象的指针pikaMain
![image](https://user-images.githubusercontent.com/88232613/130969274-ff2fdf6f-2389-466b-b51e-e7bc33472558.png)
### (5)编译源码
2021-08-26 21:12:58 +08:00
2021-08-26 21:21:40 +08:00
编译源码时需要勾选C99标准
2021-08-26 21:12:58 +08:00
![image](https://user-images.githubusercontent.com/88232613/130968626-7d8d4f46-eb0c-4ccd-9c34-eab160b290f5.png)
2021-08-26 21:21:40 +08:00
pikascript需要printf库函数因此需要勾选Use MiroLIB使得工程支持printf。
![image](https://user-images.githubusercontent.com/88232613/130969859-848b7149-93c6-4ea3-a955-2388b6d9392c.png)
2021-08-26 21:24:35 +08:00
然后直接编译即可一般来说是可以直接通过的使用compiler version 5 或者 compiler version 6均可。
### 结语
部署文档到此就结束了。继续学习PikaScript的标准开发流程请看
2021-08-26 21:24:51 +08:00
[3. PikaScipt标准开发流程](./3.PikaScript标准开发流程.md)