
        Frags / MEMTRACK - VS1005 Memory Consumption Monitor
        ----------------------------------------------------
                       for VSOS 3.67 or higher
                      2024-02-19  VLSI Solution



Frags.dl3, potentionally with some help of the MEMTRACK.DL3 memory
tracker, can display VS1005 I, X, and Y memory contents as ASCII
graphics, plus, to some extent, which programs have allocated them.

Usage: Frags [-v|+v|-bx|-h]
-v|+v	   Verbose on|off
-b|+b	   Double|half number of bytes per symbol
-bx     Set number of bytes per symbol to x (default: 64)
-h      Show this help

You can run Frags from the VSOS Shell command line. However, more
detailed output can be shown if you add the following line as the
first line of config.txt:
MEMTRACK

You may also load the memory tracker from the VSOS Shell as follows:
S:>driver +memtrack
However, in this case the memory tracker cannot give as detailed
information as if it was started earlier in the boot process.

The output of Frags looks as follows:

S:>frags
Libs: Run Sdsd Auodac auIadc Uartin sHell Frags
        0       200      400     600      800     a00      c00     e00      
I 0000: ################ ################ ################ ################
I 1000: ################ ################ ################ ################
I 2000: ########RSSSSSSS SSSSSSSSSSSAAAAA AAAAAAAAIIIIIIII IIIIIIIIIIIUUUUU
I 3000: UUUUUHHFFFFFFFFF FFFF............ ................ ................
I 4000: ................ ................ ................ ................
I 5000: ................ ................ ................ ................
I 6000: ................ ................ ................ ................
I 7000: ................ ................ ................ ...............#
        0       200      400     600      800     a00      c00     e00      
X 0000: ################ ################ ################ ################
X 1000: ################ ################ ################ #############SSS
X 2000: AIIIIIUHHHHHHHFF FFFFFFF#........ ................ ................
X 3000: ................ ................ ................ ................
X 4000: ................ ................ ................ ................
X 5000: ................ ................ ................ ................
X 6000: ................ ................ ................ ................
X 7000: ................ ................ ................ ................
        0       200      400     600      800     a00      c00     e00      
Y 0000: ################ ################ ############SAII IIIII###########
Y 1000: UUUUUUUU........ ................ ................ ................
Y 2000: ................ ................ ................ ................
Y 3000: ................ ................ ................ ................
Y 4000: ................ ................ ................ ................
Y 5000: ................ ................ ................ ................
Y 6000: ................ ................ ................ ................
Y 7000: ################ ################ ################ ################

Free: I: 19176 words (58%), X: 23028 words (70%), Y: 24032 words (73%)
FLow: I: 18690 words (57%), highestISoFar: 0x36be


The first line shows the libraries that have been loaded. Below that,
allocated and free Instruction, X Data, and Y Data memories are shown.
Allocated unknown areas (usually reserved by VSOS) are marked with '#',
free areas with '.', and areas allocated by libraries with a capital
letter (e.g. 'M' of Memtrack). Without the MEMTRACK driver, only
statically allocated memory areas are shown, but with it also
dynamically allocated areas may be shown. Finally, the total free amount
of each memory type is shown, followed by the lowest known amount of free
I memory that has been encountered so far.



License:
This code may be used freely in any product containing one or more ICs
by VLSI Solution.


Disclaimer:
No guarantee is given for the usability of this code.


Version History:
2024-02-19 HH v1.02 - Added -b option family.
2017-12-05 HH v1.01 - Ported to VS1005h.
2016-02-10 HH v1.00 - First release.
