Files
Pat Bernardi aca7188e89 Update comments and docs to reflect new runtime names
Change-Id: I061d2b9f215d7a5c18074e5e468f483eb04f2ab5
TN: U909-026
2021-09-20 17:00:54 -04:00
..
2016-10-03 07:48:44 +00:00
2016-10-03 07:48:44 +00:00
2017-05-17 12:38:01 +00:00
2017-06-30 15:17:16 +02:00
2016-10-07 09:48:51 +00:00
2016-10-03 07:48:44 +00:00
2016-10-03 07:48:44 +00:00
2016-10-03 07:48:44 +00:00
2021-08-25 17:41:48 +00:00
2016-10-07 09:48:51 +00:00
2016-10-19 15:39:52 +00:00
2016-10-03 07:48:44 +00:00

Readme for mpc5566 gnat monitor
-------------------------------

This example contains a small monitor, with these features:
* command line interface on the serial line (56700 8n1)
* display value of registers (command tlb, cr, timer, pll)
* load of S-record file (command load)
* flash programming (commands flash and load)
* execution of a program (command go)
* Data inspection (command dump)

The Makefile provided build a flash and a RAM version of the monitor.
Execute 'make' to build all versions. It creates the three versions:
* monitor.bin: this file is the BAM version, to be sent through the serial
  line and execute in the internal SRAM
* monitor-flash.srec: S-record file for the monitor in FLASH. The corresponding
  ELF file is monitor.rom
* monitor-ram.srec: S-record file for the monitor in external SRAM. Used to
  update the monitor without using an external probe. Corresponding ELF file
  is monitor.ram
Note that the monitor should be built using the Light runtime.

You cannot update the flash while running the monitor in flash.
So to update the monitor, use the following sequence:
> load         (and send monitor-ram.srec)
> go           (to execute it)
> flash unlock (to allow flash programming)
> flash erase  (erase the flash)
> load         (and send monitor-flash.srec)
> reset

First flash / Recovering
If you need to flash the monitor for the first time, or if you need to recover
from a corrupted flash, load monitor.bin using the BAM. Then follow the above
commands, starting from 'flash unlock'.
On the MPC5566EVB, you can force booting from BAM by setting config switch 1
to on (and put it off to booting from valid flash).