Ddxfish: Ddxfish moved page Raspberry Pi - Beginners Guides and Projects to Under construction guides

2013-09-25T18:13:48Z

Ddxfish moved page Raspberry Pi - Beginners Guides and Projects to Under construction guides

New page

=This Tutorial=
[[Category:Raspberry Pi]]
This is a guide I am making right now Aug 5 2013 that includes my first 10 working projects with setup, LEDs, switches, and status scripts that will change LEDs and perform actions based on switches or buttons. Slideshow from command line, and music player from command line, website server monitor (uptime monitor if you modify).

'''This guide is under construction as of August 8 2013''' and will be split into pages when completed.

My name is Chris, if you want to contact me or comment on this wiki feel free to email me at ddxfish@gmail.com or use the contact form on my website www.chriswest.us - I am available for:
*Comments on this guide
*Requests for additions to this guide (or request for clarification)
*Very basic questions about this guide (need me to add a few notes or tips?)
*Hire me for consultation on Raspberry Pi (raspbian)
*Hire me for building you a pi with any/all of these features

==Required Items==
*Raspberry Pi
*Raspberry Pi Case
*8GB or more SD Card (with Raspbian 7 Wheezy) (get a class 10 or more i recommend)
*1.5A or greater USB charger (5V 1500ma+) DC
*Network Cable attached properly
*HDMI Cable and HDMI TV (yes tv works best for me)
**Alternative: RCA Video cable, and 3.5mm audio cable

==Items for the guides==
*6 LEDs (Red, Yellow, Green, Blue, Purple, White) 5mm 3.0v@16mA and 2.1v@22mA but any 5mm LED will do
*5 Tactile Button Breadboard Switches (get 10 cuz its easy to mess them up)
*Pack of resistors (I would just buy a 15$ pack on amazon.com)
**3 x 47 ohm @ 1/4 watt (for LED)
**3 x 200 ohm @ 1/4 watt (for LED)
**3 x 1K ohm @ 1/4 watt (for switch)
**3 x 10K ohm @ 1/4 watt (for switch)
*20+ dupont (breadboard) wires (Male to Female)
*10+ dupont (breadboard) wires (Male to Male)
*22 gauge wire spool (solid core, not threaded)
*Breadboard (around 400 point tie in, 2 or 4 power rails)

=Raspberry Pi Guides List=

==Raspberry Pi - Initial Setup==
change root password
sudo passwd
update OS and install vim (text editor)
apt-get update
apt-get upgrade
apt-get install vim
You will need to edit your bash properties in 2 files, start with
vim /root/.bashrc
Add aliases to the end of /root/.bashrc and /root/.bash_profile
alias ls='ls -al --color'
alias goho='cd /home/pi'
alias gogp='cd /home/pi/gpio'
alias savepi='chown -R pi:pi /home/pi
export PS1="\[\e]0;\u@\h: \w\a\]${debian_chroot:+($debian_chroot)}\[\033[0;31m\]\u@\h\[\033[00m\] \[\033[01;34m\]\w \$\[\033[00m\]"
To copy all of this to its sister file:
cat /root/.bashrc > /root/.bash_profile

==Remove Desktop and X from Raspberry Pi==
If you want to NEVER boot into desktop and not have to back up those packages every time and worry about updates for them, this is the command for you. My guides will never use the Raspberry Pi desktop. This step is not essential to follow my or any guides I know of but will simplify some types of jobs like backups. It will remove Xserver, libx11 and ALL packages that depend on it. This means removing the ability to boot into desktop! You can try to put it back on but in my opinion this is a one way journey.

Notes:
*this command can trigger some major package changes on your system
*for me it removed MPD and a few other packages
*all I had to do was reinstall the packages (config files were never removed)

'''proceed at your own risk - one way journey'''

apt-get remove xserver* x11-common x11-utils x11-xkb-utils x11-xserver-utils xarchiver xauth xkb-data console-setup xinit lightdm libx{composite,cb,cursor,damage,dmcp,ext,font,ft,i,inerama,kbfile,klavier,mu,pm,randr,render,res,t,xf86}* lxde* lx{input,menu-data,panel,polkit,randr,session,session-edit,shortcut,task,terminal} obconf openbox gtk* libgtk* scratch tsconf xdg-tools desktop-file-utils
apt-get --yes autoremove
apt-get --yes autoclean
apt-get --yes clean

==Slim down your Raspberry Pi install==
I backup my pi on a regular basis and I have not been using the desktop on this install at all. I want to remove stuff that is not necessary like locales. Make sure you setup your locale before removing the others!

Setup your Locale
raspi-config

Remove unused locales (brought me back 70mb of my 500mb image)
Note: this remove all BUT en_US.UTF-8 so make sure u enter the names u want to keep
apt-get install localepurge (during install you select which locales to keep!)
localepurge

Clean up apt-get junk
apt-get autoremove
apt-get autoclean
apt-get clean

