Release 0.9

Author: ako

.classpath

@@ -3,6 +3,6 @@
 	<classpathentry kind="src" path="javasource"/>
 	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
 	<classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/biz.aQute.bnd.bndlib.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/org.scala-lang.scala-library.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/com.mendix.datastorage-api.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/com.mendix.json.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/com.mendix.logging.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/com.mendix.m2ee-api.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/com.mendix.mxruntime.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/com.mendix.integration.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/org.osgi.compendium.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/com.mendix.webui.jar"/><classpathentry kind="lib" path="C:/Program Files/Mendix/6.6.0/runtime/bundles/javax.servlet.jar"/>
-	<classpathentry kind="lib" path="userlib/antisamy-1.5.3.jar"/><classpathentry kind="lib" path="userlib/aopalliance-1.0.jar"/><classpathentry kind="lib" path="userlib/apache-mime4j-core-0.7.2.jar"/><classpathentry kind="lib" path="userlib/axiom-api-1.2.19.jar"/><classpathentry kind="lib" path="userlib/batik-css-1.7.jar"/><classpathentry kind="lib" path="userlib/batik-ext-1.7.jar"/><classpathentry kind="lib" path="userlib/batik-util-1.7.jar"/><classpathentry kind="lib" path="userlib/bcpkix-jdk15on-1.54.jar"/><classpathentry kind="lib" path="userlib/bcprov-jdk15on-1.54.jar"/><classpathentry kind="lib" path="userlib/bcprov-jdk16-1.46.jar"/><classpathentry kind="lib" path="userlib/commons-codec-1.3.jar"/><classpathentry kind="lib" path="userlib/commons-fileupload-1.3.2.jar"/><classpathentry kind="lib" path="userlib/commons-httpclient-3.1.jar"/><classpathentry kind="lib" path="userlib/commons-io-2.2.jar"/><classpathentry kind="lib" path="userlib/commons-lang-2.5.jar"/><classpathentry kind="lib" path="userlib/commons-lang3-3.4.jar"/><classpathentry kind="lib" path="userlib/commons-logging-1.2.jar"/><classpathentry kind="lib" path="userlib/fontbox-1.8.12.jar"/><classpathentry kind="lib" path="userlib/geronimo-activation_1.1_spec-1.1.jar"/><classpathentry kind="lib" path="userlib/geronimo-stax-api_1.0_spec-1.0.1.jar"/><classpathentry kind="lib" path="userlib/guava-14.0.1.jar"/><classpathentry kind="lib" path="userlib/guice-2.0.jar"/><classpathentry kind="lib" path="userlib/hamcrest-core-1.3.jar"/><classpathentry kind="lib" path="userlib/httpclient-4.1.jar"/><classpathentry kind="lib" path="userlib/httpcore-4.1.jar"/><classpathentry kind="lib" path="userlib/java-configparser-0.2.jar"/><classpathentry kind="lib" path="userlib/jaxen-1.1.6.jar"/><classpathentry kind="lib" path="userlib/jempbox-1.8.12.jar"/><classpathentry kind="lib" path="userlib/joda-time-2.8.2.jar"/><classpathentry kind="lib" path="userlib/junit-4.12.jar"/><classpathentry kind="lib" path="userlib/nekohtml-1.9.16.jar"/><classpathentry kind="lib" path="userlib/openid4java-0.9.8.jar"/><classpathentry kind="lib" path="userlib/org.eclipse.paho.client.mqttv3-1.1.0.jar"/><classpathentry kind="lib" path="userlib/pdfbox-1.8.12.jar"/><classpathentry kind="lib" path="userlib/slf4j-api-1.7.5.jar"/><classpathentry kind="lib" path="userlib/slf4j-simple-1.7.5.jar"/><classpathentry kind="lib" path="userlib/xercesImpl-2.9.1.jar"/><classpathentry kind="lib" path="userlib/xml-apis-1.3.04.jar"/><classpathentry kind="lib" path="userlib/xml-apis-ext-1.3.04.jar"/>
+	<classpathentry kind="lib" path="userlib/bcpkix-jdk15on-1.54.jar"/><classpathentry kind="lib" path="userlib/bcprov-jdk15on-1.54.jar"/><classpathentry kind="lib" path="userlib/bcprov-jdk16-1.46.jar"/><classpathentry kind="lib" path="userlib/guava-14.0.1.jar"/><classpathentry kind="lib" path="userlib/org.eclipse.paho.client.mqttv3-1.1.0.jar"/>
 	<classpathentry kind="output" path="deployment/run/bin"/>
 </classpath>

DIST/MqttClient-0.9.mpk

@@ -8,17 +8,33 @@ Tested with [AWS IoT][5], [The Things network][4] and [mosquitto][2] brokers.
 Main java actions:
 
  * MqttPublish - publish a message to specified topic
- * MqttSubscribe - subscribe to a topic. Required you to specify a microflow which will be called upon receiving 
+ * MqttSubscribe - subscribe to a topic. Required you to specify a microflow which will be called upon receiving
    a message. This microflow should have two string parameters: Topic and Payload.
- * MqttUnsubscribe
- 
+ * MqttUnsubscribe - unsubscribe from topic
+
+  ![MQTT Microflow actions toolbox][9]
+
 ## Usage with Amazon AWS IoT
 
 You need to register your app as a Thing on AWS IoT. Download the generated certificates and store them in your resources 
 folder of your app. When subscribing or publishing a message specify their location reletive to the resources folder.
 
 ## Usage with TTN
 
+For TTN you can leave the certifice info empty, instead provide username and password.
+
+Microflow to subscribe to an MQTT topic:
+
+ ![MQTT subscribe to topic][10]
+
+Configuration of subscribe for TTN:
+
+ ![][11]
+
+Microflow to handled messages received:
+
+ ![][12]
+
 ## Development
 
 Java dependencies are managed using Apache Ivy. There are two configuration:
@@ -43,3 +59,7 @@ included in the connector mpk.
  [6]: https://staging.thethingsnetwork.org/wiki/Backend/Connect/Application
  [7]: https://staging.thethingsnetwork.org/wiki/Backend/Security
  [8]: https://staging.thethingsnetwork.org/wiki/Backend/ttnctl/QuickStart
+ [9]: docs/images/mqtt-toolbox.png
+ [10]: docs/images/mqtt-subscribe-action.png
+ [11]: docs/images/mqtt-subscribe-ttn.png
+ [12]: docs/images/mqtt-ttn-on-message-mf.png

MqttClient.mpr

@@ -1,3 +1,3 @@
 rm userlib/*
 java -jar build\apache-ivy-2.4.0\ivy-2.4.0.jar -ivy ivy.xml -confs export -retrieve "userlib/[artifact]-[revision].[ext]"
-for %%f in (userlib\*) do touch %%f-MqttClient
+for %%f in (userlib\*) do touch %%f-MqttClient.RequiredLib