feat[i2c]: add bus configuration and max-hz control

[wdfk-prog]

为什么提交这份PR (why to submit this PR)

当前 I2C 框架层缺少统一的总线频率配置接口，I2C bus device 本身也没有用于保存运行配置的结构体。
这使得上层在需要限制 I2C 最大通信频率时，缺少通用控制入口，也不便于底层驱动记录和复用实际工作频率等配置信息。

为了给 I2C 总线提供统一的最大频率设置能力，并为后续驱动适配提供基础配置结构，提交此 PR。

你的解决方案是什么 (what is your solution)

本 PR 在 I2C 核心层做了以下改动：

1. 新增控制命令 RT_I2C_CTRL_SET_MAX_HZ，用于设置 I2C 总线最大通信频率；
2. 在 rt_i2c_control() 中增加对 RT_I2C_CTRL_SET_MAX_HZ 的处理逻辑：
   • 当传入频率值大于 0 时，保存到 bus->config.max_hz；
   • 当传入值无效时，返回错误码；
3. 保留原有 i2c_bus_control 回调分发逻辑，确保其他控制命令行为不变；
4. 在 dev_i2c.h 中新增 struct rt_i2c_configuration：
   • mode：I2C 工作模式；
   • max_hz：最大限制波特率；
   • usage_freq：实际使用波特率；
5. 在 struct rt_i2c_bus_device 中新增 config 成员，用于保存 I2C 总线配置；
6. 同步更新文件头注释和修改记录。

通过这些调整，I2C 核心层具备了统一保存和设置总线频率参数的能力，也为后续底层驱动根据 max_hz 配置实际时钟提供了基础支持。

请提供验证的bsp和config (provide the config and bsp)

• BSP:

  • 请填写已验证的 BSP 路径，例如 bsp/stm32/stm32l496-st-nucleo

• .config:

  • CONFIG_RT_USING_I2C
  • 与目标 I2C 控制器或板级驱动相关的配置项

• action:

  • 请填写你自己仓库 PR 分支触发的 CI / Action 链接

[github-actions]

👋 感谢您对 RT-Thread 的贡献！Thank you for your contribution to RT-Thread!

为确保代码符合 RT-Thread 的编码规范，请在你的仓库中执行以下步骤运行代码格式化工作流（如果格式化CI运行失败）。
To ensure your code complies with RT-Thread's coding style, please run the code formatting workflow by following the steps below (If the formatting of CI fails to run).

---

🛠 操作步骤 | Steps

1. 前往 Actions 页面 | Go to the Actions page
   点击进入工作流 → | Click to open workflow →

2. 点击 Run workflow | Click Run workflow

• 设置需排除的文件/目录（目录请以"/"结尾）
  Set files/directories to exclude (directories should end with "/")
• 将目标分支设置为 \ Set the target branch to：pr/01-i2c-bus-config-max-hz
• 设置PR number为 \ Set the PR number to：11241

3. 等待工作流完成 | Wait for the workflow to complete
   格式化后的代码将自动推送至你的分支。
   The formatted code will be automatically pushed to your branch.

完成后，提交将自动更新至 pr/01-i2c-bus-config-max-hz 分支，关联的 Pull Request 也会同步更新。
Once completed, commits will be pushed to the pr/01-i2c-bus-config-max-hz branch automatically, and the related Pull Request will be updated.

如有问题欢迎联系我们，再次感谢您的贡献！💐
If you have any questions, feel free to reach out. Thanks again for your contribution!

[github-actions]

📌 Code Review Assignment

🏷️ Tag: components

Reviewers: Maihuanyi

Changed Files (Click to expand)

• components/drivers/i2c/dev_i2c_core.c
• components/drivers/include/drivers/dev_i2c.h

🏷️ Tag: components_driver_i2c

Reviewers: wdfk-prog

Changed Files (Click to expand)

• components/drivers/i2c/dev_i2c_core.c

---

📊 Current Review Status (Last Updated: 2026-03-09 08:49 CST)

• ⌛ Maihuanyi Pending Review
• ⌛ wdfk-prog Pending Review

---

📝 Review Instructions

1. 维护者可以通过单击此处来刷新审查状态: 🔄 刷新状态
   Maintainers can refresh the review status by clicking here: 🔄 Refresh Status

2. 确认审核通过后评论 LGTM/lgtm
   Comment LGTM/lgtm after confirming approval

3. PR合并前需至少一位维护者确认
   PR must be confirmed by at least one maintainer before merging

ℹ️ 刷新CI状态操作需要具备仓库写入权限。
ℹ️ Refresh CI status operation requires repository Write permission.

[wdfk-prog]

• [components][I2C] 添加I2C配置结构体 #9087