SWSD004
v3.0.1
LORA Edge Tracker Reference Design Design Dedimingアプリケーションは、LORA Basics ModemとGeolocation Middlewaresに基づいたフル機能のトラッカーアプリケーションを示しています。
アプリケーションでは、LR1110がトランシーバーファームウェアバージョン0x0401以降を実行する必要があります。 LR1110を最新のファームウェアバージョンに更新するには、このプロジェクトに含まれる更新モデムファームウェアアプリケーションを使用してください。最新のファームウェアは、別のリポジトリから取得できます。
アプリケーションは通常、開始時に検出されたLR1110ファームウェアバージョンをシリアルコンソールに表示します。
LR11XX FW : 0x0401
INFO: ###### ===== LoRa Basics Modem Tracker application ==== ######
APP VERSION : 3.0.0
INFO: ###### ===== LoRa Basics Modem Version ==== ######
INFO: LoRaWAN version: 01.00.04.01
LR1110を更新する必要がある場合、Applications main_tracker_update_lr1110.c LR1110ファームウェアを更新します。新しいファームウェアはUARTから受信されます。
詳細については、アプリケーションのドキュメントをお読みください。
このセクションでは、トラッカーをセットアップし、関連するモバイルアプリケーションであるLora Edge™Configに接続する方法の簡単な説明を提供します。詳細については、Semtech Lora Edge™トラッカーリファレンスデザインのセットアップを参照してください。
タップして、ソフトウェアライセンス契約を受け入れます。
Almanac URLポップアップウィンドウで、デフォルトのAlmanac URLまたはAdvancedユーザーが別のURLに変更される場合があります。暦は自動的にダウンロードされます。
デフォルトのAlmanac URL（https://mgs.loracloud.com）を使用するには、後でクリックします。
Almanac URLを変更するには、[今すぐ変更]をクリックし、使用するアルマナックのURLを入力します。
[スキャンを開始]をクリックします
（Android）または
（iOS）およびLora Edge Configがモバイルデバイスの場所にアクセスできるようにします。
赤いLEDが点滅すると、Lora Edge Tracker Reference Designはペアリングモードになります。このモードには30秒間残ります。
モバイルアプリで、スキャナー画面を開きます。 Lora Edgeトラッカーリファレンスデザインの名前が表示されます。最後の4桁はDeveUi LSBです。これは、トラッカーラベルに印刷されたDeveuiと同じでなければなりません。
smtc_tkr_xxxxをタップして、Lora Edgeトラッカーリファレンスデザインをモバイルアプリケーションに接続します。接続が確立されると、赤いLEDが停止して点滅し、固体に切り替えます。更新が利用可能な場合、トラッカーは次のものを自動的に更新します。
ファームウェアの更新が完了すると、メッセージトラッカーが最新のものが表示されます。
接続したら、次の手順を順番に実行します。
その後、トラッカー操作が開始されます。 Lora Edge Tracker Reference Designからアプリを切断できます。切断するには、左矢印のアイコンをクリックします。 
（アンドロイド）、 
（iOS）。
このアプリケーションは、互換性のあるスマートフォンで実行されている「Lora Edge™Config」AndroidおよびiOSアプリを使用して構成できます。スマートフォンとトラッカーアプリケーション間の通信は、Bluetooth Low Energy（BLE）ワイヤレステクノロジーを使用します。トラッカーアプリケーションは、起動時に広告を開始し、磁石の存在を検出するたびに広告を開始します。ペアリングされていない場合、30秒後に広告を停止します。タイムアウト値は、 TRACKER_ADV_TIMEOUT_MS定数によって構成されます。
トラッカーは、ロラワンダウンリンクによっても設定できます。
次のパラメーターを構成できます。
| パラメーター | ble | ロラワン |
|---|---|---|
LoRaWAN Device EUI | ✔✔️ | |
LoRaWAN Join EUI | ✔✔️ | |
LoRaWAN Application Key | ✔✔️ | |
Use Semtech Join Server mode | ✔✔️ | |
Update almanac | ✔✔️ | |
GNSS constellation | ✔✔️ | ✔✔️ |
GNSS antenna | ✔✔️ | ✔✔️ |
Airplane mode | ✔✔️ | |
Use accelerometer | ✔✔️ | ✔✔️ |
Scan interval when tracker is moving | ✔✔️ | ✔✔️ |
Scan interval when tracker is static | ✔✔️ | ✔✔️ |
Reset accumulative charge | ✔✔️ | ✔✔️ |
Reset board | ✔✔️ | ✔✔️ |
apps/common/lorawan_key_config.hヘッダーファイルは、ロラワンパラメーター（領域、キー）を構成するためのいくつかの定数を定義します。
| 絶え間ない | コメント |
|---|---|
LORAWAN_REGION | 規制領域を選択します |
LORAWAN_CLASS | 使用するロラワンクラスを選択します |
LORAWAN_REGIONのサポート値：
SMTC_MODEM_REGION_EU_868 (default)SMTC_MODEM_REGION_US_915SMTC_MODEM_REGION_AS_923_GRP1SMTC_MODEM_REGION_AU_915SMTC_MODEM_REGION_CN_470SMTC_MODEM_REGION_AS_923_GRP2SMTC_MODEM_REGION_AS_923_GRP3SMTC_MODEM_REGION_IN_865SMTC_MODEM_REGION_KR_920SMTC_MODEM_REGION_RU_864 LORAWAN_CLASSのサポート値：
SMTC_MODEM_CLASS_ALR1110は、Chipeui/DeveuiとJoinuiiで事前に生成されています。コードがFlag CRYPTO=LR11XX_WITH_CREDENTIALSにコンパイルされ、パラメーターUse Semtech Join Server modeがデフォルトでTrueに設定されているため、アプリケーションはこれらの識別子を使用します。
トラッカーボードのSTM32WB55コントローラーのサンプルアプリケーションを構築するには、次のことが必要です。
デモは、2つのバイナリでプログラムする必要があります。
BLE_Ota.bintracker_application_autonomous.binデモは、以下を実行することにより、GNU Makeコマンドを介して構築できます。
# Navigate to the build folder
$ cd apps/tracker_application/makefile
# Execute the make call
$ make -jブートローダーBLE_Ota.binトラッカーアプリケーションを実行するために必須であり、ブートローダーのバイナリはapps/tracker_application/binフォルダーにあり、0x08000000アドレスでプログラムする必要があります。
たとえば、（STM32_Programmer_cliを使用）：
./STM32_Programmer_CLI.exe -c port=SWD -w "PATHSWSD004appstracker_applicationbinBLE_Ota.bin" 0x08000000
Linuxで
./STM32_Programmer_CLI -c port=SWD -w PATH//SWSD004/apps/tracker_application/bin/BLE_Ota.bin 0x08000000
Application tracker_application_autonomous.binはapps/tracker_application/makefile/buildフォルダーにあり、0x08007000アドレスでプログラムする必要があります
たとえば（STM32_Programmer_Cliを使用）：Windows：
./STM32_Programmer_CLI.exe -c port=SWD -w "PATHSWSD004appstracker_applicationbintracker_application_autonomous.bin" 0x08007000
./STM32_Programmer_CLI.exe -c port=SWD -w "PATHSWSD004appstracker_applicationmakefilebuildtracker_application_autonomous.bin" 0x08007000
Linuxで
./STM32_Programmer_CLI -c port=SWD -w PATH//SWSD004/apps/tracker_application/bin/tracker_application_autonomous.bin 0x08007000
./STM32_Programmer_CLI -c port=SWD -w PATH//SWSD004/apps/tracker_application/makefile/build/tracker_application_autonomous.bin 0x08007000
注：デフォルトでは、デモンストレーションは、LR1110事前にプロビジョニングされたChipeui/DeveuiとJoineUIを使用するようにコンパイルされています。サポートされているアプリケーション名は、 tracker_application_autonomous 、 uart_firmware_updateです。
ここでは、デモンストレーションのフラッシュセクターマッピング
| セクタ | コンテキストタイプ |
|---|---|
| 1〜6 | ブートローダー |
| 7からフラッシュエンドへ | トラッカーアプリケーション |
| アプリケーションフラッシュは194まで終了します | 内部ログ |
| 164 | addr_flash_store_and_forward |
| セクターフラッシュエンドまで193 | 保管して転送します |
| 194 | flash_user_internal_log_context |
| 195 | addr_flash_modem_key_context |
| 196 | flash_user_tracker_context |
| 197 | addr_flash_secure_element_context |
| 198 | addr_flash_devnonce_context |
| 199 | addr_flash_lorawan_context |
| 200 | addr_flash_modem_context |
| 201 | 使用されていません |
| 202 | flash_user_modem_e_tracker_context |
セクターを消去するには：
./STM32_Programmer_CLI.exe -c port=SWD -e [n m]
たとえば、完全なアプリケーション +関連コンテキストを消去するには：
./STM32_Programmer_CLI.exe -c port=SWD -e [8 202]
アプリケーションは、静的構成オプションが設定された後、ユーザーの介入を必要としません。
次の設定で構成された端子アプリケーションを使用します。
速度：921600ボーデータビット：8Sストップビット：1パリティ：なし
情報メッセージは、Lora Cloud Device Joinサービスにデバイスを登録するために必要なDeveui、Appeui/Joineui、およびPINから始まるシリアルコンソールに表示されます。
このアプリケーションには、GNSSとWi-Fi解決を実行するために実行するアプリケーションサーバーが必要です。
適応データレート（ADR）は、Datarate分布と領域ごとに定義された繰り返しの数を使用して、カスタムADRプロファイルで構成されています。
実際のデータレートと再送信値の数は、 main_tracker_application_autonomous.cファイルで定義されています。
値は、デューティサイクルの制約、消費電力目標などと一致するように慎重に設定する必要があります...
ここで、アプリケーションの予想される動作を示すために、ログに見られる手順に従ってください。
デフォルトでは、選択した領域が何であれ、2分ごとにデバイスが位置を送信する必要があります。
INFO: Modem Initialization
###### ===== LoRa Basics Modem Tracker application ==== ######
このプリントに続いて、アプリケーションとパラメータープリントを見つけるものとします
最初は実行されることはありません
INFO: ###### ===== JOINED EVENT ==== ######
New scan group for assisted scan
INFO: RP_TASK_GNSS - new scan group - task queued at 461083 + 120000
---- internal scan start ----
---- internal scan start ----
INFO: ###### ===== MIDDLEWARE_1 EVENT ==== ######
INFO: GNSS middleware event - SCAN DONE
SCAN_DONE info:
-- token: 0x07
-- is_valid: 1
-- number of valid scans: 4
-- scan[0][1335796859] (10 SV): 8247EA010A01567378AFF1C58A85C9DAAC54199BD49A4C2245D6E833409C1A89B0020B00
SV_ID 26: 46dB
SV_ID 7: 45dB
SV_ID 15: 43dB
SV_ID 6: 42dB
SV_ID 9: 42dB
SV_ID 89: 42dB
SV_ID 20: 40dB
SV_ID 99: 39dB
SV_ID 92: 38dB
SV_ID 108: 37dB
-- scan[1][1335796883] (10 SV): 8249EA010A01567338BBF07532486A9F4CD31D5CD41D3D2205571672D2625627B2CDCD0D
SV_ID 26: 46dB
SV_ID 7: 46dB
SV_ID 15: 44dB
SV_ID 92: 43dB
SV_ID 9: 42dB
SV_ID 89: 42dB
SV_ID 98: 41dB
SV_ID 6: 41dB
SV_ID 108: 41dB
SV_ID 20: 40dB
-- power consumption: 16 uah
-- mode: 1
-- assisted: 1
-- aiding position: (45.131836, 5.888672)
-- almanac CRC: 0X6A820509
# (...Several TX...)
---- internal TX DONE ----
INFO: ###### ===== MIDDLEWARE_1 EVENT ==== ######
INFO: GNSS middleware event - TERMINATED
TERMINATED info:
-- number of scans sent: 2
INFO: RP_TASK_WIFI - new scan - task queued at 40097 + 30000
---- internal Wi-Fi scan start ----
INFO: start Wi-Fi scan
WARN: No time available.
INFO: ###### ===== MIDDLEWARE_2 EVENT ==== ######
INFO: Wi-Fi middleware event - SCAN DONE
SCAN_DONE info:
-- number of results: 3
-- power consumption: 0 uah
-- Timestamp: 0
64 70 02 D9 94 55 -- Channel: 1 -- Type: 1 -- RSSI: -78
3C 17 10 B7 CD 90 -- Channel: 6 -- Type: 1 -- RSSI: -88
74 B6 B6 42 B4 EB -- Channel: 1 -- Type: 2 -- RSSI: -87
---- internal TX DONE ----
INFO: ###### ===== MIDDLEWARE_2 EVENT ==== ######
INFO: Wi-Fi middleware event - TERMINATED
TERMINATED info:
-- number of scans sent: 1
INFO: ###### ===== DOWNLINK EVENT ==== ######
Rx window: 2
Rx port: 151
Rx RSSI: -66
Rx SNR: 11
INFO: Downlink received:
INFO: - LoRaWAN Fport = 151
INFO: - Payload size = 7
INFO: - RSSI = -66 dBm
INFO: - SNR = 11 dB
INFO: - Rx window = SMTC_MODEM_EVENT_DOWNDATA_WINDOW_RX2
Payload - (6 bytes):
4C 05 01 26 01 00 77
INFO: ###### ===== TRACKER CONFIGURATION SETTINGS PAYLOAD RECEIVED ==== ######
tx_max_payload 242
- Tracker settings (7 bytes) : Send data
最初のデフォルト構成により、トラッカーデバイスは飛行機モードになります。このモードでは、デバイスはLorawanネットワークを自動的に結合しません。ホールセンサー効果は、トラッカーがモーションを検出するたびに短期間のみ有効になります。このデバイスは、Lora Edge™構成アプリケーションを使用して、飛行機モードから取り出すことができます。
バッテリーが枯渇すると、デバイスは自動的に飛行機モードに戻されます。
ホールエフェクトセンサーは、BLE広告を開始するためのスイッチとして使用されます。ユーザーが近くに磁石を置くとアクティブ化されます。飛行機モードでは、ホールエフェクトセンサーは、スタートアップでのみアクティブであり、トラッカーがモーションを検出したときに60秒間の間隔です。アクティベーション期間は、 TRACKER_HALL_TIMEOUT_MS定数によって構成されます。
| hallホールエフェクトセンサーがシールドを検出すると、トラッカーをリセットしてBLEを開始します。 BLEはLORA Basicsモデムの並列で実行されません |
|---|
Lora Edgeトラッカーリファレンスデザインボードには、バイカラーLEDがあります。
次に、黄色のコンポーネントはRX LEDと呼ばれ、赤いコンポーネントはTX LEDです。
アプリケーションは、LORA EdgeトラッカーリファレンスデザインのLEDを使用して、次のイベントを表示します。
LED_PERIOD_MS定数で構成できます。LED_PERIOD_MS定数で構成できます。 