==Complete SD card backup Raspberry Pi==
This is a command that lets you make a COMPLETE image of any raspberry Pi sd card. You will need to do this from a linux PC (not the raspberry pi) so you will need to shut down your pi for a bit.
*Stick the Pi SD card into your main PC running linux
*make sure you have free space enough to backup the entire size of the card
*this will put the image in your home directory in the file rpifull.img
*this backs up the boot loader, and every 1 and 0 on the card
*find the name/location of your card (/dev/sdc) and replace below. Use the "df" command
umount /dev/sdc1
umount /dev/sdc2
dd if=/dev/sdc bs=1M of=~/rpifull.img

==Complete SD Card restore Raspberry Pi==
This will take the image you made above and restore it to any SD card of the same size (sometimes works with diff sizes but cant guarantee).
*Put the SD card from the pi into your main linux PC
*Replace any /dev/sdc with your memory card
umount /dev/sdc1
umount /dev/sdc2
dd if=~/rpifull.img bs=1M of=/dev/sdc

==Zerofree on Raspberry Pi==
I make frequent backups of my pi using the dd command because I test and install so many different guides, hardware and software. My 32gb SD card (class 10 UHS) writes an image file that is 32gb, so each time I compress it using gzip or bzip2 and end up with a 20GB image roughly. This has the unfortunate side effect of storing all of the trash 1's and 0's on the partition where files used to be. To reduce the size of my zipped backup (this can reduce ZIPPED size of an image, not image size itself) I ran zerofree to write zeros to the unused space.
*shutdown the pi and take out its memory card
*boot your main pc to linux (I used linux Mint 15)
*backup your pi using dd (do this BEFORE you mess anything up with zerofree)
*run zerofree on your sdcard
apt-get install zerofree
umount /dev/sdc1 (change sdc1 to your raspi boot partition location)
umount /dev/sdc2 (change sdc2 to your raspi ext4 partition)
zerofree -v /dev/sdc (replace sdc with your usb cards location, check the command "df")

==Mount Windows Share from Raspberry Pi==
create mount folder (do all of this as root)
mkdir /myserver
add share to auto-mount
vi /etc/fstab
add this line
//192.168.1.69/sharename /myserver auto,owner,rw,username=user1,password=hackme 0 0
test to make sure it works
mount -a
or
init 6
now check the folder after mount
cd /myserver
ls

==Setup Private Keys - Raspberry Pi==
This requires you to be logged into the Raspberry Pi on PuTTy or similar ssh client and logged into root

On the Raspberry Pi:
su
cd /root
mkdir .ssh
cd .ssh
ssh-keygen
cat id_rsa.pub > authorized_keys
chmod 600 authorized_keys

On your (Windows) computer:
#copy "id_rsa" from /root/.ssh on the pi to your computer
#open PuTTygen on windows
#load the private keyfile you just downloaded (id_rsa) Note: You will have to search for *.* All file types
#save as a putty private key file with extension .ppk
#load your RPi session in putty, and enter the key location and name in the SSH section

