大兵萊恩一路直前: 108 大眼仔, 進化, (3) 檢查 Gmail 信箱 (Arduino, SG90, Animatronic Eye, Temboo)

大眼仔, 兼差當郵差

讓大眼仔做人臉追蹤的功能有點卡關, 反正閒著也閒著, 萊恩大兵幫大眼仔找了份差事, 讓它去查看 Gmail 信箱, 有未讀信件時眨個眼通知一下.

怎麼做呢? 藉由 Temboo 這個雲端平台的整合功能, 萊恩大兵沒花太多工夫, 就取得了一段可檢查 Gmail 信箱的 Processing 程式碼. 再來就是藉由 serial port 傳遞資訊, 串連大眼仔做反應了.

做法如下:

Gmail 端

要讓 Temboo 的 API 能存取 Gmail 信箱, 得開啟 App passwords 的功能.

登入帳號密碼後, 切到 Security 頁面.

Gmail 帳戶的 Security 頁面
啟動 2-Step Verification 功能後, 會多了個 App passwords 的項目.

啟動 2-Step Verification 功能
授權給 Temboo API 一個 app password (名稱可隨意取, ex: Temboo Choreos for Google).

授權給 Temboo API 一個 app password
這 app password 要保管好, 千萬別外洩了.

密碼千萬要保管好
若不放心這功能, 可隨時吊銷這筆授權.

這筆授權隨時可割可棄, 反觀..

Temboo 端

登入後, 切到 Library 頁面, 從左側欄找到 Google | Gmail 的 API (Temboo 的用詞是 Choreos) 頁面 .

支援一狗票的雲端服務
在 Gmail 的 API 頁面, 它有數種相關的 API (Choreos) 可以使用, 例如: GetUnreadImportantEmail, GetUnreadMail 等等.

光是 Gmail 就有數種服務
連到 GetUnreadMail 的頁面, 它需要填入 username 和 password. Username 就是 gmail 帳號 (gogoprivateryan@gmail.com), password 就是前面剛取得的 app passwords. 填入後, 按 “Run”.

帳密出手, 相信它..
等個幾秒鐘, 如果吐在 Output 欄位的是這串錯誤訊息, 請回去檢查 Gmail 的 app passwords 相關設定.

回去檢查 Gmail 的 app passwords 設定..
如果順利的話, 會看到 Output 的 FullCount 和 Response 欄位, 裡面有從 Gmail 信箱撈回來的資訊. 這個 FullCount 就是未讀信件的數字.

您有 5 封未讀信件..
再往下拉一點, Code 的欄位, 裡面就是相關的程式碼. 萊恩大兵選用 Processing, 其它支援的程式語言還有 Java, C#, Python, PHP, iOS, Ruby, Node.js 與 cURL. 如果 Arduino 有連網功能, Temboo 甚至可以直接產出 Arduino 的程式碼.

程式碼裡面有密碼明文, 已做塗銷處理..

再來就簡單了.

Processing

稍微改一下 Temboo 的程式碼, 加上一些功能:

每隔固定一段時間檢查 gmail 信箱一次.
如果有新信件, 就透過 serial port 傳給 arduino.

 
import com.temboo.core.*;
import com.temboo.Library.Google.Gmail.*;
import processing.serial.*;

// Create a session using your Temboo account application details
TembooSession session = new TembooSession("gogoprivateryan", "myFirstApp", "x-x-x-x-x-x-x-x-x-x-x-x-x-");

Serial myPort;  // Create object from Serial class

int timeInterval = 30 * 60 * 1000; // half an hour
int lastUpdate;
String mailCount = "";

void setup() 
{

  myPort = new Serial(this, Serial.list()[5], 9600);
  lastUpdate = millis() - timeInterval;
}

void draw() 
{
  if (millis()-lastUpdate >= timeInterval)
  {
    // Run the GetUnreadMail Choreo function
    runGetUnreadMailChoreo();
    myPort.write(mailCount "\n");

    lastUpdate = millis();
  }
}

void runGetUnreadMailChoreo() 
{
  // Create the Choreo object using your Temboo session
  GetUnreadMail getUnreadMailChoreo = new GetUnreadMail(session);

  // Set inputs
  getUnreadMailChoreo.setUsername("gogoprivateryan@gmail.com");
  getUnreadMailChoreo.setPassword("x-x-x-x-x-x-x-x-x-");

  // Run the Choreo and store the results
  GetUnreadMailResultSet getUnreadMailResults = getUnreadMailChoreo.run();
  
  // Print results
  //println(getUnreadMailResults.getResponse());
  println(getUnreadMailResults.getFullCount());
  mailCount = getUnreadMailResults.getFullCount();
}

Arduino + 大眼仔

這邊就完全聽命行事.

聽 serial port 傳來的數值, 再讓大眼仔依數值大小做適當的動作 (眨眼啦, 轉眼珠之類的).

 

#include <Servo.h>
#include <AniEyeball.h>

#define N_EYEBALL 1

AniEyeball eyeball;

// 眼皮_PIN # i
// 眼球_PIN # i + 1
const byte servoPin[N_EYEBALL*2] = {2,3};

char inData[10];
int index = 0;
int mailCount = 0;

void setup()
{
  Serial.begin(9600);

  eyeball.setPinP(servoPin[0]);
  eyeball.setPinB(servoPin[1]);
}

void loop()
{
  while (Serial.available() > 0)
  {
    char aChar = Serial.read();
    if (aChar == '\n')
    {
      String str = inData;
      mailCount = str.toInt();
      index = 0;
      inData[index] = NULL;      
      Serial.write(" done\n");
    }
    else
    {
      inData[index] = aChar;
      index  ;
      inData[index] = '\0'; // Keep the string NULL terminated
    }
  }

  if (mailCount >= 10)
  {
    eyeball.setBPos(1500);
    delay(15);
    for (int i=0; i<2; i  )
    {
      eyeball.setPPos(2000);
      delay(200);
      eyeball.setPPos(1000);
      delay(200);      
    }
  }
  else if (mailCount >= 3 && mailCount < 10)
  {
    eyeball.setPPos(1000);
    delay(15);
    for (int i=0; i<2; i  )
    {
      eyeball.setBPos(2000);
      delay(200);
      eyeball.setBPos(1000);
      delay(200);      
    }
  }
  else if (mailCount > 0 && mailCount < 3)
  {
    eyeball.sleepy();
  }
    
  mailCount = 0;
}

Okay, 準備就緒. 把它們全部串在一起, 大眼仔就扮起郵差來了. (說實在, 讓大眼仔來檢查 Gmail 信箱, 還真不實用. Anyway, 好玩就好.)

[萊恩大兵的其它文章]