Client Configuration

Client Configuration

• When a BCLD image is written to a USB, a file called bcld.cfg is generated.
• Check Tools to see how to write the BCLD-USB image to a USB device.
• This file can be used to configure BCLD.
• Below is a set of BCLD and kernel parameters which may be useful for your system.

BCLD Parameters

• BCLD Parameters are custom made for BCLD, often because they are very popular settings.
• If certain settings and customizations or new features are popular or highly requested, new BCLD parameters may be added in the future.

GENERAL

PARAMETER	EXPLANATION	TYPE	VOORBEELD / DEFAULT
bcld.afname.mouse	Bigger mouse cursor	BIT	0, 1
bcld.afname.url	Web site target	URL	https://www.google.com/
bcld.afname.verbose	Increase verbosity	BIT	0, 1

CLIENT

PARAMETER	EXPLANATION	TYPE	VOORBEELD / DEFAULT
bcld.client.restart*	Restart BCLD client	TIME (24h), +MINUTES	15:30, 02:00, +180, +300
bcld.client.shutdown*	Shutdown BCLD client	TIME (24h), +MINUTES	15:30, 02:00, +180, +300

bcld.client.restart: This will create a boot loop: BCLD will restart, but if the parameter remains, it will continue restarting

TIME: always restart at this time

+MINUTES: restart every +MINUTES

bcld.client.shutdown: This feature has the same notation as bcld.client.restart, minus the boot loop

IMPORTANT: Make sure the system clock is set correctly for this feature to work properly!

DISPLAY

PARAMETER	EXPLANATION	TYPE	VOORBEELD / DEFAULT
bcld.display.brightness	Brightness	PERCENTAGE	10 - 100
bcld.display.preset	Dimensional presets:	PRESET	- 4K (UHDTV met HDPI) - 1080p (Full HD) - HD+ (1600×900) - 768p (1368x768) - XGA (1280x1024)
bcld.display.resolution	Resolution	RESOLUTION	1280x1024, 1368x768, 1600×900, 1920x1080
bcld.display.rotate	Rotation	STRING	left, right, normal, inverted
bcld.display.scale_factor	Scaling	PERCENTAGE	10 - 200, 100
bcld.display.screensaver	Screensaver timeout	MINUTES	0 - 60

Setting bcld.display.screensaver to 0 will disable it entirely

AUDIO

PARAMETER	EXPLANATION	TYPE	VOORBEELD / DEFAULT
bcld.audio.alsa_port	Port Name	PERCENTAGE	10 - 100
bcld.audio.alsa_sink	Sink Name	PERCENTAGE	10 - 150
bcld.audio.default_playback_vol	Output Volume	PERCENTAGE	10 - 250, 100
bcld.audio.default_recording_vol	Recording Volume	PERCENTAGE	10 - 150
bcld.audio.default_sink	Default audio output device	DEVICE INDEX	1, 2, ...
bcld.audio.default_source	Default audio input device	DEVICE INDEX	1, 2, ...
bcld.audio.restore	Set ALSA Restore	BIT	0, 1
bcld.audio.sound_check	Enable BCLD Sound Check	BIT	0, 1
bcld.audio.use_combined_sink	Combined audio devices	BIT	0, 1

NETWORK

PARAMETER	EXPLANATION	TYPE	VOORBEELD / DEFAULT
bcld.default.interface	Standard network adapter	INTERFACE	enp0s1
bcld.network.check	Test afname URL	BIT	0, 1
bcld.wifi.eap.auth	Wi-Fi EAP authentication method	AUTHENTICATION METHOD	mschap, mschapv2
bcld.wifi.eap.method	Wi-Fi EAP method	EAP METHOD	tls, ttls
bcld.wifi.eap.user	Wi-Fi user (with domain) for EAP	BASE64 USER[@DOMAIN]	john, john@school.edu
bcld.wifi.eap.password	Wi-Fi password for EAP	BASE64 PASSWORD	bm90aGluZ2J1dHVzY2hpY2tlbnMK
bcld.wifi.psk	Wi-Fi password	BASE64 STRING	bm90aGluZ2J1dHVzY2hpY2tlbnMK
bcld.wifi.ssid	Wi-Fi name	BASE64 SSID	RG9udFRyeWl0QW5ha2luCg==
bcld.wol.disable	Wake-on-LAN	BIT	0, 1
bcld.wwan.enable	4G, 5G, LTE	BIT	0, 1

KERNEL

• Kernel parameters have nothing to do with BCLD and are part of the Linux kernel.
• These parameters will always work, on any linux system.
• They may be able to fix or prevent some issues while using BCLD.

PARAMETER	EXPLANATION	TYPE	VOORBEELD / DEFAULT
acpi	Advanced Configuration and Power Interface	SWITCH	on, off, noirq
acpi_backlight	Advanced Configuration and Power Interface (ACPI) backlight control	KERNEL PARAM	native, vendor, vendor_xbacklight_+100
acpi_osi			~
dis_ucode_ldr	Disable CPU microcode loader during boot	KERNEL PARAM	~
i915.enable_dc	Disable Display Clock on i915 systems (like HP)	BIT	0, 1
i915.enable_psr	Disable Panel Self Refresh on i915 systems (like HP)	BIT	0, 1
ip	IP kernel autoconfiguration. On by default.	KERNEL PARAM	none, off, dhcp
ipv6.disable	Disable IPv6 networking	BIT	0, 1
intel_iommu	Disables Input-Output Memory Management Unit only on the integrated GPU to fix hardware issues	KERNEL PARAM	igfx_off
intremap	Disabled interrupt remapping and might fix a hanging boot	KERNEL PARAM	nosid
loglevel	Set the log level manually	LOG LEVEL	0, 1, 2, 3, 4, 5, 6, 7
noapic	Disables Advanced Programmable Interrupt Controller and might fix a hanging boot	KERNEL PARAM	~
nomodeset	Instruction to leave the kernel's mode setting to the firmware	KERNEL PARAM	nomodeset
nouveau.modeset	Allows kernel from loading video driver	BIT	0, 1
pci	Kernel PCI config	KERNEL PARAM	noaer
rd.udev.log_priority	Set log level for Udev	LOG LEVEL	0, 1, 2, 3, 4, 5, 6, 7
snd_hda_intel.dmic_detect (DEPRECATED)	Enables integrated microphone detection to force audio	BIT	0, 1
snd_intel_dspcfg.dsp_driver	Intel DSP driver configuration	BIT	0, 1, 2, 3
systemd.show_status	Control the display of systemd service status messages during the boot process	KERNEL PARAM	yes, no, auto
video.use_native_backlight	Similar to acpi_backlight=native	CONFIGURATION	0, 1