FreeIOE开发文档
  • Introduction
  • 基础介绍
    • FreeIOE是什么
    • 名词解释
  • 开发引导
    • 开发入门
    • 环境搭建
      • 使用网关产品
      • 使用虚拟网关
      • 使用VSCode插件开发
      • 其他应用开发方式
    • 应用开发
      • 应用是什么
      • 快速构建应用
        • 数据采集
        • 数据上云
        • 边缘计算
        • 设备通讯
      • 深入理解应用
        • 应用本质
        • 从零构造
        • 应用配置可视化
      • 注意事项
      • 应用示例
    • 发布应用
      • 申请账户
      • 新建应用
      • 克隆应用
      • 应用打包
      • 应用上传
  • 接口文档
    • 应用接口
      • 应用基础类模块
        • 应用基础类
        • MQTT应用基础类
      • 系统接口
      • 基础接口
      • 设备对象
      • 统计接口
      • 日志接口
      • 事件类型和等级
      • 云配置接口
      • 云配置帮助接口
      • 数据通讯模块
        • 端口模块
        • 帮助模块
        • 端口超时封装
      • 工具类模块
        • 数据订阅计算
        • 数据拼接
        • 数据流缓存
    • 系统服务接口
      • 配置服务
      • 软件分发服务
      • 扩展管理服务
      • 应用管理服务
      • 缓存服务
    • 其它资料 & 文档
      • Lua语言学习
      • 二进制数据操作
      • 文件操作
      • 模块列表
      • IOE模块
      • 串口操作模块
      • 累计量计算模块
      • 工具模块
        • helper模块
        • leds模块
        • gpios模块
        • sysinfo模块
        • 周期计时模块
Powered by GitBook
On this page
  • 系统接口
  • log
  • logger
  • dump_comm
  • fire_event
  • fork
  • timeout
  • cancelable_timeout
  • exit
  • abort
  • now
  • time
  • start_time
  • yield
  • sleep
  • data_api
  • self_co
  • wait
  • wakeup
  • app_dir
  • app_sn
  • get_conf
  • set_conf
  • conf_api
  • version
  • gen_sn
  • hw_id
  • id
  • req
  • post
  • cloud_post
  • cfg_call
  • set_event_threshold
  • cleanup

Was this helpful?

  1. 接口文档
  2. 应用接口

系统接口

系统接口

FreeIOE框架提供的系统类型接口。

log

记录应用日志。

function sys:log(level, ...)
end

level是字符串类型,可用值:trace, debug, info, notice, warning, error, fatal.

示例代码

sys:log("debug", "this is a log content")

logger

function sys:logger()
end

获取logger实例。 实例包含:trace, debug, info, notice, warning, error, fatal.

示例代码

local log = sys:logger()
log:debug("this is a log content")

dump_comm

记录应用报文。

function sys:dump_comm(sn, dir, ...)

fire_event

记录应用事件。

function sys:fire_event(sn, level, type, info, data, timestamp)
end

参数说明

  • sn

    应用创建的设备序列号。

  • level

    事件等级的整数

  • type

    事件类型(如果是字符串类型则是自定义类型)

  • info

    事件描述字符串

  • data

    时间附带数据

  • timestamp

    时间戳。

fork

创建独立携程,入口执行函数 func.

function sys:fork(func, ...)
end

示例代码

sys:fork(function(a)
    print(a)
end, 1)

其中a是传入的参数1

timeout

创建延迟执行携程

function sys:timeout(ms, func)
end

ms 为延迟时间(单位是毫秒), func 为携程入口函数。

cancelable_timeout

创建可以取消的延迟携程,

function sys:cancelable_timeout(ms, func)
end

返回对象是取消函数

示例代码

local timer_cancel = sys:cancelable_timeout(...)
timer_cancel()

exit

应用退出接口。请谨慎使用。

function sys:exit()
end

abort

系统退出接口,调用此接口会导致 FreeIOE 系统退出。 请谨慎调用。

function sys:abort()
end

now

返回操作系统启动后的时间计数。 单位是微妙,最小有效精度是10毫秒。

function sys:now()
end

time

获取系统时间,单位是秒,并包含两位小数的毫秒。

function sys:time()
end

start_time

系统启动的UTC时间,单位是秒。

function sys:start_time()
end

yield

交出当前应用对CPU的控制权。相当与 sys:sleep(0)。

function sys:yield()
end

sleep

挂起当前应用, ms是挂起时常,单位是毫秒

function sys:sleep(ms)
end

data_api

function sys:data_api()
end

self_co

获取当前运行的携程对象

function sys:self_co()

wait

挂起当前携程,结合 sys:wakeup 使用

function sys:wait()
end

wakeup

唤醒一个被 sys:sleep 或 sys:wait 挂起的携程。

function sys:wakeup(co)
end

app_dir

获取当前应用所在的目录。

function sys:app_dir()
end

app_sn

获取当前应用的序列号。

function sys:app_sn()
end

get_conf

获取应用配置,default_config 默认配置

function sys:get_conf(default_config)
end

set_conf

设定应用配置

function sys:set_conf(config)
end

conf_api

function sys:conf_api(conf_name, ext, dir)
end

version

获取应用版本号。返回应用 ID 和应用版本

function sys:version()
end

示例代码

local app_id, version = sys:version()
print(app_id, version)

gen_sn

生成独立的设备序列号,dev_name 为设备名称,必须指定。

function sys:gen_sn(dev_name)
end

hw_id

获取FreeIOE设备序列号

function sys:hw_id()
end

id

获取 FreeIOE 连接云平台所用的序列号(此ID可不同与设备序列号)

function sys:id()

req

发送同步请求,相应函数为app.response或者app.on_req_<msg>函数

function sys:req(msg, ...)
end

post

发送异步请求,相应函数为app.accept或者app.on_post_<msg>函数

function sys:post(msg, ...)
end

cloud_post

请求云平台连接配置接口

API_VER: 5

function sys:cloud_post(func, ...)
end

配置项(func)

  • enable_data_one_short

  • enable_event

  • download_cfg

  • upload_cfg

  • fire_data_snapshot

  • batch_script

cfg_call

请求FreeIOE系统配置服务接口:

API_VER: 5

function sys:cfg_call(func, ...)
end

配置项(func)

  • SAVE

set_event_threshold

设定应用发送事件的数量限制(每分钟),默认情况下应用每分钟最多只能发送20条事件。取值范围是0~127,超过限制的事件会被 FreeIOE 框架丢弃。

function sys:set_event_threshold(count_per_min)

cleanup

应用清理接口(会自动被调用,请勿使用)

function sys:cleanup()
end
PreviousMQTT应用基础类Next基础接口

Last updated 5 years ago

Was this helpful?

sn是应用创建的设备序列号/为空时代表设备无关报文。参考 中的函数。 dir是报文方向: IN, OUT。

获取数据接口,参考

获取云配置服务接口。 具体参考

api
conf_api
device
dump_comm