Alexa控制的門牌演示

平臺提供的設(shè)備端點的 REST API 使將設(shè)備集成到其他平臺（此處為 AWS 平臺）上的應(yīng)用程序變得容易。

首先按照如下文檔從云控制臺創(chuàng)建一個設(shè)備：

?

?

?

?

?

1 / 8 ?在“設(shè)備”部分下單擊“添加設(shè)備”

?

按照這些說明設(shè)置您的 Arduino IDE 和Arduino MKR1000 的本部分。上傳自定義示例草圖后...

#define _DEBUG_
#define _DISABLE_TLS_
#include 
#include 
#define USERNAME "3magku"
#define DEVICE_ID "DoorSign"
#define DEVICE_CREDENTIAL "Iq7OxG4htORD"
#define SSID "yourWifiSsid"
#define SSID_PASSWORD "yourWifiPassword"
#define LED_PIN 6
ThingerWifi101 thing(USERNAME, DEVICE_ID, DEVICE_CREDENTIAL);
void setup() {
 Serial.begin(115200);
 // configure wifi network
 thing.add_wifi(SSID, SSID_PASSWORD);
 pinMode(LED_PIN, OUTPUT);
 // pin control example (i.e. turning on/off a light, a relay, etc)
 thing["led"] << digitalPin(LED_PIN);
 // resource output example (i.e. reading a sensor value, a variable, etc)
 thing["millis"] >> outputValue(millis());
 // more details at http://docs.thinger.io/arduino/
}
void loop() {
 thing.handle();
}

...您的設(shè)備狀態(tài)在云控制臺中應(yīng)如下所示：

?

設(shè)備在線

?

微雪1.54寸電子紙模組

微 雪1.54英寸電子紙模組是一款采用微封裝電泳顯示技術(shù)MED圖像顯示技術(shù)的電子紙設(shè)備。

電子紙屏幕通過反射環(huán)境光來顯示圖案，不需要背景光。一旦設(shè)置/更新顯示模式，模塊在待機(jī)模式下的功耗極低（5 uA = 0.000005 A）

由于 Arduino MKR1000 提供比 Arduino UNO/Mega 多得多的 SRAM，并且基于 3.3 V 電壓，因此它是與 Waveshare 1.54 英寸電子紙模塊一起使用的相當(dāng)大的平臺。電子紙顯示器的極低功耗使得在電池供電時嘗試將其連接到像 MKR1000 這樣的電路板更加有趣。

要將顯示模塊連接到 MKR1000 并在其上運行供應(yīng)商的示例程序，您基本上可以按照供應(yīng)商文檔中“使用 Arduino”的說明進(jìn)行操作，并考慮 MKR1000 和 UNO 之間引腳布局的一些差異：

MKR1000 上的SPI引腳是D8 (MOSI) 、D9 (SCK)和 D10 (MISO) - UNO 上的 SPI 引腳是 D11 (MOSI)、D12 (MISO) 和 D13 (SCK)。

按照Waveshare Wiki 頁面的說明，必須將兩個 SPI 信號 SCK 和 MOSI 重新映射到 MKR1000 的 D9 和 D8。其余信號如 CS、DC、RST 和 BUSY 可以自由映射到 MKR1000 的其他數(shù)字信號。

這是將模塊與 MKR1000 接線的擴(kuò)展映射表：

?

引腳和電線；將電子紙模塊連接到 MKR1000

?

生成的接線如下所示：

?

接線（架構(gòu)）

?

真正的原型設(shè)置如下所示：

?

測試電子紙模塊設(shè)置

?

要運行供應(yīng)商提供的示例和您自己的草圖，需要對提供的庫代碼進(jìn)行一些小的更改：

• 從https://www.waveshare.com/wiki/File:1.54inch_e-Paper_Module_code.7z下載代碼和庫并解壓包。

• 將demo包的arduino/libraries目錄下的文件復(fù)制到documents/arduino/libraries，實際路徑由Arduino IDE --> File --> Preferences -->Sketchbook location決定。

• 在文件libraries/ep1in54/epdif.h中進(jìn)行以下更改以反映 MKR1000 修改后的引腳映射：

