[dtv] add readme
[qemu/dtv.git] / dtv / README
blob36e2ae114443609d34681b95225200ce8cd09185
3     DTV  -  Dubious Tracer Viewer
6 This is a experiment, in using QEMU as a base for a tool capable of tracing mmio
7 accesses and respective visualization in real time. From a idea, of a quick tool
8 to check if the right value is being written to the right place.
10 The name "dubious" originates from the questionable doubt of how usefull can be
11 a tool based of a virtual machine, when the main propose is to help understand
12 what the software is doing in context with the hardware.
14 As this is a experiment, anything can happen, including if is arrived to the 
15 conclusion of a failure, all the work will be discarded.
19 Get the source, configure, build and run.
21 # ../qemu/configure --target-list=arm-softmmu --enable-trace-backends=dtv
22 # make
23 # ./arm-softmmu/qemu-system-arm [any_usual_qemu_options]
26 The basic functionaly tries to be independent of machine type, and should work
27 with any choosen machine. But for experimental reasons, this tool includes a
28 new machine(sunxi based) that can work by example in the following way.
30 # ./arm-softmmu/qemu-system-arm -machine dtv-vev                            \
31                                 -kernel [file]                              \
32                                 -initrd [file]                              \
33                                 -dtb    [file]                              \
34                                 -append [args]                              \
35                                 -device ide-drive,bus=ide.0,drive=sata      \
36                                 -drive  id=sata,if=none,file=[disk.image]