Merge remote-tracking branch 'origin/master'

Author: David Graeff

README.md

@@ -47,11 +47,21 @@ This project is not for the old eclipse based SDK! It depends on the
 support libraries (v13), additional support library extensions (v7.RecyclerView) and need at least android 4.2 (sdk version 17, released 13. Nov 2012). Parts of the app (import/export/backgrounds) are only usuable with Android 4.4 (DocumentProvider class).
 
 ### Plugin Development
-All you need to develop a plugin is described in detail at the [Plugin Developer Documentation](https://github.com/davidgraeff/Android-NetPowerctrl-Shared#plugin-developer-documentation).
+In ealier versions plugins via the android IPC were supported. This is no longer the case. Your app will be started by NetPowerCtrl via a Broadcast, from this point on, use the simpleUDP protocol for communication.
+All you need to develop a plugin is described in detail at the [Plugin Developer Documentation](https://github.com/davidgraeff/Android-NetPowerctrl/blob/master/doc/simpleudp.md). Sample implementations are available here: https://github.com/davidgraeff/esp8266_dev/tree/master/app_pc
 
 ### Authors
 * david.graeff(at)web_de
 * Some icons from http://www.clker.com/
 
+### Used external libraries
+* com.github.rey5137:material:1.1.0 (Apache License, Version 2.0)
+* com.wefika:flowlayout:0.3.4 (Apache License, Version 2.0)
+* jp.wasabeef:recyclerview-animators:1.2.0@aar (Apache License, Version 2.0)
+* com.github.gabrielemariotti.changeloglib:library:1.5.2 (Apache License, Version 2.0)
+* ch.acra:acra:4.6.2 (Apache License, Version 2.0)
+* net.lingala.zip4j:zip4j:1.3.2 (Apache License, Version 2.0)
+* com.google.code.ndef-tools-for-android:ndeftools:1.2.4 (Apache License, Version 2.0)
+    
 ### License
 Dual licensed: GPLv2+GPLv3

doc/simpleudp.md

@@ -0,0 +1,51 @@
+# SimpleUDP
+
+## SimpleUDP Packet Format (Receive type)
+* All ascii based, two characters not allowed in names and ids: newline (\n) and tabulator (\t).
+
+### General structure (lines are separated by newlines)
+Header (always SimpleUDP_info or SimpleUDP_info_ack or SimpleUDP_info_fail)
+DeviceUniqueID (often Mac address of peer)
+Name of device (english name of device, user may rename it within the app)
+Version string (no special formatting)
+List of actions (one action per line, action consists of multiple tokens)
+
+If you send SimpleUDP_detect, you will receive a full SimpleUDP_info with all known actions. If
+you send a SimpleUDP_cmd, the peer will acknowledge with a SimpleUDP_info_ack where only the affected
+actions are listed.
+
+### Structure of an action
+     TYPE \t actionID string \t action name \t optional value
+
+* **TYPE** is one of (STATELESS,TOGGLE,RANGE,NOTEXIST).
+* The **actionID** may be any string but have to be unique among all actions.
+* The **action name** can be any string as long as it does not contain \n and \t.
+* The value is only necessary if the type is TOGGLE or RANGE. If the Header is equal to SimpleUDP_info_fail
+the TYPE may be NOTEXIST if you requested a command on a non existing action.
+
+Example packet:
+     SimpleUDP_info\n
+     11:22:33:44:55:66\n
+     device_name\n
+     1.0-2015.05.10\n
+     STATELESS\tACTION1\tAction Name
+     TOGGLE\tACTION2\tAction Name\t1
+
+## SimpleUDP Packet Format (command type)
+* All ascii based, two characters not allowed in names and ids: newline (\n) and tabulator (\t).
+
+### General structure (lines are separated by newlines)
+    Header (always SimpleUDP_cmd)
+    UniqueID (we use the android device unique id)
+    CMD_TYPE \t actionID \t VALUE \t RANDOM_REQUEST_NO
+
+* **CMD_TYPE** is one of (SET,TOGGLE,RENAME), the actionID has been received before and is known.
+* **VALUE**: if CMD_TYPE is SET,RENAME a value is necessary else just set it to 0.
+* **RANDOM_REQUEST_NO**: A random request number. This is for duplicate detection. The receiver has
+to check the current commands request number against the last ~3 requests and ignore (but still
+ack) the received but already executed command.
+
+Example packet:
+     SimpleUDP_cmd\n
+     NFKAJELAFBAGAHD\n
+     SET\tACTION2\t1