本文已严重过时!!!
这里是 QuickMCU 的非正式文档。
波特率 115200。
内部 repl shell VT100(使用 PuTTY 连接就行。
函数内部会对参数类型进行自动转换,多数情况下可以良好的运行。
对应缺失的参数默认会使用 0 或 undefined 代替。
启动流程
- 自检
- 打印板子基本信息
- 执行内部 JavaScript 代码
- 挂载 spiffs 文件系统并打印用量信息
- 执行
/c/boot.js
文件中的 JavaScript 代码(如果存在 - 启动 repl (read-eval-print loop)
Global
setTimeout(func,timeout,arg)
和写web时的用法一样。
setInterval(func,timeout,arg)
和写web时的用法一样。
print(str)
打印输出str,参数可以为任何类型(会被自动转换为字符串)
无返回值
所有module都是全局中的一个object。 如无特殊说明,module 在全局中的名称皆为: 下文中二级标题的全小写字母。
OS
提供系统接口
Function
sleepMs(ms)
使 JavaScript runtime 暂停指定时间,如无必要不建议使用。
ms: 整数,sleep的时间,毫秒单位
无返回值
getTickCountMs()
返回开机到现在所经历的时间,毫秒单位。
返回整数
getFreeMem()
返回剩余内存。
返回整数
File
提供对文件系统的访问。
QuickMCU 使用 spiffs 作为文件系统。
文件前缀为 /c/
板子在启动时会自动执行 /c/boot.js
文件内的 JavaScript 代码。
Function
open(filename,mode)
打开一个文件,用于对文件进行操作。
当文件对象失去所有引用后会自动调用 close 方法关闭文件。
filename: 字符串,文件完整路径名。
mode: 字符串,POSIX标准的文件操作模式 e.g. w r w+ a…
返回 File Object
remove(filename)
删除指定文件。
filename: 字符串,文件完整路径名
返回错误码,0 为删除成功
exists(filename)
检测指定文件是否存在。
filename: 字符串,文件完整路径名
返回布尔值
CONST
EOF | 值 |
---|---|
EOF | 文件结尾标识符 |
SEEK_SET | 文件开头位置 |
SEEK_CUR | 文件当前位置 |
SEEK_END | 文件结尾位置 |
File Object
|
|
close()
关闭文件对象。
返回错误码
read(size)
从文件读取,size参数可选,不填默认读取整个文件。
size: 整数,从当前位置向后读取 size 个字符
返回字符串
readLine()
从文件当前位置读取一整行,超过1024个字符将会截断。
返回字符串
readLines()
像 readLine() 但会读取整个文件,以字符串数组形式返回,每个元素都是一行文本。
返回数组
write(str)
将 str 写入文件中,object必须为可写的模式打开。
被写入的文本会优先存入内部 buf ,只有在调用 close 或 flush 时才会写入文件
str: 字符串,待写入文本
返回错误码
seek(offset,base)
设置当前文件位置为 base+offset, 省略所有参数seek()
可以快速的将当前文件位置设置为文件头部。
offset: 整数,相对位置
base: 常数,文件位置,参看 CONST
返回错误码
tell()
返回当前文件位置。
返回整数
flush()
强制立刻将缓冲区的内容写入文件。
返回错误码