phytium-standalone-sdk/example/peripherals/pmbus

PMBus Example

1. 例程介绍

介绍例程的用途，使用场景，相关基本概念，描述用户可以使用例程完成哪些工作

本例程展示了PMBus的获取子卡基本信息、修改子卡输出电压等操作

以下例程的Slave设备其含有两个输出通道，分别是 rail1 与 rail2 ，寄存器在不同page下有不同含义，所连接的子卡是MPS子卡

芯片检测例程 (pmbus_mp_detect_example.c)

• 获取芯片的各类基础信息来确定是否检测到芯片并能与芯片正常通讯
• 获取两个通道上电初始电压

电压调节例程 (pmbus_mp_voltage_example.c)

• 获取与电压相关的信息（单位，输出格式等）
• 修改两个通道的输出电压

2. 如何使用例程

描述开发平台准备，使用例程配置，构建和下载镜像的过程

本例程需要以下硬件，

• PD2308 TSTA 测试板
• MPS PMBus子卡
• 4根额外的杜邦线
• 一个额外的电源
• 串口线和串口上位机

2.1 硬件配置方法

哪些硬件平台是支持的，需要哪些外设，例程与开发板哪些IO口相关等（建议附录开发板照片，展示哪些IO口被引出）

建议使用 I2C/PMBus 1 作为控制器

对于PD2308 TSTA 板，I2C/PMBus 1 对应 J47 引脚组，从标记有 J47 侧的第二个引脚开始依次为：SCL、SDA、ALERT；对于PMBus子卡注意要连接12V电源线。如下图：

2.2 SDK配置方法

依赖哪些驱动、库和第三方组件，如何完成配置（列出需要使能的关键配置项）

• Letter Shell组件，依赖 USE_LETTER_SHELL

• GIC组件，CONFIG_ENABLE_GICV3

• I2C组件，CONFIG_USE_FI2C

• 本例子已经提供好具体的编译指令，以下进行介绍：

  1. make 将目录下的工程进行编译
  2. make clean 将目录下的工程进行清理
  3. make image 将目录下的工程进行编译，并将生成的elf 复制到目标地址
  4. make list_kconfig 当前工程支持哪些配置文件
  5. make load_kconfig LOAD_CONFIG_NAME= 将预设配置加载至工程中
  6. make menuconfig 配置目录下的参数变量
  7. make backup_kconfig 将目录下的sdkconfig 备份到./configs下

• 具体使用方法为：

  • 在当前目录下
  • 执行以上指令

2.3 构建和下载

描述构建、烧录下载镜像的过程，列出相关的命令

参考 SDK 使用说明

2.4 输出与实验现象

描述输入输出情况，列出存在哪些输出，对应的输出是什么（建议附录相关现象图片）

2.4.1 芯片检测例程

$ pmbus mp_detect_example

2.4.2 电压调节例程

$ pmbus mp_voltage_example

3. 如何解决问题

主要记录使用例程中可能会遇到的问题，给出相应的解决方案

4. 修改历史记录

记录例程的重大修改记录，标明修改发生的版本号