RuneAudio

https://www.runeaudio.com/documentation
Admin
RuneAudio is an open-source software platform and web interface that transforms embedded devices...
Tokens:13,807
Snippets:147
Trust Score:9.6
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### 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
<?xml version="1.0" standalone='no'?>
<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
<service-group>
  <name replace-wildcards="yes">RuneAudio [device_name] [xx:xx:xx:xx:xx:xx]</name>
  <service>
    <type>_http._tcp</type>
    <port>80</port>
  </service>
</service-group>

```

--------------------------------

### 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:"<WIFI@REALTEK>"
              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
```
Tokens:
Raw