QuickMCU 帮助文档

本文已严重过时!!!

这里是 QuickMCU 的非正式文档。

波特率 115200。

内部 repl shell VT100(使用 PuTTY 连接就行。

函数内部会对参数类型进行自动转换,多数情况下可以良好的运行。

对应缺失的参数默认会使用 0 或 undefined 代替。

启动流程

  1. 自检
  2. 打印板子基本信息
  3. 执行内部 JavaScript 代码
  4. 挂载 spiffs 文件系统并打印用量信息
  5. 执行 /c/boot.js 文件中的 JavaScript 代码(如果存在
  6. 启动 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

1
{fp:pointer, filename:'str', mode:'str'}

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()

强制立刻将缓冲区的内容写入文件。

返回错误码

Licensed under CC BY-NC-SA 4.0
最后更新于 Jun 29, 2021 20:47 CST
FrostMiKu
Built with Hugo
主题 StackJimmy 设计