CMDLINE OPTIONS

Create a file cmdline.txt on the SD(HC) card used for booting. Multiple options
must be placed on a single line delimited by a space character. The following
options are available:

width=640 height=480		Changes screen size (default is maximum size)

logdev=ttyS1			Set device used for log messages
				("tty1" for screen (default), "ttySN" for UART,
				 where N=1..M, M depends on the Raspberry Pi model,
				 "ttyS1" ("ttyS11" on the Raspberry Pi 5) should be used,
				 if no screen is attached)

loglevel=4			Control amount of generated log messages
				(0: only panic, 1: also errors, 2: also warnings,
				 3: also notices, 4: also debug output (default),
				 5: also trace messages)

keymap=UK			Select keyboard mapping ("DE", "DV" (Dvorak), "ES", "FR", "IT",
				"UK" or "US")
				The default mapping can be selected at the end of the file
				include/circle/sysconfig.h (normally "DE").

usbpowerdelay=510		Delay in milliseconds between powering on an USB device on an attached
				USB hub (both internal and external) and accessing the device
				(default 510, which is sometimes not enough to detect a device)

usbspeed=full			Set speed of the whole USB to full speed (12 Mbps) instead of
				high speed (480 Mbps) as workaround in case of problems
				(does work on Raspberry Pi 1-3 and Zero only)

usbboost=15			Speed-up different aspects of USB MIDI Bulk transactions.
				This may be especially important for USB MIDI keyboards, which
				lose MIDI events (does work on Raspberry Pi 1-3 and Zero only).
				The parameter is a decimal number (default 0) with the following
				values or'ed together: 1 (Do not insert a delay, when no MIDI event
				has been received, same as when "true" is specified), 2 (restart
				receiving MIDI events, before the previous received events have
				been processed), 4 (do complete on NAK and relax the USB, when
				no MIDI event is available, this may break other attached devices),
				8 (immediately start no-split Bulk requests without queuing, this
				may break the standard USB timing).

usbignore=int3-0-0		Prevent loading a driver for an USB interface or device, which
				is normally supported by Circle, but does not functioning with
				a specific USB device. Can be specified only once.

usbsoundchannels=6,2		Select specific number of sound channels for output,input for
				"sounddev=sndusb". By default 0,0 is set, which selects the first
				found USB interfaces. The selected number of channels (max. 32)
				must be supported by the attached USB audio streaming device.

sounddev=sndpwm			Set device used for sound output
				("sndpwm" for PWM (via headphone jack), "sndi2s" for I2S (external
				 hardware required), "sndvchiq" for VCHIQ (HDMI or headphone jack),
				 "sndhdmi" for HDMI (without VCHIQ), "sndusb" for USB (external
				 hardware required), default depends on application)

soundopt=0			Select destination for sound output with "sounddev=sndvchiq"
				(0: detected automatically (default), 1: headphone jack, 2: HDMI),
				Select the sample size for "sounddev=sndusb" in bits (16 (default)
				or 24)

fast=true			Set maximum CPU speed (if class CCPUThrottle is in the system,
				default is low speed on Raspberry Pi 2/3/4/Zero)

socmaxtemp=60			Set maximum temperature of the SoC (the main chip) to be enforced
				in degrees Celsius (if class CCPUThrottle is in the system,
				range 40 to 78, default 60)

gpiofanpin=2			GPIO pin number (SoC number, not header position) to which the
				control line of a (Raspberry Pi 4) Case Fan is connected. The fan
				will be switched on, when "socmaxtemp" will be reached (if class
				CCPUThrottle is in the system). The CPU speed is not throttled,
				when this option is used. On the Raspberry Pi 5 with a Case Fan
				or Active Cooler the GPIO pin number must be 45.

touchscreen=140,3960,340,3920	Set calibration coordinates for USB touchscreens
				(minimum x, maximum x, minimum y, maximum y)
				Use tools/touchscreen-calibrator to determine the values!

backlight=150			Set an initial backlight value for the Raspberry Pi Touchscreen.
				This should only be necessary for the older control board (v1.0).

wm8960tune=+1100		Add the given value to the fractional (K) part of PLL1 input/output
				frequency ratio (treated as 24-digit binary number) of the WM8960
				Codec to suppress clicks/pops (range -10000 to 10000, default 0)
