Lua RTOS ESP32
1.0.0
LUA RTOS是一种实时操作系统，旨在在嵌入式系统上运行，对Flash和RAM内存的要求最少。目前，LUA RTOS可用于ESP32，ESP8266和PIC32MZ平台，并且可以移植到其他32位平台。
Lua RTO具有三层设计：
对于将LUA RTO移植到其他平台仅对于编写底层的代码是必要的，因为所有平台的顶部和中层都是相同的。
LUA RTOS兼容板可以通过两种方式与WhiteCat IDE编程：直接使用LUA编程语言，也可以使用将块转换为LUA的基于块的编程语言。无论您使用LUA还是块，两种形式的编程都是由相同的编程环境制成的。例如，程序员可以决定使用块制作快速原型，然后更改为LUA，最后返回块。
WhiteCat IDE可在以下网址提供：https：//ide.whitecatboard.org。
在我们的Wiki中，您有更多信息。
请注意，您可能需要为Windows和Mac OSX版本的董事会的USB到串行适配器下载并安装驱动程序。 GNU/Linux版本通常不需要任何驱动程序。通过串行端口连接连接到董事会需要该驱动程序。
| 木板 |
|---|
| Whitecat ESP32 N1 |
| ESP32核心 |
| ESP32事情 |
对于Linux，当前记录的用户应具有读写访问SUSB到串行设备的访问。在大多数Linux发行版中，这是通过将用户添加到以下命令的拨号组来完成的：
$ sudo usermod - a - G dialout $ USER 安装WhiteCat控制台。 WhiteCat控制台是一种命令行工具，允许程序员使用最后可用的固件刷新LUA RTOS兼容板。
为您的平台下载WhiteCat控制台二进制。
将WhiteCat控制台二进制复制到系统路径访问的文件夹。例如：
测试WhiteCat控制台二进制效果很好。
对于Ubuntu / Mac OS，打开一个终端并类型：
$ wcc
wcc - p port | - ports [ - ls path |
[ - down source destination ] | [ - up source destination ] |
[ - f | - ffs ] | [ - erase ] | - d ]
- ports : list all available serial ports on your computer
- p port : serial port device , for example / dev / tty . SLAB_USBtoUART
- ls path : list files present in path
- down src dst : transfer the source file ( board ) to destination file ( computer )
- up src dst : transfer the source file ( computer ) to destination file ( board )
- f : flash board with last firmware
- ffs : flash board with last filesystem
- erase : erase flash board
- d : show debug messages对于Windows，打开“命令”窗口并键入wcc.exe
查找板使用哪种串行设备。
用板插头打开终端。
$ wcc - ports
Available serial ports on your computer :
/ dev / cu . Bluetooth - Incoming - Port
/ dev / cu . Bluetooth - Modem现在插入板。
$ wcc - ports
Available serial ports on your computer :
/ dev / cu . Bluetooth - Incoming - Port
/ dev / cu . Bluetooth - Modem
/ dev / cu . SLAB_USBtoUART在上面的示例中，董事会使用/Dev/cu.slab_usbtouart串行设备。该设备将在以下步骤中用作参数值-P。
对于Windows，使用wcc.exe而不是wcc。
闪烁您的木板。
打开一个带有木板插头的终端。
$ wcc - p / dev / cu . SLAB_USBtoUART - f如果要刷新默认文件系统，请添加-FFS选项。
$ wcc - p / dev / cu . SLAB_USBtoUART - f - ffs如果您是第一次闪烁LUA RTOS固件，您将遇到错误：
Unknown board model .
Maybe your firmware is corrupted , or you haven ' t a valid Lua RTOS firmware installed.
Do you want to install a valid firmware now [ y / n ])?如果要安装有效的固件，请输入“ Y”：
Please , enter your board type :
1 : WHITECAT N1
2 : WHITECAT N1 WITH OTA
3 : ESP32 CORE BOARD
4 : ESP32 CORE BOARD WITH OTA
5 : ESP32 THING
6 : ESP32 THING WITH OTA
7 : GENERIC
8 : GENERIC WITH OTA
Type : 最后输入您的董事会类型，您的板将闪烁。
对于Windows，使用wcc.exe而不是wcc。
要升级使用安装LUA RTOS固件的板子：
$ wcc - p / dev / cu . SLAB_USBtoUART - f如果您需要使用安装在其上安装的LUA RTOS固件的板上的固件类型，例如，将OTA固件更改为非OTA固件：
$ wcc - p / dev / cu . SLAB_USBtoUART - erase
$ wcc - p / dev / cu . SLAB_USBtoUART - f 为您的桌面平台安装ESP32工具链。请遵循Espressif提供的说明：
克隆或从Espressif中汲取ESP-IDF存储库：
如果您是第一次构建LUA RTOS，请克隆ESP-IDF存储库：
git clone -- recursive https://github.com/espressif/esp-idf.git否则，从您的ESP-IDF文件夹中汲取最后的ESP-IDF更改：
git pull
git submodule update -- init --recursive克隆或拉动LUA RTOS存储库：
如果您是第一次构建Lua RTO，请克隆Lua RTOS存储库：
git clone -- recursive https://github.com/whitecatboard/Lua-RTOS-ESP32否则，从您的lua lua lua-rtos-esp32文件夹中拉出最后一个lua rtos：
git pull origin master安装程序仅与Python 2一起使用。
您可以通过运行检查您的Python版本
python --version
如果您的默认Python Verision为3.xx，则最方便的切换方法是安装Pyenv。然后安装最新的Python2，并激活Python2版本。在Lua-RTOS-ESP32目录中激活Python2可能是您最好的方法。
您可能需要使用
pip install pyparsing==2.4.7
这是与Python2一起使用的最新版本。
设置构建环境：
转到lua-rtos-esp32文件夹：
cd Lua - RTOS - ESP32编辑Env文件和更改路径，IDF_PATH，Library_path，PKG_Config_path，CPATH，适合您的安装位置。
现在做：
source . / env建造：
$ make flash如果您是第一次构建LUA RTOS，请选择您的板类型，然后按Enter：
Please , enter your board type :
1 : Whitecat N1 ESP32
2 : Whitecat N1 ESP32 with OTA
3 : Whitecat N1 ESP32 DEVKIT
4 : Whitecat N1 ESP32 DEVKIT with OTA
5 : Espressif Systems ESP32 - CoreBoard
6 : Espressif Systems ESP32 - CoreBoard with OTA
7 : SparkFun ESP32 Thing
8 : SparkFun ESP32 Thing with OTA
Board type :当Lua RTOS构建过程完成时，板将闪烁。由于某些操作系统或董事会，由于板上的USB到Serial适配器的设备名称不兼容，因此闪烁的过程可能会失败。在这种情况下，请更改默认配置以满足您的董事会或操作系统要求，如上所述。
更改默认配置：
您可以更改默认配置：
$ make menuconfig在“串行闪存器config /默认串行端口”类别下，检查板上的USB到串行适配器的设备名称。
为其他董事会建造：
如果您以前已经构建了Lua RTO，并且想为其他董事会类型构建：
$ make clean转到步骤5。
您可以使用您喜欢的终端模拟器程序（例如picocom，minicom，hirder -terminal，putty等）连接到LUA RTOS控制台。连接参数是：
例如，如果您使用picocom：
picocom -- baud 115200 /dev/tty.SLAB_USBtoUART / /
/ _____ /
/ _____________
W H I T E C A T
Lua RTOS beta 0.1 build 1479953238 Copyright ( C ) 2015 - 2017 whitecatboard . org
cpu ESP32 at 240 Mhz
spiffs0 start address at 0x180000 , size 512 Kb
spiffs0 mounted
spi2 at pins sdi = 012 / sdo = 013 / sck = 014 / cs = 015
sd0 is at spi2 , pin cs = 015
sd0 type II , size 1943552 kbytes , speed 15 Mhz
sd0a partition type 0 b, sector 227 , size 1943438 kbytes
fat init file system
fat0 mounted
redirecting console messages to file system ...
Lua RTOS beta 0.1 powered by Lua 5.3 .4
Executing / system . lua ...
Executing / autorun . lua ...
/ > Lua RTO对您来说是免费的，但是需要资金才能使其成为可能。随意捐赠尽可能少或尽可能多。每笔捐款都非常感谢。
