树莓派“瑞士军刀”扩展板教程 V1.X TO V2.X 的适配说明

本文介绍在树莓派瑞士军刀扩展板升级到V2.0之后，如何对原先V1.X的教程做出适当修改之后应用到V2.0的方法。以下将通过链接引用V1.0的内容并附上差异说明和代码变更来对每一个DIY应用进行阐述。

开始之前，你需要了解SAKS V2.0在硬件和SDK上做了哪些变更，可以参考硬件变更、SDK变更：

由于V2.0的引脚顺序重新定义过，因此原有教程中的引脚编号对应表需要自行对应到新版本。另外，SDK升级说明中关于LED组的调用方法也请特别注意。虽然Github上我们将SDK的目录结构做了调整，但我们尽可能保证了对旧有代码的兼容性，main.py 主程序中对SDK的导入依然可沿用之前的方式无需变更。

Lv1，树莓派瑞士军刀扩展板上手把玩

1.1、轻松搞定 GPIO 开发环境（V1.X版例程）
环境的安装未变更。原例程中用了一个LED作为测试，由于新SAKS的LED必须通过寄存器来操作，因此这里先改用蜂鸣器来测试。在以后的教程中将说明LED组的使用方法。

对照原例程，Python代码修改为

# -*- coding: utf-8 -*-
import RPi.GPIO as GPIO
import time
# BOARD编号方式，基于插座引脚编号
GPIO.setmode(GPIO.BCM)
# 输出模式
GPIO.setup(12, GPIO.OUT)
 
while True:
    GPIO.output(12, GPIO.HIGH)
    time.sleep(1)
    GPIO.output(12, GPIO.LOW)
    time.sleep(1)

C代码修改为

#include <wiringPi.h>
int main(void)
{
    wiringPiSetup();
    pinMode (26, OUTPUT);
    for(;;)
    {
        digitalWrite(26, HIGH); delay (500);
        digitalWrite(26, LOW); delay (500);
    }
}

其他部分不变，测试效果为蜂鸣器发出哔声。

1.2、绚丽的流水灯（V1.X版例程）
SAKS V2.0 LED组的操作方式改用由一片74HC595芯片驱动，该芯片的使用方法查看这里。我们已经将该驱动封装在SAKS SDK中，要在SAKS上实现原文中的流水灯效果变得异常简易。而下面我们将介绍在不使用SDK的情况下如何驱动LED组以便大家能对LED组的操作原理有深入理解。

完整代码如下：

import RPi.GPIO as GPIO
import time

GPIO.setmode(GPIO.BCM)

DS = 6
SHCP = 19
STCP = 13

def init():
    GPIO.setup(DS, GPIO.OUT)
    GPIO.setup(SHCP, GPIO.OUT)
    GPIO.setup(STCP, GPIO.OUT)

    GPIO.output(DS, GPIO.LOW)
    GPIO.output(SHCP, GPIO.LOW)
    GPIO.output(STCP, GPIO.LOW)

def writeBit(data):
    GPIO.output(DS, data)

    GPIO.output(SHCP, GPIO.LOW)
    GPIO.output(SHCP, GPIO.HIGH)

#写入8位LED的状态
def writeByte(data):
    for i in range (0, 8):
        writeBit((data >> i) & 0x01)
    #状态刷新信号
    GPIO.output(STCP, GPIO.LOW)
    GPIO.output(STCP, GPIO.HIGH)

try:
    init()
    while True:
        #以下一组8个编码由一组二进制转换而成：
        #00000001,00000010,00000100,00001000,00010000,00100000,01000000,10000000
        #分别对应8个LED点亮状态
        for i in [0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80]:
            writeByte(i)
            time.sleep(0.1)
        #LED组全开
        #writeByte(0xff)
        #time.sleep(0.1)

except KeyboardInterrupt:
    print "except"
    #LED组全关
    writeByte(0x00)
    GPIO.cleanup()

