Skip to content

Commit f6616e0

Browse files
jason-foxjason-fox
committed
Switch to JSON IoT Agent
1 parent 4ef4083 commit f6616e0

3 files changed

Lines changed: 51 additions & 51 deletions

File tree

‎README.ja.md‎

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
[![FIWARE IoT Agents](https://fiware.github.io/catalogue/badges/chapters/iot-agents.svg)](https://github.com/FIWARE/catalogue/blob/master/iot-agents/README.md)
55
[![License: MIT](https://img.shields.io/github/license/fiware/tutorials.IoT-over-MQTT.svg)](https://opensource.org/licenses/MIT)
66
[![Support badge](https://img.shields.io/badge/tag-fiware-orange.svg?logo=stackoverflow)](https://stackoverflow.com/questions/tagged/fiware)
7-
[![UltraLight 2.0](https://img.shields.io/badge/Payload-Ultralight-27ae60.svg)](https://fiware-iotagent-ul.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
7+
[![JSON](https://img.shields.io/badge/Payload-JSON-27ae60.svg)](https://fiware-iotagent-json.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
88
<br/> [![Documentation](https://img.shields.io/readthedocs/fiware-tutorials.svg)](https://fiware-tutorials.rtfd.io)
99

1010
<!-- prettier-ignore -->
@@ -13,7 +13,7 @@
1313
を紹介します
1414
。[以前のチュートリアル](https://github.com/FIWARE/tutorials.IoT-Agent) で作成し
1515
た
16-
、[UltraLight 2.0](https://fiware-iotagent-ul.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
16+
、[JSON](https://fiware-iotagent-json.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
1717
IoT Agent は、[Mosquitto](https://mosquitto.org/) message broker を介して MQTT
1818
を使用して一連のダミー IoT デバイスと通信するように再構成されます。
1919

@@ -29,7 +29,7 @@ IoT Agent は、[Mosquitto](https://mosquitto.org/) message broker を介して
2929
- [アーキテクチャ](#architecture)
3030
- [Mosquitto の設定](#mosquitto-configuration)
3131
- [ダミー IoT デバイスの設定](#dummy-iot-devices-configuration)
32-
- [IoT Agent for UltraLight 2.0 の設定](#iot-agent-for-ultralight-20-configuration)
32+
- [IoT Agent for JSON の設定](#iot-agent-for-ultralight-20-configuration)
3333
- [前提条件](#prerequisites)
3434
- [Docker と Docker Compose](#docker-and-docker-compose)
3535
- [WSL](#wsl)
@@ -94,8 +94,8 @@ IoT Agent は、[Mosquitto](https://mosquitto.org/) message broker を介して
9494
| IoT デバイスは、常に通信を受信する準備ができている必要があります | IoT デバイスは、いつ通信を受けるかを選択します |
9595
| より高い消費電力要件 | 低消費電力要件 |
9696

97-
UltraLight 2.0 IoT Agent は
98-
、[UltraLight 2.0](https://fiware-iotagent-ul.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
97+
JSON IoT Agent は
98+
、[JSON](https://fiware-iotagent-json.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
9999
構文を使用してメッセージを送信または解釈するだけですが、複数の**転送**メカニズム
100100
を使用してメッセージを送受信するために使用できます。したがって、同じ FIWARE
101101
Generic Enabler を使用して、より幅広い範囲の IoT デバイスに接続することができま
@@ -112,7 +112,7 @@ Generic Enabler を使用して、より幅広い範囲の IoT デバイスに
112112
このチュートリアルの目的のために、一連のダミー IoT デバイスが作成され、Context
113113
Broker に接続されます。使用されるアーキテクチャとプロトコルの詳細は
114114
、[IoT Sensors のチュートリアル](https://github.com/FIWARE/tutorials.IoT-Sensors/tree/NGSI-v2)に
115-
あります。各デバイスの状態は、次の UltraLight デバイス・モニタの Web ページで確
115+
あります。各デバイスの状態は、次の JSON デバイス・モニタの Web ページで確
116116
認できます : `http://localhost:3000/device/monitor`
117117

118118
![FIWARE Monitor](https://fiware.github.io/tutorials.IoT-over-MQTT/img/device-monitor.png)
@@ -125,7 +125,7 @@ Broker に接続されます。使用されるアーキテクチャとプロト
125125
、[以前のチュートリアル](https://github.com/FIWARE/tutorials.IoT-Agent/)で作成し
126126
たコンポーネントに基づいています
127127
。[Orion Context Broker](https://fiware-orion.readthedocs.io/en/latest/) と
128-
[IoT Agent for UltraLight 2.0](https://fiware-iotagent-ul.readthedocs.io/en/latest/)
128+
[IoT Agent for JSON](https://fiware-iotagent-json.readthedocs.io/en/latest/)
129129
の 2 つの FIWARE コンポーネントを使用します。アプリケーションが _“Powered by
130130
FIWARE”_ と認定されるには、Orion Context Broker を使用するだけで十分です。Orion
131131
Context Broker と IoT Agent はオープンソースの
@@ -141,11 +141,11 @@ Context Broker と IoT Agent はオープンソースの
141141
、[NGSI-v2](https://fiware.github.io/specifications/OpenAPI/ngsiv2) を使用して
142142
リクエストを受信します
143143
- FIWARE
144-
[IoT Agent for UltraLight 2.0](https://fiware-iotagent-ul.readthedocs.io/en/latest/)
144+
[IoT Agent for JSON](https://fiware-iotagent-json.readthedocs.io/en/latest/)
145145
は以下を行います :
146146
- [NGSI-v2](https://fiware.github.io/specifications/OpenAPI/ngsiv2) を使用し
147147
てサウス・バウンド・リクエストを受信し、MQTT Broker 用の
148-
[UltraLight 2.0](https://fiware-iotagent-ul.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
148+
[JSON](https://fiware-iotagent-json.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
149149
の**トピック**に変換します
150150
- 登録された**トピック**について **MQTT Broker** をリッスンし、測定値をノ
151151
ース・バウンドに送信します
@@ -159,7 +159,7 @@ Context Broker と IoT Agent はオープンソースの
159159
- **IoT Agent** がデバイスの URLs や Keys などのデバイス情報を保持するため
160160
に使用します
161161
- MQTT 上で動作する
162-
[UltraLight 2.0](https://fiware-iotagent-ul.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
162+
[JSON](https://fiware-iotagent-json.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
163163
プロトコルを使用して
164164
、[ダミー IoT デバイス](https://github.com/FIWARE/tutorials.IoT-Sensors/tree/NGSI-v2)のセ
165165
ットとして機能する Web サーバー
@@ -245,7 +245,7 @@ tutorial:
245245
- ポート `3000` が公開されているので、ダミー IoT デバイスを表示する Web ページ
246246
が表示されます
247247
- ポート `3001` はチュートリアルのアクセスのためだけに公開されているため、cUrl
248-
または Postman は同じネットワーク以外からも、UltraLight コマンドを作成できま
248+
または Postman は同じネットワーク以外からも、JSON コマンドを作成できま
249249
す
250250

251251
`tutorial` コンテナは、次のように環境変数によって設定値を指定できます :
@@ -255,23 +255,23 @@ tutorial:
255255
| DEBUG | `tutorial:*` | ロギングに使用するデバッグ・フラグ |
256256
| WEB_APP_PORT | `3000` | ダミー・デバイスのデータを表示する web-app が使用するポート |
257257
| DUMMY_DEVICES_PORT | `3001` | コマンドを受信するためにダミー IoT デバイスが使用するポート |
258-
| DUMMY_DEVICES_API_KEY | `4jggokgpepnvsb2uv4s40d59ov` | UltraLight インタラクションに使用されるランダムなセキュリティキー - デバイスと IoT Agent 間のインタラクションの完全性を保証するために使用されます |
258+
| DUMMY_DEVICES_API_KEY | `4jggokgpepnvsb2uv4s40d59ov` | JSON インタラクションに使用されるランダムなセキュリティキー - デバイスと IoT Agent 間のインタラクションの完全性を保証するために使用されます |
259259
| DUMMY_DEVICES_TRANSPORT | `MQTT` | ダミー IoT デバイスによって使用されるトランスポート・プロトコル |
260260

261261
このチュートリアルでは、YAML ファイルで記述されている他の `tutorial` コンテナの
262262
設定値は使用しません。
263263

264264
<a name="iot-agent-for-ultralight-20-configuration"></a>
265265

266-
## IoT Agent for UltraLight 2.0 の設定
266+
## IoT Agent for JSON の設定
267267

268-
[IoT Agent for UltraLight 2.0](https://fiware-iotagent-ul.readthedocs.io/en/latest/)
268+
[IoT Agent for JSON](https://fiware-iotagent-json.readthedocs.io/en/latest/)
269269
は 、Docker コンテナ内でインスタンス化できます。公式の Docker イメージは、Docker
270-
Hub からタグ付けされた `fiware/iotagent-ul` です。必要な構成を以下に示します :
270+
Hub からタグ付けされた `fiware/iotagent-json` です。必要な構成を以下に示します :
271271

272272
```yaml
273273
iot-agent:
274-
image: quay.io/fiware/iotagent-ul:latest
274+
image: quay.io/fiware/iotagent-json:latest
275275
hostname: iot-agent
276276
container_name: fiware-iot-agent
277277
depends_on:
@@ -318,7 +318,7 @@ iot-agent:
318318
| IOTA_LOG_LEVEL | `DEBUG` | IoT Agent のログ・レベル |
319319
| IOTA_TIMESTAMP | `true` | 接続されたデバイスから受信した各測定値にタイムスタンプ情報を提供するかどうかを指定 |
320320
| IOTA_CB_NGSI_VERSION | `v2` | アクティブな属性の更新を送信するときにNGSI v2 を使用するように指定するかどうか |
321-
| IOTA_AUTOCAST | `true` | Ultralight の数値が文字列ではなく数値として読み取られるようにする |
321+
| IOTA_AUTOCAST | `true` | JSON の数値が文字列ではなく数値として読み取られるようにする |
322322
| IOTA_MONGO_HOST | `context-db` | mongoDB のホスト名 - デバイス情報を保持するために使用 |
323323
| IOTA_MONGO_PORT | `27017` | mongoDB はリッスンしているポート |
324324
| IOTA_MONGO_DB | `iotagentul` | mongoDB で使用されるデータベースの名前 |
@@ -414,7 +414,7 @@ Bash スクリプトを実行することによって、コマンドラインか
414414

415415
チュートリアルを正しく実行するには、ブラウザのデバイス・モニタページが表示されて
416416
いることを確認し、ページをクリックして cUrl コマンドを入力する前にオーディオを有
417-
効にしてください。デバイス・モニタには、Ultralight 2.0 構文を使用して、ダミー
417+
効にしてください。デバイス・モニタには、JSON 構文を使用して、ダミー
418418
IoT デバイスのアレイの現在の状態が表示されます。
419419

420420
#### デバイス・モニタ
@@ -697,7 +697,7 @@ curl -iX POST \
697697
"entity_name": "urn:ngsi-ld:Motion:001",
698698
"entity_type": "Motion",
699699
"apikey": "4jggokgpepnvsb2uv4s40d59ov",
700-
"protocol": "PDI-IoTA-UltraLight",
700+
"protocol": "PDI-IoTA-JSON",
701701
"transport": "MQTT",
702702
"timezone": "Europe/Berlin",
703703
"attributes": [
@@ -834,7 +834,7 @@ curl -iX POST \
834834
"device_id": "bell001",
835835
"entity_name": "urn:ngsi-ld:Bell:001",
836836
"entity_type": "Bell",
837-
"protocol": "PDI-IoTA-UltraLight",
837+
"protocol": "PDI-IoTA-JSON",
838838
"transport": "MQTT",
839839
"apikey": "4jggokgpepnvsb2uv4s40d59ov",
840840
"commands": [
@@ -935,7 +935,7 @@ curl -iX POST \
935935
"device_id": "door001",
936936
"entity_name": "urn:ngsi-ld:Door:001",
937937
"entity_type": "Door",
938-
"protocol": "PDI-IoTA-UltraLight",
938+
"protocol": "PDI-IoTA-JSON",
939939
"transport": "MQTT",
940940
"apikey": "4jggokgpepnvsb2uv4s40d59ov",
941941
"commands": [
@@ -977,7 +977,7 @@ curl -iX POST \
977977
"device_id": "lamp001",
978978
"entity_name": "urn:ngsi-ld:Lamp:001",
979979
"entity_type": "Lamp",
980-
"protocol": "PDI-IoTA-UltraLight",
980+
"protocol": "PDI-IoTA-JSON",
981981
"transport": "MQTT",
982982
"apikey": "4jggokgpepnvsb2uv4s40d59ov",
983983
"commands": [
@@ -1020,7 +1020,7 @@ IoT Agent を IoT デバイスに接続すると、Orion Context Broker にコ
10201020

10211021
コマンドが登録されると
10221022
、[以前のチュートリアル](https://github.com/FIWARE/tutorials.IoT-Sensors/tree/NGSI-v2)で実行
1023-
したように、IoT デバイスに直接 UltraLight 2.0 リクエストを送信するのではなく
1023+
したように、IoT デバイスに直接 JSON リクエストを送信するのではなく
10241024
、**ベル**を鳴らし、**スマート・ドア**を開閉し、**スマート・ランプ**をオン/オフ
10251025
に切り替えることができます。
10261026

0 commit comments

Comments
 (0)