描述

ARTIK 和 ARTIK Cloud 教程?

昨天，在 SDC 的開幕主題演講中，我們發布了對三星 Artik 10 和 5 的官方支持。在我們的合作伙伴Snappin.io的幫助下，我們制作了一個現場演示，您可以在下面觀看。

在這篇文章中，我們將通過我們的舞臺演示的極簡版本來說明如何快速和安全地更新您的 ARTIK。

特別是，我們將學習如何：

• 使用 resin.io 設置 ARTIK 設備并將其連接到互聯網。
• 將我們的接近傳感器連接到我們的電路板。（如果您沒有傳感器，我們將隨機發出值來模擬傳感器）。
• 連接到 ARTIK Cloud 并將數據推送到它。
• 準備我們的代碼并將其推送到我們的設備（如果您還不熟悉，您將學習一些關于 Docker 和 git 的知識）。

入門

將您的 ARTIK（5 或 10）、SD 卡和接近傳感器（可選）放在手邊。

注冊resin.io 。如果您已經有一個帳戶，請跳過

添加您的公共 ssh 密鑰，這樣我們就可以稍后推送代碼，通過從github導入它，使用您機器上的現有密鑰或生成一個新密鑰來執行此操作。

接下來，創建一個應用程序，隨意命名并選擇設備類型 Artik 5 或 10。然后下載您的設備操作系統，添加您的網絡配置。下載 resinOS 后，使用蝕刻機或您選擇的圖像閃光器將其刻錄到 SD 卡。

設置您的設備

為了在我們的 ARTIK 上啟動并運行 resinOS，我們需要首先將其設置為從我們的 SD 卡啟動，而不是從它的內部eMMC 內存啟動。為此，我們需要將微型SW2撥碼開關設置到位置1:on和2:on，如下所示。

注意：此resinOS 將完全覆蓋現有的eMMC。

我們現在可以插入 5VDC 電源線并將標有 的電源開關撥到PWR SW位置on。我們現在應該有一些發光的 LED 指示生命跡象。接下來，我們需要按住SW3 POWER按鈕 1 或 2 秒，這將啟動從 SD 卡啟動。

幾秒鐘后，您應該會看到您的 ARTIK 出現在 resin.io 儀表板上。如果它在 1 或 2 分鐘后仍未出現，請仔細檢查您的以太網連接或您在下載時輸入了正確的 wifi 憑據。如果您仍然無法在線獲取，請通過 support@resin.io 聯系我們。

注意：為了使 wifi 正常工作，您需要將（ARTIK 5J20和J33）和（ARTIK 10 J20 和 J36）的跳線設置到板的邊緣。

您的 ARTIK 現在會將 resinOS 閃存到內部 eMMC 上，以便您可以移除 SD。這將需要 2 或 3 分鐘。完成后，它將自行關閉，您將在儀表板上看到該設備處于某種Post-Provisioning狀態。此時你需要：

• 翻轉電源開關off位置。
• 取出 SD 卡。
• 將SW2dip 開關設置為1:off和2:off。

所有這一切之后，我們翻轉PWR SW背部on并再次按住SW3 POWER按鈕一秒鐘左右。如果一切按計劃進行，我們現在應該IDLE在我們的儀表板上有一個新配置的狀態。

連接傳感器

在此步驟中，我們將使用紅外線接近傳感器 (Sharp GP2Y0A21YK) 。如果您沒有傳感器，可以跳到下一節。

如下圖所示連接傳感器：

.

有關管腳映射的詳細信息，請參閱ARTIK 文檔。

配置 Artik Cloud

注冊Artik-cloud 。

有兩個門戶可以管理您的 Artik 云。開發者門戶和用戶門戶。開發人員門戶為您提供了一個界面來創建和管理設備類型和應用程序，而用戶門戶允許您管理設備及其數據。

所以首先我們需要創建一個設備類型。為此，您需要創建一個清單。清單只是一組向 Artik Cloud 描述設備數據的說明。例如：

 {
    "name": "reading",
    "type": "CUSTOM",
    "valueClass": "Integer",
    "isCollection": false,
    "tags": []
  }

清單還允許您解釋該數據并觸發操作，但這超出了本教程的規范。有關這方面的更多信息，您可以查閱文檔。

為了您的方便，我們將.manifest.json

因此，將設備類型命名為任何您喜歡的名稱，例如resinArtik并上傳我們提供的。manifest.json

接下來，我們將在用戶門戶 (My ARTIK Cloud)上創建并連接一個設備。

選擇齒輪圖標并生成設備令牌。

