描述

我們將使用 Beam 為公交時刻表構建一個滾動 LED 顯示屏！您可能在地鐵站或公交車站看到過其中一個。您可以為家里建造一個，以幫助您準確了解您還剩多少時間——尤其是當您像我們一樣傾向于在早上按響鬧鐘時！讓我們開始吧。?

什么是光束？?

Beam 是一個漂亮的 LED 矩陣 — 120 個 LED 顯示滾動文本、動畫或自定義燈光效果。Beam 可用于構建連接的通知中心或帶有您自己的動畫的自行車燈。它與 Arduino、Particle 等兼容。?

?

小巧超薄。

?

光束可以很容易地進行菊花鏈連接——最多可以連續連接四個光束。從單個?5 x 24?網格變為?480 個 LED的5 x 96?網格。雙側連接器讓您無需任何焊接即可輕松將梁卡在一起。

?

?

?

?

?

1 / 2 ?光束可以很容易地進行菊花鏈式連接 - 只需滑入側面連接器并將其卡入。?

?

Beam 旨在消除復雜的 LED 網格和凌亂的圖書館的麻煩。僅用一行顯示滾動文本非常簡單。只需幾行代碼，您就可以構建一個 IFTTT 連接的通知中心、自動收報機磁帶、自行車燈等等。

?

將 Particle 與 Beam 結合使用，并獲取有關 Beam 的早晨更新。?

?

它是適合任何項目的超薄顯示器。只需將電線插入側面連接器即可開始使用。不需要面包板。超亮 LED 可以透過任何半透明材料發光。將您的項目從基本的七段顯示器升級到一個新的水平。

?

?

聯播指南

在 Beam PCB 的背面，兩端各有兩個母連接器。兩個連接器是相同的，任何一個都可用于連接到您的主機微控制器。?

HOST_V+：?連接到 5V 或 3.3V，具體取決于您的微控制器。例如，如果使用 Arduino UNO，則此引腳應連接到 5V，因為它是一個 5V 平臺。Particle Photon 是一個 3.3V 平臺，所以這個引腳應該連接到 3.3V。?

3.3V ：連接到主機微控制器上的 3.3V 引腳

GND ：連接到接地引腳。?

SYNC ：無需將此引腳連接到您的微控制器。當連續鏈接多個光束時使用它。?

RESET ：連接到微控制器上的任何數字引腳。?

IRQ ：目前未使用。不連接。?

SCL ：連接到微控制器上的 SCL 引腳

SDA ：連接到微控制器上的 SDA 引腳。?

?

?

注冊開放 API

對于此示例，我們使用可用于溫哥華的 Translink Open API。轉到https://developer.translink.ca/?并注冊一個免費帳戶。您所在的城市可能會有自己的 API - 美國流行的 API 是NextBus 。?

?

?

?

?

查找您的巴士站號碼

最簡單的方法是使用谷歌地圖。在此示例中，我們從 MEC Vancouver 搜索到 BC Place。當您顯示巴士路線的詳細信息時，巴士站 ID 將顯示在巴士編號和路線下方。在本例中，公交車站 ID 為 50482。??

?

?

?

?

在 Particle Cloud 上注冊您的 webhook

在 Particle CLI 中，使用以下代碼注冊您的 webhook。 ?

particle webhook GET bus_info "http://api.translink.ca/rttiapi/v1/stops/59837/estimates?apikey=AAAAAAAAAAAAAAAAAA&count=1&routeNo=003"

確保將上面字符串中的 apikey 替換為您在注冊 API 后收到的 apikey。?

單擊右側的圖像了解更多詳細信息。有關 webhook 的更多信息，請單擊此處：? Particle Webhooks 。

?

?

?

?

從 Github 和 Flash 下載代碼！

下載庫并導航到 /examples/transit 文件夾。

粒子光束庫

關于代碼的幾點說明：

以下訂閱方法向我們的 webhook 注冊了一個名為 gotBusData 的回調。?

Particle.subscribe("hook-response/bus_info", gotBusData, MY_DEVICES);

在 gotBusData 回調函數中，我們嘗試提取相關信息并將字符串打印到 Beam。?

void gotBusData(const char *name, const char *data) {
   String str = String(data);
   String leaveStr = tryExtractString(str, "", "");
   String destinationStr = tryExtractString(str, "", "");
   String countdownStr = tryExtractString(str, "", "");
   String routeStr = tryExtractString(str, "", "");
   if (routeStr != NULL) {
       Serial.println("Route No: " + routeStr);
   }
   if (destinationStr != NULL) {
       Serial.println("Going to: " + destinationStr);
   }
   if (countdownStr != NULL) {
       Serial.println("Leaving in: " + countdownStr + String("Mins"));
   }
   if (routeStr !=NULL){
       String beamString =String(routeStr + " " + destinationStr + " " + coun    tdownStr + " MINS");
       beamString.toUpperCase();
       Serial.println(beamString);
       char buf[1024];
       beamString.toCharArray(buf, 1024);
       b.begin();
       b.print(buf);
       b.setSpeed(5);
       b.play();
   }
}

Beam 庫的核心在于以下將文本打印到 Beam 的調用。?

b.begin();
b.print(buf);
b.setSpeed(5);
b.play();

最后，我們每 60 秒在主循環中調用一次發布方法。這是為了確保我們不會達到允許的每日 API 調用限制。 ?

Particle.publish("bus_info");
delay(30000);

上傳

在點擊上傳之前，需要注意以下幾點。?

• 如果使用一個光束，將背面的滑塊開關設置為“A”。?

• 注意??主 .ino 文件頂部的#define BEAMCOUNT 。這應該設置為您正在使用的光束數量。我們建議將其設置為 1 并在嘗試其他示例之前使用單個 Beam 進行測試。?

• 要以菊花鏈方式連接更多光束：從左到右，確保第一個光束的滑塊開關設置為“A”，第二個光束的“B”，依此類推。所以你總共使用了四個光束，那么開關設置應該是從左到右的A、B、C、D。?

• 確保 RSTPIN 設置為正確的數字引腳。?

現在點擊上傳，您應該會看到文本和動畫出現在 Beam 上。根據微控制器支持的 i2c 速度，可能需要幾秒鐘才能完成所有寄存器的更新。打開串行監視器，您應該會看到記錄了一些調試消息。