//
// Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:  
//
//////////////////////////////////////////////////////////////////////////////
//
// Generic ROM image loading script with automatic attaching and symbol loading.
// This is designed to be used in conjunction with the board configuration
// system to be found in configdialog.cmm.
//
//////////////////////////////////////////////////////////////////////////////

print "======================================================================="
print "Generic ROM image loading script"

; Declare the global variables used by the system and read the current config into them
do globals.cmm

; Special check so that people do not try to download images to the h6 or labrador, which is not supported
if ("&Platform"=="34xx_sdp"||"&Platform"=="34xx_lab")
	(
	dialog.ok "Image downloading not supported for &Platform"
	enddo
	)

if "&RamImage"==""
	(
	print "No image selected"
	enddo
	)

; Attach to the board and reset its hardware completely
do init.cmm

; Clean up some image specific details
task.reset
mmu.reset

; Detected from image file
&fileName="&RamImage"
&fileSize=os.file.size(&fileName)
&fileDate=os.file.date(&fileName)

print "========================================================="
print "Filename: &fileName"
print "Date:     &fileDate"
print "Size:     &fileSize"
print "RAM addr: &RamAddr"
print "========================================================="

; Load first few bytes of the image into ram and see whether it has a header on the front
data.load.binary "&fileName" &RamAddr++0x200
&firstWord=(data.long(sd:&RamAddr))
&skipHeader="false"

if ((&firstWord)==0x434F5045)
	(
	print "File has EPOC Image header (will skip it)"
	&skipHeader="true"
	)
else
	(
	print "No EPOC header present on file &fileName"
	)

print "Started download: " CLOCK.TIME()

; Turbo mode will disable cpu checks after each system speed memory access
if ("&SystemOptionTurbo"!="")
	(
	sys.option turbo &SystemOptionTurbo
	)

; Udate the screen
screen

if "&skipHeader"=="true"
	(
	data.load.binary "&fileName" &RamAddr /SKIP 100
	)
else
	(
	data.load.binary "&fileName" &RamAddr
	)

if os.file("&PlatformsDir\&Platform\postload.cmm")
	(
	do &PlatformsDir\&Platform\postload.cmm
	)

sys.option turbo off

print "Finished load: " CLOCK.TIME()

; Set all CPUs to point at the entrypoint of the ROM, stored in RamAddr
&currentCPU=&NumberOfCpus-1
print "Setting PC of &NumberOfCpus CPU core(s) to &RamAddr"

while &currentCPU>=0
	(
	; Only change the current core if there is more than one or it will cause an error
	if &NumberOfCpus>1
		core &currentCPU

	; Now set the PC address for the current core
	register.set PC &RamAddr
	&currentCPU=&currentCPU-1
	)

; How do we decide whether this is a debug image or not?  if we check for a 'D'
; in the filename it could match on anything whilst if we match on *D.IMG we'll
; get most of the debug images but not all of them...
if string.scan(string.lwr("&fileName"),"techview.img",0)==-1
	(
	; Logic doesn't work for Techview
	if string.scan(string.lwr("&fileName"),"d.img",0)==-1
		(
		; .SYM files are not normally produced for UREl builds, but we might have a .SYMBOL
		; file that we can pull in. See if there is a .symbol file matching the filename.
		&_SYMBOLBASENAME=string.cut("&fileName",-string.len(os.file.extension(&fileName)))
		&_SYMBOLFILENAME="&_SYMBOLBASENAME"+".symbol"
		if os.file("&_SYMBOLFILENAME")
			(
			; This was recently added by Lauterbach so it is not in all versions of the software
			data.load.symbian "&_SYMBOLFILENAME" &RamAddr /nocode
			print "UREL image, .symbol file loaded, finished everything: " CLOCK.TIME()
			ENDDO
			)

		print "UREL image, no .symbol file, finished everything: " CLOCK.TIME()
		enddo
		)
	)

; Switch the windows in to showing source (if available) rather than mixed
mode.hll

; Sase disassemble method on symbol data rather than CPU access mode
sys.OPTION DISMODE AUTO

do symbolics.cmm

enddo