獲取新生成的設備令牌和設備 ID，并將它們作為設備環境變量添加到resin.io 設備視圖中。

確保它們被相應地命名：。ARTIKCLOUD_DEVICE_ID ARTIKCLOUD_DEVICE_TOKEN

代碼

正如我提到的，我們將推出一個精簡的演示，簡而言之，它是一個小節點應用程序，可以從接近傳感器讀取數據，如果您沒有連接傳感器，它會隨機生成一個。如果所述讀數超過閾值 ( default = 250)，則將事件推送到 ARTIK Cloud。

您會注意到的第一件事是存在 `Dockerfile.template，這是因為 resin.io 以 docker 容器的形式構建和運行所有應用程序。我們出于各種原因使用容器，它使我們能夠支持每種語言并以安全的原子方式更新設備，同時仍然在設備上保持輕量級占用空間。它也已成為在 Web 上更新應用程序的事實上的方式，所以為什么不在嵌入式設備上使用它。

# base-image for node on any machine using a template variable,
# see more about dockerfile templates here:http://docs.resin.io/pages/deployment/docker-templates
FROM resin/%%RESIN_MACHINE_NAME%%-node

# Save source folder
RUN printf "%s\n" "${PWD##}" > SOURCEFOLDER

# Move to /usr/src/app
WORKDIR /usr/src/app

# Move package to filesystem
COPY "$SOURCEFOLDER/app/package.json" ./

# Install NodeJS dependencies via NPM
RUN JOBS=MAX npm i --unsafe-perm --production && npm cache clean

# Move app to filesystem
COPY "$SOURCEFOLDER/app/index.js" ./

# Start app
CMD ["node", "/usr/src/app/index.js"] 

這個文件相對較短，但有幾個要點需要注意：

• 我們使用 resin 的官方基礎鏡像。%%RESIN MACHINE NAME%% 允許我們從 resin.io 的 Dockerhub 動態拉取圖像，因此它可以自動替換為artik5或artik10取決于您使用的設備。毫不奇怪，它還預裝了節點。
• 我們NPM install在添加其余源代碼之前運行，這允許我們更改我們的 index.js 而不會使 resin.io 構建器的緩存無效/node_modules。這是一個性能增強，所以如果現在還不完全清楚，請不要擔心。
• CMD命令在我們的構建器上運行之前的所有內容，然后將完整的容器下載到設備并CMD執行命令，啟動我們的應用程序。

應用程序邏輯在很大程度上是不言自明的，正如我提到的，如果您沒有連接傳感器，它有一個后備。

function getReading(cb){  
  // got a sensor ?
  read_adc0(function(reading){
    if (reading != 0) {
      // sensor connected
      cb(reading)
    } else {
      // no sensor connected so generate a value
      cb(generateRandomVal(sensor_threshold))
    }
  });
}

當sensor_threshold超過時，它會將事件數據推送到云端。

/*
Function that enables and reads proximity sensor  
*/
function enable_proximity_sensor() {  
  console.log('Monitoring for movement');

  setInterval(function() {
    getReading(function(reading){
      console.log('Sensor reading: ' + reading)
      if (reading > sensor_threshold) {
        console.log('pushing event to ARTIK Cloud');
        push2ArtikCloud(reading);
      }
    })
  }, poll_interval);
}

推送代碼

好的，讓我們部署。幸運的是，這是一個簡單的三步過程：Clone, add remote, push. 從克隆這個存儲庫開始。

git clone https://github.com/resin-io-projects/resin-artik-cloud-publisher && cd resin-artik-cloud-publisher 

在樹脂儀表板上導航到您的應用程序，然后在右上角復制您的設備端點。

git add git push resin master 

一旦您在構建日志中看到 resin.io 獨角獸，這意味著您已經構建了容器，之后它將下載到您應用程序中的所有設備。您可以從 resin.io 儀表板看到進度。

一旦應用程序開始運行。查看ARTIK Cloud以查看實時事件流。

注意：我們已經針對以下版本的 ARTIK 對此進行了測試。Artik10：開發。Board10，VER。0.5 (2015.12.23), Artik5: TYPE 5, VER. 3.2 (2015.10.22)

結論

所以這就是我們所取得的成就：

• 我們采用了一個應用程序，并使用類似網絡的工作流程將其部署到一個硬件上，未來派擊掌！
• 我們使用環境變量為 ARTIK 設備遠程提供運行時配置。
• 我們深入 ARTIK Cloud 并發送了一些基本的事件數據。

如果您想了解有關樹脂的更多信息，請深入閱讀我們的文檔或在我們的聊天室中向我們的團隊提問。

?