please add documentation to: bwcontroller.c

[zoff99]

can you add more comment and documentation into that file?
its very complex to read and know how its works.

[zoff99]

@mannol can you add documentation to this file please, and how the BWC works in detail.