Switch to JSON IoT Agent

Author: jason-fox

README.ja.md

@@ -78,28 +78,28 @@ IoT Agent は、デバイスのグループが独自のネイティブ・プロ
 すべての IoT Agent は単一のペイロード形式に対して定義されていますが、
 そのペイロードに対して複数の異なるトランスポートを使用できます。。
 
-Ultralight IoT Agent にすでに紹介しました。これは、キーと値のペアの単純なバー
+JSON IoT Agent にすでに紹介しました。これは、キーと値のペアの単純なバー
 (`|`) で区切られたリストを使用して通信します。このペイロードは単純で
 簡潔ですが、比較的あいまいな通信メカニズムです。インターネットで使用される最も
 一般的なメッセージング・ペイロードは、JavaScript 開発者に馴染みのある、いわゆる
 JavaScript Object Notation または JSON です。
 
-JSON は Ultralight よりも若干冗長ですが、より大きなメッセージを送信するコスト
+JSON は JSON よりも若干冗長ですが、より大きなメッセージを送信するコスト
 は、構文の親しみやすさによって相殺されます。多くの一般的なデバイスは JSON 形式で
 メッセージを送信するようにプログラムでき、データを解析するためのソフトウェア・
 ライブラリが多数存在するため、個別の
 [IoT Agent for JSON](https://fiware-iotagent-json.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
 はこの形式で送信されるメッセージに対処するために特別に作成されました。
 
-JSON ペイロードを使用した通信と Ultralight プレーン・テキスト・ペイロードを
+JSON ペイロードを使用した通信と JSON プレーン・テキスト・ペイロードを
 使用した通信の間に実際的な違いはありません。その通信の基礎、言い換えれば、
 コンポーネント間でメッセージが渡される方法を定義する基本的なプロトコルは
 同じままです。明らかに、IoT Agent 内の JSON ペイロードの解析、つまり、JSON から
 NGSI へのメッセージの変換、またはその逆変換は、JSON IoT Agent に固有です。
 
 2つの IoT Agent の直接比較を以下に示します:
 
-| IoT Agent for Ultralight                                                   | IoT Agent for JSON                                                         | 関連するプロトコル領域     |
+| IoT Agent for JSON                                                   | IoT Agent for JSON                                                         | 関連するプロトコル領域     |
 | -------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------- |
 | サンプル測定値 `c\|1`                                                      | サンプル測定値 `{"count": "1"}`                                            | メッセージ・ペイロード     |
 | サンプル・コマンド `Robot1@turn\|left`                                     | サンプル・コマンド `{"Robot1": {"turn": "left"}}`                          | メッセージ・ペイロード     |
@@ -621,7 +621,7 @@ POST リクエストを以下に送信することを意味します。
 http://iot-agent:7896/iot/json?i=<device_id>&k=4jggokgpepnvsb2uv4s40d59ov
 ```
 
-これは、Ultralight IoT Agent と非常によく似た構文です - パスのみが
+これは、JSON IoT Agent と非常によく似た構文です - パスのみが
 変更されています。これにより、複数の IoT Agent が異なる場所でリッスン
 できます。
 
@@ -722,7 +722,7 @@ curl -iX POST \
 ```
 
 ペイロードと `Content-Type` の両方が更新されました。ダミー・デバイスは、
-ドアのロックが解除されたときに、以前のチュートリアルで同様の Ultralight
+ドアのロックが解除されたときに、以前のチュートリアルで同様の JSON
 リクエストを行いました。各モーション・センサの状態が変化し、ノースバウンド・
 リクエストがデバイス・モニタに記録されます。
 
@@ -899,7 +899,7 @@ curl -X GET \
 
 ### Smart Door のプロビジョニング
 
-基盤となる Ultralight プロトコルと JSON プロトコルは非常に類似しているため、
+基盤となる JSON プロトコルと JSON プロトコルは非常に類似しているため、
 アクチュエータとデバイスは、IoT Agent がデバイスと通信するために必要なデータと
 同じ属性を使用してプロビジョニングされ、NGSI を JSON に解析するペイロードは
 IoT Agent 自体に委任されます。コマンドと測定値の両方を提供するデバイスの

README.md

@@ -81,25 +81,25 @@ As defined previously, an IoT Agent is a component that lets a group of devices
 Context Broker using their own native protocols. Every IoT Agent is defined for a single payload format, although they
 may be able to use multiple disparate transports for that payload.
 
-We have already encountered the Ultralight IoT Agent, which communicates using a simple bar (`|`) separated list of
+We have already encountered the JSON IoT Agent, which communicates using a simple bar (`|`) separated list of
 key-value pairs. This payload is a simple, terse but relatively obscure communication mechanism - by far the commonest
 messaging payload used on the Internet is the so-called JavaScript Object Notation or JSON which will be familar to any
 software developer.
 
-JSON is slightly more verbose than Ultralight, but the cost of sending larger messages is offset by the familiarity of
+JSON is slightly more verbose than JSON, but the cost of sending larger messages is offset by the familiarity of
 the syntax. A separate
 [IoT Agent for JSON](https://fiware-iotagent-json.readthedocs.io/en/latest/usermanual/index.html#user-programmers-manual)
 has been created specifically to cope with messages sent in this format, since a large number of common devices are able
 to be programmed to send messages in JSON and many software libraries exist to parse the data.
 
-There is no practical difference between communicating using a JSON payload and communicating using the Ultralight plain
+There is no practical difference between communicating using a JSON payload and communicating using the JSON plain
 text payload - provided that the basis of that communication - in other words the fundamental protocol defining how the
 messages are passed between the components remains the same. Obviously the parsing of JSON payloads within the IoT
 Agent - the conversion of messages from JSON to NGSI and vice-versa will be unique to the JSON IoT Agent.
 
 A direct comparison of the two IoT Agents can be seen below:
 
-| IoT Agent for Ultralight                                            | IoT Agent for JSON                                                  | Protocol's Area of Concern |
+| IoT Agent for JSON                                            | IoT Agent for JSON                                                  | Protocol's Area of Concern |
 | ------------------------------------------------------------------- | ------------------------------------------------------------------- | -------------------------- |
 | Sample Measure `c\|1`                                               | Sample Measure `{"count": "1"}`                                     | Message Payload            |
 | Sample Command `Robot1@turn\|left`                                  | Sample Command `{"Robot1": {"turn": "left"}}`                       | Message Payload            |
@@ -531,7 +531,7 @@ GET or POST requests to:
 http://iot-agent:7896/iot/json?i=<device_id>&k=4jggokgpepnvsb2uv4s40d59ov
 ```
 
-Which is very similar syntax to the Ultralight IoT Agent - only the path has changed. This allows multiple IoT Agents to
+Which is very similar syntax to the JSON IoT Agent - only the path has changed. This allows multiple IoT Agents to
 listen at different locations.
 
 When a measurement from an IoT device is received on the resource URL it needs to be interpreted and passed to the
@@ -625,7 +625,7 @@ curl -iX POST \
   -d '{"c": "1"}'
 ```
 
-Both the payload and the `Content-Type` have been updated. The dummy devices made a similar Ultralight request in the
+Both the payload and the `Content-Type` have been updated. The dummy devices made a similar JSON request in the
 previous tutorials when the door was unlocked, you will have seen the state of each motion sensor changing and a
 Northbound request will be logged in the device monitor.
 
@@ -789,7 +789,7 @@ command can be seen in the value of the `ring_info` attribute.
 
 ### Provisioning a Smart Door
 
-Because the underlying Ultralight and JSON protocols are so similar, actuators and devices are provisioned using the
+Because the underlying JSON and JSON protocols are so similar, actuators and devices are provisioned using the
 same attributes as the data the IoT Agent needs to know to communicate with the device reamins the same, and the payload
 parsing NGSI to JSON is delegated to the IoT Agent itself. Provisioning a device which offers both commands and
 measurements is merely a matter of making an HTTP POST request with both `attributes` and `command` attributes in the

services

@@ -120,7 +120,7 @@ case "${command}" in
 		stoppingContainers
 		echo -e "Starting containers: \033[1;34mOrion\033[0m, \033[1;36mIoT-Agent\033[0m, \033[1;30mTutorial\033[0m and a \033[1;30mMongoDB\033[0m database."
 		echo -e "- \033[1;34mOrion\033[0m is the context broker"
-		echo -e "- \033[1;36mIoT-Agent\033[0m is configured for the UltraLight Protocol"
+		echo -e "- \033[1;36mIoT-Agent\033[0m is configured for the JSON Protocol"
 		echo -e "- \033[1;30mTutorial\033[0m acts as a series of dummy IoT Sensors over HTTP"
 		echo ""
 		${dockerCmd} up -d --remove-orphans