电子说
Slack是一款在线协作软件,可以让你与团队成员进行聊天、文件传送、语音/视频通话等功能。Slack还可以整合多种工具和服务,如电子邮件、Google Drives、Twitter、Trello等,以提高工作效率和自动化任务。有App方便大家在手机或平板电脑上使用。
这次要实现的树莓派Pico W远程控制机器人,简单来说,就是我们在手机上用Slack发消息,指挥Pico W帮我们干活。
Slack 的 chat.postMessage API 可将消息从开发板发送到 Slack 频道。Slack 为应用和机器人提供了一个事件 API,用于响应 Slack 上的活动。由于开发板不能从公共互联网直接访问,因此无法使用公共 HTTP webhook。
我们必须使用Slack 的Socket Mode。 Socket Mode使应用和机器人能够使用动态的WebSocket 接收事件。动态套接字的URL可以通过Slack的apps.connections.open API获取。
Pico W与Slack API 接收事件和发送消息的通信机制:
要完成上述操作,你必须先有Slack令牌。
配置 Slack
在 Web 浏览器中访问:
并使用您的 Slack 凭据登录,单击“创建新应用”按钮。
单击“From scratch”选项。
输入应用程序的名称(例如“Pico W”),为应用程序选择一个工作区,然后单击“创建应用程序”按钮。
单击左侧的“Socket Mode”部分,然后单击切换到“启用Socket Mode”。
输入应用级令牌的“Token Name”,例如“Pico W app”,然后单击“生成”按钮。
生成并显示应用级令牌,复制该值并保存以备将来使用,然后单击“完成”按钮。
单击左侧的“OAuth 和权限”部分,向下滚动到“Scopes”部分,然后单击“添加 OAuth 范围”按钮。
添加“app mention:read”权限。
添加“chat:write”权限。
单击左侧的“事件订阅”部分,然后单击“启用事件”开关。
展开“订阅bot事件”部分并单击“添加bot用户事件”按钮。
选择“app_mention”。
点击右下角的“保存更改”按钮。
点击左侧的“基本信息”部分,然后点击“请求安装”按钮。
填写“简短描述”,选择“背景颜色”,点击“保存更改”按钮
工作区管理员可以批准申请。然后转到“基本信息”部分,单击“安装到工作区”按钮。
安装完成后,单击左侧的“OAuth & Permissions”部分,滚动到“工作区的OAuth Token”部分,然后复制“Bot User OAuth Token”值并保存以供将来参考。
现在你有了一个应用程序级别的令牌值和一个Slack应用程序的Bot用户OAuth令牌值,可以在Raspberry Pi Pico W板上使用。
基于 MicroPython 的 Slack 机器人
MicroPython 为许多基于Arm Cortex-M 的微控制器提供Python 3实现,包括 Raspberry Pi Pico W上的RP2040。
Thonny IDE 将用于安装 MicroPython 并将代码上传到 Raspberry Pico W。
从 Thonny 主页下载适用于您的计算机的操作系统 (OS) 专用版本的 Thonny。在撰写本指南时,Thonny 4.1.2 是最新版本。
用Thonny刷好MicroPython以后,将 GitHub 中的代码下载到计算机上的文件夹。
相关代码:
https://github.com/IoToutpost/example-of-a-slackbot-for-pico-w
打开 Raspberry Pi Pico W 板上的 config.py 文件,填写 Wi-Fi 网络的 SSID 和密码,以及之前配置的 Slack 应用和机器人令牌。
打开树莓派Pi Pico W板上的 main.py 文件,然后按绿色的播放按钮运行应用程序。如果一切配置正确,开发板现在将连接到您的 Wi-Fi 网络,然后连接到 Slack。
基于 C 语言的 Slack 机器人
对于 C 版本,以下库将与pico-sdk一起使用:
FreeRTOS 内核 – 为网络堆栈提供实时操作系统(RTOS)
lwIP – 用于 TCP/IP 通信
Mbed TLS – 用于 TLS 通信
coreHTTP – 用于 HTTP 客户端
cJSON – 用于解析和序列化 JSON 数据
使用 Raspberry Pi 的 Pico SDK 和所需的工具链设置您的计算机。
有关更多信息,请参阅 Raspberry Pi Pico 入门指南。
在终端窗口中,设置 PICO_SDK 环境变量:
export PICO_SDK_PATH=/path/to/pico-sdk
将目录更改为下载示例代码的位置,然后将目录更改为文件夹:pico-sdk
cd path/to/example-of-a-slackbot-for-pico-w
cd pico-sdk
创建一个构建目录,并将目录更改为该目录:
mkdir build
cd build
使用你的 Wi-Fi SSID 和密码以及 Slack 应用和机器人令牌运行,然后运行以编译应用程序。
cmake .. -DPICO_BOARD=pico_w -DWIFI_SSID="
-DWIFI_PASSWORD="
-DSLACK_APP_TOKEN="
-DSLACK_BOT_TOKEN="
make
按住Pico W上的BOOTSEL按钮,同时将USB电缆插入计算机。
将文件复制到挂载的Raspberry Pi Pico,
启动ROM磁盘:picow_slack_bot.uf2
cp -a picow_slack_bot.uf2
/Volumes/RPI-RP2/.
使用串行监视器应用程序(如屏幕)查看主板的 USB 串行输出,
将 /dev/cu.usbmodem00000000000001 替换为主板的路径:
screen /dev/cu.usbmodem0000000000001
如果一切配置正确,开发板现在将连接到您的 Wi-Fi 网络,然后连接到 Slack。
在计算机上打开 Slack,并创建一个新的测试频道。在信息输入窗口中输入,然后点按绿色按钮或按回车键发送。@
由于 Pico W 不在频道中,系统将提示您添加它们。点击“邀请他们”按钮。
被邀请后,开发板将点亮 LED, 然后回复消息告知状态。您也可以尝试发送消息以关闭 LED。@
结论
本指南介绍了通过Raspberry Pi Pico W上运行MicroPython和C应用程序,来与Slack API发送和接收消息。
示例应用程序代码可以接收并处理消息文本,以控制板载 LED,然后将 LED 的当前状态告知用户。
你可以在自己的Raspberry Pi Pico W上尝试一下,然后在示例代码的基础上构建更多功能,从而将 Slack 扩展到物理世界。
作者:Sandeep Mistry 编译:IoT前哨站
审核编辑:汤梓红
全部0条评论
快来发表一下你的评论吧 !