#ifndef EPDIF_H
#define EPDIF_H
#include 
/* COMMENT OR REMOVE THIS SECTION: 
// Pin definition
#define RST_PIN 8
#define DC_PIN 9
#define CS_PIN 10
#define BUSY_PIN 7
*/
/* ADD THE FOLLOWING SECTION: */
// Custom pin definition (MKR1000)
#define RST_PIN 4
#define DC_PIN 5
#define CS_PIN 7
#define BUSY_PIN 3
class EpdIf {

• 編譯并上傳演示草圖 epd1in54-demo 以測試模塊和您的設(shè)置。

門牌 - 應(yīng)用

門牌應(yīng)用程序是前面部分中兩個示例草圖的簡單組合：用??于測試Thinger.io連接性的草圖和 Waveshare 提供的 ep1in54-demo 草圖。

對于這個演示，我們基本上：

• 創(chuàng)建三個小的 (200 x 200 px) 單色位圖并將這些圖像轉(zhuǎn)換為 C 字節(jié)數(shù)組 - 請參閱 Waveshare wiki 中的“如何顯示圖像”部分。

?

?

?

?

?

1 / 3 ?打開

?

• 在草圖中包含這些位圖數(shù)組：

/* "imagedata_open.h" */
extern const unsigned char IMAGE_DATA_OPEN[];
/* "imagedata_open.coo" */
#include "imagedata_open.h"
#include 
const unsigned char IMAGE_DATA_OPEN[] PROGMEM = {
/* 0X00,0X01,0XC8,0X00,0XC8,0X00, */
0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff, ...
// Image data for "We are open", "Sorry, we are closed" and "Be right back" ...
#include "imagedata_open.h"
#include "imagedata_closed.h"
#include "imagedata_brb.h"

• 為thinger.io定義輸入資源和處理程序以接收參數(shù)以選擇要顯示的圖像：

// Handle for "image" resource:
 thing["image"] << [](pson &in) {
   boolean clean = in["clean"];
   int number = in["number"];
   displayImage(clean, number);
 };
// Handler called function for displaying images:
void displayImage(boolean clean, int number)
{
 if (clean) { ePaperClear(); }
 const unsigned char *image_data;
 switch (number)
 {
   case 0:
     image_data = IMAGE_DATA_OPEN;
     break;
   case 1:
     image_data = IMAGE_DATA_AWAY;
     break;
   case 2:
     image_data = IMAGE_DATA_CLOSED;
     break;
 }
 ePaperShowImage(image_data);
}
// Clear e-ink display:
void ePaperClear()
{
 epd.ClearFrameMemory(0xFF);   // bit set = white, bit reset = black
 epd.DisplayFrame();
 epd.ClearFrameMemory(0xFF);   // bit set = white, bit reset = black
 epd.DisplayFrame();
 epd.Init(lut_partial_update);
}
// Display image on e-ink display:
void ePaperShowImage(const unsigned char image_data[])
{
 epd.SetFrameMemory(image_data);
 epd.DisplayFrame();
 epd.SetFrameMemory(image_data);
 epd.DisplayFrame();
 epd.Init(lut_partial_update);
}

完整的代碼可以在這里找到。

編譯、上傳和運行代碼后，設(shè)備應(yīng)在thinger.io設(shè)備狀態(tài)板上顯示為在線，單擊查看 API按鈕后，您應(yīng)該會在DOORSIGN API中看到先前定義的輸入資源為圖像 - 私有。當(dāng)您展開此項時，您將看到輸入參數(shù)，并且您將能夠向您的設(shè)備發(fā)送請求：

?

?

?

?

?

1 / 6 ? DOORSIGN 儀表板

?

如果您選擇顯示查詢，則顯示的 REST 調(diào)用稍后將在 AWS Lambda 函數(shù)中使用。

可以在此處找到有關(guān)thinger.io服務(wù)器 API的更多信息。

Alexa 技能

從Amazon Developer Console開始創(chuàng)建 Alexa Skill ：

• 將技能類型保留為自定義交互模型。

• 如果您的設(shè)備使用英語（英國），請將語言更改為英語（英國）。

• 選擇一個名稱，例如“門牌”。

• 將所有其他全局字段保留為否。

• 保存。

• 請注意下一個屏幕上新創(chuàng)建的應(yīng)用程序 ID 。

• 單擊下一步。

?

?

?

?

?

1 / 5 ?開發(fā)者控制臺

?

接下來定義

• Intent Schema （見下文）

{
 "intents": [
    {
 "slots": [
        {
 "name": "Status",
 "type": "STATUS_TYPE"
        }
      ],
 "intent": "ShowStatus"
    },
    {
 "intent": "AMAZON.HelpIntent"
    },
    {
 "intent": "AMAZON.StopIntent"
    }
  ]
}

• 自定義插槽類型“STATUS_TYPE” ，值為“ open ”、“ away ”和“ closed ”

• 和示例話語（見下文）

ShowStatus display that we are {Status}
ShowStatus show that i am {Status}
ShowStatus we are {Status}
ShowStatus i am {Status}

?

?

?

?

?

1 / 5 ?交互模型：意圖模式

?

AWS 拉姆達(dá)

作為技能的端點，我們創(chuàng)建了一個 AWS Lambda 函數(shù)。

• 登錄AWS 管理控制臺，

• 選擇所有服務(wù) > 計算 > Lambda

• 選擇創(chuàng)建函數(shù)

• 通過輸入“alexa”選擇藍(lán)圖和過濾器

• 選擇任何藍(lán)圖，例如alexa-skill-kit-sdk-factskill (Node.js)，然后單擊配置

• 為您的功能選擇一個名稱，例如myDoorSign

• 選擇現(xiàn)有角色或定義新角色（參見此處）

• 函數(shù)創(chuàng)建成功后：

• 添加類型為Alexa Skills Kit的觸發(fā)器，并通過輸入先前創(chuàng)建的 Alexa Skill的應(yīng)用程序 ID對其進(jìn)行配置。

• 在函數(shù)代碼部分，選擇文件 index.js 的內(nèi)聯(lián)編輯器中的所有代碼，并通過粘貼以下代碼替換它：

'use strict';
/*
 * App ID for the skill
 */
var APP_ID = "REPLACE_ME__ALEXA_APP_ID";
var SKILL_NAME = "REPLACE_ME__ALEXA_SKILL_NAME";
/*
 * Alexa SDK
 */
var Alexa = require('alexa-sdk');
/*
* HTTP/HTTPS
*/
var https = require('https');
/*
 * Thinger.io device
 */
const ti_user = "REPLACE_ME__THINGER_IO_USER";
const ti_device = "REPLACE_ME__THINGER_IO_DEVICE_ID";
const ti_token = "REPLACE_ME__THINGER_IO_ACCESS_TOKEN";
const ti_api_host = "api.thinger.io"
const ti_api_port = 443;
const ti_api_base_path = "/v2/users/" + ti_user + "/devices/" + ti_device + "/";
/*
 * Register handlers
 */
exports.handler = function (event, context, callback) {
 var alexa = Alexa.handler(event, context);
 alexa.appId = APP_ID;
 alexa.registerHandlers(handlers);
 alexa.execute();
};
var handlers = {
 /*
     * The "ShowStatus" intent:
     */
 "ShowStatus": function () {
 var myHandler = this;
 var speechOutput;
 var cardTitle;
 var statusSlot = this.event.request.intent.slots.Status;
 var status = "open";
 var imageNumber = 0;
 // Get slot(s):
 if (statusSlot && statusSlot.value) {
 status = statusSlot.value.toLowerCase();
        }
 // Determine image number from status:
 switch (status) {
 case "open":
 imageNumber = 0;
 break;
 case "closed":
 imageNumber = 2;
 break;
 case "away":
 imageNumber = 1;
 break;
 default:
 imageNumber = 0;
 break;
        }
 // Build path:
 var ti_api_path = ti_api_base_path + "image";
 // Build request body:
 var ti_input = { in: {
 clean: true,
 number: imageNumber
            }
        };
 // Build POST request:
 var request_body = JSON.stringify(ti_input);
 var request_headers = {
 "Authorization": "Bearer " + ti_token,
 "Content-Type": "application/json",
 "Content-Length": Buffer.byteLength(request_body)
        }
 var request_options = {
 host: ti_api_host,
 port: ti_api_port,
 path: ti_api_path,
 method: "POST",
 headers: request_headers
        }
 console.log("REQUEST - HEAD:" + JSON.stringify(request_options));
 console.log("REQUEST - BODY:" + JSON.stringify(request_body));
 // Handle POST request:
 var request = https.request(request_options, function (r) {
 console.log("RESPONSE - STATUS:" + r.statusCode);
 r.on('data', function (d) {
 console.log("RESPONSE:" + d);
 var d_json = JSON.parse(d);
            });
 r.on('end', function () {
 console.log("END: returning speech output ...");
 speechOutput = "The door sign has been updated successfully! The new status shown is '"+ status+"'.";
 cardTitle = "Success";
 myHandler.emit(':tellWithCard', speechOutput, cardTitle, speechOutput);
            });
 r.on('error', function (e) {
 console.log("ERROR:");
 console.error(e);
 speechOutput = "Sorry, there was problem - I could not update the door sign!";
 cardTitle = "Error";
 myHandler.emit(':tellWithCard', speechOutput, cardTitle, speechOutput);
            });
        });
 // Send POST request:
 request.write(request_body);
 request.end();
    },
 /*
     * Built-in intents:
     */
 "AMAZON.HelpIntent": function () {
 this.emit(':ask', "You can say tell door sign 'we are open', or, you can say exit... What can I help you with?", "What can I help you with?");
    },
 "AMAZON.StopIntent": function () {
 var speechOutput = "OK";
 this.emit(':tell', speechOutput);
    },
 'Unhandled': function () {
 this.emit(':ask', "What can I do for you?", "What can I do for you?");
    }
};

并替換字符串：

• 將_ME__THINGER_IO_USER 替換為您的thinger.io用戶名

• REPLACE_ME__THINGER_IO_DEVICE_ID 為之前在thinger.io注冊的設(shè)備的 ID

• 將_ME__THINGER_IO_ACCESS_TOKEN 替換為之前在thinger.io上為您的設(shè)備創(chuàng)建的附加訪問令牌

• REPLACE_ME__ALEXA_APP_ID 為之前創(chuàng)建的 Alexa Skill 的 Application Id

• REPLACE_ME__ALEXA_SKILL_NAME 為之前創(chuàng)建的 Alexa Skill 的名稱

在您的 Alex Skill 的配置部分：

• 選擇AWS Lambda ARN （Amazon 資源名稱）作為服務(wù)端點類型

• 并在Default字段中輸入此 Lambda 函數(shù)的 ARN 。

?

?

?

?

?

1 / 15 ? AWS 管理控制臺

?

把它們縫在一起

現(xiàn)在您應(yīng)該已經(jīng)將您的設(shè)備連接到thinger.io平臺（通過用戶名、設(shè)備 ID 和設(shè)備令牌），將您的設(shè)備鏈接到 AWS Lambda 函數(shù)（通過用戶名、設(shè)備 ID 和訪問令牌）并將 AWS Lambda 函數(shù)鏈接到一個Alexa 技能（通過技能應(yīng)用程序 ID 和 Lambda 函數(shù)的 ARN）。

如果所有步驟都已正確執(zhí)行，您可以測試您的設(shè)置。

?

?

?

?

?

1 / 4 ?測試

?

?

改進(jìn)、更改和待辦事項

• 一個很好的包裝

• 更復(fù)雜、功耗更低的通信設(shè)置（例如，具有重新連接算法的 MQTT 有助于延長睡眠時間）

• 更大的顯示器

• 如果您不能（或不想）獲得 Arduino MKR1000，任何具有 SPI 硬件支持的 Arduino 代碼兼容設(shè)備（例如 ESP8266 型板）也應(yīng)該這樣做，如果您稍微調(diào)整一下引腳映射.