libs/rt-thread-official
libs
/
rt-thread-official
mirror of https://github.com/RT-Thread/rt-thread.git
4
0
Fork 0
Code Issues Releases Wiki Activity
rt-thread-official/components/external/lua
History
zhangjun c9591f825c 增加rt_strnlen,lua采用单独的线程 2016-08-12 22:19:52 +08:00
..
applications 增加rt_strnlen,lua采用单独的线程 2016-08-12 22:19:52 +08:00
exlibs move larduinolib.c into ART's repo, add lua external library example 2012-11-13 07:43:55 +00:00
lua add support of arm standard c library, support using armcc to compile lua 2012-11-22 03:39:22 +00:00
test add lua support for rt-thead 2012-11-10 07:32:39 +00:00
ChangeLog add lua support for rt-thead 2012-11-10 07:32:39 +00:00
README.md Update and rename README.TXT to README.md 2015-11-24 16:19:25 +08:00
SConscript Re-normalizing the repo 2013-01-08 22:40:58 +08:00

README.md

Lua on RT-Thread

简介

RT-Thread中的Lua修改自eLua的Lua-5.1.4版本。 采用gcc工具链时，Lua依赖于newlib库，采用keil时，Lua依赖于arm的标准c库。 启动lua的RAM占用情况 - 标准的lua 17.1904296875 KB - 优化的lua 5.01953125 KB 注：数据来自print(collectgarbage('count'))的输出 优化是指采用一个lua patch --- Lua Tiny RAM

使用

在RT-Thread的finsh中，调用lua()获得一个lua解释器。 在lua解释器中 - 可以调用lua标准库中的函数，如：print('hello, lua on rt-thread') - 可以执行脚本文件，如：dofile('/hello.lua') - 可以定义新的函数，如：function sinc(x) return math.sin(x)/x end - etc.

配置

1.通过在rtconfig.h中定义RT_USING_LUA加入lua组件
2.可以定义RT_LUA_OPTRAM减少RAM占用
3.可以定义RT_LUS_USE_EXLIBS而添加外部库，如arduino的常用函数封装为一个arduino库
3.更多的配置项可以在luaconf.h中找到

开发相关

- lua组件依赖于libc，需要在rtconfig.h中定义RT_USING_LIBC
- 开启编译器对C99的支持，如MDK中，在C/C++选项的Misc Controls输入框中添加--c99
- 使用gcc时，需要在链接脚本中定义_stext和_etext，.ordata*放在两者之间。用于判断数据是read-only和writable  
  使用keil时，需要在分散加载文件中把rodata放在ER_IROM1区
- 添加新的模块，参见exlibs/lexamplelib.c

目录说明

- lua：从eLua获得Lua-5.1.4版本代码
- exlibs：external libraries，外部库代码，如example库
- applications：Lua应用代码，如finsh中lua()
- test：测试代码