基于RK3576的时间参数系统操作

1. 时间操作简介

在应用开发中，特别是设计日记记录功能中，经常涉及时间戳的操作，时间戳可直观的体现程序的运行时间，运行效率。EASY EAI orin-nano评估套件对时间的操作如下所示。

1.1 查看时间

查看系统时间命令如下所示。date命令查看的是时区时间(通过网络校时)，当前设置为CST，即北京时间。hwclock是查看硬件RTC时间(EASY EAI orin-nano默认没有RTC，此处读取错误)，通常以格林威治时间（GMT）为标准。

1.2 设置时间

设置系统时间有两种方法，可直接设置以及NTP设置。

通过date命令可以设置系统时间，设置格式为“yyyy-MM-dd HH:mm:ss”，设置系统时间之后，若有外接RTC模块，还需要输入“hwclock -w”来写入硬件RTC时间。

sudo date -s "2025-01-20 14:47:02"
sudo hwclock -w

NTP全称为网络时间同步协议，可以通过网络上的时间服务器来同步本地ARM板的系统时间。EASY EAI orin-nano采用ntpd服务来进行网络校时，若要采用手动校时，则需先停掉该校时服务。

1.3 系统时区设置

在新建日志文件时，可能由于ARM板本身的时区与当地不一致，导致日志的时间与PC的时间不一致。EASY EAI orin-nano的时区相关目录与文件如下所示。

