全部文档
OneOS简介 硬件支持 快速开发指南 编译构造工具 API参考文档 高级语言 用户编程手册 应用笔记 FAQ

class machine.RTC

machine.RTC类是machine模块下的一个硬件类,用于指定R设备的配置和控制,提供对RTC设备的操作方法

构造函数

构造函数 class machine.RTC()
功能 构造一个RTC对象
参数说明 无参数
返回值 返回创建的machine.RTC类对象

实例方法

machine.RTC类包括如下实例方法

方法名 说明
RTC.init() 根据传入的参数初始化RTC设备起始时间
RTC.deinit() 重置RTC设备时间,重新运行RTC设备
RTC.now() 获取当前时间
RTC.alarm() 设置RTC闹钟
RTC.alarm_left() 获取剩余的RTC闹钟时长
RTC.cancel () 取消RTC闹钟

详细说明如下:

方法名称 RTC.init(datetime)
功能 根据传入的参数初始化RTC设备起始时间
参数说明 datetime:为一个时间元组,格式如下:(year, month, day, wday, hour, minute, second, yday) 参数介绍如下所示:
year:年份
month:月份,范围 [1, 12]
day:日期,范围 [1, 31]
wday:星期,范围 [0, 6],0 表示星期一,以此类推
hour:小时,范围 [0, 23]
minute:分钟,范围[0, 59]
second:秒,范围[0, 59]
yday:从当前年份 1 月 1 日开始的天数,范围 [0, 365]
返回值 固定返回None
异常值描述 当传入错误初始化参数时,会触发ValueError,携带异常值1
方法名称 RTC.deinit()
功能 重置RTC设备时间,重新运行RTC设备
参数说明 无参数
返回值 固定返回None

注: RTC对象deinit之后需要重新init设置起始时间才能使用

方法名称 RTC.now()
功能 获取当前时间
参数说明 无参数
返回值 返回值为RTC.init中datetime 时间元组格式 (year, month, day, wday, hour, minute, second, yday)
方法名称 RTC.alarm(time, *, repeat=False)
功能 设置RTC闹钟
参数说明 timer:设置闹钟的时间,单位为ms repeat:设定闹钟是否重复
返回值 固定返回None
方法名称 RTC.alarm_left()
功能 获取剩余的RTC闹钟时长
参数说明 无参数
返回值 返回剩余的闹钟时长,单位为ms
方法名称 RTC.cancel ()
功能 取消RTC闹钟
参数说明 无参数
返回值 固定返回None

results matching ""

    No results matching ""