在终端运行下载本教程的源码库并进入到对应的源码目录，执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/water-lights
sudo python waterlights.py

1.3、通过串口登录树莓派（V1.X版例程）
步骤和流程完全没有变，排针位置有调整，请按照扩展板上注释所示接线（RX、TX、GND 注释已标注）。
1054988163-0

1.4、红色警报器（V1.X版例程）
将原代码中关于LED的部分注释掉（舍去LED闪烁效果）、修改蜂鸣器的引脚编号后即可正常运行。

PIN_NO_BEEP = 12
#PIN_NO_LED = 7
 
GPIO.setmode(GPIO.BCM)
GPIO.setup(PIN_NO_BEEP, GPIO.OUT, initial=GPIO.HIGH)
#GPIO.setup(PIN_NO_LED, GPIO.OUT, initial=GPIO.HIGH)

# 单次哔声和LED发光
def beep(seconds):
    GPIO.output(PIN_NO_BEEP, GPIO.LOW)
    #GPIO.output(PIN_NO_LED, GPIO.LOW)
    time.sleep(seconds)
    GPIO.output(PIN_NO_BEEP, GPIO.HIGH)
    #GPIO.output(PIN_NO_LED, GPIO.HIGH)

在终端运行下载本教程的源码库并进入到对应的源码目录，执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/chime
sudo python chime.py

1.5、浪漫小夜灯（V1.X版例程）
SAKS SDK将大部分方法的调用均保持了兼容，仅需要使用最新的SAKS SDK V2.0，经过小幅的调整即可适配到SAKS V2.0。
新的SDK不再支持 SAKS.ledrow.items[n].on() 这种用法了，将原代码修改为 SAKS.ledrow.on_for_index(n) 即可。

在终端运行下载本教程的源码库并进入到对应的源码目录，执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/nightlight
sudo python main.py

Lv2，树莓派瑞士军刀扩展板进阶例程

2.1、呼吸灯（V1.X版例程）
呼吸灯需要对IO口作PWM控制，而由于SAKS V2.0用来驱动LED的74HC595芯片并不支持该模式，因此无法实现该例程中的呼吸灯效果。

2.2、数字闹钟（V1.X版例程）
SAKS SDK将大部分方法的调用均保持了兼容，仅需要使用最新的SAKS SDK V2.0，经过小幅的调整即可适配到SAKS V2.0。将原代码中关于LED的部分注稍作调整后即可正常运行，其中关于LED操作的代码。
SAKS.ledrow.items[6].off()
改为
SAKS.ledrow.off_for_index(6)

SAKS.ledrow.items[6].on()
改为
SAKS.ledrow.on_for_index(6)

在终端运行下载本教程的源码库并进入到对应的源码目录，执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/digital-clock
sudo python main.py

Lv3，树莓派瑞士军刀扩展板实用应用

3.1、数字温度计（V1.X版例程）
SAKS SDK将大部分方法的调用均保持了兼容，仅需要使用最新的SAKS SDK V2.0，经过小幅的调整即可适配到SAKS V2.0。本例程的代码仅需要将原SDK更新到SAKS SDK V2.0即可正常运行。
传感器安插位置和方向请参考下图：
1894376447-0
在终端运行下载本教程的源码库并进入到对应的源码目录，执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/temperature-display-ds18b20
sudo python main.py

3.2、CPU 温度显示和警报（V1.X版例程）
SAKS SDK将大部分方法的调用均保持了兼容，仅需要使用最新的SAKS SDK V2.0，经过小幅的调整即可适配到SAKS V2.0。本例程的代码仅需要将原SDK更新到SAKS SDK V2.0即可正常运行。
在终端运行下载本教程的源码库并进入到对应的源码目录，执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/CPU-temperature-display
sudo python main.py