路径	描述
/usr/share/zoneinfo/*	zoneinfo时区模块文件，保存各个地区的时区文件
/etc/localtime	本地机器的时区文件，实际是zoneinfo时区模块文件中的其中一个
/etc/timezone	本地机器的时区文件，用于给应用层直接读取

设置系统时区命令如下所示。首先从zoneinfo目录中选择想要的时区文件，替换掉/etc/localtime文件，然后把/etc/timezone修改为目标地区，最后需要复位评估板，此时观察系统即可看到时区设置成功。

替换/etc/localtime后的时区

1.4 系统运行时长

查看系统从上电到命令执行的运行信息。

uptime打印的信息分别如下：

当前服务器时间；

当前服务器运行时长；

当前用户数；

当前的负载均衡，load average；

2. 快速上手

如果您初次阅读此文档，请阅读：《入门指南/源码管理及编程介绍/源码工程管理》，按需管理自己工程源码（注：此文档必看，并建议采用【远程挂载管理】方式，否则有代码丢失风险！！！）。

2.1 源码工程下载

先在PC虚拟机定位到nfs服务目录，再在目录中创建存放源码仓库的管理目录：

cd ~/nfsroot
mkdir GitHub
cd GitHub

再通过git工具，在管理目录内克隆远程仓库（需要设备能对外网进行访问）

git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-3576.git

注：

* 此处可能会因网络原因造成卡顿，请耐心等待。

* 如果实在要在gitHub网页上下载，也要把整个仓库下载下来，不能单独下载本实例对应的目录。

2.2 开发环境搭建

通过adb shell进入板卡开发环境，如下图所示。

通过以下命令，把nfs目录挂载上nfs服务器。

mount -t nfs -o nolock < nfs server ip >:< nfs path in server > /home/orin-nano/Desktop/nfs/

2.3 例程编译

然后定位到nfs的挂载目录，再在目录中创建存放源码仓库的管理目录：

cd /home/orin-nano/Desktop/nfs/GitHub

进入到对应的例程目录执行编译操作，具体命令如下所示：

cd EASY-EAI-Toolkit-3576/Demos/common-system_opt/
./build.sh

2.4 例程运行及效果

执行下方命令，运行示例程序：

./Release/test-timepara-opt

执行效果如下所示。

API的详细说明，以及API的调用（本例程源码），详细信息见下方说明。

3. 时间操作API说明

3.1 引用方式

EASY EAI api库位于本仓库的easyeai-api目录中。为方便客户在本地工程中直接调用我们的EASY EAI api库，此处列出工程中需要链接的库以及头文件等，方便用户直接添加。

描述	CMake写法	Makefile写法
api.cmake	${common_root}/system_opt/api.cmake	无
头文件目录	${SYSTEM_OPT_INCLUDE_DIRS}	-I ../../easyeai-api/common/system_opt
源文件目录	${SYSTEM_OPT_SOURCE_DIRS}	../../easyeai-api/common/system_opt
库文件目录	无	无
库链接参数	${SYSTEM_OPT_LIBS}	无

API源代码路径为EASY-EAI-Toolkit-3576/easyeai-api/common/system_opt/。用户可通过源代码了解接口实现，甚至可对源码进行修改。

3.2 获取时间戳（调试使用）

获取时间戳函数用于获取秒、毫秒、微秒，函数原型如下所示。

uint64_t get_timeval_us();
uint64_t get_timeval_ms();
uint64_t get_timeval_s();

具体介绍如下所示。

函数名：get_timeval_us()、get_timeval_ms()、get_timeval_s()
头文件	easyeai-api/common/system_opt/system_opt.h
输入参数	无
返回值	时间戳，分别为：微秒级、毫秒级、秒级
注意事项	无

3.3 系统延时(基于nanosleep)

nanosleep一旦被调用，线/进程就进入 TASK_INTERRUPTIBLE 状态，直到线/进程被唤醒，就回到 TASK_RUNNIN 状态。TASK_INTERRUPTIBLE 是可以被 [信号] 和 [wake_up()] 唤醒的，当信号到来时，进程会被设置为“可运行”。

对线/进程进行秒、毫秒、微秒级别的延时，函数原型如下所示。

uint32_t osTask_usDelay(uint32_t us);
uint32_t osTask_msDelay(uint32_t ms);
uint32_t osTask_sDelay(uint32_t s);

具体介绍如下所示。

函数名：osTask_usDelay()、osTask_msDelay()、osTask_sDelay()
头文件	easyeai-api/common/system_opt/system_opt.h
输入参数	延时时长，分别为：微秒级、毫秒级、秒级
返回值	线/进程被意外唤醒后，还剩余未执行的延时时长。
注意事项	无

3.4 系统延时(基于usleep)

对线/进程进行秒、毫秒、微秒级别的延时，函数原型如下所示。

uint32_t msleep(uint32_t ms);

具体介绍如下所示。

函数名：msleep()
头文件	easyeai-api/common/system_opt/system_opt.h
输入参数	延时时长，毫秒级
返回值	线/进程被意外唤醒后，还剩余未执行的延时时长。
注意事项	还可使用系统提供的usleep和sleep进行微秒级和秒级延时

3.5 获取时间

获取当前系统时间，其值表示从CUT（Coordinated Universal Time）时间1970年1月1日00:00:00到当前时刻的秒数。函数原型如下所示。

int get_time_stamp();

具体描述如下所示。

函数名：get_time_stamp()
头文件	easyeai-api/common/system_opt/system_opt.h
输入参数	无
返回值	时间戳，秒级
注意事项	无

3.6 获取系统日期，系统时间

获取系统日期，系统时间函数原型如下。

void get_system_date_time(uint32_t *curDate, uint32_t *curTime);

具体描述如下所示。

函数名：get_system_date_time()
头文件	easyeai-api/common/system_opt/system_opt.h
输入参数	curDate：年月日排列保存变量
	curTime：时分秒排列保存变量
返回值	无
注意事项	无

3.7 设置系统日期，系统时间

设置系统日期，系统时间的操作函数原型如下所示。

void set_system_date_time(int year, int mon, int day, int hour, int min, int second);

具体描述如下所示。

函数名：set_system_date_time()
头文件	easyeai-api/common/system_opt/system_opt.h
输入参数	year：年
	mon：月
	day：日
	hour：时
	min：分
	second：秒
返回值	无
注意事项	注意ntp校时会把此函数设置的时间覆盖掉

4. API测试案例

示例代码路径为EASY-EAI-Toolkit-3576/Demos/common-system_opt/test-timepara-opt.c。

审核编辑 黄宇