1. 目的
本教程旨在教您如何使用SiriControl开源Python框架在RaspberryPi项目中添加Siri功能和控制功能。
2. 概述
在本教程中，我将介绍如何设置和使用SiriControl Python框架。我将利用SiriControl模块和Raspberry Pi 3来点亮和熄灭一个LED。学完本教程之后，您将能够使用SiriControl将Siri语音命令添加到任何Raspberry Pi项目中。开始学习之前，请确保您拥有以下设备和材料，并确保已经安装RaspberryPi且软件能够正常运行。
3. 设备
- Raspberry Pi 3 – Raspberry Pi链接
- HDMI线–HDMI线链接
- LED – LED的Adafruit链接
- 鼠标 + 键盘 – 键盘/鼠标的Amazon链接
- 显示器/TV – 任何带HDMI接口的TV或显示器
- 跳线 – 跳线的Amazon链接
- Micro USB电缆 – Micro USB 电缆的Amazon链接
- 面包板 – 面包板的Amazon链接
4. 目录
- 为SiriControl创建一个Gmail帐户
- iOS设备设置
- SiriControl
- 设置SiriControl
- 创建自己的模块
- 电路接线
- 上传并运行程序
程序
1.0 为SiriControl创建一个Gmail帐户
SiriControl模块需要一个Gmail帐户才能工作。我创建了一个新的Gmail帐户，仅供SiriControl使用。我建议您也这样做。这是一个好主意，因为Python脚本可以包含该帐户的用户名和密码。
创建帐户后，我们需要允许不太安全的应用程序访问Gmail。这是因为Gmail服务器将Python脚本视为不太安全的应用程序。我们可以在Sign-in & Security（登录和安全） 部分进行设置。
图1：应用程序访问（关闭）
图2：应用程序访问（开启）
设置Gmail帐户的最后一步是启用IMAP协议。设置路径如下： Gmail->Settings->Gear Part->Settings->Forwarding and POP/IMAP->IMAP Access.
图3：IMAP（禁用）
图4：IMAP（启用）
2.0 iOS设备设置
将iOS设备上的“Notes”连至已经设置好与SiriControl配合使用的Gmail帐户。选择 Settings->Accounts & Passwords->Add Account（设置->帐户和密码->添加帐户）， 添加刚才设置好的Gmail帐户。添加该帐户后，选择它并启用Notes（图6：Gmail帐户下的Notes）。接下来，选择 Settings->Notes，并启用“On My iPhone” Account（我iPhone上的帐户）。 然后，将 Default Account 改为Gmail帐户。现在，我的iOS设备设置完毕。
图5：帐户和密码
图6：Gmail帐户下的Notes
图7：默认帐户-Notes
3.0 Siri控制
3.1 设置SiriControl
要使用SiriControl，我们需要将模块的资源库克隆到RaspberryPi。要做到这一点，请打开终端窗口并输入以下命令：
1. sudo apt-get update
2. sudo apt-get install git-core
3. git clone https://github.com/theraspberryguy/SiriControl-System
图8：克隆资源库
克隆资源库之后，打开脚本siricontrol.py。在脚本中输入Gmail帐户的用户名和密码，然后保存脚本。
3.2 创建自己的模块
Siricontrol.py 运行时，会从模块（modules）文件夹中加载模块脚本。执行不同的任务时，按照模板编写新的模块脚本很重要。因为我想控制一个LED，所以我写了一个脚本来打开LED (LED_on.py) 和一个脚本来关闭LED (LED_off.py).
要制作自己的模块，请在模板脚本中执行以下步骤：
1. 在“moduleName”中命名该模块
2. 为模块提供“commandWords”，以便让Siri执行命令。
3. 在execute(command) 函数下写入想要执行的功能。
4. 确保将脚本保存在模块文件夹中。
4.0 连接电路
为了让SiriControl执行命令，我搭建了一个简单的LED电路。我总是喜欢用Fritzing绘制接线图。Fritzing是一款开源原理图设计和PCB布线软件。Fritzing的下载地址（可选）如下：https://fritzing.org/home/
图9：Raspberry Pi LED原理图
LED和电阻应串联在引脚11（GPIO17）和引脚25（地）之间。电阻的作用是限制流过LED的电流，并应根据您的LED进行相应调整，以防止电流过大将LED烧坏。请记住，LED较长的引线是正极，应连接到引脚11。
5.0 上传并运行程序
完成上述步骤后，我使用以下命令运行SiriControl脚本：
python siricontrol.py
该脚本开始运行，并使用模块文件夹中的所有模块进行初始化。
图10：执行LED点亮
图11：执行LED熄灭
现在我命令Siri，“Note: Turn on LED（注意：打开LED）”，LED灯亮起，同时脚本会告诉我它执行了我的命令并且正在倾听另一个命令。我现在说，“Note: Turn off LED（注意：关闭LED）”，LED熄灭。只要符合以下条件，该脚本就会执行我（不管在任何地方）对Siri发出的命令：
1. Raspberry Pi正在运行该脚本。
2. Raspberry Pi已连至互联网，以便可以轮询Gmail帐户。
现在，您可以为任意Raspberry Pi项目添加任何SiriControl控制模块。虽然我在这个项目中使用了Pi，但是该教程在安装了Python的其他Linux开发板上同样可以工作。
6.0 附件：脚本
6.1 Siricontrol.py
import time
import imaplib
import email
import os
import pkgutil
##########################################
# Add your gmail username and password here
username = ""
password = ""
##########################################
class ControlException(Exception):
pass
class Control():
def __init__(self, username, password):
print("------------------------------------------------------")
print("- SIRI CONTROL -")
print("- Created by Sanjeet Chatterjee -")
print("- Website: thereallycoolstuff.wordpress.com -")
print("------------------------------------------------------")
try:
self.last_checked = -1
self.mail = imaplib.IMAP4_SSL("imap.gmail.com", 993)
self.mail.login(username, password)
self.mail.list()
self.mail.select("Notes")
# Gets last Note id to stop last command from executing
result, uidlist = self.mail.search(None, "ALL")
try:
self.last_checked = uidlist[0].split()[-1]
except IndexError:
pass
self.load()
self.handle()
except imaplib.IMAP4.error:
print("Your username and password is incorrect")
print("Or IMAP is not enabled.")
def load(self):
"""Try to load all modules found in the modules folder"""
print("\n")
print("Loading modules...")
self.modules = []
path = os.path.join(os.path.dirname(__file__), "modules")
directory = pkgutil.iter_modules(path=[path])
for finder, name, ispkg in directory:
try:
loader = finder.find_module(name)
module = loader.load_module(name)
if hasattr(module, "commandWords") \
and hasattr(module, "moduleName") \
and hasattr(module, "execute"):
self.modules.append(module)
print("The module '{0}' has been loaded, "
"successfully.".format(name))
else:
print("[ERROR] The module '{0}' is not in the "
"correct format.".format(name))
except:
print("[ERROR] The module '" + name + "' has some errors.")
print("\n")
def fetch_command(self):
"""Retrieve the last Note created if new id found"""
self.mail.list()
self.mail.select("Notes")
result, uidlist = self.mail.search(None, "ALL")
try:
latest_email_id = uidlist[0].split()[-1]
except IndexError:
return
if latest_email_id == self.last_checked:
return
self.last_checked = latest_email_id
result, data = self.mail.fetch(latest_email_id, "(RFC822)")
voice_command = email.message_from_string(data[0][1].decode('utf-8'))
return str(voice_command.get_payload()).lower().strip()
def handle(self):
"""Handle new commands
Poll continuously every second and check for new commands.
"""
print("Fetching commands...")
print("\n")
while True:
try:
command = self.fetch_command()
if not command:
raise ControlException("No command found.")
print("The word(s) '" + command + "' have been said")
for module in self.modules:
foundWords = []
for word in module.commandWords:
if str(word) in command:
foundWords.append(str(word))
if len(foundWords) == len(module.commandWords):
try:
module.execute(command)
print("The module {0} has been executed "
"successfully.".format(module.moduleName))
except:
print("[ERROR] There has been an error "
"when running the {0} module".format(
module.moduleName))
else:
print("\n")
except (TypeError, ControlException):
pass
except Exception as exc:
print("Received an exception while running: {exc}".format(
**locals()))
print("Restarting...")
time.sleep(1)
if __name__ == '__main__':
Control(username, password)
6.2 Led_on.py
#You can import any modules required here
import RPi.GPIO as GPIO #import GPIO module
import time
#This is name of the module – it can be anything you want
moduleName = “LED_on”
#These are the words you must say for this module to be executed
commandWords = [“turn”, “on”, “led”]
#This is the main function which will be execute when the above command words are said
def execute(command):
LED = 11 # Set LED pin to pin 11
GPIO.setmode(GPIO.BOARD)
GPIO.setup(LED, GPIO.OUT) #configure LED as an output
print(“\n”)
print(“LED is On.”)
6.3 Led_off.py
#You can import any modules required here
import RPi.GPIO as GPIO #import GPIO module
import time
#This is name of the module – it can be anything you want
moduleName = “LED_off”
#These are the words you must say for this module to be executed
commandWords = [“turn”, “off”, “led”]
#This is the main function which will be execute when the above command words are said
def execute(command):
LED = 11 # Set LED pin to pin 11
GPIO.setmode(GPIO.BOARD)
GPIO.setup(LED, GPIO.OUT) #configure LED as an output
print(“\n”)
print(“LED is off.”)
GPIO.output(LED, GPIO.LOW) #turn LED on
DevicePlus 编辑团队
设备升级版适用于所有热爱电子和机电一体化的人。
