(1) raspberrypi document
https://www.raspberrypi.org/documentation/
翻译 2016.06.24
----------------------------------------
(2) 启动前的准备
#启动前的准备
一份启动你的树莓派的教程。
##你需要什么？
###必须的东西（一般情况下使用）
- SD卡
- 我们推荐8GB class 4的sdcard - 完美预装上了NOOBSX系统。【class4读取速度10+MB】
- 显示器和连接线
- 任何 HDMI或者DVI接口的现实器和电视都可以作为树莓派的显示器。为了最好的效果，找一个支持HDMI输入的，但是其他的旧式的设备一样支持。
- 键盘和鼠标
- 任何标准usb借口的键盘和鼠标都可以在树莓派上工作。
- 无线键鼠匹配好了也可以。
- 键盘的布局的配置见[raspi-config]
- 电源支持
- 树莓派的电源由USB micro接口供电，和大多数的手机充电器一样。
- 你需要一个质量好一点的电源供电，在型号3B的树莓派需要5v至少2A的供电，之前的低功耗的旧型号，至5v下700mA的供电电。
- 700mA的供电只能支持基础使用，如果需要更多能耗的话会导致树莓派重启。
##可选的
- 以太网网线（型号b或者b+）
- 一条以太网网线可以让你的pi连接上一个本地网或者互联网上。
- USB 无线网卡
- 你可以使用USB无线网卡连接上无线网络不过需要配置。
- 音频设备
- 可通过标准的3.5mm接口通过音箱或者耳机播放音频。
- 没有HDMI线，可以通过音频接口播放。
- 如果使用了hdmi借口连接了带扬声器的显示器，音频会直接通过hdmi传给显示器，但是你可能更喜欢用其他扬声器播放，就需要[配置一下]()
##处理问题
在准备启动时遇到了一些问题，可以在[论坛]上搜索解决问题的办法。如果你不能找到，可以发布你的问题，尽量提供一些细节。
----------------------------------------
(3) 安装
#安装
一些简单的教程，教你如何在你的树莓派上安装软件。
初学者可以用NOOBS开始，会让用户选择安装标准的发行版本。对于普通用户的发行版本是Raspbian，也提供其他的一些发行版本，比如OpenELEC（XBMC 媒体中心）或者 arch Linux。
## 目录
- [NOOBS]()
- [安装镜像]()
- [sd卡 (nyf://entry?itemid=1) ]()
----------------------------------------
(4) 安装操作系统镜像
#安装操作系统镜像
本文主要解释了如何将一个树没皮的系统镜像安装到一个sd卡上面。在安装镜像的时候需要另外一台电脑和一个sd卡的读卡器。
我们建议大多数的用户下载为了更方便安装而设计的NOOBS。然而，大多数进阶的用户安装一个特别的镜像应该应该会用到这个教程。
## 下载镜像
官方推荐的操作系统镜像可以从这个[页面]()上下载。
第三方也提供了一些可选择的发行版本。
在下载完zip文件之后，将img的镜像文件解压之后写入你的sd卡。
## 将镜像写入SD卡
根据你的选择下载相应的发行版，你需要使用镜像写入工具来把它安装到你的sd卡上。
根据你的操作系统来查看教程：
- Linux
- mac os
- [Windows]()
----------------------------------------
(5) sd卡
#SD卡
树莓派兼容任何兼容性的SD卡，但是还是要注意下面的一些：
- SD 卡的容量大小。安装NOOBS，至少需要8GB的容量。镜像安装，我们建议最少4GB，一些发行版可以在更小的卡里运行。特别是OpenELEC和Arch。
- SD卡的级别。卡的级别决定了持久的读写熟读，一个Class 4的卡写入速度4MB/s， class 10可以达到10MB/s。然而需要注意的是，这并不意味class 10的卡在日常使用中表现的比class 4要好，因为经常写入速度超过了读取速度，增加了搜索的次数。
- sd卡的尺寸。最开始的a和b型号需要全尺寸的sd卡。但是新的a+和b+和2b，zero和3b需要micro sd卡。
我们建议在这里购买树莓派的sd卡，其他的一些零售商可以买到。这是一个8GB大小的sd卡，class6，有大尺寸的sd卡套，比其他大多数的sd卡表现要好，是个不错的选择。
如果你在你的sd卡上遇到了一些问题，确定是否依照下面的一些步骤：
1. 确保你使用了一个正品的sd卡。有一些便宜的卡容量比宣传的容量要小，也不能使用多久。
2. 保证使用的质量的好的电源。你可以在在tp1和tp2之间测量你的电压，如果跌到了4.75v，恰好在做一些比较繁重的任务，就会变得很不稳定。
3. 保证你使用了好的usb电源线连接电源。如果你使用的电源线是质量的好电源，TP1到TP2的电压差还是在4.75v之下，大多是因为线的消耗，为了节约成本usb连接线会尽量减少铜，在这么长的线材上耗损1v（或者1w）的电压。
4. 在切断电源之前先关闭树莓派，输入sudo halt，等待树莓派的信号灯闪烁表示显示关闭。
5. 最后，超频使用pi也可能导致异常，这问题之前被修复过，但是仍然可能会发生。如果检查在检查了上面提到的几步，还是有问题的话，请让我知道。
----------------------------------------
(6) 使用
##使用
一些基础的使用例子，可以帮助里开始使用raspbian的一些软件。
目录：
- scratch
- scratch是一个可视的变成工具，可以让用户通过拖动和放置界面，做一些动画和游戏。
- python
- python 是一个广泛使用的变成语言，很容易入门，也很强大。
- Sonic pi
- 用sonic pi写代码制作音乐。
- 终端
----------------------------------------
(7) 远程访问
#远程访问
有时候你想要远程访问一个没有连接显示器的树莓派：比如，如果树莓派被嵌入了比如机器人的设备，如果你想要在别的地方查看它上面的一些信息，或者你刚好没有用多余的显示器。
##目录
- IP 地址
如何找到你的树莓派的ip地址，为了连接上它之需。
- 通过互联网连接
通过因特网连接上树莓派。
- VNC (nyf://entry?itemid=0)
远程访问树莓派的图形界面，就是在另外电脑上的一个窗口上访问。
- SSH
在另外电脑上访问树莓派的命令行。
- SFTP
在你的树莓派和另外的电脑之前用security FTP传输文件
- SCP
在你的树莓派和另外的电脑之前用Securiy copy传输文件
- SSHFS
在你的树莓派和另外的电脑之前用Security FTP传输文件
- rsync
在树莓派和其他电脑上同步文件，rsync通过ssh。
- FTP
在你的树莓派和另外的电脑之前用FTP传输文件
- Web 服务器
可以制作一个网站介绍显示一些信息，其他电脑可以通过一个浏览器来访问，通过网络，或者因特网。
----------------------------------------
(8) VNC
VNC 虚拟网络电脑
有时候不方便直接在树莓派上工作的时候，你可能想要通过在另外一台电脑上远程控制。
VNC是一个图形化的桌面分享系统，可以让你在一个电脑远程控制另外一个。它通过控制器传送鼠标和键盘的事件，然后接受远程计算机屏幕上的更新。
你会在你电脑上的一个窗口看到树莓派的桌面，你可以控制它，就像在树莓派上工作一样。
- 在你的树莓派上，使用显示器或者通过SSH远程连接，安装TightVNC安装包
sudo apt-get install tightvncserver
- 然后，运行TightVNC服务器，会提示你输入密码，然后会提示输入只观看的密码（为可选项）。
tightvncserver
- 在终端下运行一个VNC服务器。这条例子开启了一个全高清分辨率的VNC display（:1）
注意由于默认的x session从display 零开始，如果你使用:0的话，可能会获得一个错误信息。
- 由于现在有两个x 会话在运行，可能会比较消耗资源，建议关掉默认在:0运行的display管理器。使用如下命令：
service lightdm stop
- 现在，在你的电脑上，安装运行VNC客户端吧：、
- linux下可以安装xtightvncviewer
sudoinstall xtightvncviewer
- 其他的平台下的tightvnc可以从tightvnc.com下载
【停止vnc， vncserver -kill :1】
## 自动化然后开机时运行
你可以创建一个简单的写有命令的文件，用来在树莓派上运行VNC服务器，to save having to remember it：
- 创建一个包含下面shell脚本的文件：
#!/bin/sh
vncserver :1 -geometry 1920x1080 -depth 24 -dpi 96
- 保存为vnc.sh
- 让文件变成可执行的：
chmod +x vnc.sh
- 然后可以随时运行它：
./vnc.sh
- 如果你希望在vnc客户端上的鼠标作为箭头显示而不是默认的"x"，在/home/pi/.vnc/xstartup里添加一个选项给xsetroot：
-cursor_name left_ptr
开启启动：
- 在命令行里root登录：
sudo su
- 切换到/etc/init.d/目录
cd /etc/init.d/
- 创建一个包含下面脚本的文件
#! /bin/sh
# /etc/init.d/vncboot
### BEGIN INIT INFO
# Provides: vncboot
# Required-Start: $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start VNC Server at boot time
# Description: Start VNC Server at boot time.
### END INIT INFO
USER=pi
HOME=/home/pi
export USER HOME
case "$1" in
start)
echo "Starting VNC Server"
#Insert your favoured settings for a VNC session
su - $USER -c "/usr/bin/vncserver :1 -geometry 1280x800 -depth 16 -pixelformat rgb565"
;;
stop)
echo "Stopping VNC Server"
/usr/bin/vncserver -kill :1
;;
*)
echo "Usage: /etc/init.d/vncboot {start|stop}"
exit 1
;;
esac
exit 0
- 保存为vncboot（只是做个比方）
- 然后让文件可执行
chmod 755 vncboot
- 开启dependency-base的启动顺序
update-rc.d -f lightdm remove
update-rc.d vncboot defaults
- 如果启用了dependency-base启动顺序，你可以看到这个：
update-rc.d: using dependency based boot sequencing
- 重启你的树莓派，然后你可以发现vnc服务器已经在运行了。
你就可以在你的电脑或者笔记本上用vnc客户端程序远程连接服务器，然后控制树莓派了。根据你的电脑的操作系统依照下面说明去做：
- linux
- mac os
- windows