Forrest logo
back to the vcgencmd tool

vcgencmd:tldr:68941

vcgencmd: Print the throttled state of the system as a bit pattern.
$ vcgencmd get_throttled
try on your machine

The command "vcgencmd get_throttled" is a command used in the Raspberry Pi operating system to query the GPU firmware for the current throttling status of the system.

The Raspberry Pi's GPU firmware monitors various metrics related to the CPU and system temperature. If certain thresholds are exceeded, the firmware may activate throttling mechanisms to protect the system from overheating or other issues.

When you execute the "vcgencmd get_throttled" command, it retrieves the current status of any active throttling events. The command returns a 32-bit hexadecimal value, where each bit represents a specific type of throttling event. By converting this hexadecimal value to binary, you can determine which throttling events are active by examining the binary representation.

For example, if the command returns a value of "0x50000", converting it to binary would result in "1010000000000000000". In this case, two bits are set: the 5th bit (counting from the right) indicates under-voltage has occurred, and the 18th bit indicates that the system has been throttled due to temperature issues.

This command is useful for troubleshooting and monitoring the system's operating conditions. If you see any active throttling events, it indicates that the Raspberry Pi is experiencing some issues and may not be performing optimally.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.
back to the vcgencmd tool