==Setup MPD and MPC - Raspberry Pi==
This guide will show you how to get Music Player Daemon (a SERVER that outputs to the pi audio, HDMI and regular, can be controlled locally or remotely) and Music Player Client to play music and command them from a terminal window or an MPD graphical client (to connect and control the music)
apt-get install mpd mpc
setup mpd
vi /etc/mpd.conf
setup these lines (just make the directory or file if it doesnt exist, use the touch command)
music_directory
playlist_directory
db_file
log_file
pid_file
state_file
sticker_file
bind_to_address (comment this line with a # at the start)
port "6600" (uncomment this line, remove the #)
user "pi"
metadata_to_use (uncomment)
mixer_type "software" (uncomment this line)
restart the pi
reboot (dont use init 6)
start MPD on the pi, look for errors
service mpd start
(wait until its done)
service mpd restart

Connect to mpd using a client on your main computer (I use Auremo MPD Client)
#download Auremo MPD Client (open source!)
#enter the ip in the setup for the pi
#click connect

==Text to Speech==
This is how to make your pi talk over its speakers using a generated voice
apt-get install festival
Now make it talk
echo "the time is" `date +%I` `date +%m` | festival --tts

==How to shutdown or restart the raspberry pi==
After using like 5 different Raspberry Pi's with multiple setups, OS, SD cards, and methods of restarting, I had found I was restarting and shutting down wrong and frequently destroying or losing files that were recently open or near to others in the data structure. I lost my entire first setup after 40 or so hours of learning and work due to using '''init 6''' to restart the pi.

You will find people that will tell you this is safe. They are correct-- most of the time. You can use the '''reboot''' command also but it does the same thing and is also unsafe.

My solution was to create a restart script that stops any services I can, then kills any running programs that could interfere with my file system if forced to shutdown too early, then waits 15 seconds and uses the shutdown command after the pause. I made this script reboot.sh to avoid data corruption on my pi (it happened 4 or 5 times!). Feel free to copy and modify to your taste.

echo "Beginning forced shutdown script"
#unmount my network share (cifs)
umount -f /jane
#cron triggers scripts all the time on my setup, kill it!
service cron stop
##service running my python buttons listen script
service pybuttons stop
killall python
service mpd stop
service ntp stop
service alsa-utils stop
service networking stop
service ssh stop
killall fbi
killall samba
killall mpd
killall mpc
killall vim
killall vi
killall omxplayer
killall sftp-server
killall python
#unmount my network share (cifs) again just in case!
umount -f /jane
sleep 15
shutdown -h -r now

==Bash Slideshow==
This program will run from runlevel 2 (command line only) if you want. It uses the Frame Buffer to display images in a slideshow. It preloads and caches images that are upcoming.
apt-get install fbi
Now create 2 scripts to turn on and off the slideshow
cd /home/pi
mkdir scripts
cd scripts
touch sson.sh
chmod +x sson.sh
touch ssoff.sh
chmod +x ssoff.sh
vi slideshow.sh
Now fill the file sson.sh with this
#!/bin/bash
PHOTODIR=/storage/wallpapers
INTERVAL=30
fbi -T 1 -cachemem 24 -readahead -autodown -t $INTERVAL -u `find $PHOTODIR -iname "*.jpg"`
And fill ssoff.sh with this
#!/bin/bash
killall fbi
Now trigger the slideshow on and off using the scripts
./sson.sh
./ssoff.sh

==Check the CPU Temperature Raspberry Pi==
Make a simple script that tells u the temperature of your raspberry pi's onboard temperature sensor (no, I dont know where it is!)

Make a file called degree.sh in your scripts directory (wherever you save urs)
touch degree.sh
chmod +x degree.sh
nano degree.sh
Now, Add these lines
#!/bin/bash
/opt/vc/bin/vcgencmd measure_temp
Save and exit. Test by using
sh degree.sh

==Setup LIRC on Raspberry Pi==
[[File:Raspberry-pi-infrared-sensor-diagram.png|thumb|right|alt RPi Connected to a TSOP4838 temperature sensor]]
This is a complicated guide to setting up LIRC on the Raspberry Pi to run remote commands.

'''Materials'''
*Vishay TSOP4838 $4 (aka 38kHz Infrared (IR) Receiver Module - Part Number 276-640 at Radio Shack)

Start by installing LIRC
apt-get install lirc

Now, edit the file /etc/lirc/hardware.conf
# /etc/lirc/hardware.conf
#
# Arguments which will be used when launching lircd
LIRCD_ARGS=""

#Don't start lircmd even if there seems to be a good config file
#START_LIRCMD=false

#Don't start irexec, even if a good config file seems to exist.
START_IREXEC=true

#Try to load appropriate kernel modules
LOAD_MODULES=true

# Run "lircd --driver=help" for a list of supported drivers.
DRIVER="default"
# usually /dev/lirc0 is the correct setting for systems using udev
DEVICE="/dev/lirc0"
MODULES="lirc_rpi"

# Default configuration files for your hardware if any
LIRCD_CONF=""
LIRCMD_CONF=""

Now edit the file '''/etc/modules''' and add this line
lirc_rpi

Now edit (or make) the file '''/lib/udev/rules.d/98-lircd.rules''' and add this line
KERNEL=="lirc[0-9]*", SUBSYSTEM=="lirc", SUBSYSTEMS=="platform", GOTO="begin"

Now test to see if receiver works, run this and press some buttons, see anything?
/etc/init.d/lirc stop
mode2 -d /dev/lirc0

Now setup your remote control or use a default lircd.conf for a remote on file with LIRC
Notes: setup as many or as few buttons as you want. I would recommend doing them all now.
irrecord --list-namespace (print or save this, you will need it during setup)
irrecord -d /dev/lirc0 ~/lircd.conf (follow instructions and use above command for key names)

Now copy the created ~/lircd.conf to its new home
mv /etc/lirc/lircd.conf /etc/lirc/lircd.original (backup original)
cp ~/lircd.conf /etc/lirc/lircd.conf (Copy it home)

Now test your keys and remote setup
service lirc restart
killall irexec
irw (now spam some buttons! Ctrl + C to exit)

Want to launch programs with your remote? Edit or create '''~/.lircrc''' ~/ means the users home directory
touch ~/.lircrc
vi ~/.lircrc

Add these lines to '''~/.lircrc'''
Note: Replace KEY_POWER with your key from your lircd.conf
Note: Use an & at the end of the config = line. It will run the command without making you wait for it to complete
begin
prog = irexec
button = KEY_POWER
config = /home/pi/gpio/11blink.sh &
end

Test... Again but this time to exec the program
killall irexec
service lirc restart
irexec -d (now test your button)

==Multi LED and Switch Control==
[[File:Rpi-buttons-led.png|right|thumb|alt Raspberry Pi with Buttons and LEDs]]

Under construction guides - Revision history

Ddxfish: Ddxfish moved page Raspberry Pi - Beginners Guides and Projects to Under construction guides