Merge pull request arduino#27 from ToSa27/development

Improved documentation and usage of codebender for auto sketch compilation

Author: henrikekblad

Bootloader/Readme.md

@@ -0,0 +1,47 @@
+See NodeJsController/Readme.md for usage instructions...
+
+<h1>Technical details to write your own controller</h1>
+All initialization the bootloader does (finding parent / requesting nodeId on first start) uses the same packets as a normal MySensors sketch. There is no need for the controller to distinguish between packets from the bootloader and packets from normal sketch execution. The controller only needs to care about two additional request/response communications. All communication is binary.
+<h2>FirmwareConfig</h2>
+<ul>
+<li>the bootloader sends a FirmwareConfigRequest packet to the gateway to request information about the firmware it should execute:
+<p>
+typedef struct<br/>
+{<br/>
+&nbsp;uint16_t type;<br/>
+&nbsp;uint16_t version;<br/>
+} FirmwareConfigRequest;
+</p>
+<li>the gateway (the controller) responds with a FirmwareConfigResponse including details about the firmware the sensor should execute:
+<p>
+typedef struct<br/>
+{<br/>
+&nbsp;uint16_t type;<br/>
+&nbsp;uint16_t version;<br/>
+&nbsp;uint16_t blocks;<br/>
+&nbsp;uint16_t crc;<br/>
+} FirmwareConfigResponse;
+</p>
+</ul>
+<h2>Firmware</h2>
+<ul>
+<li>the bootloader sends a FirmwareRequest packet to the gateway to request a specific subset (block) of the compiled firmware:
+<p>
+typedef struct<br/>
+{<br/>
+&nbsp;uint16_t type;<br/>
+&nbsp;uint16_t version;<br/>
+&nbsp;uint16_t block;<br/>
+} FirmwareRequest;
+</p>
+<li>the gateway (the controller) responds with a FirmwareResponse including the specific block of the compiled firmware:
+</ul>
+<p>
+typedef struct<br/>
+{<br/>
+&nbsp;uint16_t type;<br/>
+&nbsp;uint16_t version;<br/>
+&nbsp;uint16_t block;<br/>
+&nbsp;uint8_t data[FIRMWARE_BLOCK_SIZE];<br/>
+} FirmwareResponse;
+</p>