描述

我們正在為Nile 項目構建一個開源原型。

背景

Nile 是一個去中心化且免傭金的購物平臺，旨在為當地經濟賦能。尼羅河正在重新定義電子商務的現狀，不是建立一個統治世界的巨型公司，而是賦予人們和社區權力，以作為強大且相互關聯的生態系統與這些巨人競爭。為此，尼羅河將在普通人充當供應商的幫助下將當地商店和客戶聯系起來。因此，最重要的流程之一是訂購流程，當客戶在當地商店訂購產品并希望供應商將其送貨上門時，該流程就開始了。為了跟蹤訂單及其狀態，我們希望提供一種工具來使用 RFID 卡創建和讀取唯一的訂單標識符。本文旨在指導您逐步創建此類工具。

概述

正如主圖所示，本教程的目標是構建一個工具，用于向 RFID 卡寫入和讀取數據，并借助 LED 環的顏色指示器可視化該過程。MAM 根存儲在 RFID 卡上，Web 應用程序讀取 MAM 流并顯示訂單的代表性數據。我們有六個步驟來指導您完成：

1. 機箱準備- 準備機箱以將所有硬件放入其中。

2. 設置 Raspberry PiZero - 安裝 Raspbian，配置 ssh 和 wifi 以及通過 SSH 連接到 Pi。

3. 添加 RFID 組件- 將 RFID 模塊 (Mifare RC522) 連接到 Pi。

4. 添加 LED 組件- 將 NeoPixel Ring - 12 x 5050 RGB LED 模塊連接到 Pi。

5. 將所有東西放在一起- 在這里，我們將修復機箱內的所有硬件。

6. 讓代碼運行——最后但并非最不重要的是，我們通過添加代碼使整個事情正常進行。

1.案例準備

我們希望將工具所需的一切都放在一個冷藏箱中。為了準備案例，您需要做以下事情：

• 一個盒子- 把所有東西都放在里面
• 一個小玻璃杯——還有……
• ...鉛筆- 標記整體
• 一把刀- 切出整體
• 一張砂紙- 細化邊緣
• 一塊方形磨砂玻璃- 用作窗戶
• 一把刷子——還有……
• ...一些丙烯酸顏色- 以您喜歡的顏色繪制盒子
• 一塊方形磨砂玻璃- 用于窗戶
• 熱膠槍- 固定盒子窗戶后面的玻璃

?

2. 樹莓派零設置

準備好案例后，我們需要開始進行 Raspberry Pi 的基本設置。

第 1 步 - 安裝 Raspbian

首先我們要安裝Raspbian - 我們建議安裝 Raspbian Stretch Lite（在此處下載）。為此，請將 Pi 的 SD 卡插入您的計算機并在其上閃存 Raspian Stretch Lite。提示：為此，您可以使用Etcher 。

第 2 步 - 配置無頭 WiFi

閃爍過程完成后，SD 卡已從您的計算機中彈出。您需要做的就是將其拔出并插入，讓操作系統再次識別它。一旦你的引導驅動器出現打開你的終端并執行：

$ cd /Volumes/boot 

現在我們要啟用 SSH ，它在 Raspberry Pi 上默認是禁用的。ssh我們只需在驅動器中創建一個名為的文件。boot為此執行：

$ touch ssh 

即使文件為空，它也會在 Pi 啟動后立即啟用 ssh。

最后，我們還希望 Pi 在啟動后立即連接到 wifi。為此，我們將連接詳細信息存儲在bootPi 的驅動器中。執行以下命令：

$ nano wpa_supplicant.conf

現在繼續并將以下代碼粘貼到文件中。還要輸入您的 wifi 連接詳細信息，然后按ctrl + x保存更改。

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
network={    
    ssid="YOUR_SSID"    
    psk="YOUR_WIFI_PASSWORD"    
    key_mgmt=WPA-PSK
}

提示：如果您打算在不同的地方使用該工具，您現在可以輕松設置多個 wifi 配置。通過這樣做，當您更改位置時，您無需拔出 Pi 的 SD 卡。如果你想這樣做，只需添加以下代碼：

$ ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
$ update_config=1
$
$ network={
$     ssid="SCHOOL_NETWORK_NAME"
$     psk="SCHOOL_PASSWORD"
$     id_str="school"
$ }
$ 
$ network={
$     ssid="HOME_NETWORK_NAME"
$     psk="HOME_PASSWORD"
$     id_str="home"
$ }

您可以通過添加更多網絡對象在此處添加任意數量的網絡。

現在我們準備好通過 SSH 連接到 Pi。

第 3 步 - 通過 SSH 連接

要通過 SSH 連接到 Pi，您可以執行以下命令：

$ sshpass -p  ssh -o StrictHostKeyChecking=no pi@

提示：如果您打算在將來多次重復這個過程，為了使這個過程更容易，您可以創建一個別名來訪問 pi，piz而不是上面的命令。為此執行：

$ nano ~/.zshrc

然后簡單地創建一個別名將其粘貼到文件中：

alias

現在，打開一個新選項卡，您就可以通過執行以下命令連接到 pi：

$ piz

3.添加RFID組件