3.3、树莓派关机键（V1.X版例程）
原例程中使用了单个LED的闪烁表示关机或重启前的状态。适配到SAKS V2.0上，我们需要对驱动LED的74HC595芯片操作方法做一个简单的封装来实现同样的效果。
修改后的完整代码如下：

import RPi.GPIO as GPIO
import time
import os,sys
import signal

#定义关机键和关机状态指示灯的GPIO引脚
GPIO.setmode(GPIO.BCM)
pin_btn = 20
DS = 6
SHCP = 19
STCP = 13

#初始化SAKS上相应按键，按键内部上拉
GPIO.setup(pin_btn, GPIO.IN, pull_up_down = GPIO.PUD_UP)

GPIO.setup(DS, GPIO.OUT)
GPIO.setup(SHCP, GPIO.OUT)
GPIO.setup(STCP, GPIO.OUT)

GPIO.output(DS, GPIO.LOW)
GPIO.output(SHCP, GPIO.LOW)
GPIO.output(STCP, GPIO.LOW)

#初始化按下关机键的次数
press_times = 0
#按下关机键后等待并倒数10次
count_down = 10
led_on_reboot = 0
led_on_halt = 0

def writeBit(data):
    GPIO.output(DS, data)

    GPIO.output(SHCP, GPIO.LOW)
    GPIO.output(SHCP, GPIO.HIGH)

#写入8位LED的状态
def writeByte(data):
    for i in range (0, 8):
        writeBit((data >> i) & 0x01)
    #状态刷新信号
    GPIO.output(STCP, GPIO.LOW)
    GPIO.output(STCP, GPIO.HIGH)

def onPress(channel):
    global press_times, count_down
    print('pressed')
    press_times += 1
    if press_times > 3:
        press_times = 1
    #重启模式
    if press_times == 1:
        #黄色LED亮
        writeByte(0x20)
        print('system will restart in %s' % (count_down))
    #关机模式
    elif press_times == 2:
        #红色LED亮
        writeByte(0x80)
        print('system will halt in %s' % (count_down))
    #模式取消
    elif press_times == 3:
        writeByte(0x00)
        print 'cancel'
        count_down = 10

#设置按键检测，检测到按下时调用 onPress 函数
GPIO.add_event_detect(pin_btn, GPIO.FALLING, callback = onPress, bouncetime = 500)

try:
    while True:
        #重启模式
        if press_times == 1:
            if count_down == 0:
                print "start restart"
                os.system("shutdown -r -t 5 now")
                sys.exit()
            led_on_reboot = not led_on_reboot
            #黄色 LED 闪烁
            if led_on_reboot:
                writeByte(0x20)
            else:
                writeByte(0x00)
        #关机模式
        if press_times == 2:
            if count_down == 0:
                print "start shutdown"
                os.system("shutdown  -t 5 now")
                sys.exit()
            led_on_halt = not led_on_halt
            #红色 LED 闪烁
            if led_on_halt:
                writeByte(0x80)
            else:
                writeByte(0x00)

        if press_times == 1 or press_times == 2:
            count_down -= 1
            print "%s second" % (count_down)
        time.sleep(1)
except KeyboardInterrupt:
    print('User press Ctrl+c, exit;')
finally:
    GPIO.cleanup()

在终端运行下载本教程的源码库并进入到对应的源码目录，执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/power-button
sudo python powerbutton.py

3.4、数字秒表（V1.X版例程）
SAKS SDK将大部分方法的调用均保持了兼容，仅需要使用最新的SAKS SDK V2.0，经过小幅的调整即可适配到SAKS V2.0。本例程的代码仅需要将原SDK更新到SAKS SDK V2.0即可正常运行。
在终端运行下载本教程的源码库并进入到对应的源码目录，执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/digital-stopwatch
sudo python main.py

Lv4，树莓派瑞士军刀扩展板挑战应用

