
Debugging hints for wav2bin                                       10.05.2021
---------------------------

For software development Code::Blocks 13.12 with GCC version 4.8.1 was used.
This version was developed on Windows 7 64-bit, but the code also supports 
32-bit systems. In addition, the Pocket Tools are also running on Linux, OSX
and Android which has been tested and what is taken into account.

1. For debugging at BYTE level, switch the debug traces on with the parameter 
 -l 0xC0 or use -l 0x400 (ByteList + WaveTime after the Byte) 
 and see it in your audio editor

2. For troubleshooting at LOW level, the wave and amplitude level, 
take advantage of the capabilities of your development environment. 
You should always have the option "WavTime(ptrFile)" monitored. 
The fileInfo (ptrFile) struct is declared in ConvertWavToBin.

You should also have the affected section open in parallel in a window of 
your audio editor.

3. If you want to observe the processing including transformation of the 
individual samples, then set the --start parameter twice. 
The second start parameter points to the beginning of the debug window, 
which roughly contains the useful data of a quater. 

You should specify the time [in seconds] exactly to 5 digits after the decimal
point: -s0.00000, a maximum of 10 ms before the area to be examined, 
or set the variables debug_time or debug_position in source code. 

Use the following debug options:

-s Start_time -s Debug_time (new in version 2.1.1)

-l 0x10000 low level tests and samples (above debug_time) 
-l 0x20000 with byte position

   Explanation of the symbols displayed
   ~Sample value > +- Transformed rated value
   ^ high amp      v low amp

-l 1 Bit and transition(amplitude) level

   Explanation of the symbols displayed 
   1: Transitions of a bit
      *s( sync start bit )s   +s(. sync high )s   -s(o sync low )s
      q{ quater }q            {{ byte }}
	  ... skip bits           *sk(skip QT bits)sk     
	  Trans<Amps>, if both equal, then only the first value

   2: Synchronisation of bits (for series 1100-1500, improved in version 2.1.1)
   4: Read bits (in nibbles) 
   8: Skiped bits number
