# 如何扩展脚本？

## 一、前言

> [!tip]
>
> 脚本扩展一般涉及到两部分内容的扩充，包含对于支持服务器类型的扩充，或者对支持读取的传感器类型的扩充。

不论如何修改脚本，请在完成后主要修改后，修改 `SCRIPT_VERSION` 用于和主线脚本进行版本区分。

例如：

- `SCRIPT_VERSION="1.6.5 for project"` 代表基于脚本1.6.5版本为某个项目做特殊定制

## 二、新增支持服务器

### 修改点1-Support_Server_List

``````sh
# 可以在这里添加对应的服务器型号
Support_Server_List="5280m7, 5468m7, 5688m7, donghu, yichun, qiandaohu"
``````

### 修改点2-添加服务器配置入口

``````sh
# 修改函数 set_configuration
set_configuration(){
  # ... 省略部分代码
  case ${server_type} in
  	"5280m7")
  		set_configuration_5280m7
  		;;
  	# [开始修改]在这里针对要添加的服务器添加如下语句，将 {server_name} 替换为对应的服务器型号
  	# 这里修改的意义在于添加一个设置服务器I2C拓扑的入口，后面会专门编写 set_configuration_{server_name} 函数
  	"{server_name}")
  		set_configuration_{server_name}
  		;;
  	# [结束修改]
  esac
  # ... 省略部分代码
}
``````

### 修改点3-添加I2C拓扑适配函数

``````sh
# 在脚本中找到函数 set_configuration_5280m7，在这个函数上面新建一个函数，名为
set_configuration_{server_name}(){
	# 可以模仿 5280m7 函数的写法，来编写本函数
	# 主体编写的内容就是，针对卡的类型和槽位来配置通道上正确的I2C属性
	# 需要考虑的内容如下：
	# 1.是否支持OCP网卡
	# 2.I2C链路上是否存在PCA9641
	# 3.每个物理slot和I2C Bus的对应关系
	# 4.每个物理slot和I2C PCA9546/9548 channel的对应关系
	# 5.PCA9641和PCA9546/9548的slave地址
	
	# 提供一种模板
	# 首先判断网卡类型是否为 pcie (ocp形态同理)
	if [ ${nic_type} = "pcie" ];then
		# 根据 SLOT number 做针对性配置
		if [ ${slot_number} -eq 0 ];then
			i2c_bus=12
			is_have_pca9641=1
			pca9641_slave=0x41
			pca9548_slave=0x70
			pca9548_channel="0x01"
		elif [ ${slot_number} -eq 1 ]; then
			i2c_bus=12
			is_have_pca9641=1
			pca9641_slave=0x41
			pca9548_slave=0x70
			pca9548_channel="0x02"
		elif [ ${slot_number} -eq 2 ]; then
			i2c_bus=12
			is_have_pca9641=1
			pca9641_slave=0x41
			pca9548_slave=0x70
			pca9548_channel="0x04"
		else
			 format_print $WARNING "Unspecified card slot!"
		fi
	fi
}
``````

### 修改点4-添加I2C扫描函数（可选）

``````sh
# 类似 修改点2, 在 start_detect_device 函数中添加入口函数
# 形如 detect_on_{server_name}

# 随后新建一个对应的函数
detect_on_{server_name}(){
	# 首先给定对应 slot 的 i2c bus号码
	i2c_bus=12
	
	# 根据链路上是否存在9641来编写，如果没有9641，跳过这里
	pca9641_slave="0x31"
    get_pca9641_control
    
    # 调用 do_i2c_detect 函数，来执行一次9548的通道切换并做一次i2cdetect
    # 参数表如下    i2cbus     9548_slave  9548_channel(hex) 9548_index  slot_number
    do_i2c_detect $i2c_bus    "0x70"        "0x01"              0			1
    do_i2c_detect $i2c_bus    "0x70"        "0x02"              1			2
    do_i2c_detect $i2c_bus    "0x70"        "0x04"              2			3
}
``````

### 修改点5-服务器auto选择配置（可选）

> [!note]
>
> script v1.8 新增特性：
>
> - server_type 配置为 auto 后可以自行搜索boardid进行匹配服务器类型（仅限通用服务器）

可以针对已知的boardid对 `try_get_server_type`函数中做针对性修改。