1. 时间操作简介在应用开发中特别是设计日记记录功能中经常涉及时间戳的操作时间戳可直观的体现程序的运行时间运行效率。1.1 查看系统时间(钟)查看系统时间命令如下所示。1.2 设置系统时间(钟)设置系统时间有两种方法可【手动设置时间】以及【NTP设置时间】。【手动设置时间】通过date命令可以设置系统时间设置格式为“yyyy-MM-dd HH:mm:ss”。* 如有RTC时设置系统时间之后还需要输入“hwclock -w”来写入硬件RTC时间。* 修改时间一般需要管理员权限若非管理员用户需加上“sudo”【NTP设置时间】NTP就是网络时间同步协议。通过在互联网上的校时服务器对板卡按照一定规律不同的ntp-client策略会不一样进行自动校时。1.3 RTC时钟设置本文着重介绍系统时间RTC部分(如有)请参考阅读《外设接口使用说明/RTC》。1.4 时区与校时服务时区【系统时钟】和【RTC时钟】用的都是UTC时间不同地区所使用的时间还需要考虑上时区的影响。校时服务【系统时钟】除了可以被手动操作外校时服务也会影响系统时钟。关于【时区设置】和【校时服务】EASY-EAI-Nano-TB可以参考《应用笔记/自动校时与时区设置》一文进行操作。更详细的交互作用机制可参考《系统时间管理介绍》。1.5 系统运行时长查看系统从上电到命令执行的运行信息。uptime打印的信息分别如下当前服务器时间当前服务器运行时长当前用户数当前的负载均衡load average2. 快速上手2.1 开发环境准备如果您初次阅读此文档请阅读《入门指南/开发环境准备/Easy-Eai编译环境准备与更新》并按照其相关的操作进行编译环境的部署。在PC端Ubuntu系统中执行run脚本进入EASY-EAI编译环境具体如下所示。cd ~/develop_environment ./run.sh 22042.2 源码下载以及例程编译在EASY-EAI编译环境下创建存放源码仓库的管理目录cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit通过git工具在管理目录内克隆远程仓库git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-1126B.git注* 此处可能会因网络原因造成卡顿请耐心等待。* 如果实在要在gitHub网页上下载也要把整个仓库下载下来不能单独下载本实例对应的目录。进入到对应的例程目录执行编译操作具体命令如下所示cd EASY-EAI-Toolkit-1126B/Demos/common-system_opt/ ./build.sh注* 由于依赖库部署在板卡上因此交叉编译过程中必须保持/mnt挂载。2.3 例程运行通过串口调试或ssh调试进入板卡后台定位到例程部署的位置如下所示cd /userdata/Demo/common-system_opt运行例程命令如下所示./test-timepara-opt2.4 运行效果执行效果如下所示。API的详细说明以及API的调用本例程源码详细信息见下方说明。3. 时间操作API说明3.1 引用方式EASY EAI api库位于本仓库的easyeai-api目录中。为方便客户在本地工程中直接调用我们的EASY EAI api库此处列出工程中需要链接的库以及头文件等方便用户直接添加。API源代码路径为EASY-EAI-Toolkit-1126B/easyeai-api/common/system_opt/。用户可通过源代码了解接口实现甚至可对源码进行修改。3.2 获取时间戳调试使用获取时间戳函数用于获取秒、毫秒、微秒函数原型如下所示。uint64_t get_timeval_us(); uint64_t get_timeval_ms(); uint64_t get_timeval_s();具体介绍如下所示。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);具体介绍如下所示。3.4 系统延时(基于usleep)对线/进程进行秒、毫秒、微秒级别的延时函数原型如下所示。uint32_t msleep(uint32_t ms);具体介绍如下所示。3.5 获取时间获取当前系统时间其值表示从CUTCoordinated Universal Time时间1970年1月1日00:00:00到当前时刻的秒数。函数原型如下所示。int get_time_stamp();具体描述如下所示。3.6 获取系统日期系统时间获取系统日期系统时间函数原型如下。void get_system_date_time(uint32_t *curDate, uint32_t *curTime);具体描述如下所示。3.7 设置系统日期系统时间设置系统日期系统时间的操作函数原型如下所示。void set_system_date_time(int year, int mon, int day, int hour, int min, int second);具体描述如下所示。4. API测试案例示例代码路径为EASY-EAI-Toolkit-1126B/Demos/common-system_opt/test-timepara-opt.c。