Hello IoT World Demo - HTML Client
The Hello IoT World Demo is a simple real-time telemetry application based on MQTT.Cool.
The Hello IoT World Demo uses the MQTT.Cool Web Client API to show how MQTT.Cool can be used to send real-time telemetry data through the Web and, very important, how incoming update flow can be further manipulated in terms of bandwidth and frequency management.
In this demo, the Web page submits two MQTT subscriptions to two separate topics, in order to receive real-time telemetry metrics from a hypothetical car, such as Speed and Engine RPM. Upon receipt, data message is displayed by the pertinent graphical gauge.
Real-time telemetry updates are delivered by a random feed simulator, which is a pure MQTT Java client that connects to an MQTT broker, generates simulated data and publishes them to the target topics at a fixed interval (100 ms).
The demo shows how MQTT.Cool enables an end-to-end connection between the Web page and the MQTT broker, as it takes the role of real MQTT server proxy by acting as an intermediary for requests coming from the client and targeted to the broker (in this case, the subscriptions to telemetry topics), as well as for responses (subscription acks) and Application Messages (telemetry data) coming from the broker and directed to the client.
Use the Max Bandwidth slider to dynamically change the maximum bandwidth granted for the current session. Upon moving the slider, the new bandwidth will be notified by the client to MQTT.Cool, which in turn will change the update frequency on the fly, to respect the bandwidth limit. You can see that with a bandwidth as ridiculous as 0.5 kilobits per seconds, MQTT.Cool is still able to deliver updates to the page, thanks to the very optimized network protocol used.
Use the Max Frequency slider to dynamically change the maximum update rate of incoming messages relative to a single subscription. The client will renew the subscription asking for the new frequency limit and MQTT.Cool will change the update frequency on the fly, to respect the frequency limit.
You can see how the bandwidth and frequency constraints act on different levels. The bandwidth constraint is applied to the whole session, that is, to the global update flow for this page. On the other hand, the frequency constraint is applied to each MQTT subscription individually. Both the constraints set an upper bound, which is dynamically managed by MQTT.Cool. Note that the updates are not queued and delayed, but resampled and conflated. In other words, when a subscription has a chance to be updated (based on a round-robin algorithm), it will receive the very latest available message, not an old one.
Here the overall architecture of the demo:
If you want to install a version of this demo pointing to your local MQTT.Cool, follows these steps.
As prerequisite, this demo needs an up and running MQTT broker. You can choose whatever MQTT broker you prefer, or may also use one of the available public broker (an up-to-date list is maintained at https://github.com/mqtt/mqtt.github.io/wiki/public_brokers).
Configure an MQTT.Cool instance. Please refer to mqtt.cool web site download page to find the MQTT.Cool download package. MQTT.Cool comes with a set of predefined configurations for connecting with local MQTT server instances, as well as with the most common publicly accessible brokers. If you want to provide a new custom configuration, open the
brokers_configuration.xmlfile located under
<MQTT.COOL_HOME>/confand provide a set of entries similar to the following (please refer to the inline documentation for more in-depth information on how to configure broker connection parameters):
... <!-- MQTT broker connection parameters for a local instance listening on port 1883, aliased by "mybroker". --> <param name="mybroker.server_address">tcp://localhost:1883</param> <param name="mybroker.connection_timeout">5</param> <param name="mybroker.keep_alive">20</param> ...
Launch the MQTT.Cool server.
Download this project.
unpkg, it is hot-linked in the html page.
jQuery is currently hot-linked in the html page: you may want to replace it with a local version and/or to upgrade its version.
Deploy this demo on MQTT.Cool (used as Web server) or in any external Web server. If you choose the former, create a folder with name such as
<MQTT.COOL_HOME>/pagesfolder, and copy there the contents of
src/webof this project.
maven is installed on you machine, build the feed simulator and
generate the launch scripts by executing the following command:
$ mvn package appaassembler:assemble
After that, all the resources needed to launch the simulator are placed under
the newly created
The demo assumes that the MQTT.Cool server is launched from localhost, but if
you need to target a different server, search in
const MQTT_COOL_URL = 'http://localhost:8080';
and change it accordingly.
Further, the demo will look for the mosquitto alias, which is one of the
predefined configurations in
brokers_configuration.xml. Once more, if you
need to target a different MQTT broker, and provided that relative connection
parameters are already defined as shown above, modify the following line in
mqttClient = mqttCoolSession.createClient('mosquitto');
and change it by replacing mosquitto with the new alias that maps the MQTT broker you are going to use.
Open your browser and point it to http://localhost:8080/Hello_IoT_World, or to the address according to the host and/or the name of the folder where you deployed the project.
feed folder, run the feed simulator application to publish simulated
On Linux systems;
$ sh bin/startFeed <url_broker>
On Window systems:
$ bin\startFeed.bat <url_broker>
url_broker is the url of the MQTT broker relative to the alias in use.
Immediately, the gauges in the web page reflect updates according to the received real-time metrics.
MQTT.Cool Compatibility Notes
- Compatible with MQTT.Cool SDK for Web Clients version 1.0.0 or newer.
- Compatible with MQTT.Cool since version 2.0.0 or newer.