我們想通過 RFID 寫入器和讀取器擴展 Pi。我們決定使用 Mifare RC522。該模塊可以使用 SPI 連接。

第 1 步：啟用樹莓派 SPI

要為 Pi 啟用 SPI，請執行以下命令轉到配置設置：

$ raspi-config

現在選擇接口選項，然后選擇 SPI。出現提示時確認yes并重新啟動您的 Pi：

$ sudo reboot 

一旦您的 Pi 重新啟動，通過執行以下命令打開 config.txt：

$ sudo nano /boot/config.txt 

現在尋找以下行：

$ dtparam=spi=on 

如果您找到它，則您的 SPI 接口工作正常，您可以繼續下一步。

第 2 步：安裝 RFID 軟件

要安裝 RFID 軟件，我們首先需要安裝 Python 2.7 dev。為此執行：

$ sudo apt-get install python2.7-dev

接下來我們需要下載并安裝python的SPI工具。

$ git clone https://github.com/lthiery/SPI-Py.git
$ cd SPI-Py
$
$ sudo python setup.py install

最后下載以下python庫來使用RC522模塊：

$ git clone https://github.com/mxgxw/MFRC522-python.git
$
$ cd MFRC522-python

第三步：接線圖

作為最后一步，請按照此接線圖將 RC522 連接到 Raspberry Pi Zero。

?

追溯

如果您遇到如下圖所示的回溯，請按照這些說明進行操作。

該問題是由 SPI python 庫引起的，可以通過回滾到同一庫的先前版本輕松解決。

$ git clone https://github.com/lthiery/SPI-Py.git
$ git checkout 8cce26b9ee6e69eb041e9d5665944b88688fca68
$
$ sudo python setup.py install

確保在回滾后再次運行安裝程序。如果您仍然有問題，請參閱相關的 StackOverflow 文章。

4.添加燈光組件

對我們來說，該工具具有一些奇特的即時用戶反饋似乎很重要。最簡單的方法是通過顏色的視覺反饋。所以我們決定添加一個磨砂玻璃窗和一個NeoPixel Ring - 12 x 5050 RGB LED以提供某種彩色進度條。

示意圖要將此組件添加到 Raspberry Pi Zero，請遵循以下示意圖：

5. 把所有東西放在一起

在我們構建了我們的案例并將所有硬件組件放在一起之后，我們準備好將所有東西放入案例中。您決定在框中放置元素的方式完全取決于您。我們所做的只是簡單地使用一些聚苯乙烯泡沫塑料和膠帶來固定盒子內的所有元件。

提示：從視覺的角度來看，真正重要的一件事是將燈的位置非常靠近窗戶。

6：運行代碼

我們需要運行兩個應用程序，一個用于商店，一個用于包裝站。按照代表性 Readme.md 文件中的說明安裝依賴項并運行應用程序。

第一步：開店申請

創建您的商店首先，運行商店應用程序 -使用演示用戶登錄并導航到導航中的商店頁面。現在在這里輸入您的商店名稱和位置。創建商店后，應用程序會為您創建一個 MAM 根目錄，其中存儲了有關您商店的所有信息。

MAM 根以及用于向頻道發布新消息的種子，兩者都僅存儲在瀏覽器的本地數據庫中。所以沒有第三方持有您的憑據。

MAM 流中的新消息表示對商店數字雙胞胎的更改 - 例如，如果您更改商店名稱。通過這種方法，我們可以獲得商店的整個變更歷史記錄。和處理產品order_request_address和catalog_root訂購流程，這不是本教程的一部分。

創建一些產品下一步是在Products 頁面中創建一些產品。之后，我們準備創建訂單。為了簡化本教程中的工作流程，我們直接在商店應用程序中創建訂單，而不是在這里也使用客戶應用程序。

?

創建訂單轉到“訂單”頁面，選擇一些產品并創建訂單。

第二步：打包申請

寫入 RFID 卡我們需要 Packing Station Prototype 將 MAM 根寫入 RFID 卡。直接在Shop應用Order頁面復制，然后去packing station app到Write頁面。現在將 MAM 根粘貼到給定的輸入中。完成后，按寫入按鈕。讀卡器上的燈現在應該從藍色變為橙色，這表示將卡放在盒子上并等待幾秒鐘，直到燈變為綠色。這表明寫入過程成功，我們現在可以讀取卡了。

讀取 RFID 卡現在導航至讀取頁面并等待指示燈變為藍色。一旦它是藍色的，您就可以將卡片放在盒子上，然后將從 MAM 根目錄獲取訂單信息。RFID 閱讀器從卡中讀取 MAM 根，將其發送到前端并獲取流中的當前數據。因此，無論何時執行此過程，您都將始終從 tangle 中獲取最新數據。

?

結論

本教程演示了一個真實世界的用例，使用 Tangle 作為分布式賬本來存儲有關本地商店、他們的產品和訂單的數字雙胞胎的重要數據。在本教程中，MAM 通道表示從供應商到客戶的訂單生命周期。智能包站只覆蓋了我們需要構建的設備生態系統的一小部分，以便為整個過程提供服務，但這仍然是第一步。

我們打算進一步改進這個用例和教程。如果您有任何問題，請告訴我們！