---
tags: 
aliases: 
date: 2025-11-24 
time: 15:05:35
description: 
---
This page note how to isntall custom built `.ko` file.

### 版號確認
用 `uname -a` 查看目前 kernel 版本。
用 `modinfo tcxxx_pcie_eth.ko` 檢查 vermagic 版本。
ko 版本與 kernel 版本必須一致。
```
1|KM1:/ # uname -r
5.15.78-qki-consolidate-android13-8-gf5cf1391b188
```

```
KM1:/ # modinfo /storage/emulated/0/Documents/tc956x_pcie_eth.ko
filename:       /storage/emulated/0/Documents/tc956x_pcie_eth.ko
license:        GPL v2
author:         Toshiba Electronic Devices & Storage Corporation
description:    TC956X PCI Express Ethernet Network Driver
srcversion:     5F197F74D301D4F6ADC6A72
depends:
name:           tc956x_pcie_eth
vermagic:       5.15.167-g94a5a0e4b3fa SMP preempt mod_unload modversions aarch64
```

### Unload old driver
#### Old driver is a module
用 `lsmod | grep tc956x` 確認原本的 module 已安裝。
用 `rmmod` 移除原本的 module：`sudo rmmod tc956x_pcie_eth`
用 `insmod` 來安裝新的 module：`insmod tc956x_pcie_eth.ko`

#### Old module is static link
`lsmod` 找不到東西，但 `find` 卻在 `/sys` 裡看到了一堆 `tc956x` 相關的檔案。這代表原本的驅動程式是**直接編譯進核心 (Static Linked)**，而不是獨立的 `.ko` 檔案。

##### 1. 確認原本的 Module 是否已正確安裝
```shell
ls -l /sys/bus/pci/drivers/tc956x_pci-eth/
```
如果在該目錄下看到類似 `0001:05:00.0` 這樣的 PCI ID 連結（Symlink），就代表**原本的內建驅動已經抓到裝置並正在控制它**。

##### 2. 解綁原本的內建驅動
```shell
# 解綁 Port 0
echo -n "0001:05:00.0" > /sys/bus/pci/drivers/tc956x_pci-eth/unbind

# 解綁 Port 1 (如果有)
echo -n "0001:05:00.1" > /sys/bus/pci/drivers/tc956x_pci-eth/unbind
```

##### 3. 載入新的 `.ko` 檔
```shell
insmod tc956x_pcie_eth.ko
```


### 可能的錯誤
#### Unbind driver 就 reboot
##### 試著先把 eth 關掉：
```
ip link set eth0 down
```

如果還是會當機，試著查看 log，先確認 log 目錄下有哪些檔案：
```shell
ls -l /sys/fs/pstore/
```

假設有發現檔案叫做 `pmsg-ramoops-0`，那可以：
```shell
cat /sys/fs/pstore/pmsg-ramoops-0
```

如果是亂碼，試著：
```shell
logcat -P /sys/fs/pstore/pmsg-ramoops-0
```

或是：
```shell
string /sys/fs/pstore/pmsg-ramoops-0
```

##### 使用 `driver_override` (繞過 Unbind 的崩潰)
1. 先載入新的 KO 檔
	1. `insmod /storage/emulated/0/Documents/tc956x_pcie_eth.ko`
2. **設定 Driver Override** 強制指定該 PCI 裝置未來只能使用新的驅動名稱。
	1. `echo "tc956x_pcie_eth" > /sys/bus/pci/devices/0001:05:00.0/driver_override`
3. **嘗試替換**
	- 不執行 `unbind` (因為會當機)，我們嘗試執行 `bind` 給新驅動。但在標準 Linux 中，如果裝置已被佔用，通常需要先 `unbind`。
	- 但在某些架構下，如果我們無法執行 `unbind`，唯一的路是修改 `boot.img` 的 cmdline，加上 `initcall_blacklist` 禁用舊驅動初始化。

#### Unknown symbol
如果 insmod 的訊息是：`tc956x_pcie_eth: Unknown symbol ...` 之類。
這代表您的驅動程式依賴某個核心功能（例如 PHY 介面或 PTP），但目前的核心沒有開啟該功能。

#### Version mismatch (版本不符)
核心會說 `disagrees about version of symbol` 或 `version magic '...' should be '...'`。
這代表您的 `.ko` 檔是給 Kernel A 編譯的，但您的機器跑的是 Kernel B。

#### Initialization failed
初始化失敗 - 這是最像 ENOENT 的原因。
如果驅動程式在載入時（`module_init`）嘗試讀取某個**設定檔**或**Firmware (韌體)**（例如 `/vendor/firmware/tc956x.bin`），而那個檔案不存在，驅動程式會回傳錯誤代碼 `-ENOENT`，導致 `insmod` 顯示「找不到檔案」。

### 題外化
#### [[modprobe 與 insmod 的差別]]

# 參考來源
- [Linux .ko 檔案置換教學](https://gemini.google.com/app/52b1336e11a24217?hl=zh-TW)