cbootimage(1)

💖 cbootimage — the tegra BCT compiler, bestie edition 💖

okay so real talk, this is cbootimage(1), and it lives in the NVIDIA Tegra Firmware Signing Tool manual. it's a little compiler that turns your cute little text files into bootable images. no cap, it's iconic. ✨

🌸 SYNOPSIS 🌸

cbootimage [ options ] configfile [ inputimage ] outputimage

🦋 DESCRIPTION 🦋

so what does this do?? it makes images that you can drop straight into the boot flash of a device running a Tegra SoC. that's the whole vibe. 💅

there are two primary modes of operation, and honestly, you need to know both:

1. Compile a textual representation of a BCT into a binary image.
2. Generate an entire boot image from a previously compiled BCT and a bootloader binary.

⭐ Platforms supported ⭐

like, it supports a LOT of platforms, she's versatile:

• Tegra20
• Tegra30
• Tegra114
• Tegra124
• Tegra132
• Tegra210

👑 COMMANDS 👑

• -gbct — Generate the new bct file from the given config file.
• -h, --help, -? — Print help text and exit. (the "i'm lost" button, we've all been there 🫶)

✨ OPTIONS ✨

okay here's the menu, pick your fighter:

• -d, --debug — Output debugging information. it's giving detective energy 🔍
• -oodm_data — Specify the odm_data value (in hex).
• -t, --tegra NN — Select target device. Must be one of: 20, 30, 114, 124, 132, 210.
• -s, --ssoc tegraNN — Select target device. Must be one of: tegra20, tegra30, tegra114, tegra124, tegra32, tegra210.
• -u --update — Copy input image data and update bct configs into new image file

🎀 EXAMPLES 🎀

To generate a bct file from a text description obtained either through bct_dump(1) or cbootimage-configs:

$ cbootimage -gbct -t124 PM375_Hynix_2GB_H5TC4G63AFR_RDA_924MHz.bct.cfg PM375_Hynix_2GB_H5TC4G63AFR_RDA_924MHz.bct
New BCT file PM375_Hynix_2GB_H5TC4G63AFR_RDA_924MHz.bct has been successfully generated!

To generate a boot image file including the newly generated bct:

cbootimage -t124 jetson-tk1-emmc.img.cfg jetson-tk1-emmc.img
Image file jetson-tk1-emmc.img has been successfully generated!

like, look at her go. she ate that. 🔥

💀 RETURN VALUE 💀

If any error occurs a non zero exit status is returned.

so basically: zero = we slayed, non-zero = something went wrong, go check your config bestie 😭

🌈 SEE ALSO 🌈

tegrarcm(1),bct_dump(1)

and that's the whole page, mwah 💜 this was cbootimage-1.8, dated 6 October 2015, from the NVIDIA Tegra Firmware Signing Tool manual. go forth and compile, queen 👑✨