//
// 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 NOR Flash writing script.
//
// Change History:
//
// 01/01/2008 1.0 : Initial version
// 12/02/2009 1.1 : Updated to initialise board and load globals before doing
//                  anything else
//
//////////////////////////////////////////////////////////////////////////////

&scriptversion=1.1

print "======================================================================="
print "Generic NOR flashing script version &scriptversion"

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

; Make sure that flashing is supported on the target platform
if os.file("&PlatformsDir\&Platform\flash.cmm")
	(
	local &result

	; Make sure the user really does want to overwrite out their NOR flash!
	if "&FlashWriteProtect"!="OFF"
	(
		dialog.yesno "Are you *sure* you want to erase NOR flash and write this image: &FlashImage?"
		entry &result
	)
	else
	(
		&result=(0==0)
	)

	if &result
		(
		; Attach to the board and reset its hardware completely
		do init.cmm

		; Make sure a filename has been specified
		if "&FlashImage"==""
			(
			print "Select ROM image to flash"

			dialog.file "*.bin;*.img"
			entry &FlashImage

			if "&FlashImage"==""
				(
				print "*** Aborted (no ROM image filename specified) ***"
				enddo
				)
			)

		print "&Platform hardware configured for flashing"

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

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

		; Now do the platform specific operations
		do &PlatformsDir\&Platform\flash.cmm "&FlashImage" &FlashAddr &skipHeader
		)
	)
else
	(
	dialog.ok "NOR flashing not supported for platform &Platform"
	)

enddo