Difference between revisions of "Raspberry Pi"

From ArchWiki
Jump to: navigation, search
(Adding another user)
(Added raspberry pi camera setup info)
(36 intermediate revisions by 14 users not shown)
Line 1: Line 1:
{{delete|Archlinuxarm is a seperate project.  The lead dev for alarm does not support this page.}}
 
 
[[Category:Getting and installing Arch]]
 
[[Category:Getting and installing Arch]]
{{Note|Support for the ARM architecture is provided on http://archlinuxarm.org/ }}
+
[[cs:Raspberry Pi]]
 +
[[ru:Raspberry Pi]]
 +
{{Article summary start}}
 +
{{Article summary text|Raspberry Pi (RPi) is a minimalist computer built for the [[Wikipedia:ARMv6|ARMv6 architecture]]. [http://www.raspberrypi.org/ More information about this project] and [http://uk.farnell.com/raspberry-pi technical specification].}}
 +
{{Article summary heading|Related}}
 +
{{Article summary wiki|Beginners' Guide}}
  
How mature is Raspberry Pi (RPI). A brief overview.
+
[http://elinux.org/RPiconfig RPi Config] - Excellent source of info relating to under-the-hood tweaks.
  
== What is Raspberry Pi ==
+
[http://elinux.org/RPI_vcgencmd_usage RPi vcgencmd usage] - Overview of firmware command vcgencmd.
 +
{{Article summary end}}
  
It is a minimalist computer built for ARMv6 architecture. [http://www.raspberrypi.org/ More information about this project] and [http://uk.farnell.com/raspberry-pi technical specification].
+
== Article Preface ==
 +
This article is not meant to be an exhaustive setup guide and assumes that the reader has setup an Arch system before. Arch newbies are encouraged to read the [[Beginners' Guide]] if unsure how to preform standard tasks such as creating users, managing the system, etc.
 +
 
 +
{{Note|Support for the ARM architecture is provided on http://archlinuxarm.org not through posts to the official Arch Linux Forum.  Any posts related to ARM specific issues will be promptly closed per the [https://wiki.archlinux.org/index.php/Forum_Etiquette#Arch_Linux_Distribution_Support_ONLY Arch Linux Distribution Support ONLY] policy.}}
  
 
== Installing Arch Linux ARM ==
 
== Installing Arch Linux ARM ==
  
In this manual will describe only essential moments for different RPI. Other procedures are the same instructions for ArchLinux. The only exception is the basic initialization and installation of equipment. It is further assumed that the configuration is performed on a machine running Archlinux.
+
See the [http://archlinuxarm.org/platforms/armv6/raspberry-pi#qt-platform_tabs-ui-tabs2 archlinuxarm documentation].
  
=== Backup Cards ===
+
== Audio ==
If you own an official card provided with your RPI ([http://uk.farnell.com/samsung/raspberry-pi-prog-4gb-sdcard/memory-sdcard-raspberry-pi-4gb/dp/2113756 for example]) recommend before installing Arch ARM Linux to backup using {{ic|dd}}. The path must be specified to the device {{ic|/dev/sdX}} not for another partition {{ic|/dev/sdc1}}
+
{{Note| The requisite module '''snd-bcm2835''' should be autoloaded by default.}}
  
  # dd if=/dev/sdX of=$HOME/backup_RPi.img
+
Install the needed packages:
 +
  pacman -S alsa-utils alsa-firmware alsa-lib alsa-plugins
  
{{Note | There is a bit copy of the card. The resulting file is the same size as your card.}}
+
Optionally adjust the default volume using `alsamixer` and ensure that the sole source "PCM" is not muted (denoted by double MM if muted).
{{Note | card may not be installed.}}
+
{{Warning | Bad parameters can damage your data.}}
+
  
=== Installation ===
+
Select an audio source for output:
 +
amixer cset numid=3 x
  
Installation is similar to backing card. Download the image file from [http://archlinuxarm.org/platforms/armv6/raspberry-pi Arch Linux ARM]
+
Where 'x' corresponds to:
 +
*0 for Auto
 +
*1 for Analog out
 +
*3 for HDMI
  
# dd bs=1M if=/path/to/archlinux.img of=/dev/sdX
+
=== Caveats for HDMI Audio ===
 +
Some applications require a setting in {{ic|/boot/config.txt}} to force audio over HDMI:
 +
hdmi_drive=2
  
After inserting the card into the slot on the PPi should boot the base system Arch Linux ARM.
+
== Onboard Hardware Sensors ==
 +
=== Temperature ===
 +
Temperatures sensors for the board itself are including as part of the '''raspberrypi-firmware-tools''' package.  The RPi offers a sensor on the BCM2835 SoC (CPU/GPU):
  
=== Home ===
+
/opt/vc/bin/vcgencmd measure_temp
 +
temp=49.8'C
  
The downloaded image file is approximately 2 gigabytes of which is /boot 94 megabytes and / 1.8 gigabytes. If you used a larger card to 2GB, so I recommend the rest of the card to connect as /home (or /usr). Clearance must be formatted using the example [[Gparted]]. At the first possible opportunity (after booting RPI or after mounting the card in the computer) need to be adjusted {{ic | /etc/fstab}}
+
Alternatively, simply read from the filesystem:
 +
% cat /sys/class/thermal/thermal_zone0/temp               
 +
49768
  
# sudo vim /etc/fstab
+
=== Voltage ===
 +
Four different voltages can be monitored via {{ic|/opt/vc/bin/vcgencmd}} as well:
  
For example, add
+
% /opt/vc/bin/vcgencmd measure_volts <id>
  
/dev/mmcblk0p3 /home ext4 defaults 0 0
+
*core for core voltage
 +
*sdram_c for sdram Core voltage
 +
*sdram_i for sdram I/O voltage
 +
*sdram_p for sdram PHY voltage
  
== The first operation ==
+
=== Lightweight Monitoring Suite ===
 +
{{AUR|Monitorix}} has specific support for the RPi since v3.2.0.  Screenshots available [[http://www.monitorix.org/screenshots.html here]].
  
Summary of the [http://archlinuxarm.org/support/guides/system/first-steps official procedure]:
+
== Overclocking/Underclocking ==
 +
The RPi can be overclocked by editing {{ic|/boot/config.txt}}, for example:
 +
 +
arm_freq=800
 +
arm_freq_min=100
 +
core_freq=300
 +
core_freq_min=75
 +
sdram_freq=400
 +
over_voltage=0
  
=== Remote SSH access ===
+
The optional xxx_min lines define the min usage of their respective settings.  When the system is not under load, the values will drop down to those specified.  Consult the [http://elinux.org/RPiconfig#Overclocking Overclocking] article on elinux for additional options and examples.
  
If you do not use the HDMI output RPI and you will access the device using SSH, the following applies.
+
A reboot is needed for new settings to take effect.
Root pasword is: {{ic | root}}. I recommend to perform key exchange [[SSH_Keys]].
+
  
$ ssh root@192.168.1.123 (Use your Ip RPI)
+
{{Note|The overclocked setting for CPU clock applies only when the governor throttles up the CPU, i.e. under load.}}
  
=== Localization ===
+
Users may query the current frequency of the CPU via this command:
 +
cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_cur_freq
  
# vim /etc/locale.gen
+
== Serial Console ==
 +
Edit the default /boot/cmdline.txt
  
uncomment {{ic | en_US.UTF-8 UTF-8}} and {{ic | en_US ISO-8859-2}}
+
Change loglevel to 5 to see boot messages
 +
loglevel=5
  
generate localization files
+
Change speed from 115200 to 38400
 +
console=ttyAMA0,38400 kgdboc=ttyAMA0,38400
  
  # locale-gen
+
Start getty service
 +
  systemctl start getty@ttyAMA0
  
=== Setting the time and date using OpenNTP ===
+
Enable on boot
 +
systemctl enable getty@ttyAMA0.service
  
dopnit
+
Creating the proper service link:
 +
ln -s /usr/lib/systemd/system/serial-getty@.service /etc/systemd/system/getty.target.wants/serial-getty@ttyAMA0.service
  
=== Setting the time and date manually ===
+
Then connect :)
 
+
  screen /dev/ttyUSB0 38400
complete
+
 
+
=== Changing the root password ===
+
After the first start RPI is native root password to root. It is therefore necessary to change it. Executed after power command {{ic | passwd}}
+
 
+
  # passwd root
+
 
+
=== Adding another user ===
+
Using {{ic|useradd}} to add the user.
+
 
+
# useradd username
+
 
+
=== Sudo ===
+
Start {{ic|visudo}}
+
 
+
# su -
+
# visudo
+
 
+
add the line "USER ALL=(ALL) ALL" below the line root ALL=(ALL) ALL, where "USER" is your username
+
  
 
== Video ==
 
== Video ==
 +
pacman -S xf86-video-fbdev
  
The generic {{pkg|xf86-video-fbdev}} driver can be used.
+
Adjustments are likely required to correct proper overscan/underscan and are easily achieved in {{ic|boot/config.txt}} in which many tweaks are set. To fix, simply uncomment the corresponding lines and setup per the commented instructions:
  
== Serial Console ==
+
# uncomment the following to adjust overscan. Use positive numbers if console
Edit the default /boot/cmdline.txt
+
# goes off screen, and negative if there is too much border
 +
#overscan_left=16
 +
overscan_right=8
 +
overscan_top=-16
 +
overscan_bottom=-16
  
Change loglevel to 5 to see boot messages
+
Users wishing to use the analog video out should consult [https://raw.github.com/Evilpaul/RPi-config/master/config.txt this] config file which contains options for non-NTSC outputs.
# loglevel=5
+
  
Change speed from 11520 to 38400
+
A reboot is needed for new settings to take effect.
# console=ttyAMA0,38400 kgdboc=ttyAMA0,38400
+
  
Start getty service
+
== Raspberry Pi Camera module ==
  # systemctl start getty@ttyAMA0
+
The commands for the camera module are including as part of the '''raspberrypi-firmware-tools''' package - which is installed by default. You can then use:
 +
/opt/vc/bin/raspistill
 +
  /opt/vc/bin/raspivid
  
Enable on boot
+
You need to append to /boot/config.txt:
#systemctl enable getty@ttyAMA0.service
+
  
Creating the proper service link:
+
  start_file=start_x.elf
  # ln -s /usr/lib/systemd/system/getty@.service /etc/systemd/system/getty.target.wants/getty@ttyAMA0.service
+
  fixup_file=fixup_x.dat
 
+
Then connect :)
+
  # screen /dev/ttyUSB0 38400
+
  
  Referenced from these [http://www.raspberrypi.org/phpBB3/viewtopic.php?f=53&t=19186] posts [https://bbs.archlinux.org/viewtopic.php?id=144847]
+
Optionally
 +
  disable_camera_led=1

Revision as of 12:22, 24 September 2013

Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary wiki

RPi Config - Excellent source of info relating to under-the-hood tweaks.

RPi vcgencmd usage - Overview of firmware command vcgencmd. Template:Article summary end

Article Preface

This article is not meant to be an exhaustive setup guide and assumes that the reader has setup an Arch system before. Arch newbies are encouraged to read the Beginners' Guide if unsure how to preform standard tasks such as creating users, managing the system, etc.

Note: Support for the ARM architecture is provided on http://archlinuxarm.org not through posts to the official Arch Linux Forum. Any posts related to ARM specific issues will be promptly closed per the Arch Linux Distribution Support ONLY policy.

Installing Arch Linux ARM

See the archlinuxarm documentation.

Audio

Note: The requisite module snd-bcm2835 should be autoloaded by default.

Install the needed packages:

pacman -S alsa-utils alsa-firmware alsa-lib alsa-plugins

Optionally adjust the default volume using `alsamixer` and ensure that the sole source "PCM" is not muted (denoted by double MM if muted).

Select an audio source for output:

amixer cset numid=3 x

Where 'x' corresponds to:

  • 0 for Auto
  • 1 for Analog out
  • 3 for HDMI

Caveats for HDMI Audio

Some applications require a setting in /boot/config.txt to force audio over HDMI:

hdmi_drive=2

Onboard Hardware Sensors

Temperature

Temperatures sensors for the board itself are including as part of the raspberrypi-firmware-tools package. The RPi offers a sensor on the BCM2835 SoC (CPU/GPU):

/opt/vc/bin/vcgencmd measure_temp
temp=49.8'C

Alternatively, simply read from the filesystem:

% cat /sys/class/thermal/thermal_zone0/temp                
49768

Voltage

Four different voltages can be monitored via /opt/vc/bin/vcgencmd as well:

% /opt/vc/bin/vcgencmd measure_volts <id>
  • core for core voltage
  • sdram_c for sdram Core voltage
  • sdram_i for sdram I/O voltage
  • sdram_p for sdram PHY voltage

Lightweight Monitoring Suite

MonitorixAUR has specific support for the RPi since v3.2.0. Screenshots available [here].

Overclocking/Underclocking

The RPi can be overclocked by editing /boot/config.txt, for example:

arm_freq=800
arm_freq_min=100
core_freq=300
core_freq_min=75
sdram_freq=400
over_voltage=0

The optional xxx_min lines define the min usage of their respective settings. When the system is not under load, the values will drop down to those specified. Consult the Overclocking article on elinux for additional options and examples.

A reboot is needed for new settings to take effect.

Note: The overclocked setting for CPU clock applies only when the governor throttles up the CPU, i.e. under load.

Users may query the current frequency of the CPU via this command:

cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_cur_freq

Serial Console

Edit the default /boot/cmdline.txt

Change loglevel to 5 to see boot messages

loglevel=5

Change speed from 115200 to 38400

console=ttyAMA0,38400 kgdboc=ttyAMA0,38400

Start getty service

systemctl start getty@ttyAMA0

Enable on boot

systemctl enable getty@ttyAMA0.service

Creating the proper service link:

ln -s /usr/lib/systemd/system/serial-getty@.service /etc/systemd/system/getty.target.wants/serial-getty@ttyAMA0.service

Then connect :)

screen /dev/ttyUSB0 38400

Video

pacman -S xf86-video-fbdev

Adjustments are likely required to correct proper overscan/underscan and are easily achieved in boot/config.txt in which many tweaks are set. To fix, simply uncomment the corresponding lines and setup per the commented instructions:

# uncomment the following to adjust overscan. Use positive numbers if console
# goes off screen, and negative if there is too much border
#overscan_left=16
overscan_right=8
overscan_top=-16
overscan_bottom=-16

Users wishing to use the analog video out should consult this config file which contains options for non-NTSC outputs.

A reboot is needed for new settings to take effect.

Raspberry Pi Camera module

The commands for the camera module are including as part of the raspberrypi-firmware-tools package - which is installed by default. You can then use:

/opt/vc/bin/raspistill
/opt/vc/bin/raspivid

You need to append to /boot/config.txt:

start_file=start_x.elf
fixup_file=fixup_x.dat

Optionally

disable_camera_led=1