{"id":24091796,"url":"https://github.com/Prry/rtt-rx8900","last_synced_at":"2025-09-17T01:32:15.784Z","repository":{"id":113689124,"uuid":"254652062","full_name":"Prry/rtt-rx8900","owner":"Prry","description":"rx8900 driver for rt-thread","archived":false,"fork":false,"pushed_at":"2024-10-16T15:57:01.000Z","size":2562,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-18T15:59:50.183Z","etag":null,"topics":["i2c","rt-thread","rtc","rx8900"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Prry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-10T14:16:27.000Z","updated_at":"2024-10-16T15:57:05.000Z","dependencies_parsed_at":"2023-11-12T16:48:56.537Z","dependency_job_id":null,"html_url":"https://github.com/Prry/rtt-rx8900","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prry%2Frtt-rx8900","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prry%2Frtt-rx8900/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prry%2Frtt-rx8900/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prry%2Frtt-rx8900/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Prry","download_url":"https://codeload.github.com/Prry/rtt-rx8900/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233312724,"owners_count":18657094,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["i2c","rt-thread","rtc","rx8900"],"created_at":"2025-01-10T07:44:43.251Z","updated_at":"2025-09-17T01:32:10.364Z","avatar_url":"https://github.com/Prry.png","language":"C","funding_links":[],"categories":["Packages"],"sub_categories":["Peripherals"],"readme":"# 高精度RTC rx8900 驱动软件包\n\n\n\u003cbr\u003e\n\n\n## 1 介绍\n\nrx8900 软件包是针对RT-Thread驱动框架实现的实时时钟驱动，遵循RT-Thread RTC框架，可以从芯片内置RTC无缝切换使用外置高精度rx8900 RTC。rx8900是爱普生公司一款i2c接口的高精度RTC芯片，集成32768Hz晶振和温度传感器，并能根据环境温度调整频率，具有供电范围灵活、待机电流低、走时精度高等优点。\n\n\n\n### 1.1 支持功能\n\n* 实时时钟\n* 闹钟\n* 片内温度读取\n\n\n\n### 1.2 目录结构\n\n| 名称     | 说明       |\n| -------- | ---------- |\n| docs | 文档目录 |\n| inc |头文件目录 |\n| src | 源代码目录 |\n|LICENSE| 许可证文件 |\n|SConscript|RT-Thread默认构建脚本|\n\n\n\n### 1.3 许可证\n\nrx8900 软件包遵循 Apache license v2.0 许可，详见 `LICENSE` 文件。\n\n\n### 1.4 依赖\n- RT-Thread 3.0+\n- RT-Thread I2C设备驱动框架\n- RT-Thread RTC设备驱动框架\n\n\u003cbr\u003e\n\n## 2 获取 rx8900 软件包\n\n使用 rx8900 package 需要在 RT-Thread 的包管理器中选择它，具体路径如下：\n\n```\nRT-Thread online packages ---\u003e\n    peripheral libraries and drivers ---\u003e\n        [*] extren rtc drivers  ---\u003e\n            [*] ds3231：Extern RTC drivers fo rx8900 \n                 Version (latest)  ---\u003e\n```\n\n然后让 RT-Thread 的包管理器自动更新，或者使用 `pkgs --update` 命令更新包到 BSP 中。\n\n\u003cbr\u003e\n\n## 3 使用 rx8900 软件包\n\n### 3.1 初始化\n首先需初始化rx8900 驱动，可以手动在初始化线程合适的地方调用\u003ccode\u003ert_hw_rx8900 _init()\u003c/code\u003e初始化，也可以直接使用\u003ccode\u003eINIT_DEVICE_EXPORT\u003c/code\u003e通过RT-Thread的自动初始化机制来初始化注册。初始化成功后，会注册名称为“rtc”的驱动设备。\n\n```c\nINIT_DEVICE_EXPORT(rt_hw_rx8900_init);\t/* 通过RTT的自动初始化机制初始化rx8900 */\n```\n\n\u003e 注：\n\u003e\n\u003e 如果开启了芯片内部RTC，需先禁止内部RTC\n\n\n\n### 3.2 使用方式\n\n对于时间和闹钟的访问，使用RT-Thread标准RTC和闹钟接口访问。片内温度读取，则由软件包提供一个函数接口。\n\n\n\n* **获取当前时间**\n\n```\ntime_t time(time_t *t)\ntime_t now;      \nnow = time(RT_NULL);\n```\n\n* **设置时间**\n\n```\n #define RT_DEVICE_CTRL_RTC_SET_TIME     0x11        /**\u003c set time */\n rt_err_t rt_device_control(rt_device_t dev, int cmd, void *arg)；\n```\n\n* **获取闹钟时间**\n\n```\n #define RT_DEVICE_CTRL_RTC_GET_ALARM    0x12        /**\u003c get alarm */\n rt_err_t rt_device_control(rt_device_t dev, int cmd, void *arg)；\n```\n\n* **设置闹钟时间**\n\n```\n #define RT_DEVICE_CTRL_RTC_SET_ALARM    0x13      /**\u003c set alarm */\n rt_err_t rt_device_control(rt_device_t dev, int cmd, void *arg)；\n```\n\n\u003e 注：\n\u003e\n\u003e 详细用法可以参考“/components/drivers/rtc.c”和“/components/drivers/alarm.c”源码。\n\n\n\n* **提供一个获取片内温度接口**\n\n```\nfloat rx8900 _get_temperature(void)；\n```\n\n\n\n### 3.3 msh/finsh测试\n\n* msh获取时间\n\n```\nmsh \u003edate\nSat Jan  1 00:00:04 2000\n```\n\n* msh设置时间\n\n```\nmsh date 2020 04 10 17 41 10  \nmsh \u003edate\nFri Apr 10 17:41:15 2020\n```\n\n* finsh获取时间\n\n```\nfinsh \u003elist_date()\nFri Apr 10 17:41:49 2020\n```\n\n* finsh设置时间\n\n```\nfinsh \u003eset_date(2020,5,1)\n        0, 0x00000000\nfinsh \u003eset_time(12,0,0)  \n        0, 0x00000000\nfinsh \u003elist_date()\nFri May  1 12:00:04 2020\n```\n\n* msh打印温度\n\n```\nmsh \u003elist_rx89_temp\nrx8900 temperature: [27.5C] \n```\n\n* finsh打印温度\n\n```\nfinsh \u003elist_rx89_temp()\nrx8900 temperature: [27.5C]\n```\n\n\n\n\n\u003cbr\u003e\n\n## 4 注意事项\n\n使用RT-Thread的RTC框架，RTC设备注册名称为“rtc”，注意需先屏蔽内置芯片RTC驱动。\n\n\u003cbr\u003e\n\n## 5 联系方式\n\n- 维护：[Acuity](https://github.com/Prry)\n- 主页：\u003chttps://github.com/Prry/rtt-rx8900\u003e      \n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPrry%2Frtt-rx8900","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPrry%2Frtt-rx8900","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPrry%2Frtt-rx8900/lists"}