Update docstrings file heders

Author: brefra

plugwise/controller.py

@@ -1,4 +1,15 @@
-"""Base for Plugwise messages."""
+"""
+Message controller for USB-Stick
+
+The controller will:
+- handle the connection (connect/disconnect) to the USB-Stick
+- take care for message acknowledgements based on sequence id's
+- resend message requests when timeouts occurs
+- holds a sending queue (fifo)
+- passes received messages back to message processor (stick.py)
+- execution of callbacks after processing the response message
+
+"""
 
 from datetime import datetime, timedelta
 import logging

plugwise/parser.py

@@ -1,4 +1,16 @@
-"""Transform Plugwise message from wire format to response message object."""
+"""
+Data parser for USB-Stick
+
+The parser will:
+- buffer receiving data
+- filter out received zigbee routing data
+- collect message data by detecting header and footer
+- detect message type based on message ID or fixed sequence ID
+- validate received data on checksum
+- decode collected data into a response message instance
+- pass over received messages to message_processor (controller.py)
+
+"""
 
 import logging