コンテンツにスキップ

config platform firmware サブコマンド

概要

config platform firmware は platform firmware 操作を fwutil に委譲する CLI グループ。install と update は未知オプションを Click で解釈せず、そのまま fwutil へ渡す1。

コマンド一覧

コマンド 用途
config platform firmware install [fwutil args...] platform firmware install を実行
config platform firmware update [fwutil args...] platform firmware update を実行
show platform firmware [fwutil args...] firmware 情報を表示

各コマンドの詳細

config platform firmware install

用法:

config platform firmware install [fwutil args...]

実装は ["fwutil", "install"] + args を subprocess.check_call() で実行する。fwutil が非 0 で終了した場合、その return code で CLI も終了する。

config platform firmware update

用法:

config platform firmware update [fwutil args...]

install と同じ構造で、実行コマンドだけが fwutil update になる。

show platform firmware

用法:

show platform firmware [fwutil args...]

表示側は sudo fwutil show に委譲する2。サポートされる component 名・firmware target・追加オプションは platform plugin と fwutil 実装に依存する。

注意

  • この CLI は CONFIG_DB を直接編集しない。
  • add_help_option=False のため、config platform firmware install --help のような引数も原則 fwutil に渡される。

関連リファレンス

  • (関連リンクなし)

引用元

データフロー (手動作成)

flowchart LR
  CLI["config platform firmware"]
  FW["fwutil install / update"]
  PA["platform_api<br/>(Component.install_firmware)"]
  HW["フラッシュデバイス / BIOS / BMC"]
  CLI --> FW
  FW --> PA
  PA --> HW

凡例

platform 系 (CLI → fwutil → platform_api → HW) のミニ図。CONFIG_DB を直接介さないコマンドのため手動で記述。

関連 Topics

運用ヒント

典型的な利用シーン

  • BIOS / CPLD / FPGA / SSD の firmware install と確認。
  • fwutil でのスケジュール更新 (next / boot)。

よくある落とし穴

  • install 後の reboot 種別 (cold / warm / fast / power) を間違えると flash しない。
  • firmware 競合状態で install を中断すると BIOS が brick することがある。電源断厳禁。

関連する show / debug

show platform firmware status
show platform firmware version
fwutil show status

関連 CLI コマンド

  1. config platform firmware の install / update 定義。https://github.com/sonic-net/sonic-utilities/blob/39732bceb8bdefe706518ab40623bbbba6ff33b9/config/main.py#L8734 ↩

  2. show platform firmware は sudo fwutil show を実行する。https://github.com/sonic-net/sonic-utilities/blob/39732bceb8bdefe706518ab40623bbbba6ff33b9/show/platform.py#L290 ↩