4.1、PM2.5 指示灯（V1.X版例程）
SAKS SDK将大部分方法的调用均保持了兼容，仅需要使用最新的SAKS SDK V2.0，经过小幅的调整即可适配到SAKS V2.0。将原代码中关于LED的部分注稍作调整后即可正常运行。
SAKS.ledrow.items[n].on()
改为
SAKS.ledrow.on_for_index(n)

SAKS.ledrow.items[n].off()
改为
SAKS.ledrow.off_for_index(n)

在终端运行下载本教程的源码库并进入到对应的源码目录，将代码中的 cityid 和 key 根据实际情况替换。执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/pm25-display
sudo python main.py

4.2、站点宕机指示（V1.X版例程）
原例程中使用了单个LED的闪烁表示关机或重启前的状态。适配到SAKS V2.0上，我们需要对驱动LED的74HC595芯片操作方法做一个简单的封装来实现同样的效果。
关键代码修改如下：

def writeBit(data):
    GPIO.output(DS, data)

    GPIO.output(SHCP, GPIO.LOW)
    GPIO.output(SHCP, GPIO.HIGH)

#写入8位LED的状态
def writeByte(data):
    for i in range (0, 8):
        writeBit((data >> i) & 0x01)
    #状态刷新信号
    GPIO.output(STCP, GPIO.LOW)
    GPIO.output(STCP, GPIO.HIGH)

while True:
    check()
    #正常状态，绿灯亮
    if status == 200:
        writeByte(0x04)
    #异常状态，黄灯亮
    elif status == 500 or status == 404 or status == 403:
        writeByte(0x10)
    #错误状态，红灯亮
    else:
        writeByte(0x40)

在终端运行下载本教程的源码库并进入到对应的源码目录，执行运行脚本的指令可看到效果：

git clone https://github.com/spoonysonny/SAKS-tutorials.git
cd SAKS-tutorials/site-check
sudo python sitecheck.py

本文属于《树莓派瑞士军刀扩展板（SAKS）DIY 教程》系列文章，查看系列文章目录，请访问：https://shumeipai.nxez.com/swiss-army-knife-shield-for-raspberry-pi-diy-tutorials

这是一篇发布于 8年前的文章，其中的信息可能已经有所发展或是发生改变，请了解。

4,082

Humyem
2016年8月28日 at 00:14

蜂鸣器的那个例子里，蜂鸣器端口的GPIO.BCM的代码貌似不是32而是12噢

回复
- admin
  2016年8月29日 at 12:19
  
  已修正，感谢指正
xux
2017年10月21日 at 21:48

pi@xux:/xx/dao/test $ python bibi.py
bibi.py:7: RuntimeWarning: This channel is already in use, continuing anyway. Use GPIO.setwarnings(False) to disable warnings.
GPIO.setup(12, GPIO.OUT)
^CTraceback (most recent call last):
File “bibi.py”, line 11, in
time.sleep(1)
KeyboardInterrupt

运行脚本的时候如果在响的时候停掉，蜂鸣器可能会一直响

再次执行脚本的时候会如上报错

回复
admin
2017年10月21日 at 21:55

中断了一直响是正常的，因为电平没有被归位。脚本报错这个需要具体看代码。

回复
xux
2017年10月21日 at 22:08

请问怎么直接恢复所有电平？

回复

树莓派“瑞士军刀”扩展板教程 V1.X TO V2.X 的适配说明

Lv1，树莓派瑞士军刀扩展板上手把玩

Lv2，树莓派瑞士军刀扩展板进阶例程

Lv3，树莓派瑞士军刀扩展板实用应用

Lv4，树莓派瑞士军刀扩展板挑战应用

5 评论

发表评论取消回复

Lv1，树莓派瑞士军刀扩展板上手把玩

Lv2，树莓派瑞士军刀扩展板进阶例程

Lv3，树莓派瑞士军刀扩展板实用应用

Lv4，树莓派瑞士军刀扩展板挑战应用

5 评论

发表评论 取消回复

发表评论取消回复