描述

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

什么是光束？?

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

?

小巧超薄。

?

光束可以很容易地進(jìn)行菊花鏈連接——最多可以連續(xù)連接四個(gè)光束。從單個(gè)?5 x 24?網(wǎng)格變?yōu)?480 個(gè) LED的5 x 96?網(wǎng)格。雙側(cè)連接器讓您無需任何焊接即可輕松將梁卡在一起。

?

?

?

?

?

1 / 2 ?光束可以很容易地進(jìn)行菊花鏈?zhǔn)竭B接 - 只需滑入側(cè)面連接器并將其卡入。?

?

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

?

將 Particle 與 Beam 結(jié)合使用，并獲取有關(guān) Beam 的早晨更新。?

?

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

?

?

聯(lián)播指南

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

HOST_V+：?連接到 5V 或 3.3V，具體取決于您的微控制器。例如，如果使用 Arduino UNO，則此引腳應(yīng)連接到 5V，因?yàn)樗且粋€(gè) 5V 平臺。Particle Photon 是一個(gè) 3.3V 平臺，所以這個(gè)引腳應(yīng)該連接到 3.3V。?

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

GND ：連接到接地引腳。?

SYNC ：無需將此引腳連接到您的微控制器。當(dāng)連續(xù)鏈接多個(gè)光束時(shí)使用它。?

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

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

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

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

?

?

注冊開放 API

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

?

?

?

?

查找您的巴士站號碼

最簡單的方法是使用谷歌地圖。在此示例中，我們從 MEC Vancouver 搜索到 BC Place。當(dāng)您顯示巴士路線的詳細(xì)信息時(shí)，巴士站 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。?

單擊右側(cè)的圖像了解更多詳細(xì)信息。有關(guān) webhook 的更多信息，請單擊此處：? Particle Webhooks 。

?

?

?

?

從 Github 和 Flash 下載代碼！

下載庫并導(dǎo)航到 /examples/transit 文件夾。

粒子光束庫

關(guān)于代碼的幾點(diǎn)說明：

以下訂閱方法向我們的 webhook 注冊了一個(gè)名為 gotBusData 的回調(diào)。?

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

在 gotBusData 回調(diào)函數(shù)中，我們嘗試提取相關(guān)信息并將字符串打印到 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 的調(diào)用。?

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

最后，我們每 60 秒在主循環(huán)中調(diào)用一次發(fā)布方法。這是為了確保我們不會達(dá)到允許的每日 API 調(diào)用限制。 ?

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

上傳

在點(diǎn)擊上傳之前，需要注意以下幾點(diǎn)。?

• 如果使用一個(gè)光束，將背面的滑塊開關(guān)設(shè)置為“A”。?

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

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

• 確保 RSTPIN 設(shè)置為正確的數(shù)字引腳。?

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