K3CONF(1)

💖 NAME 💖

okay so welcome to the manual page for k3conf, bestie — it lives in section 1 of the General Commands Manual, and its whole government name is k3conf - TI K3 Configuration Diagnostic Tool. that's it, that's the name, slay. ✨

---

🎀 SYNOPSIS 🎀

k3conf - [--host <id>] [--version] [--help] [--cpuinfo] <command> [<args>]

---

🦋 DESCRIPTION 🦋

so like, k3conf is a standalone application, and its whole vibe is being a quick'n easy way to diagnose / debug / audit the configuration of TI K3 based architecture processors at runtime. and the iconic part? it has no particular kernel dependency. periodt.

it's designed to be as platform-agnostic as possible — like, it can run on any Linux platform, and it's easy to port to literally any other OS. and even though k3conf today focuses on TISCI related functionality, it's intended for any other area too. main character energy that keeps its options open 💅

---

👑 OPTIONS 👑

• --host<id> — use this host id for communicating with sysfw 🫶
• --help — print k3conf help
• --version — print k3conf version
• --cpuinfo — print the host processor information

---

🌈 COMMANDS 🌈

here's the whole menu, no cap. every single one:

• k3conf show hosts — prints all the available TISCI hosts
• k3conf show threads — prints all available TISCI threads
• k3conf show device — prints all available TISCI devices
• k3conf show device <dev_id> — prints the corresponding device id information
• k3conf show clock — prints all the available TISCI clocks
• k3conf show clock <dev_id> — prints the clock for corresponding device id
• k3conf show processor — prints all the available TISCI processors
• k3conf show rm — prints the resources managed by system firmware
• k3conf show rm <dev_id> — prints resources managed by System firmware for corresponding device
• k3conf dump device — prints device status of all TISCI devices
• k3conf dump device <dev_id> — prints device status of corresponding TISCI device
• k3conf dump clock — prints clock status of all TISCI devices
• k3conf dump clock <dev_id> — prints clock status of corresponding TISCI device.
• k3conf dump parent_clock <dev_id> <clk_id> — prints the clock parent of corresponding clock
• k3conf dump processors — prints status of all available processors
• k3conf dump processor <dev_id> — prints status of corresponding processor
• k3conf dump rm [OPTIONS] — prints resource allocation for all utypes / hosts
• k3conf dump rm [OPTIONS] <type> — prints resource allocation for corresponding utype
• k3conf dump rm [OPTIONS] <type> <subtype> — prints resource allocation for corresponding type and subtype

and the OPTIONS for dump rm are:

• -h <host_id> — filter only corresponding host_id 🔍

• k3conf enable device <dev_id> — enables TISCI device and prints the status
• k3conf enable clock <dev_id> <clk_id> — enables TISCI clock and prints the status
• k3conf disable device <dev_id> — disables TISCI device and prints the status
• k3conf disable clock device <dev_id> <clk_id> — disables TISCI clock and prints the status
• k3conf set clock <dev_id> <clk_id> <freq> — sets TISCI clock's frequency and prints the status
• k3conf set parent_clock <dev_id> <clk_id> <freq> — sets the parent clock for a clock mux and prints the mux status

⚠️ bestie, refer to the following documentation for preconditions before you go touching this one: http://downloads.ti.com/tisci/esd/latest/2_tisci_msgs/pm/clocks.html#power-management-clock-frequency-configure http://downloads.ti.com/tisci/esd/latest/2_tisci_msgs/pm/clocks.html#tisci-msg-set-clock-parent

• k3conf read <addr> [<size>] — no. of bits to be read is given in the size argument. expected input size is 8,16,32,64. prints the value at the specified io memory 🧚
• k3conf write <addr> <val> [<size>] — no. of bits to be written is given in the size argument. expected input size is 8,16,32,64. writes the value at the specified io memory

---

and that's the whole page, fr fr. this was K3CONF(1) from the General Commands Manual — that's the section 1, general commands girlies. thanks for reading, ily, go diagnose something gorgeous 💜🫶