Skip to content

Latest commit

 

History

History
285 lines (208 loc) · 11 KB

raspberrypi.md

File metadata and controls

285 lines (208 loc) · 11 KB

Raspberry Pi

Raspberry Pi Foundation, GitHub, Magazine

Quick start

Documentation

Operating system setup

Installing operating system images

Validated configurations

Type CPU RAM OS
Pi Model B Rev 2 BCM2835 ARMv6 1176JZF-S 700 MHz 512 Mo Raspberry Pi OS Lite (32-bit)
Pi Model 2 B BCM2836 ARMv7 Cortex-A7 Quad Core 900MHz 1 Go Ubuntu Server 18.04 (32-bit), Ubuntu Server 20.04 LTS (32-bit)
Pi Model 4 B BCM2711 ARMv8 Quad core Cortex-A72 64-bit 1.5GHz 4 Go LPDDR4-3200 Ubuntu Server 18.04 (64-bit), Ubuntu Server 20.04 LTS (64-bit)

Known issues

Key elements

SD card preparation

  • (Optional) Download a specific version from ubuntu.com (for instance the previous before the LTS if it's too new for a specific hardware) WARNING links have to be modified manually (typo in pi version number...)
  • (Optional) Look at available systems
  • Install Raspberry Pi Imager from the Downloads page
  • Insert the SD card and run the Raspberry Pi Imager
  • (Optional) Eject and insert again the SD card
    • Edit network-config at the root of the drive (with new eth0 and wlan0 parameters)

Initial boot

Insert the SD card in the board, plug a keyboard (USB), a monitor (HDMI) then plug the power cable

Hardware check

Note: @since Kernel 4.9, BCM2835 will be displayed for the processor, even for BCM2836, BCM2837 and BCM2711. You should look instead at the revision code, which is unique.

cat /proc/cpuinfo

Shared steps

Wifi setup

# list interfaces (make sure wlan0 is displayed)
ls /sys/class/net

# edit or create a netplan yaml file and apply the change
sudo nano /etc/netplan/50-cloud-init.yaml
sudo netplan -d apply
systemctl daemon-reload
sudo reboot

# make sure it's connected (with an IP)
ip a
ping google.com

# enable an interface
sudo ip link set wlan0 up

# see the wireless interface
iwconfig

# if it doesn't show up, run
sudo ifconfig wlan0 up

# scan available networks
sudo iwlist wlan0 scan

# look at services
sudo systemctl status systemd-networkd.service
sudo systemctl status netplan-wpa-wlan0.service

# some Wifi USB adaptors may be incompatible with networkd, in this case fallback to NetworkManager
# - just in case make sure the value is correct (2 letter iso country code)
sudo nano /etc/default/crda
# - make sure NetworkManager service is started (start it if needed)
sudo systemctl status NetworkManager.service
# - edit netplan file to use NetworkManager instead of networkd (and comment the existing config)
sudo nano /etc/netplan/50-cloud-init.yaml
sudo netplan apply
systemctl daemon-reload
# - install additional package to have additional tools to configure wifi network
sudo apt install network-manager
# - run the configuration wizard
nmtui
# - set static ip
nmcli con mod mywifiname ipv4.addresses "192.168.86.144" ipv4.gateway "192.168.86.1" ipv4.dns "8.8.8.8,4.4.4.4" ipv4.method "manual"
# - look at the configuration file
sudo more /etc/NetworkManager/system-connections/mywifiname
# - restart the service to take this new configuration into account
sudo systemctl restart NetworkManager.service

System update

# review the operating system information
lsb_release -a

# use package manager to run updates
sudo apt update
sudo apt upgrade
sudo apt dist-upgrade
sudo reboot

Troubleshoot

# make sure all services are up
systemctl --failed

# look at recent entries in the journal
journalctl -xe

Keyboard layout configuration

sudo dpkg-reconfigure keyboard-configuration
sudo setupcon
more /etc/default/keyboard
sudo reboot

Raspberry Pi OS (aka Raspbian, Debian 10 = Buster)

  • Login with pi/raspberry
  • Change keyboard layout
  • Configure the easy way: set Wifi parameters, update hostname, enable SSH, change password, (optional) change keyboard configuration
raspi-config
  • (Optional] Configure a static ip by editing /etc/dhcpcd.conf (do a sudo reboot afterwards)
interface wlan0
static ip_address=192.168.86.145/24
static routers=192.168.86.1
static domain_name_servers=192.168.86.1 8.8.8.8 4.4.4.4
  • Run updates

Ubuntu Server (18.04)

  • Login with ubuntu/ubuntu (you'll be asked to provide a new password)
  • Change keyboard layout
  • (Optional) Review boot log
dmesg
  • If there is an issue starting systemd-modules, look at the journal and investigate the issue
sudo systemctl status systemd-modules-load.service

# manual step needed on Raspberry Pi 2: comment is_iser (see https://askubuntu.com/questions/877245/systemd-modules-load-failed-to-start)
sudo nano /lib/modules-load.d/open-iscsi.conf

sudo systemctl start systemd-modules-load.service
  • Configure Wifi
  • Run system updates

Ubuntu Server (20.04 LTS)

  • Login with ubuntu/ubuntu (you'll be asked to provide a new password)
  • Change keyboard layout
  • Configure Wifi
  • Run system updates

Recipes

.NET applications

Install .NET Core on ARMv6 32-bit

.NET Core is not compatible with ARMv6 (even with ARM32 versions: see .NET Runtime issue #7764

Install .NET Core on ARMv7 32-bit

The official procedure and workaround don't work.

# link taken by following download link from https://dotnet.microsoft.com/download/dotnet-core/3.1
wget https://download.visualstudio.microsoft.com/download/pr/56691c4c-341a-4bca-9869-409803d23cf8/d872d7a0c27a6c5e9b812e889de89956/dotnet-sdk-3.1.302-linux-arm.tar.gz
mkdir -p $HOME/dotnet
tar -xvf dotnet-sdk-3.1.302-linux-arm.tar.gz -C $HOME/dotnet
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet
dotnet --version

# add the two export lines in .bashrc so it will be permanent
nano .bashrc

cat << \EOF >> ~/.profile

# add .NET Core SDK
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet

# add .NET Core SDK tools
export PATH="$PATH:$HOME/.dotnet/tools"
EOF

logout

Install .NET Core on ARMv8 64-bit



Retro gaming


retropie


Home: retropie.org.uk, GitHub


Configuration:


    

  • 

    Usability
    


    • 

  • 

    SSH
    

      

    • Enable SSH in raspi-config: interfacing options > SSH > Enable > reboot your pi
      • 

    

    • 

  • 

    Amiga games
    

      

    • Install Amiberry from the optional packages

        

      • Follow the guide
        • 

      • Copy Amiga games (.adf, .ipf, .zip) in /home/pi/RetroPie/roms/amiga
        • 

      • Copy BIOS files (kick13.rom, kick20.rom, kick31.rom) in /home/pi/RetroPie/BIOS
        • 

      

      • 

    • Make sure you have a keyboard and a mouse :)
      • 

    

    • 

  • 

    /boot/config.txt file
    

      

    • Values
      • 

    

    


    
Key
value
Detail
Comment

    
    


    
hdmi_group
1
CEA (Consumer Electronics Association) is the display standard that is typically used on a TV


    

    
hdmi_group
2
DMT (Display Monitor Timings) is the standard that is typically used by monitors


    

    
hdmi_mode
16
CEA 1920×1080 16:9 60hz


    

    
hdmi_mode
97
CEA 3840×2160 16:9 60hz
Raspberry Pi 4 Only. To use this hdmi_enable_4kp60=1 must be set in /boot/config.txt.

    

    
hdmi_mode
82
DMT 1920×1080 16:9 60hz


    
    

    

      

    • To review: hdmi_force_hotplug=1, hdmi_drive=2
      • 

    

    • 



Known issues:



Amibian


Seems dead