搭配 树莓派 使用

硬件连接

连接树莓派的时候，可以直接将板子插到树莓派的 40PIN 排针上去，注意对好引脚。
如果是选择用 9PIN 排线连接的话，请参考下方的引脚对应表格：

树莓派连接引脚对应关系

e-Paper	Raspberry Pi	Raspberry Pi
BCM2835编码	Board物理引脚序号
VCC	3.3V	3.3V
GND	GND	GND
DIN	MOSI	19
CLK	SCLK	23
CS	CE0	24
DC	25	22
RST	17	11
BUSY	24	18
PWR	18	12

开启SPI接口

• 打开树莓派终端，输入以下指令进入配置界面：

  sudo raspi-config
  选择Interfacing Options -> SPI -> Yes 开启SPI接口

• 重启树莓派：

  sudo reboot

• 检查 /boot/config.txt，可以看到 'dtparam=spi=on' 已被写入

• 为了确保 SPI 没有被占用，建议其他的驱动覆盖暂时先关闭。可以使用 ls /dev/spi* 来检查 SPI 占用情况，终端输出 /dev/spidev0.0 和 /dev/spidev0.1 表示 SPI 情况正常

运行C语言例程

• 安装 lg 库

  #打开树莓派终端，并运行以下指令：
  wget https://github.com/joan2937/lg/archive/master.zip
  unzip master.zip
  cd lg-master
  make
  sudo make install
  # 更多的可以参考源码：https://github.com/gpiozero/lg

• 安装 gpiod 库（可选）

  #打开树莓派终端，并运行以下指令：
  sudo apt-get update
  sudo apt install gpiod libgpiod-dev

• 安装 BCM2835（可选）

  #打开树莓派终端，并运行以下指令：
  wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz
  tar zxvf bcm2835-1.71.tar.gz 
  cd bcm2835-1.71/
  sudo ./configure && sudo make && sudo make check && sudo make install
  # 更多的可以参考官网：http://www.airspayce.com/mikem/bcm2835/

• 安装 wiringPi（可选）

  #打开树莓派终端，并运行以下指令：
  sudo apt-get install wiringpi
  #对于树莓派2019年5月之后的系统（早于之前的可不用执行），可能需要进行升级：
  wget https://project-downloads.drogon.net/wiringpi-latest.deb
  sudo dpkg -i wiringpi-latest.deb
  gpio -v
  # 运行 gpio -v 会出现 2.52 版本，如果没有出现，说明安装出错。
  
  #Bullseye 分支系统使用如下命令：
  git clone https://github.com/WiringPi/WiringPi
  cd WiringPi
  ./build
  gpio -v
  # 运行 gpio -v 会出现 2.60 版本，如果没有出现，说明安装出错。

• 下载程序（已下载可跳过）

  wget https://www.waveshare.net/w/upload/8/8d/3in97_e-Paper_G.zip
  unzip 3in97_e-Paper_G.zip -d 3in97_e-Paper_G
  cd 3in97_e-Paper_G/RaspberryPi_JetsonNano/

• 备用解压方式

  sudo apt-get install p7zip-full
  7z x 3in97_e-Paper_G.zip -O./3in97_e-Paper_G
  cd 3in97_e-Paper_G/RaspberryPi_JetsonNano/

• 通过 GitHub 下载程序（备用方式，已下载可跳过）

目前访问 GitHub 并不是很流畅，建议使用上面的方法从我们官网下载。

git clone https://github.com/waveshare/e-Paper.git
cd e-Paper/E-paper_Separate_Program/3in97_e-Paper_G/RaspberryPi_JetsonNano/

• 编译程序（说明：-j4 为使用4线程编译，数字可自行修改；）

  # 此时在 3in97_e-Paper_G/RaspberryPi_JetsonNano 位置
  cd c
  sudo make clean
  sudo make -j4

• 运行程序

  sudo ./epd

运行python例程

• 虚拟环境安装

在最新版本的系统中，python的库有些无法正常安装，需要使用虚拟环境，然后进行安装库然后运行程序 虚拟环境配置、运行、退出

# 安装虚拟环境需要的库
sudo apt-get update
sudo apt-get install git python3-pip -y
sudo apt install python3-venv

# 创建一个新的虚拟环境（myenv 这个是虚拟环境的名称，可以进行修改）
python3 -m venv myenv

# 激活虚拟环境
source myenv/bin/activate

# 安装库（见Wiki对应位置）

# 下载例程（见Wiki对应位置）

# 运行例程（见Wiki对应位置）

# 退出虚拟环境
deactivate

• 安装函数库

  sudo apt-get update
  sudo apt-get install python3-pip
  sudo apt-get install python3-pil
  sudo apt-get install python3-numpy
  sudo pip3 install spidev

• 安装函数库（python2）

  sudo apt-get update
  sudo apt-get install python-pip
  sudo apt-get install python-pil
  sudo apt-get install python-numpy
  sudo pip install spidev

• 安装gpiozero库（系统默认已安装，如果没有安装请按照以下命令进行安装）

  sudo apt-get update
  # python3
  sudo apt install python3-gpiozero
  # python2
  sudo apt install python-gpiozero

• 下载程序（已下载可跳过）

  wget https://www.waveshare.net/w/upload/8/8d/3in97_e-Paper_G.zip
  unzip 3in97_e-Paper_G.zip -d 3in97_e-Paper_G
  cd 3in97_e-Paper_G/RaspberryPi_JetsonNano/

• 备用解压方式

  sudo apt-get install p7zip-full
  7z x 3in97_e-Paper_G.zip -O./3in97_e-Paper_G
  cd 3in97_e-Paper_G/RaspberryPi_JetsonNano/

• 通过 GitHub 下载程序（备用方式，已下载可跳过）

目前访问 GitHub 并不是很流畅，建议使用上面的方法从我们官网下载。

git clone https://github.com/waveshare/e-Paper.git
cd e-Paper/E-paper_Separate_Program/3in97_e-Paper_G/RaspberryPi_JetsonNano/

• 运行程序

  # 确保在 3in97_e-Paper_G/RaspberryPi_JetsonNano/ 位置
  cd python/examples/
  python3 epd_3in97g_test.py