readme update

Author: bitrate16

README.md

@@ -13,19 +13,21 @@ The script provided here was built based on an analysis of captured Bluetooth tr
 
 Essentially, the script takes an input images, scales it to the printers native X resolution of 384 pixels, and then sends it to the printer.
 
-## Current abilities
+## Features
 
 * Printing text of any length encoded in ASCII
 * Printing Images using PIL library
-* Printing raw bytes representing image in binary (black/white) form
-* Printing a page break of desired size (in pixels)
-* Printing using generator/iterator which returns image row by row in form of bytes or PIL Images
+* Printing Images row-by row using binary row representation
+* Printing page breaks using paper feed
+* Printing using generator/iterator that return bytes for each row, chunks of bytes for each row, images
 * Requesting printer details (Serial Number, Name, Battery Level, Hardware Info and an option the meaning of which i don't know)
-* Configuring print concentration (light, gray, black)
+* Configuring print concentration (temperature)
+* Changing printer serial number
 * Configuring printer poweroff timeout
 
-## Prerequirements
-* Peripage A6/A6+ printer
+## Prerequisites
+
+* Peripage A6/A6+/A40/e.t.c printer
 * Python 3
 
 ## Installation
@@ -44,31 +46,14 @@ pip install peripage
 ```
 
 ## Dependencies
-* `PyBluez==0.30`
-* `Pillow==8.1.2`
-* `argparse==1.1` (for CLI)
+
+* `PyBluez>=0.30`
+* `Pillow>=8.1.2`
+* `argparse>=1.1`
 
 Install dependencies with
 `pip install -r requirements.txt`
 
-On windows you may need to install PyBluez 0.3
-```
-git clone https://github.com/pybluez/pybluez
-cd pybluez
-pip install . --user
-```
-
-On raspberry pi it may require to install additional libraries
-```
-sudo apt install libbluetooth-dev libopenjp2-7 libtiff5
-```
-
-And in some cases you will have to restart the bluetooth adapter and service on raspberry pi when it fails to connect or device is busy
-```
-sudo systemctl restart bluetooth
-sudo hciconfig hci0 reset
-```
-
 ## Identify printer Bluetooth MAC address
 
 **On linux:**
@@ -100,6 +85,27 @@ Scanning bluetooth devices... please wait.
 00:15:83:15:bc:5f    Imaging                         PeriPage+BC5F
 ```
 
+## Troubleshooting
+
+> Windows installation requires installing PyBluez from master branch as pypi module is not updated
+
+```
+pip install git+https://github.com/pybluez/pybluez@master#egg=pybluez --user
+```
+
+> Raspberry PI installation requires additional libraries
+
+```
+sudo apt install libbluetooth-dev libopenjp2-7 libtiff5
+```
+
+> Some cases may require restarting bluetooth adapter
+
+```
+sudo systemctl restart bluetooth
+sudo hciconfig hci0 reset
+```
+
 ## CLI usage
 
 **On linux**
@@ -152,7 +158,7 @@ peripage -m 00:15:83:15:bc:5f -p A6p -b 100 -t "HONK" -n
 ```
 Newline is required to fush the internal printer buffer and force it to print all text without cutting
 
-### Print Service example
+## Print Service
 
 **Print 50 text tasks on A6+**
 ```python
@@ -171,7 +177,8 @@ for i in range(50):
 ```
 Newline is required to fush the internal printer buffer and force it to print all text without cutting
 
-### Suggestions
+## Recommendations
+
 * Don't forget about concentration, this can make print brighter and better visible.
 * Split long images into multiple print requests with cooldown time for printer (printer may overheat during a long print and will stop printing for a while. This will result in partial print loss because the internal buffer is about 250px height). For example, when you print [looooooooooooooooooooooooooooooongcat.jpg](http://lurkmore.so/images/9/91/Loooooooooooooooooooooooooooooooooooooooooongcat.JPG), split it into at least 20 pieces with 1-2 minutes delay because you will definetly loose something without cooling. Printer gets hot very fast. Yes, it was the first that i've printed.
 * Be carefull when printing lots of black or using max concentration, as i said, printer heats up very fast.
@@ -183,6 +190,8 @@ Newline is required to fush the internal printer buffer and force it to print al
 
 View this [python notebook](https://github.com/bitrate16/peripage-python/blob/main/notebooks/peripage-tutorial.ipynb) for tutorial
 
+View this [python notebook](https://github.com/bitrate16/peripage-python/blob/main/notebooks/Test-notebook.ipynb) for test
+
 ## Printer disassembly
 
 [Disassembly for A6+](https://imgur.com/a/6LLwuaD)
@@ -194,17 +203,30 @@ View this [python notebook](https://github.com/bitrate16/peripage-python/blob/ma
 * Python 2.7 support
 * Implement overheat protection
 * Implement cover open handler
-* Tweak wait timings to precisely match the printing speed
+* Tweak wait timings to precisely match printing speed
 * Implement printer renaming
 * Implement printing stop operation
 * Reverse-engineer USB driver and add support for it
-* **FIX:** Print randomly gets cropped (some images getting cropped)
-* **FIX:** 1 type conversion is low quality
+* Print randomly gets cropped (some images getting cropped)
+* 1 type conversion is low quality
+
+## Contribution
+
+> Q: How to contribute?
+>
+> A: Implement some features and make a pull request in this repo. For example, you could add info about USB communication, write a any-font printing using PIL text drawing, make an additional research in protocol and other cool things.
+
+> Q: How to get my printer supported?
+>
+> A: If you own a peripage printer that is currently unsupported, you can reverse-engineer the bluetooth packets captured from the oficial printing app and find out the specs of your printer (the main and the only spec is bytes per row). Another way is to find how many letters can fit in a row when using `printASCII()`.
+>
+> If you would like to participate, please make an issue and I will guide you on how to obtain required parameters.
 
 ## Credits
 
 * [Elias Weingärtner](https://github.com/eliasweingaertner) for initial work in reverse-engineering bluetooth protocol
 * [bitrate16](https://github.com/bitrate16) for additional research and python module
+* [henryleonard](https://github.com/henryleonard) for specs of A40 printer
 
 ## Disclaimer