### KEYMAP variable examples for /etc/vconsole.conf Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Example values for the KEYMAP variable in /etc/vconsole.conf on RuneOS (Arch Linux based). The first shows a possible initial value, while the second shows a desired setting; other options include fr, uk, us, etc. ```text KEYMAP=de-latin1-nodeadkeys ``` ```text KEYMAP=cz ``` -------------------------------- ### Example diskutil list output Source: https://www.runeaudio.com/documentation/quick-start/sd-card-setup-mac Example output from diskutil list. The SD card appears as /dev/disk2 with a 7.9 GB size and a DOS_FAT_32 partition named CANAKIT. ```text /dev/disk0 #: TYPE NAME SIZE IDENTIFIER 0: GUID_partition_scheme *500.3 GB disk0 1: EFI EFI 209.7 MB disk0s1 2: Apple_CoreStorage 499.4 GB disk0s2 3: Apple_Boot Boot OS X 134.2 MB disk0s3 /dev/disk1 #: TYPE NAME SIZE IDENTIFIER 0: Apple_HFS Macintosh HD *499.1 GB disk1 /dev/disk2 #: TYPE NAME SIZE IDENTIFIER 0: FDisk_partition_scheme *7.9 GB disk2 1: DOS_FAT_32 CANAKIT 7.9 GB disk2s1 ``` -------------------------------- ### Resize partition with fdisk Source: https://www.runeaudio.com/documentation/troubleshooting/extend-partition-sd Starts the fdisk interactive utility on the SD card device to resize the partition. Use the interactive commands p, d, n, p, t, and w as described to delete and recreate the main RuneOS partition with the same start block and the default end block, marking it as type 83 (Linux). A reboot may be required after writing changes. ```bash fdisk /dev/mmcblk0 ``` -------------------------------- ### Edit /etc/modules-load.d/raspberrypi.conf with nano Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Opens the kernel modules configuration file to disable the native analog output when a DAC or digital output board is installed. ```bash # nano /etc/modules-load.d/raspberrypi.conf ``` -------------------------------- ### lsusb output for a typical WiFi adapter Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Example output of lsusb showing a typical WiFi adapter. If the adapter is not found, it may be bad, require too much power, or not be identifiable by RuneOS. ```text Bus 001 Device 004: ID 7392:7811 Edimax Technology Co., Ltd EW-7811Un 802.11n Wireless Adapter [Realtek RTL8188CUS] ``` -------------------------------- ### Write image to SD card with dd Source: https://www.runeaudio.com/documentation/quick-start/sd-card-setup-mac Writes the RuneAudio image to the SD card. The first line shows the general syntax; the second is a real example. Double-check the destination drive to avoid data loss. ```bash dd bs=1m if=[source] of=[destination] ``` ```bash dd bs=1m if=/Users/antonypa/Desktop/RuneAudio_rpi_0.3-beta_20141029_2GB.img of=/dev/disk2 ``` -------------------------------- ### Rune UI access URLs for Windows and OSX/Linux/Android Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting URLs to access the Rune UI from a browser. The first works on Microsoft Windows when Avahi/Bonjour is installed; the second works on OSX, Linux, and Android. ```text http://runeaudio ``` ```text http://runeaudio.local ``` -------------------------------- ### Create avahi service file for RuneAudio player Source: https://www.runeaudio.com/documentation/development/runeaudio-remote-control XML configuration for the avahi service file `/etc/avahi/services/runeaudio.service`. Create this file with the given content if it doesn't exist or is empty. Replace `device_name` and `xx:xx:xx:xx:xx:xx` with the desired device name and MAC address. ```xml RuneAudio [device_name] [xx:xx:xx:xx:xx:xx] _http._tcp 80 ``` -------------------------------- ### Switch RuneUI to the dev branch (delete, clone, clear cache) Source: https://www.runeaudio.com/documentation/troubleshooting/updating Required steps to switch from the main branch to the dev branch. Delete the contents of /var/www (double-check the path first), clone the dev branch of RuneUI into that directory, and clear the PHP OPcache. Finally, reboot the device and hard refresh your browser cache. ```bash rm -rf /var/www/{*,.*} ``` ```bash git clone -b dev https://github.com/RuneAudio/RuneUI.git/ /var/www ``` ```bash curl -s http://localhost/clear ``` -------------------------------- ### List available keymaps with localectl Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Command to list all available keymaps on RuneOS. Use it to find the correct keymap value for the KEYMAP variable in /etc/vconsole.conf. ```bash localectl list-keymaps ``` -------------------------------- ### Edit /boot/config.txt with nano Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Opens the Raspberry Pi boot configuration file for editing, either before flashing the SD card or on the Pi itself via local console or SSH/PuTTY. ```bash # nano /boot/config.txt ``` -------------------------------- ### Enable HiFiBerry DAC+ device tree overlay Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Shows the device tree overlay section in /boot/config.txt. To enable a HiFiBerry DAC+, remove the '#' from the corresponding line; otherwise the kernel will not detect the board. ```config # Uncomment one of these lines to enable an audio interface #device_tree_overlay=hifiberry-dac device_tree_overlay=hifiberry-dacplus #device_tree_overlay=hifiberry-digi #device_tree_overlay=hifiberry-amp #device_tree_overlay=iqaudio-dac #device_tree_overlay=iqaudio-dacplus ``` -------------------------------- ### Resize filesystem with resize2fs Source: https://www.runeaudio.com/documentation/troubleshooting/extend-partition-sd Resizes the filesystem to fill the resized partition. Use /dev/mmcblk0p1 instead if the main RuneOS partition was mmcblk0p1. This can be run while the filesystem is online (no need to unmount it). ```bash resize2fs /dev/mmcblk0p0 ``` -------------------------------- ### Flash SD card with sudo dd Source: https://www.runeaudio.com/documentation/quick-start/sd-card-setup-mac Runs the dd command with sudo to gain permission. It will prompt for your password and then flash the SD card. ```bash sudo dd bs=1m if=/Users/antonypa/Desktop/RuneAudio_rpi_0.3-beta_20141029_2GB.img of=/dev/disk2 ``` -------------------------------- ### List disks with diskutil list Source: https://www.runeaudio.com/documentation/quick-start/sd-card-setup-mac Lists all disks attached to the Mac. Use the output to identify the SD card by its size and device identifier (e.g., /dev/disk2). ```bash diskutil list ``` -------------------------------- ### List USB devices with lsusb Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Command to list all detected USB devices from the terminal. Use it to verify that a WiFi adapter is detected; a typical adapter appears as an Edimax EW-7811Un with Realtek RTL8188CUS. ```bash lsusb ``` -------------------------------- ### dd permission denied error Source: https://www.runeaudio.com/documentation/quick-start/sd-card-setup-mac Likely error message when running dd without sufficient permissions. Add sudo to the command to proceed. ```text dd: /dev/disk2: Permission denied ``` -------------------------------- ### Update RuneUI from the terminal (git pull and clear cache) Source: https://www.runeaudio.com/documentation/troubleshooting/updating Run in the terminal to update RuneUI from the main branch. Commands change to the /var/www directory, pull the latest changes with git pull, and clear the PHP OPcache via curl. Afterward, hard refresh your browser cache. ```bash cd /var/www git pull curl -s -X GET 'http://localhost/clear' ``` -------------------------------- ### Typical iwconfig output Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Typical output of iwconfig showing wlan0 with power management off and good link quality, plus lo, eth0, ifb0, and ifb1 with no wireless extensions. ```text wlan0 IEEE 802.11bgn ESSID:"ABCD EFGH" Nickname:"" Mode:Managed Frequency:2.412 GHz Access Point: 28:27:BF:C9:A7:5D Bit Rate:72.2 Mb/s Sensitivity:0/0 Retry:off RTS thr:off Fragment thr:off Encryption key:****-****-****-****-****-****-****-**** Security mode:open Power Management:off Link Quality=100/100 Signal level=77/100 Noise level=0/100 Rx invalid nwid:0 Rx invalid crypt:0 Rx invalid frag:0 Tx excessive retries:0 Invalid misc:0 Missed beacon:0 lo no wireless extensions. eth0 no wireless extensions. ifb0 no wireless extensions. ifb1 no wireless extensions. ``` -------------------------------- ### Increase USB current on Raspberry Pi (max_usb_current=1) Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Add this parameter to the /boot/config.txt file on a Pi B+ or Pi 2 to increase the USB power allowance from the default 150mA per port to about 300mA per port (1.2A total). This helps support power-hungry peripherals such as WiFi dongles and wireless keyboards. ```plaintext # setting the max usb current to 1200mA max_usb_current=1 ``` -------------------------------- ### Check WiFi status with iwconfig Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Command to check WiFi signal strength, link quality, and that wlan0 power management is turned off. Power management may cause the WiFi adapter to 'go to sleep'. ```bash iwconfig ``` -------------------------------- ### Unmount SD card with diskutil unmountDisk Source: https://www.runeaudio.com/documentation/quick-start/sd-card-setup-mac Unmounts the SD card manually from the terminal. Do not eject the card; only unmount it before flashing. ```bash diskutil unmountDisk /dev/disk2 ``` -------------------------------- ### Comment out snd-bcm2835 to disable analog output Source: https://www.runeaudio.com/documentation/troubleshooting/rpi-troubleshooting Place a '#' before 'snd-bcm2835' in the second line of /etc/modules-load.d/raspberrypi.conf to disable the native analog output. ```config #snd-bcm2835 ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.