The Map Worm (MQTTwrapper Class Demo)

(No library is wrapped...)

Go back to example list / Go to the repository of this example on GitHub

HOST (Where is the broker):

SEND (Behave as a publisher):

RECV (Behave as a subscriber):

Map (Pick up from the subscriber):

The coordinate points will be pinned and drawn lines when the above subscriber receives them if the coordinate is formatted like the following.

plot lat lng name

lat

Latitude (real-number, -90≦lat≦90)

lng

Longitude (real-number, -180≦lng≦180)

name

the name of the point (option)

Or you can erase all pins and lines by the following message.

erase all

README (What is this?):

This is a control panel to try to use the MQTTwrapper class. This library makes your web browser an MQTT-over-WebSocket speaker. And then the protocol is very helpful to send/receive text data (also byte stream) from/to the UNIX stdin/stdout.

Only one simple application is required to connect to the stdin/stdout. That is "Mosquitto."

Try to use me by the following steps.

How to Use Me:

0-1) [PREP.] Install Mosquitto

The installation instructions are on this page.

0-2) [PREP.] Write the configuration for Mosquitto

Copy and save the following text as the file "mosquitto.local.conf" in your favor directory.
allow_anonymous true #=== Plain MQTT listener 1883 protocol mqtt #=== Plain MQTT over WebSocket listener 8000 protocol websockets #=== Secure MQTT over WebSocket (TLS) listener 8884 protocol websockets certfile /PATH/TO/YOUR/certfile.pem keyfile /PATH/TO/YOUR/keyfile.pem cafile /PATH/TO/YOUR/cafile.pem

1) Start an MQTT broker

Type the following command on your UNIX terminal.
$ mosquitto -c mosquitto.local.conf

2) Connect me to the MQTT broker

In the "HOST" section, fill in the URL form (Specify "ws://localhost:8000/" to use the above MQTT broker, of course, it's OK to use another broker.) and push the "Connect" button. Then, wait for the button name to be "CONNECTED."

3) Start subscribing

Decide on the topic name in the "RECV" secion and type it into the "topicname" field. Then, push the "Start" button in the same section.

4) Run "mapworm.sh" to get the sample

Run the "../../../sh_for_example/mapworm.sh" on a UNIX terminal. Note that you have to use the same MQTT broker and the same topic name as what you specified in this HTML. (See the "mapworm.sh" usage to do it.)

Finally, you can see the "Map worm" growing on the map.