Information for getting Peach Pi operational on your Raspberry Pi 3 (RPi3) Model B Disclaimer: This Peach Pi package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. ----------------------------------------------------------------------------------- The File you downloaded is a zip file and we zipped it with 7Zip. Most any zipping program should work to unzip the files. You can download a free copy of 7Zip from here: http://www.7-zip.org/ In the event that you do not have an internet connection the above 7Zip installation program for Windows is in the folder that you unzipped. Use the Hash Check System Included in the zip file is a text file named Hash Check. It is a good practice to always check the original Hash Check against the results that you get from a Hash Check. In Linux you can check the Hash with an application called GTKHash. In Windows you can download a free Hash Check program at: http://download.cnet.com/MD5-SHA-Checksum-Utility/3001-2092_4-10911445.html? In the event that you do not have an internet connection the above Hash Check installation program for Windows is in the folder that you unzipped. ----------------------------------------------------------------------------------- Suggested Usage and Warning: Peach Pi was built on a Raspberry Pi 3 (RPi3) Model B Quad-Core 1.2 GHz 1 GB RAM with On-board WiFi and with Bluetooth Connectivity. As of the writing of this help file, Peach OSI has not tested Peach Pi on anything other than the previously stated device the Raspberry Pi 3 (RPi3) Model B Quad-Core 1.2 GHz 1 GB RAM. Peach Pi should run on a Raspberry Pi 2 (RPi2)900 MHz quad-core ARM Cortex-A7 CPU with 1GB RAM but those devices may experience issues with the config.txt file because the config.txt file has been modified to overclock the Raspberry Pi 3. Users of the Raspberry Pi 2 - if attempting to run Peach Pi - should immediately go to the /boot/ folder and delete the config.txt file and replace it with the copy of the default config.txt file that is already stored in the /boot/ directory. Otherwise the existing config.txt file will be running your Raspberry Pi device overclocked with several overclocked settings. If you decide to run Peach Pi on any device - especially versions of Raspberry Pi that are not the Raspberry Pi 3 (RPi3) Model B - then you do so at your own risk. Please read through the entire help file before you attempt to install Peach Pi on any micro SD card an before running Peach Pi on any Raspberry Pi device. Again, by installing Peach Pi on any device you agree that you understand that peach OSI has no responsibility for any damages that may result from that or any subsequent installation(s). You also agree that you are doing so AT YOUR OWN RISK. ----------------------------------------------------------------------------------- Importance of using the right micro SD card. Of the foremost importance in using Peach Pi on your Raspberry Pi 3 (RPi3) Model B is the size, quality and speed of the SD card that you installed Peach Pi on to. We recommend Kingston, Sandisk or Patriot micro SD cards and we also recommend a 32GB SD card in either of those three flavors. Peach Pi will run on a 16GB SD card but we have found that the OS is more responsive with a 32GB SD card. We also suggest that you use an SD card with a speed rating of Class 10. Peach Pi will run on an 8GB SD card with a rating of 4 but the system will lag seriously without available storage and with such a slow speed class rating. ----------------------------------------------------------------------------------- Very Important: Once you get Peach Pi installed to your Raspberry Pi 3 (RPi3) Model B you will need the following. The username for this distro is peachuser. The password for this distro is also peachuser. All letters above are lowercase and there are no spaces. You should change your password for better protection and privacy of your Peach Pi installation on your Raspberry Pi 3 (RPi3) Model B. You can easily change your password by clicking on “Applications” in the taskbar at the top left of your screen in the upper taskbar – and then click on “Favorites” in the sub menu in the window that opens. The application that you need to open to change the password is named “Password”. Once you have the “Password” application open you need to enter the current password “peachuser” in order to change to a new password. You do not need to change the username. If you create a new user and password for yourself, (you will need to use a different application named “Users and Groups”) be sure to give that username administrative privileges or that username will not be able to use all of the functions and features of Peach Pi. The app for creating a new user is named “Users and Groups” and it is the second application listed in the same “Favorites” folder in the main “Applications” menu available at the top left of your screen. ----------------------------------------------------------------------------------- Burning Peach Pi to a micro SD Card ----------------------------------------------------------------------------------- Burn to micro SD card with Windows - Included in the zip file are two programs designed to work with Windows. The first program is SD Formatter and the other is Win32DiskImager. You will need to install both programs in order to burn the Peach Pi image file to your micro SD card. 1.) After installing the two above programs insert your micro SD card into your computer (however way you can access the micro SD card in your computer. I use a USB to micro SD card convertor.) 2.) Next open or run the SD Formatter program. The SD Formatter program should automatically detect your micro SD Card. Make absolutely sure that the drive letter depicted is the correct drive letter for your micro SD card. Click on the "Option" tab inside the SD Formatter program. Leave format type to "QUICK" but on the field labeled "Format Size Adjustment", switch that option to "On" and then click on "OK". Next click on "Format" in the main window. Answer yes to all the warnings and let the SD formatter program do its magic. 3.) Next open or run the Win32 Disk Imager program. The Win32 Disk Imager program should automatically detect your micro SD Card. Make absolutely sure that the drive letter depicted is the correct drive letter for your micro SD card. Click on the small blue folder next to your drive letter and navigate to the location where you have the Peach Pi file stored named PeachPi.armhf.16.04.LTS.img. Click on that file. Now simply click on "Write"and Win32 Disk Imager will write the Peach Pi image file to your micro SD card. Lastly, be sure to properly remove the micro SD card from the system and you should be good to install Peach Pi into your Raspberry Pi and boot with it. Be sure to expand the storage capability in the micro SD card as per the instructions in part 2 below in the section entitled "Normal Operation of your Raspberry Pi 3 (RPi3) Model B using Peach Pi. ----------------------------------------------------------------------------------- For Linux - 1.) Copy the Peach Pi image file (named: PeachPi.armhf.16.04.LTS.img) to the root of your (username) - (whatever username your Linux favor was installed with) folder. This folder is located in the /home/(username) folder. 2.) Insert your micro SD card into your computer (however way you can access the micro SD card in your computer. I use a USB to micro SD convertor.) 3.) If you need to format the micro SD card (such as a previously used micro SD card) in Linux we will use the fdisk commands. In a terminal, start fdisk /dev/sdx where /dev/sdx is your SD card device (may depend on the Linux distro you're using, see what's to follow). You can then delete all existing partitions on the device by typing d, and then adding a single new partition & format it. You an also just type n to create a new partition table, and start laying everything out. cfdisk is also another viable tool, which is basically fdisk with a greatly improved user interface. In both cases, once the drive is formatted, you will lastly need to mount it. If you're unable to determine the proper device, remove the SD card, run fdisk -l, and then re-run it with the SD card inserted. The micro SD card is the device that has been added. 4.) Your micro SD card needs to be unmounted so open a terminal and type sudo umount /dev/sdb1 /dev/sdb2 Remember you may need to change /dev/sdb , /dev/sdb1 and /dev/sdb2 depending where your system mounts your cards. It could be sde, sdc, etc. Just make sure that you do not use sda as that is your permanently installed hardrive or SSD drive. Again if you're unable to determine the proper device, remove the SD card, run fdisk -l, and then re-run it with the SD card inserted. The micro SD card is the device that has been added. If your version of Linux does not have dcfldd already installed for making card images, which is a replacement for the old dd disk duplication program, then you should install it now. dcfldd has a number of improvements, most notably a progress meter so you can see it working, and be confident that it hasn't crashed. Install dcfldd if you haven't already got it (it won't hurt to try to install it again if you already have it): In a terminal enter - sudo apt-get update && sudo apt-get install dcfldd Then type into the terminal to load the image onto your micro SD card. sudo dcfldd if=PeachPi.armhf.16.04.LTS.img of=/dev/sdb Again, remember you may need to change /dev/sdb depending where your system mounts your cards. It could be sde, sdc, etc. Just make sure that you do not use sda as that is your permanently installed hardrive or SSD drive. If the dcfldd command cannot find the PeachPi.armhf.16.04.LTS.img you will get an error messange stating the file is not found. Make sure that you have copied the file PeachPi.armhf.16.04.LTS.img to the /home/"username" directory in your Linux flavor and it should be placed in that directory along with the folders like "Desktop", "Documents", "Pictures", etc. After the transfer completes give it a couple of minutes to be sure everything is completely transfered and then in the terminal type sudo sync to clear the registers and then type into the terminal sudo shutdown -r now to shutdown your Linux PC. It is now safe to remove the micro SD card and install it into your Raspberry Pi 3 (RPi3) Model B. ----------------------------------------------------------------------------------- Normal Operation of your Raspberry Pi 3 (RPi3) Model B using Peach Pi While using Peach Pi on your Raspberry Pi 3 (RPi3) Model B you should follow these guidelines to help to make the most of your experience with Peach Pi on your Raspberry Pi 3 (RPi3) Model B. 1. Given that Peach Pi is built based a version of our Peach OSI – an Xubuntu derivative called Peach OSI Barebones – Peach Pi is designed to give the user a full desktop computer experience without having to know or learn the nuances of a Raspberry Pi or the Linux operating system. In running Peach Pi you need to be aware that your Raspberry Pi 3 (RPi3) Model B has been overclocked and that several other features for the Raspberry Pi 3 (RPi3) Model B have been optimized. These changes are made in the /boot/config.txt and /boot/cmdline.txt files and can be further altered you if should decide to do so. We have made backups of both default files and you can replace the current functioning file with the backup copy to return your Raspberry Pi 3 (RPi3) Model B to its default status. 2. Immediately upon loading up Peach Pi for the first time you need to expand the PI Root partition so that you can utilize any and all of the space on your micro SD card. For this process we will use the Gparted application. Open Gparted by clicking on “Applications” in the taskbar in the upper left of your screen. In the window that opens click on "Favorites" from the right side of the open Window. Gparted should be the third menu choice in the list that appears. Click on Gparted and give the password to open Gparted. (Password will be peachuser – unless you changed it). In Gparted – right click on the listed devices on the listed items that has a partition formatted with “ext4” (should be the second partition in the list). Click on “Resize/Move”. In the upper right of the window that opens you can see the heading “Maximum Size”. Fill in the box that reads “New Size” with the amount you can read in the “Maximum Size” data. Once you have “New Size” filled in properly click on the next box beside “Free Space Following (MiB) and the box should automatically populate to zero. If not then enter a numerical 0. Then click on “Resize” on the button on the lower right of the open window. You're not finished yet though. You must apply the changes. To apply the changes click on the green check mark in the menu near the top. Verify you want to make the changes and Gparted will do the rest. When Gparted finishes close Gparted and reboot. You should now have full access to all the space that's available on your micro SD card. 3. Connecting Peach Pi to your WiFi is a simple process to complete. In the right side of the top taskbar you can see an icon that looks like a radio signal or wave. Left click on that icon. The name of your particular WiFi should already be listed in the section named “WiFi Network” if your WiFi is on and in range. Click on the name of your WiFi and another window will open aloowing for you to enter your personal WiFi network key. Fill it in and hit enter. You should now be connected to your WiFi. 4. Always be sure to properly shut down your Raspberry Pi 3 (RPi3) Model B. Do not unplug the power cable until you’ve properly shut down Peach Pi. The easiest way to shut down Peach Pi is to click on the red shut down button in the taskbar to your far upper left. A window will open with the shutdown options. This is most important because failing to properly shut down your Raspberry Pi 3 (RPi3) Model B can severely corrupt your Micro SD card. 5. Try not to open more than one (two at most) applications at a time while using Peach Pi. Your Raspberry Pi 3 (RPi3) Model B has only 1GB of RAM available and if you attempt to utilize more memory than you have on-board – all operations will get very slow. 6. Peach Pi has been designed to monitor the temperature of your Raspberry Pi 3 (RPi3) Model B. If the temperature ever reaches 85 degrees Celsius your Raspberry Pi 3 (RPi3) Model B will automatically shut down to protect the Pi from overheating. 7. Run the “Updates” application at least once per week. Under normal usage you should get a notification if there are any available updates to Peach Pi. But it is still a good idea to check manually from time to time. There is an icon in the bottom dock for this purpose. It can be initiated by clicking on the orange circle icon with alternating arrows rotating within the orange circle icon. 8. Last but not least. The more things that you plug into your Raspberry Pi the slower the small device is going to run. Try to limit the USB devices that you plug-in to your Raspberry Pi. Never unplug a USB device without Unmounting it or ejecting it first by right clicking on that devices icon that’s on the desktop. Also, never remove the SD card without shutting down first. Doing so can corrupt the SD card and any USB stick that was inadvertently removed from the Pi without properly following the procedure needed to remove the device from the system. ----------------------------------------------------------------------------------- For more information and help you'll find a handy read-me file on your desktop once you boot into Peach Pi. Be sure to read through that file as it has tons of information that you may need in completing your transformation from a standard Raspberry Pi 3 (RPi3) Model B to a fully functional Peach Pi. That file will show you how to backup your micro SD card, how to expand the partition to use the full micro SD card and how to get the most out of your Raspberry Pi 3 (RPi3) Model B with Peach Pi installed.