Merge branch 'main' of https://github.com/pinballpower/code_dmdreader

Author: pinballpower

README.md

@@ -7,11 +7,16 @@ It also runs on Windows. This is especially helpful if you want to test a colori
 ## License
 The license has been changed from MIT to GPL v3 on 2.5.2022. In general, I'm not a big fan of the GPL and rather prefer the more open MIT license. 
 However, in similar products open source software has been used to create close-source software that should replace existing open-source software. 
-To make sure that won't happen with this software, the license of this software has been changed to GPL v3. Just to clarify: That doesn't mean 
-anything about "commercial" or "non-commercial" use cases. If you want to create a commercial product based on this software, feel free to do so. 
+To make sure that won't happen with this software, the license of this software has been changed to GPL v3. 
+Just to clarify: That doesn't mean anything about "commercial" or "non-commercial" use cases. If you want to create a commercial product based 
+on this software, feel free to do so. 
 If you want to sell compiled versions of this software, you can do this as long as you provide users a way to access the full source code that's 
 needed to build their own software. This is also valid for any derivate work.
 
+## Donations
+
+If you like this, feel free to send a donation. However, not to us, but to a charity of your choice. You don't have to send us any money to use this software.
+
 ## Documentation
 
 - [Installation](doc/install.md)

doc/colorisations.md

@@ -3,3 +3,5 @@ The following colorisations have been tested. Others might also work. If you tes
 |Name & Version|Type|Status|tested by|Date|Comments|
 |---|---|---|---|---|---|
 |[Tron 2.2](https://vpuniverse.com/files/file/14216-tron-legacy-stern-2011-dmd-64-colors-serum-format-v22-final)|Serum|ok|[pinballpower](https://github.com/pinballpower)|30.6.23|works great|
+
+If you like a colorisation, you might send a donation to the author of the colorisation.

doc/development.md

@@ -0,0 +1,18 @@
+# Development tips & tricks
+
+## Platform
+
+It's often best to develop on a modern PC instead of a Raspberry Pi. DMDReader has been developed mostly on Windows. Compilation is a lot faster on a PC than on a Raspberry Pi.
+
+## Memory
+
+Note that DMDReader uses some C++ frameworks. Modern C++ frameworks use a lot of templates. The good thing about this: You can write very clean code that is also very fast. 
+The bad thing: the compiler has a lot of work to do to deal with all these templates. This means on a slow system it will take some time to compile it. You also need a lot of
+memory. Use a system with at least 2GB of RAM. If you run muliple jobs in parallel, have at least 2GB RAM physical RAM per job.
+
+## Timing
+
+A real pinball machine delievers DMD frames at a fixed rate - independent if something has been changed or not. DMDReader (and even the RP2040 hardware interface for real pinballs) 
+deduplicate frames. By default, a frame is only being processed if something has changes. This can create problems with some processors (e.g. the VNI module) - that expect frames at
+a fixed rate. 
+There are some workarounds to deal with this: