/****************************************************************************** Project: Portable command line ISP for NXP LPC1000 / LPC2000 family and Analog Devices ADUC70xx Filename: lpc21isp.c Compiler: Microsoft VC 6/7, Microsoft VS2008, Microsoft VS2010, GCC Cygwin, GCC Linux, GCC ARM ELF Author: Martin Maurer (Martin.Maurer@clibb.de) Copyright: (c) Martin Maurer 2003-2011, All rights reserved Portions Copyright (c) by Aeolus Development 2004 http://www.aeolusdevelopment.com This file is part of lpc21isp. lpc21isp is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. lpc21isp is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License and GNU General Public License along with lpc21isp. If not, see . */ #if defined(_WIN32) #if !defined __BORLANDC__ #include "StdAfx.h" // Precompiled Header for WIN32 #endif #endif // defined(_WIN32) #include "lpc21isp.h" // if using propriatory serial port communication (customize attached lpc21isp.h) #include "adprog.h" #include "lpcprog.h" #include "lpcterm.h" /* Change-History: 1.00 2004-01-08 Initial Version, tested for MSVC6/7 and GCC under Cygwin 1.01 2004-01-10 Porting to Linux (at least compiling must work) 1.02 2004-01-10 Implemented conversion intel hex format -> binary 1.03 2004-01-25 Preparation to upload to public website 1.04 2004-02-12 Merged in bugfixes by Soeren Gust 1.05 2004-03-14 Implement printing of error codes as text / strings 1.06 2004-03-09 Merged in bugfixes by Charles Manning: The '?' sychronisation does not reliably respond to the first '?'. I added some retries. The LPC2106 sometimes responds to the '?' by echoing them back. This sometimes causes an attempt to match "?Synchonized". Added code to strip off any leading '?'s. Timeouts were too long. Change from RTS/CTS to no flow control. Done because many/most people will use only 3-wire comms. Added some progress tracing. 1.07 2004-03-14 Implement handling of control lines for easier booting 1.08 2004-04-01 Bugfix for upload problem 1.09 2004-04-03 Redesign of upload routine Now always 180 byte blocks are uploaded, to prevent small junks in uuencoding 1.10 2004-04-03 Clear buffers before sending commands to LPC21xx, this prevents synchronizing errors when previously loaded program does a lot of output, so FIFO of PC runs full 1.11 2004-04-03 Small optimization for controlling reset line otherwise termonly starts LPC twice, free PC buffers 1.12 2004-04-04 Add switch to enable logging terminal output to lpc21isp.log 1.13 2004-05-19 Merged in improvement by Charles Manning: Instead of exiting the wrong hex file size is corrected 1.14 2004-07-07 Merged in improvement by Alex Holden: Remove little/big endian dependancy 1.15 2004-09-27 Temporary improvement by Cyril Holweck: Removed test (data echoed = data transmited) on the main data transfert, since this was the biggest failure reason and is covered by checksome anyway. Added COMPILE_FOR_LPC21, to have target dump it's own memory to stdout. 1.16 2004-10-09 Merged in bugfix / improvement by Sinelnikov Evgeny I found out that Linux and Windows serial port initialization are different with pinouts states. My board don't get reset signal at first cycle of DTR pinout moving. And I add this moving to initalization cycle. 1.17 2004-10-21 Changes by Cyril Holweck Divide main, take out the real programming function, that can also be used by a target to copy its own code to another. 1.18 2004-10-26 Changes by Cyril Holweck Added a "G 0 A\r\n" at end of programming to run code. 1.19 2004-11-03 Changes by Robert Adsett Add support for Analog Devices. Separate file load from programming. Change from a debug on/off flag to debug level Remove if (debug) tests and replace with DebugPrintf statements. Change serial I/O and timing so that the system dependancies are isolated to a few portability functions. Add support for binary serial I/O. Add doxygen support. 1.20 2004-11-07 Preparation for multiport booting (factory support) 1.21 2004-11-08 Bugfix from Robert Adsett BinaryLength was not initialized 1.22 2004-11-08 Changes from Cyril Holweck / Evgeny Sinelnikov Forgotten IspEnvironment-> and bugfixes if COMPILE_FOR_LINUX If COMPILE_FOR_LPC21, PhilipsDownload() 'acts as' main(): - it should not be static and should return int. - no sub-function can use exit() but only return () Use 'char' instead of 'byte' ;) 1.23 2005-01-16 Build in automatic detection of LPC chiptype (needed for 256 KByte support) 1.24B 2005-06-02 Changes by Thiadmer Riemersma: completed support for other chip types (LPC213x series and others). 1.24C 2005-06-11 Changes by Thiadmer Riemersma: added the device ID codes for chip types LPC2131 and LPC2132. 1.25 2005-06-19 Martin Maurer: Setup more parameters in DCB, otherwise wrong code is downloaded (only Windows and Cygwin) when a previous program has changed these parameters Check exact string of "G 0 A\r\n0\r\n" instead of whole received buffer, to prevent checking of already received by program start (error on running program, but reports CMD_SUCCESS) Add ifdefs for all baudrates (needed only for high baudrate, which seem to be not available on Macs...) 1.26 2005-06-26 Martin Maurer: Correct check again: "G 0 A\r\n0\r\n" is cutted, because of reboot (error on running program, but reports CMD_SUCCESS) 1.27 2005-06-29 Martin Maurer: Add LPC chip ID's (thanks to Robert from Philips) for missing LPC213x and upcoming new LPC214x chips (currently untested, because i don't have access to these chips, please give me feedback !) 1.28 2005-07-27 Anders Rosvall / Embedded Artists AB: Changed the reset timeout to 500 ms when entering the bootloader. Some external reset controllers have quite long timeout periods, so extening the timeout delay would be a good thing. 1.29 2005-09-14 Rob Jansen: Added functionality to download to RAM and run from there. In LoadFile() added record types 04 (Extended Linear Address Record) and 05 (Start Linear Address Record), added address offset (IspEnvironment->BinaryOffset) and start address (...->StartAddress). Changed PhilipsDownload to skip all Flash prepare/erase/copy commands. Note: Tested with VC7 only 1.30 2005-10-04 Rob Jansen: - forgot to change the version string in 1.29 - Wrong text in LoadFile corrected (printed text mentions record type 05, this should be 04 - Changed LoadFile to accept multiple record types 04 - Changed LoadFile to check on memory size, will not load more than x MB if linear extended address records are used 1.31 2005-11-13 Martin Maurer: Thanks to Frank Gutmann Updated number of sectors in device table for LPC2194, LPC2292 and LPC2294 1.32 2005-12-02 Martin Maurer: Corrected missing control of RTS/DTR in case user selected -termonly and -control Small correction (typo in debug) 1.33 2006-10-01 Jean-Marc Koller: Added support for MacOS X (difference on how to set termios baudrate). 1.34 2006-10-01 Cyril Holweck: Made it compile again for lpc21isp Added const keyword to constant variables to make it better code for embeded target. (decrease RAM usage) Replaced all regular call to printf() by DebugPrintf() Removed call to scanf() (not much usefull and cost a lot to my target) 1.35 2006-22-01 Cyril Holweck Added feature for LPC21: will start downloading at Sector 1 and upward, to finish with Sector 0, the one containing the checksum controling BSL entry 1.36 2006-25-01 Cyril Holweck PhilipsDownload() will now return a unique error code for each error 1.37 2006-10-03 Jeroen Domburg Added LPC2103 (and only the 2103, I can't find the IDs for 2101/2102) Corrected a loop which occured if the program completely fits in sector 0 1.38 2007-01-05 Ray Molenkamp Added feature for LPC21: Wipe entire device before programming to enable reflashing of chips with the lpc codeprotection feature enabled. 1.39 2007-01-12 Martin Maurer Added initial support for new processors LPC23xx and LPC24xx 1.40 2007-01-22 Martin Maurer Correction of chip id of LPC2458 1.41 2007-01-28 Jean-Marc Koller Modified Terminal() to disable ECHO with termios only once, instead of modifying and restoring termios in each getch and kbhit call (which caused a strange echo behaviour in MacOS X). 1.42 2007-01-28 Rob Probin Added -localecho command to allow local echoing in terminal mode for use where target does not echo back keystrokes. 1.43 2007-01-29 Martin Maurer Moved keyboard handling routines to own subroutines, so they can be used during aborting synchronisation. Newest cygwin made problems, StringOscillator always contained '\0x0d' at the end, when calling lpc21isp from batch file 1.44 2007-02-23 Yang Yang Added feature for LPC21: Verify the data in Flash after every writes to sector. To detect errors in writing to Flash ROM. 1.45 2007-02-25 Martin Maurer Replace printf syntax of DumpString by a simple pointer to a string printf syntax is a nice thing, but it is not working :-( and therefore makes debugging much more difficult... Moved VERSION_STR to top of file to avoid possible cosmetical errors 1.46 2007-02-25 Martin Maurer Again corrected debug output: should solve output of (FFFFFFB5) instead of (B5) 1.47 2007-02-27 Robert Adsett Raised timeout on AD send packet function. 1.48 2007-04-20 Martin Maurer Thanks to Josef Wolf for preventing to overwrite over end of array 1.49 2007-10-16 New Option -halfduplex allow single wire using. Implemented and tested only for Windows. Data Resend implemented. 1.50 2007-10-31 Changes by Simon Ellwood Formated the code for readablity Fixed some c++ compiler issues 1.51 2007-11-20 Changes by Simon Ellwood Split into seperate files Made more modular so when used in an embedded mode only the required code is built 1.52 2008-01-22 Changes by Manuel Koeppen Made compileable again for linux and windows Fixed bug in ClearSerialPortBuffers (linux) 1.53 2008-02-25 Changes by Michael Roth Get priority of debug messages wih -control right 1.54 2008-03-03 Martin Maurer Try to bring lpc21isp back to a useable state in Windows, Cygwin, Linux and Mac OS. Merged in changes by Erika Stefanini, which were done only for old version 1.49: Added device ids for revision B chips 1.55 2008-03-03 Martin Maurer Thanks to Fausto Marzoli, bugfix for compiling latest version under Linux 1.56 2008-04-01 Steve Franks Integrate FreeBSD patch. Add support for swapping and/or inverting RTS & DTR 1.57 2008-04-06 Mauricio Scaff Changed OpenSerialPort to work with MacOS Corrected the number of sectors in some 512K devices (28 instead of 27) Added support for LPC2387 and LPC2388 Defined BL error 19 (Code Protected) 1.58 2008-05-10 Herbert Demmel dh2@demmel.com I had the special requirement to integrate the program into my own Windows software compiled with Borland C++ Builder 5. I had to do some minor changes for Borland (see defined __BORLANDC__) and modified to code slightly to have some simple callbacks for screen i/o (see define INTEGRATED_IN_WIN_APP). Please notet that I don *not* check / modify the part for AnalogDevices !! Besides that I fixed some minor issues: added dcb.fOutxCtsFlow = FALSE and dcb.fOutxDsrFlow = FALSE (sometimes required) Now comparing one character less of answer to "Now launching ... code" command 1.59 2008-07-07 Peter Hayward Fixed freeze under Windows XP SP2 by removing redundant call to SetCommMask. 1.60 2008-07-21 Martin Maurer Added uptodate part ids for LPC2458, LPC2468 and LPC2478 Add comment "obsolete" for older part ids for LPC2458 and LPC2468 Add ", " between compile date and time 1.61 2008-10-21 Fausto Marzoli (thanks to Geoffrey Wossum for the patches) Fix for compiling latest version under Linux and "ControlLinesSwapped" issue 1.62 2008-11-19 Martin Maurer Added (untested) support for LPC2109 Added (untested) support for LPC2361 / LPC2362 Heavy update of part identification number of LPC23xx and LPC24xx Correct bug, that hex file must exist, when "-detectonly" is used Correct Makefile.vc: use /Fe instead of -o 1.63 2008-11-23 Martin Maurer Changed to GNU Lesser General Public License 1.64 2009-01-19 Steve Franks __FREEBSD__ changed to __FreeBSD__ at some point, plus other com port fixes 1.65 2009-03-26 Vito Marolda Added pre-erasure of sector 0 to invalidate checksum before starting modification of the other sectors, so that the bootloader restarts if programming gets aborted while writing on a non-empty part. 1.66 2009-03-26 Vito Marolda Corrected interpretation of intel hex record 03 which is execution start address and not data segment address 1.67 2009-04-19 SASANO Takayoshi Add OpenBSD support 1.68 2009-05-17 Martin Maurer Merge in changes done by Bruno Quoitin (baudrate problem when __APPLE__ is used) Remove TABs from source code and replaced them with spaces 1.69 2009-06-18 Martin Maurer Add support for LPC17xx devices 1.70 2009-06-29 Martin Maurer Further improvement of LPC17xx support Workaround for booter (4.1) of LPC17xx, which does not echo all sent characters (0D,0A,...) ISP command GO seems to be broken: Sending 'G 196 T(0A)' Answer(Length=15): 'G 196 T(0A)0(0D)(0A)' leads to 'prefetch_abort_exception(0D)(0A)1FFF07A5' No solution known...need your help here... Manual workaround: Use DTR and RTS toggling to start application (e.g. 2 batch files) 1.71 2009-07-19 Martin Maurer Added LPC17xx with CPUID starting with 0x26 (not according user manual) 1.72 2009-09-14 Martin Maurer Add support for LPC13xx devices 1.73 2009-09-14 Martin Maurer Correct again (hopefully the last time) the CPUIDs for some LPC17xx devices (Now according to User Manual LPC17xx Version 00.07 (31 July 2009)) 1.74 2009-09-14 Mario Ivancic Added support for multiple HEX files, besed on internal version 1.37B. NOTE: this feature is used in production in 1.37B but is not tested in this version. Added numeric debug level command line switch -debugn, n=[0-5] Added command line scitch -try n to specify nQuestionMarks limit. Defaul: 100 Merged in DoNotStart patch from cgommel_new Static functions declarations moved from lpc21isp.h to this file Modified LoadFile() to return error_code instead exit(1) Removed IspEnvironment.debug_level, all code uses global debug_level 1.75 2010-01-05 Martin Maurer Added support for LPC11xx devices (not tested at all) Changed Product in LPC_DEVICE_TYPE from number to string to distinguish new LPC11 devices Changed "unsigned" to "unsigned int" in LPC_DEVICE_TYPE 1.76 2010-02-01 Published test version without source code 1.77 2010-02-01 Martin Maurer Corrected chip id of LPC1342 and LPC1343 Added a new chip type for LPC11xx and LPC13xx microcontrollers Use higher area of RAM with LPC11xx and LPC13xx, because lower RAM is occupied by ISP Add code to lpcprog.c to read unique id, but not yet activate. Adapt block sizes for copying for each model of LPC11xx and LPC13xx 1.78 2010-02-16 Martin Maurer Corrected chip id of LPC1751 Added support for LPC1759, LPC1767 and LPC1769 1.79 2010-02-19 Andrew Pines Added __APPLE__ flag to CFLAGS in Makefile to detect and handle OS X Added -Wall to Makefile to report warnings more comprehensively Added #define in lpc21isp.h to substitute strnicmp with strncasecmp (needed for Unix) Fixed a few format specifiers in lpcprog.c to eliminate some warnings 1.80 2010-03-04 Philip Munts Added entries to LPCtypes[] in lpcprog.c for obsolete revisions of LPC2364/6/8/78. Added entry to LPCtypes[] in lpcprog.c for new LPC2387. 1.81 2011-03-30 Mario Ivancic As per message #517 from Thiadmer Riemersma, removed WaitForWatchDog and WatchDogSeconds in PhilipsDownload(). 1.82 2011-06-25 Moses McKnight Corrected MaxCopySize for a number of the LPC11xx series Added support for several more LPC11xx and LPC11Cxx series 1.83 2011-08-02 Martin Maurer Thanks to Conurus for detecting and fixing a bug with patching checksum (patching was too early, chip id was not yet available) (Re-)Added code to start downloaded via "G 0 T", when using LPC1xxx (Starting code at position 0 seems to work, compare to comment of version 1.70) Changed some occurances of Philips to NXP Added -static to Makefile (thanks to Camilo) Added support for LPC1311/01 and LPC1313/01 (they have separate identifiers) Correct flash size of LPC1342 to 16 KByte (thanks to Decio) Abort programming when unknown NXP chip id is detected */ // Please don't use TABs in the source code !!! // Don't forget to update the version string that is on the next line #define VERSION_STR "1.83" #if defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN static char RxTmpBuf[256]; // save received data to this buffer for half-duplex char * pRxTmpBuf = RxTmpBuf; #endif #if !defined COMPILE_FOR_LPC21 int debug_level = 2; #endif static void ControlModemLines(ISP_ENVIRONMENT *IspEnvironment, unsigned char DTR, unsigned char RTS); static unsigned char Ascii2Hex(unsigned char c); #ifdef COMPILE_FOR_WINDOWS static void SerialTimeoutSet(ISP_ENVIRONMENT *IspEnvironment, unsigned timeout_milliseconds); static int SerialTimeoutCheck(ISP_ENVIRONMENT *IspEnvironment); #endif // COMPILE_FOR_WINDOWS static int AddFileHex(ISP_ENVIRONMENT *IspEnvironment, const char *arg); static int AddFileBinary(ISP_ENVIRONMENT *IspEnvironment, const char *arg); static int LoadFile(ISP_ENVIRONMENT *IspEnvironment, const char *filename, int FileFormat); #define ERR_RECORD_TYPE_LOADFILE 55 /** File record type not yet implemented. */ #define ERR_ALLOC_FILE_LIST 60 #define ERR_FILE_OPEN_HEX 61 /**< Couldn't open hex file. */ #define ERR_FILE_SIZE_HEX 62 /**< Unexpected hex file size. */ #define ERR_FILE_ALLOC_HEX 63 /**< Couldn't allocate enough memory for hex file. */ #define ERR_FILE_ALLOC_BIN 64 /**< Couldn't allocate enough memory for bin file. */ #define ERR_FILE_RECST_HEX 65 /**< Can't find start of record indicator for Intel Hex file.*/ #define ERR_FILE_OPEN_BIN 66 /**< Couldn't open binary file. */ #define ERR_FILE_SIZE_BIN 67 /**< Unexpected binary file size. */ #define ERR_FILE_WRITE_BIN 68 /**< Couldn't write debug binary file to disk. How's that for ironic? */ #define ERR_MEMORY_RANGE 69 /**< Out of memory range. */ /************* Portability layer. Serial and console I/O differences */ /* are taken care of here. */ #if defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN static void OpenSerialPort(ISP_ENVIRONMENT *IspEnvironment) { DCB dcb; COMMTIMEOUTS commtimeouts; IspEnvironment->hCom = CreateFile(IspEnvironment->serial_port, GENERIC_READ | GENERIC_WRITE,0,NULL,OPEN_EXISTING,FILE_ATTRIBUTE_NORMAL,NULL); if (IspEnvironment->hCom == INVALID_HANDLE_VALUE) { DebugPrintf(1, "Can't open COM-Port %s ! - Error: %ld\n", IspEnvironment->serial_port, GetLastError()); exit(2); } DebugPrintf(3, "COM-Port %s opened...\n", IspEnvironment->serial_port); GetCommState(IspEnvironment->hCom, &dcb); dcb.BaudRate = atol(IspEnvironment->baud_rate); dcb.ByteSize = 8; dcb.StopBits = ONESTOPBIT; dcb.Parity = NOPARITY; dcb.fDtrControl = DTR_CONTROL_DISABLE; dcb.fOutX = FALSE; dcb.fInX = FALSE; dcb.fNull = FALSE; dcb.fRtsControl = RTS_CONTROL_DISABLE; // added by Herbert Demmel - iF CTS line has the wrong state, we would never send anything! dcb.fOutxCtsFlow = FALSE; dcb.fOutxDsrFlow = FALSE; if (SetCommState(IspEnvironment->hCom, &dcb) == 0) { DebugPrintf(1, "Can't set baudrate %s ! - Error: %ld", IspEnvironment->baud_rate, GetLastError()); exit(3); } /* * Peter Hayward 02 July 2008 * * The following call is only needed if the WaitCommEvent * or possibly the GetCommMask functions are used. They are * *not* in this implimentation. However, under Windows XP SP2 * on my laptop the use of this call causes XP to freeze (crash) while * this program is running, e.g. in section 5/6/7 ... of a largish * download. Removing this *unnecessary* call fixed the problem. * At the same time I've added a call to SetupComm to request * (not necessarity honoured) the operating system to provide * large I/O buffers for high speed I/O without handshaking. * * SetCommMask(IspEnvironment->hCom,EV_RXCHAR | EV_TXEMPTY); */ SetupComm(IspEnvironment->hCom, 32000, 32000); SetCommMask(IspEnvironment->hCom, EV_RXCHAR | EV_TXEMPTY); commtimeouts.ReadIntervalTimeout = MAXDWORD; commtimeouts.ReadTotalTimeoutMultiplier = 0; commtimeouts.ReadTotalTimeoutConstant = 1; commtimeouts.WriteTotalTimeoutMultiplier = 0; commtimeouts.WriteTotalTimeoutConstant = 0; SetCommTimeouts(IspEnvironment->hCom, &commtimeouts); } #endif // defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN #if defined COMPILE_FOR_LINUX static void OpenSerialPort(ISP_ENVIRONMENT *IspEnvironment) { IspEnvironment->fdCom = open(IspEnvironment->serial_port, O_RDWR | O_NOCTTY | O_NONBLOCK); if (IspEnvironment->fdCom < 0) { int err = errno; DebugPrintf(1, "Can't open COM-Port %s ! (Error: %dd (0x%X))\n", IspEnvironment->serial_port, err, err); exit(2); } DebugPrintf(3, "COM-Port %s opened...\n", IspEnvironment->serial_port); /* clear input & output buffers, then switch to "blocking mode" */ tcflush(IspEnvironment->fdCom, TCOFLUSH); tcflush(IspEnvironment->fdCom, TCIFLUSH); fcntl(IspEnvironment->fdCom, F_SETFL, fcntl(IspEnvironment->fdCom, F_GETFL) & ~O_NONBLOCK); tcgetattr(IspEnvironment->fdCom, &IspEnvironment->oldtio); /* save current port settings */ bzero(&IspEnvironment->newtio, sizeof(IspEnvironment->newtio)); IspEnvironment->newtio.c_cflag = CS8 | CLOCAL | CREAD; #if defined(__FreeBSD__) || defined(__OpenBSD__) if(cfsetspeed(&IspEnvironment->newtio,(speed_t) strtol(IspEnvironment->baud_rate,NULL,10))) { DebugPrintf(1, "baudrate %s not supported\n", IspEnvironment->baud_rate); exit(3); }; #else #ifdef __APPLE__ #define NEWTERMIOS_SETBAUDARTE(bps) IspEnvironment->newtio.c_ispeed = IspEnvironment->newtio.c_ospeed = bps; #else #define NEWTERMIOS_SETBAUDARTE(bps) IspEnvironment->newtio.c_cflag |= bps; #endif switch (atol(IspEnvironment->baud_rate)) { #ifdef B1152000 case 1152000: NEWTERMIOS_SETBAUDARTE(B1152000); break; #endif // B1152000 #ifdef B576000 case 576000: NEWTERMIOS_SETBAUDARTE(B576000); break; #endif // B576000 #ifdef B230400 case 230400: NEWTERMIOS_SETBAUDARTE(B230400); break; #endif // B230400 #ifdef B115200 case 115200: NEWTERMIOS_SETBAUDARTE(B115200); break; #endif // B115200 #ifdef B57600 case 57600: NEWTERMIOS_SETBAUDARTE(B57600); break; #endif // B57600 #ifdef B38400 case 38400: NEWTERMIOS_SETBAUDARTE(B38400); break; #endif // B38400 #ifdef B19200 case 19200: NEWTERMIOS_SETBAUDARTE(B19200); break; #endif // B19200 #ifdef B9600 case 9600: NEWTERMIOS_SETBAUDARTE(B9600); break; #endif // B9600 // Special value // case 32000: NEWTERMIOS_SETBAUDARTE(32000); break; default: { DebugPrintf(1, "unknown baudrate %s\n", IspEnvironment->baud_rate); exit(3); } } #endif IspEnvironment->newtio.c_iflag = IGNPAR | IGNBRK | IXON | IXOFF; IspEnvironment->newtio.c_oflag = 0; /* set input mode (non-canonical, no echo,...) */ IspEnvironment->newtio.c_lflag = 0; cfmakeraw(&IspEnvironment->newtio); IspEnvironment->newtio.c_cc[VTIME] = 1; /* inter-character timer used */ IspEnvironment->newtio.c_cc[VMIN] = 0; /* blocking read until 0 chars received */ tcflush(IspEnvironment->fdCom, TCIFLUSH); if(tcsetattr(IspEnvironment->fdCom, TCSANOW, &IspEnvironment->newtio)) { DebugPrintf(1, "Could not change serial port behaviour (wrong baudrate?)\n"); exit(3); } } #endif // defined COMPILE_FOR_LINUX #if defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN static void CloseSerialPort(ISP_ENVIRONMENT *IspEnvironment) { CloseHandle(IspEnvironment->hCom); } #endif // defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN #if defined COMPILE_FOR_LINUX static void CloseSerialPort(ISP_ENVIRONMENT *IspEnvironment) { tcflush(IspEnvironment->fdCom, TCOFLUSH); tcflush(IspEnvironment->fdCom, TCIFLUSH); tcsetattr(IspEnvironment->fdCom, TCSANOW, &IspEnvironment->oldtio); close(IspEnvironment->fdCom); } #endif // defined COMPILE_FOR_LINUX /***************************** SendComPortBlock *************************/ /** Sends a block of bytes out the opened com port. \param [in] s block to send. \param [in] n size of the block. */ void SendComPortBlock(ISP_ENVIRONMENT *IspEnvironment, const void *s, size_t n) { #if defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN unsigned long realsize; size_t m; unsigned long rxsize; char * pch; char * rxpch; #endif // defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN DumpString(4, s, n, "Sending "); #if defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN if (IspEnvironment->HalfDuplex == 0) { WriteFile(IspEnvironment->hCom, s, n, &realsize, NULL); } else { pch = (char *)s; rxpch = RxTmpBuf; pRxTmpBuf = RxTmpBuf; // avoid buffer otherflow if (n > sizeof (RxTmpBuf)) n = sizeof (RxTmpBuf); for (m = 0; m < n; m++) { WriteFile(IspEnvironment->hCom, pch, 1, &realsize, NULL); if ((*pch != '?') || (n != 1)) { do { ReadFile(IspEnvironment->hCom, rxpch, 1, &rxsize, NULL); }while (rxsize == 0); } pch++; rxpch++; } *rxpch = 0; // terminate echo string } #endif // defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN #if defined COMPILE_FOR_LINUX || defined COMPILE_FOR_LPC21 write(IspEnvironment->fdCom, s, n); #endif // defined COMPILE_FOR_LINUX || defined COMPILE_FOR_LPC21 } /***************************** SendComPort ******************************/ /** Sends a string out the opened com port. \param [in] s string to send. */ void SendComPort(ISP_ENVIRONMENT *IspEnvironment, const char *s) { SendComPortBlock(IspEnvironment, s, strlen(s)); } /***************************** SerialTimeoutTick ************************/ /** Performs a timer tick. In this simple case all we do is count down with protection against underflow and wrapping at the low end. */ static void SerialTimeoutTick(ISP_ENVIRONMENT *IspEnvironment) { if (IspEnvironment->serial_timeout_count <= 1) { IspEnvironment->serial_timeout_count = 0; } else { IspEnvironment->serial_timeout_count--; } } /***************************** ReceiveComPortBlock **********************/ /** Receives a buffer from the open com port. Returns all the characters ready (waits for up to 'n' milliseconds before accepting that no more characters are ready) or when the buffer is full. 'n' is system dependant, see SerialTimeout routines. \param [out] answer buffer to hold the bytes read from the serial port. \param [in] max_size the size of buffer pointed to by answer. \param [out] real_size pointer to a long that returns the amout of the buffer that is actually used. */ static void ReceiveComPortBlock(ISP_ENVIRONMENT *IspEnvironment, void *answer, unsigned long max_size, unsigned long *real_size) { char tmp_string[32]; #if defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN if (IspEnvironment->HalfDuplex == 0) ReadFile(IspEnvironment->hCom, answer, max_size, real_size, NULL); else { *real_size = strlen (pRxTmpBuf); if (*real_size) { if (max_size >= *real_size) { strncpy((char*) answer, pRxTmpBuf, *real_size); RxTmpBuf[0] = 0; pRxTmpBuf = RxTmpBuf; } else { strncpy((char*) answer, pRxTmpBuf, max_size); *real_size = max_size; pRxTmpBuf += max_size; } } else ReadFile(IspEnvironment->hCom, answer, max_size, real_size, NULL); } #endif // defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN #if defined COMPILE_FOR_LINUX || defined COMPILE_FOR_LPC21 *real_size = read(IspEnvironment->fdCom, answer, max_size); #endif // defined COMPILE_FOR_LINUX sprintf(tmp_string, "Read(Length=%ld): ", (*real_size)); DumpString(5, answer, (*real_size), tmp_string); if (*real_size == 0) { SerialTimeoutTick(IspEnvironment); } } /***************************** SerialTimeoutSet *************************/ /** Sets (or resets) the timeout to the timout period requested. Starts counting to this period. This timeout support is a little odd in that the timeout specifies the accumulated deadtime waiting to read not the total time waiting to read. They should be close enought to the same for this use. Used by the serial input routines, the actual counting takes place in ReceiveComPortBlock. \param [in] timeout_milliseconds the time in milliseconds to use for timeout. Note that just because it is set in milliseconds doesn't mean that the granularity is that fine. In many cases (particularly Linux) it will be coarser. */ static void SerialTimeoutSet(ISP_ENVIRONMENT *IspEnvironment, unsigned timeout_milliseconds) { #if defined COMPILE_FOR_LINUX IspEnvironment->serial_timeout_count = timeout_milliseconds / 100; #elif defined COMPILE_FOR_LPC21 IspEnvironment->serial_timeout_count = timeout_milliseconds * 200; #else IspEnvironment->serial_timeout_count = timeout_milliseconds; #endif } /***************************** SerialTimeoutCheck ***********************/ /** Check to see if the serial timeout timer has run down. \retval 1 if timer has run out. \retval 0 if timer still has time left. */ static int SerialTimeoutCheck(ISP_ENVIRONMENT *IspEnvironment) { if (IspEnvironment->serial_timeout_count == 0) { return 1; } return 0; } #if defined COMPILE_FOR_LINUX || defined COMPILE_FOR_CYGWIN /***************************** getch ************************************/ /** Replacement for the common dos function of the same name. Reads a single unbuffered character from the 'keyboard'. \return The character read from the keyboard. */ int getch(void) { char ch; /* Read in one character */ read(0,&ch,1); return ch; } #endif // defined COMPILE_FOR_LINUX || defined COMPILE_FOR_CYGWIN #if defined COMPILE_FOR_LINUX || defined COMPILE_FOR_CYGWIN /***************************** kbhit ************************************/ /** Replacement for the common dos function of the same name. Indicates if there are characters to be read from the console. \retval 0 No characters ready. \retval 1 Characters from the console ready to be read. */ int kbhit(void) { /* return 0 for no key pressed, 1 for key pressed */ int return_value = 0; /* time struct for the select() function, to only wait a little while */ struct timeval select_time; /* file descriptor variable for the select() call */ fd_set readset; /* we're only interested in STDIN */ FD_ZERO(&readset); FD_SET(STDIN_FILENO, &readset); /* how long to block for - this must be > 0.0, but could be changed to some other setting. 10-18msec seems to work well and only minimally load the system (0% CPU loading) */ select_time.tv_sec = 0; select_time.tv_usec = 10; /* is there a keystroke there? */ if (select(1, &readset, NULL, NULL, &select_time)) { /* yes, remember it */ return_value = 1; } /* return with what we found out */ return return_value; } struct termios keyboard_origtty; #endif // defined COMPILE_FOR_LINUX || defined COMPILE_FOR_CYGWIN /***************************** PrepareKeyboardTtySettings ***************/ /** Set the keyboard tty to be able to check for new characters via kbhit getting them via getch */ void PrepareKeyboardTtySettings(void) { #if defined COMPILE_FOR_LINUX || defined COMPILE_FOR_CYGWIN /* store the current tty settings */ if (!tcgetattr(0, &keyboard_origtty)) { struct termios tty; /* start with the current settings */ tty = keyboard_origtty; /* make modifications to put it in raw mode, turn off echo */ tty.c_lflag &= ~ICANON; tty.c_lflag &= ~ECHO; tty.c_lflag &= ~ISIG; tty.c_cc[VMIN] = 1; tty.c_cc[VTIME] = 0; /* put the settings into effect */ tcsetattr(0, TCSADRAIN, &tty); } #endif } /***************************** ResetKeyboardTtySettings *****************/ /** Reset the keyboard tty to original settings */ void ResetKeyboardTtySettings(void) { #if defined COMPILE_FOR_LINUX || defined COMPILE_FOR_CYGWIN /* reset the tty to its original settings */ tcsetattr(0, TCSADRAIN, &keyboard_origtty); #endif } #if !defined COMPILE_FOR_LPC21 /***************************** ControlModemLines ************************/ /** Controls the modem lines to place the microcontroller into various states during the programming process. error rather abruptly terminates the program. \param [in] DTR the state to set the DTR line to. \param [in] RTS the state to set the RTS line to. */ static void ControlModemLines(ISP_ENVIRONMENT *IspEnvironment, unsigned char DTR, unsigned char RTS) { //handle wether to invert the control lines: DTR ^= IspEnvironment->ControlLinesInverted; RTS ^= IspEnvironment->ControlLinesInverted; //handle wether to swap the control lines if (IspEnvironment->ControlLinesSwapped) { unsigned char tempRTS; tempRTS = RTS; RTS = DTR; DTR = tempRTS; } #if defined COMPILE_FOR_LINUX int status; if (ioctl(IspEnvironment->fdCom, TIOCMGET, &status) == 0) { DebugPrintf(3, "ioctl get ok, status = %X\n",status); } else { DebugPrintf(1, "ioctl get failed\n"); } if (DTR) status |= TIOCM_DTR; else status &= ~TIOCM_DTR; if (RTS) status |= TIOCM_RTS; else status &= ~TIOCM_RTS; if (ioctl(IspEnvironment->fdCom, TIOCMSET, &status) == 0) { DebugPrintf(3, "ioctl set ok, status = %X\n",status); } else { DebugPrintf(1, "ioctl set failed\n"); } if (ioctl(IspEnvironment->fdCom, TIOCMGET, &status) == 0) { DebugPrintf(3, "ioctl get ok, status = %X\n",status); } else { DebugPrintf(1, "ioctl get failed\n"); } #endif // defined COMPILE_FOR_LINUX #if defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN if (DTR) EscapeCommFunction(IspEnvironment->hCom, SETDTR); else EscapeCommFunction(IspEnvironment->hCom, CLRDTR); if (RTS) EscapeCommFunction(IspEnvironment->hCom, SETRTS); else EscapeCommFunction(IspEnvironment->hCom, CLRRTS); #endif // defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN #if defined COMPILE_FOR_LPC21 LPC_RESET(DTR); LPC_BSL(RTS); #endif DebugPrintf(3, "DTR (%d), RTS (%d)\n", DTR, RTS); } /***************************** ClearSerialPortBuffers********************/ /** Empty the serial port buffers. Cleans things to a known state. */ void ClearSerialPortBuffers(ISP_ENVIRONMENT *IspEnvironment) { #if defined COMPILE_FOR_LINUX /* variables to store the current tty state, create a new one */ struct termios origtty, tty; /* store the current tty settings */ tcgetattr(IspEnvironment->fdCom, &origtty); // Flush input and output buffers tty=origtty; tcsetattr(IspEnvironment->fdCom, TCSAFLUSH, &tty); /* reset the tty to its original settings */ tcsetattr(IspEnvironment->fdCom, TCSADRAIN, &origtty); #endif // defined COMPILE_FOR_LINUX #if defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN PurgeComm(IspEnvironment->hCom, PURGE_TXABORT | PURGE_RXABORT | PURGE_TXCLEAR | PURGE_RXCLEAR); #endif // defined COMPILE_FOR_WINDOWS || defined COMPILE_FOR_CYGWIN } #endif // !defined COMPILE_FOR_LPC21 #if defined COMPILE_FOR_LINUX /***************************** Sleep ************************************/ /** Provide linux replacement for windows function. \param [in] Milliseconds the time to wait for in milliseconds. */ void Sleep(unsigned long MilliSeconds) { usleep(MilliSeconds*1000); //convert to microseconds } #endif // defined COMPILE_FOR_LINUX #if defined COMPILE_FOR_LPC21 /** Provide linux replacement for windows function. \note I implement that one in my private header file today... \param [in] Milliseconds the time to wait for in milliseconds. */ /*static void Sleep(unsigned long MilliSeconds) { # warning Sleep function not implemented } */ #endif // defined COMPILE_FOR_LPC21 /************* Applicationlayer. */ #if !defined COMPILE_FOR_LPC21 /***************************** DebugPrintf ******************************/ /** Prints a debug string depending the current debug level. The higher the debug level the more detail that will be printed. Each print has an associated level, the higher the level the more detailed the debugging information being sent. \param [in] level the debug level of the print statement, if the level is less than or equal to the current debug level it will be printed. \param [in] fmt a standard printf style format string. \param [in] ... the usual printf parameters. */ #if !defined INTEGRATED_IN_WIN_APP void DebugPrintf(int level, const char *fmt, ...) { va_list ap; if (level <= debug_level) { char pTemp[2000]; va_start(ap, fmt); //vprintf(fmt, ap); vsprintf(pTemp, fmt, ap); TRACE(pTemp); va_end(ap); fflush(stdout); } } #endif #endif // !defined COMPILE_FOR_LPC21 /***************************** ReceiveComPort ***************************/ /** Receives a buffer from the open com port. Returns when the buffer is filled, the numer of requested linefeeds has been received or the timeout period has passed \param [in] ISPEnvironment. \param [out] Answer buffer to hold the bytes read from the serial port. \param [in] MaxSize the size of buffer pointed to by Answer. \param [out] RealSize pointer to a long that returns the amout of the buffer that is actually used. \param [in] WantedNr0x0A the maximum number of linefeeds to accept before returning. \param [in] timeOutMilliseconds the maximum amount of time to wait before reading with an incomplete buffer. */ void ReceiveComPort(ISP_ENVIRONMENT *IspEnvironment, const char *Ans, unsigned long MaxSize, unsigned long *RealSize, unsigned long WantedNr0x0A, unsigned timeOutMilliseconds) { unsigned long tmp_realsize; unsigned long nr_of_0x0A = 0; unsigned long nr_of_0x0D = 0; int eof = 0; unsigned long p; unsigned char *Answer; char tmp_string[32]; Answer = (unsigned char*) Ans; SerialTimeoutSet(IspEnvironment, timeOutMilliseconds); (*RealSize) = 0; do { ReceiveComPortBlock(IspEnvironment, Answer + (*RealSize), MaxSize - 1 - (*RealSize), &tmp_realsize); if (tmp_realsize != 0) { for (p = (*RealSize); p < (*RealSize) + tmp_realsize; p++) { if (Answer[p] == 0x0a) { nr_of_0x0A++; } else if (Answer[p] == 0x0d) { nr_of_0x0D++; } else if (((signed char) Answer[p]) < 0) { eof = 1; } } } (*RealSize) += tmp_realsize; } while (((*RealSize) < MaxSize) && (SerialTimeoutCheck(IspEnvironment) == 0) && (nr_of_0x0A < WantedNr0x0A) && (nr_of_0x0D < WantedNr0x0A) && !eof); Answer[(*RealSize)] = 0; sprintf(tmp_string, "Answer(Length=%ld): ", (*RealSize)); DumpString(3, Answer, (*RealSize), tmp_string); } #if !defined COMPILE_FOR_LPC21 /***************************** ReceiveComPortBlockComplete **************/ /** Receives a fixed block from the open com port. Returns when the block is completely filled or the timeout period has passed \param [out] block buffer to hold the bytes read from the serial port. \param [in] size the size of the buffer pointed to by block. \param [in] timeOut the maximum amount of time to wait before guvung up on completing the read. \return 0 if successful, non-zero otherwise. */ int ReceiveComPortBlockComplete(ISP_ENVIRONMENT *IspEnvironment, void *block, size_t size, unsigned timeout) { unsigned long realsize = 0, read; char *result; char tmp_string[32]; result = (char*) block; SerialTimeoutSet(IspEnvironment, timeout); do { ReceiveComPortBlock(IspEnvironment, result + realsize, size - realsize, &read); realsize += read; } while ((realsize < size) && (SerialTimeoutCheck(IspEnvironment) == 0)); sprintf(tmp_string, "Answer(Length=%ld): ", realsize); DumpString(3, result, realsize, tmp_string); if (realsize != size) { return 1; } return 0; } /***************************** ReadArguments ****************************/ /** Reads the command line arguments and parses it for the various options. Uses the same arguments as main. Used to separate the command line parsing from main and improve its readability. This should also make it easier to modify the command line parsing in the future. \param [in] argc the number of arguments. \param [in] argv an array of pointers to the arguments. */ static void ReadArguments(ISP_ENVIRONMENT *IspEnvironment, unsigned int argc, char *argv[]) { unsigned int i; if (argc >= 5) { for (i = 1; i < argc - 3; i++) { if (stricmp(argv[i], "-wipe") == 0) { IspEnvironment->WipeDevice = 1; DebugPrintf(3, "Wipe entire device before writing.\n"); continue; } if (stricmp(argv[i], "-bin") == 0) { IspEnvironment->FileFormat = FORMAT_BINARY; DebugPrintf(3, "Binary format file input.\n"); continue; } if (stricmp(argv[i], "-hex") == 0) { IspEnvironment->FileFormat = FORMAT_HEX; DebugPrintf(3, "Hex format file input.\n"); continue; } if (stricmp(argv[i], "-logfile") == 0) { IspEnvironment->LogFile = 1; DebugPrintf(3, "Log terminal output.\n"); continue; } if (stricmp(argv[i], "-detectonly") == 0) { IspEnvironment->DetectOnly = 1; IspEnvironment->ProgramChip = 0; DebugPrintf(3, "Only detect LPC chip part id.\n"); continue; } if(strnicmp(argv[i],"-debug", 6) == 0) { char* num; num = argv[i] + 6; while(*num && isdigit(*num) == 0) num++; if(isdigit(*num) != 0) debug_level = atoi( num); else debug_level = 4; DebugPrintf(3, "Turn on debug, level: %d.\n", debug_level); continue; } if (stricmp(argv[i], "-DoNotStart") == 0) { IspEnvironment->DoNotStart = 1; DebugPrintf(3, "Do NOT start MCU after programming.\n"); continue; } if (stricmp(argv[i], "-control") == 0) { IspEnvironment->ControlLines = 1; DebugPrintf(3, "Use RTS/DTR to control target state.\n"); continue; } if (stricmp(argv[i], "-controlswap") == 0) { IspEnvironment->ControlLinesSwapped = 1; DebugPrintf(3, "Use RTS to control reset, and DTR to control P0.14(ISP).\n"); continue; } if (stricmp(argv[i], "-controlinv") == 0) { IspEnvironment->ControlLinesInverted = 1; DebugPrintf(3, "Invert state of RTS & DTR (0=true/assert/set, 1=false/deassert/clear).\n"); continue; } if (stricmp(argv[i], "-halfduplex") == 0) { IspEnvironment->HalfDuplex = 1; DebugPrintf(3, "halfduplex serial communication.\n"); continue; } if (stricmp(argv[i], "-ADARM") == 0) { IspEnvironment->micro = ANALOG_DEVICES_ARM; DebugPrintf(2, "Target: Analog Devices.\n"); continue; } if (stricmp(argv[i], "-NXPARM") == 0 || stricmp(argv[i], "-PHILIPSARM") == 0) { IspEnvironment->micro = NXP_ARM; DebugPrintf(2, "Target: NXP.\n"); continue; } if (stricmp(argv[i], "-Verify") == 0) { IspEnvironment->Verify = 1; DebugPrintf(2, "Verify after copy RAM to Flash.\n"); continue; } #ifdef INTEGRATED_IN_WIN_APP if (stricmp(argv[i], "-nosync") == 0) { IspEnvironment->NoSync = 1; DebugPrintf(2, "Performing no syncing, already done.\n"); continue; } #endif #ifdef TERMINAL_SUPPORT if (CheckTerminalParameters(IspEnvironment, argv[i])) { continue; } #endif if(*argv[i] == '-') DebugPrintf( 2, "Unknown command line option: \"%s\"\n", argv[i]); else { int ret_val; if(IspEnvironment->FileFormat == FORMAT_HEX) { ret_val = AddFileHex(IspEnvironment, argv[i]); } else { ret_val = AddFileBinary(IspEnvironment, argv[i]); } if( ret_val != 0) { DebugPrintf( 2, "Unknown command line option: \"%s\"\n", argv[i]); } } } // Newest cygwin delivers a '\x0d' at the end of argument // when calling lpc21isp from batch file for (i = 0; i < strlen(argv[argc - 1]) && i < (sizeof(IspEnvironment->StringOscillator) - 1) && argv[argc - 1][i] >= '0' && argv[argc - 1][i] <= '9'; i++) { IspEnvironment->StringOscillator[i] = argv[argc - 1][i]; } IspEnvironment->StringOscillator[i] = 0; IspEnvironment->serial_port = argv[argc - 3]; IspEnvironment->baud_rate = argv[argc - 2]; } if (argc < 5) { debug_level = (debug_level < 2) ? 2 : debug_level; } if (argc < 5) { DebugPrintf(2, "\n" "Portable command line ISP\n" "for NXP LPC1000 / LPC2000 family and Analog Devices ADUC 70xx\n" "Version " VERSION_STR " compiled for " COMPILED_FOR ": " __DATE__ ", " __TIME__ "\n" "Copyright (c) by Martin Maurer, 2003-2011, Email: Martin.Maurer@clibb.de\n" "Portions Copyright (c) by Aeolus Development 2004, www.aeolusdevelopment.com\n" "\n"); DebugPrintf(1, "Syntax: lpc21isp [Options] file[ file[ ...]] comport baudrate Oscillator_in_kHz\n\n" "Example: lpc21isp test.hex com1 115200 14746\n\n" "Options: -bin for uploading binary file\n" " -hex for uploading file in intel hex format (default)\n" " -term for starting terminal after upload\n" " -termonly for starting terminal without an upload\n" " -localecho for local echo in terminal\n" " -detectonly detect only used LPC chiptype (NXPARM only)\n" " -debug0 for no debug\n" " -debug3 for progress info only\n" " -debug5 for full debug\n" " -donotstart do not start MCU after download\n" " -try try n times to synchronise\n" " -wipe Erase entire device before upload\n" " -control for controlling RS232 lines for easier booting\n" " (Reset = DTR, EnableBootLoader = RTS)\n" #ifdef INTEGRATED_IN_WIN_APP " -nosync Do not synchronize device via '?'\n" #endif " -controlswap swap RS232 control lines\n" " (Reset = RTS, EnableBootLoader = DTR)\n" " -controlinv Invert state of RTS & DTR \n" " (0=true/assert/set, 1=false/deassert/clear).\n" " -verify Verify the data in Flash after every writes to\n" " sector. To detect errors in writing to Flash ROM\n" " -logfile for enabling logging of terminal output to lpc21isp.log\n" " -halfduplex use halfduplex serial communication (i.e. with K-Line)\n" " -ADARM for downloading to an Analog Devices\n" " ARM microcontroller ADUC70xx\n" " -NXPARM for downloading to a NXP LPC1xxx/LPC2xxx (default)\n"); exit(1); } if (IspEnvironment->micro == NXP_ARM) { // If StringOscillator is bigger than 100 MHz, there seems to be something wrong if (strlen(IspEnvironment->StringOscillator) > 5) { DebugPrintf(1, "Invalid crystal frequency %s\n", IspEnvironment->StringOscillator); exit(1); } } } /***************************** ResetTarget ******************************/ /** Resets the target leaving it in either download (program) mode or run mode. \param [in] mode the mode to leave the target in. */ void ResetTarget(ISP_ENVIRONMENT *IspEnvironment, TARGET_MODE mode) { if (IspEnvironment->ControlLines) { switch (mode) { /* Reset and jump to boot loader. */ case PROGRAM_MODE: ControlModemLines(IspEnvironment, 1, 1); Sleep(100); ClearSerialPortBuffers(IspEnvironment); Sleep(100); ControlModemLines(IspEnvironment, 0, 1); //Longer delay is the Reset signal is conected to an external rest controller Sleep(500); // Clear the RTS line after having reset the micro // Needed for the "GO
" ISP command to work */ ControlModemLines(IspEnvironment, 0, 0); break; /* Reset and start uploaded program */ case RUN_MODE: ControlModemLines(IspEnvironment, 1, 0); Sleep(100); ClearSerialPortBuffers(IspEnvironment); Sleep(100); ControlModemLines(IspEnvironment, 0, 0); Sleep(100); break; } } } /***************************** Ascii2Hex ********************************/ /** Converts a hex character to its equivalent number value. In case of an error rather abruptly terminates the program. \param [in] c the hex digit to convert. \return the value of the hex digit. */ static unsigned char Ascii2Hex(unsigned char c) { if (c >= '0' && c <= '9') { return (unsigned char)(c - '0'); } if (c >= 'A' && c <= 'F') { return (unsigned char)(c - 'A' + 10); } if (c >= 'a' && c <= 'f') { return (unsigned char)(c - 'a' + 10); } DebugPrintf(1, "Wrong Hex-Nibble %c (%02X)\n", c, c); exit(1); return 0; // this "return" will never be reached, but some compilers give a warning if it is not present } /***************************** AddFileHex *******************************/ /** Add a file to the list of files to read in, flag it as hex format. \param [in] IspEnvironment Programming environment. \param [in] arg The argument that was passed to the program as a file name. \return 0 on success, an error code otherwise. */ static int AddFileHex(ISP_ENVIRONMENT *IspEnvironment, const char *arg) { FILE_LIST *entry; // Add file to list. If cannot allocate storage for node return an error. entry = malloc(sizeof(FILE_LIST)); if( entry == 0) { DebugPrintf(1, "Error %d Could not allocated memory for file node %s\n", ERR_ALLOC_FILE_LIST, arg); return ERR_ALLOC_FILE_LIST; } // Build up entry and insert it at the start of the list. entry->name = arg; entry->prev = IspEnvironment->f_list; entry->hex_flag = 1; IspEnvironment->f_list = entry; return 0; // Success. } /***************************** AddFileBinary ****************************/ /** Add a file to the list of files to read in, flag it as binary format. \param [in] IspEnvironment Programming environment. \param [in] arg The argument that was passed to the program as a file name. \return 0 on success, an error code otherwise. */ static int AddFileBinary(ISP_ENVIRONMENT *IspEnvironment, const char *arg) { FILE_LIST *entry; // Add file to list. If cannot allocate storage for node return an error. entry = malloc(sizeof(FILE_LIST)); if( entry == 0) { DebugPrintf( 1, "Error %d Could not allocated memory for file node %s\n", ERR_ALLOC_FILE_LIST, arg); return ERR_ALLOC_FILE_LIST; } // Build up entry and insert it at the start of the list. entry->name = arg; entry->prev = IspEnvironment->f_list; entry->hex_flag = 0; IspEnvironment->f_list = entry; return 0; // Success. } #if 0 void ReadHexFile(ISP_ENVIRONMENT *IspEnvironment) { LoadFile(IspEnvironment); if (IspEnvironment->BinaryLength) { BINARY* FileContent = IspEnvironment->FileContent; unsigned long Pos; unsigned char RecordLength; unsigned short RecordAddress; unsigned long RealAddress = 0; unsigned char RecordType; unsigned char Hexvalue; unsigned long StartAddress; int BinaryOffsetDefined = 0; unsigned char i; DebugPrintf(3, "Converting file %s to binary format...\n", IspEnvironment->input_file); Pos = 0; while (Pos < IspEnvironment->BinaryLength) { if (FileContent[Pos] == '\r') { Pos++; continue; } if (FileContent[Pos] == '\n') { Pos++; continue; } if (FileContent[Pos] != ':') { DebugPrintf(1, "Missing start of record (':') wrong byte %c / %02X\n", FileContent[Pos], FileContent[Pos]); exit(1); } Pos++; RecordLength = Ascii2Hex(FileContent[Pos++]); RecordLength <<= 4; RecordLength |= Ascii2Hex(FileContent[Pos++]); DebugPrintf(4, "RecordLength = %02X\n", RecordLength); RecordAddress = Ascii2Hex(FileContent[Pos++]); RecordAddress <<= 4; RecordAddress |= Ascii2Hex(FileContent[Pos++]); RecordAddress <<= 4; RecordAddress |= Ascii2Hex(FileContent[Pos++]); RecordAddress <<= 4; RecordAddress |= Ascii2Hex(FileContent[Pos++]); DebugPrintf(4, "RecordAddress = %04X\n", RecordAddress); RealAddress = RealAddress - (RealAddress & 0xffff) + RecordAddress; DebugPrintf(4, "RealAddress = %08lX\n", RealAddress); RecordType = Ascii2Hex(FileContent[Pos++]); RecordType <<= 4; RecordType |= Ascii2Hex(FileContent[Pos++]); DebugPrintf(4, "RecordType = %02X\n", RecordType); if (RecordType == 0x00) // 00 - Data record { /* * Binary Offset is defined as soon as first data record read */ //BinaryOffsetDefined = 1; // Memory for binary file big enough ? while ((RealAddress + RecordLength - IspEnvironment->BinaryOffset) > IspEnvironment->BinaryMemSize) { IspEnvironment->BinaryMemSize <<= 1; // Double the size allocated !!! IspEnvironment->BinaryContent = (BINARY*) realloc(IspEnvironment->BinaryContent, IspEnvironment->BinaryMemSize); } // We need to know, what the highest address is, // how many bytes / sectors we must flash if (RealAddress + RecordLength - IspEnvironment->BinaryOffset > IspEnvironment->BinaryLength) { IspEnvironment->BinaryLength = RealAddress + RecordLength - IspEnvironment->BinaryOffset; DebugPrintf(3, "Image size now: %ld\n", IspEnvironment->BinaryLength); } for (i = 0; i < RecordLength; i++) { Hexvalue = Ascii2Hex(FileContent[Pos++]); Hexvalue <<= 4; Hexvalue |= Ascii2Hex(FileContent[Pos++]); IspEnvironment->BinaryContent[RealAddress + i - IspEnvironment->BinaryOffset] = Hexvalue; } } else if (RecordType == 0x01) // 01 - End of file record { break; } else if (RecordType == 0x02) // 02 - Extended segment address record { for (i = 0; i < RecordLength * 2; i++) // double amount of nibbles { RealAddress <<= 4; if (i == 0) { RealAddress = Ascii2Hex(FileContent[Pos++]); } else { RealAddress |= Ascii2Hex(FileContent[Pos++]); } } RealAddress <<= 4; } else if (RecordType == 0x03) // 03 - Start segment address record { for (i = 0; i < RecordLength * 2; i++) // double amount of nibbles { RealAddress <<= 4; if (i == 0) { RealAddress = Ascii2Hex(FileContent[Pos++]); } else { RealAddress |= Ascii2Hex(FileContent[Pos++]); } } RealAddress <<= 8; } else if (RecordType == 0x04) // 04 - Extended linear address record, used by IAR { for (i = 0; i < RecordLength * 2; i++) // double amount of nibbles { RealAddress <<= 4; if (i == 0) { RealAddress = Ascii2Hex(FileContent[Pos++]); } else { RealAddress |= Ascii2Hex(FileContent[Pos++]); } } RealAddress <<= 16; if (!BinaryOffsetDefined) { // set startaddress of BinaryContent // use of LPC_FLASHMASK to allow a memory range, not taking the first // [04] record as actual start-address. IspEnvironment->BinaryOffset = RealAddress & LPC_FLASHMASK; } else { if ((RealAddress & LPC_FLASHMASK) != IspEnvironment->BinaryOffset) { DebugPrintf(1, "New Extended Linear Address Record [04] out of memory range\n" "Current Memory starts at: 0x%08X, new Address is: 0x%08X", IspEnvironment->BinaryOffset, RealAddress); exit(1); } } } else if (RecordType == 0x05) // 05 - Start linear address record { StartAddress = 0; for (i = 0; i < RecordLength * 2; i++) // double amount of nibbles { StartAddress <<= 4; if (i == 0) { StartAddress = Ascii2Hex(FileContent[Pos++]); } else { StartAddress |= Ascii2Hex(FileContent[Pos++]); } } DebugPrintf(1,"Start Address = 0x%08X\n", StartAddress); IspEnvironment->StartAddress = StartAddress; } while (FileContent[Pos++] != 0x0a) // Search till line end { } } DebugPrintf(2, "\tconverted to binary format...\n"); // When debugging is switched on, output result of conversion to file debugout.bin if (debug_level >= 4) { int fdout; fdout = open("debugout.bin", O_RDWR | O_BINARY | O_CREAT | O_TRUNC, 0777); write(fdout, IspEnvironment->BinaryContent, IspEnvironment->BinaryLength); close(fdout); } } } #endif // #if 0 /***************************** LoadFile *********************************/ /** Loads the requested file to download into memory. \param [in] IspEnvironment structure containing input filename \param [in] filename the name of the file to read in. \param [in] FileFormat the format of the file to read in (FORMAT_HEX or FORMAT_BINARY) \return 0 if successful, otherwise an error code. */ static int LoadFile(ISP_ENVIRONMENT *IspEnvironment, const char *filename, int FileFormat) { int fd; int i; int BinaryOffsetDefined; unsigned long Pos; unsigned long FileLength; BINARY *FileContent; /**< Used to store the content of a hex */ /* file before converting to binary. */ unsigned long BinaryMemSize; fd = open(filename, O_RDONLY | O_BINARY); if (fd == -1) { DebugPrintf(1, "Can't open file %s\n", filename); return ERR_FILE_OPEN_HEX; } FileLength = lseek(fd, 0L, 2); // Get file size if (FileLength == (size_t)-1) { DebugPrintf(1, "\nFileLength = -1 !?!\n"); return ERR_FILE_SIZE_HEX; } lseek(fd, 0L, 0); // Just read the entire file into memory to parse. FileContent = (BINARY*) malloc(FileLength); if( FileContent == 0) { DebugPrintf( 1, "\nCouldn't allocate enough memory for file.\n"); return ERR_FILE_ALLOC_HEX; } BinaryOffsetDefined = 0; BinaryMemSize = IspEnvironment->BinaryLength; read(fd, FileContent, FileLength); close(fd); DebugPrintf(2, "File %s:\n\tloaded...\n", filename); // Intel-Hex -> Binary Conversion if (FileFormat == FORMAT_HEX) { unsigned char RecordLength; unsigned short RecordAddress; unsigned long RealAddress = 0; unsigned char RecordType; unsigned char Hexvalue; unsigned long StartAddress; DebugPrintf(3, "Converting file %s to binary format...\n", filename); Pos = 0; while (Pos < FileLength) { if (FileContent[Pos] == '\r') { Pos++; continue; } if (FileContent[Pos] == '\n') { Pos++; continue; } if (FileContent[Pos] != ':') { DebugPrintf(1, "Missing start of record (':') wrong byte %c / %02X\n", FileContent[Pos], FileContent[Pos]); exit(1); } Pos++; RecordLength = Ascii2Hex(FileContent[Pos++]); RecordLength <<= 4; RecordLength |= Ascii2Hex(FileContent[Pos++]); DebugPrintf(4, "RecordLength = %02X\n", RecordLength); RecordAddress = Ascii2Hex(FileContent[Pos++]); RecordAddress <<= 4; RecordAddress |= Ascii2Hex(FileContent[Pos++]); RecordAddress <<= 4; RecordAddress |= Ascii2Hex(FileContent[Pos++]); RecordAddress <<= 4; RecordAddress |= Ascii2Hex(FileContent[Pos++]); DebugPrintf(4, "RecordAddress = %04X\n", RecordAddress); RealAddress = RealAddress - (RealAddress & 0xffff) + RecordAddress; DebugPrintf(4, "RealAddress = %08lX\n", RealAddress); RecordType = Ascii2Hex(FileContent[Pos++]); RecordType <<= 4; RecordType |= Ascii2Hex(FileContent[Pos++]); DebugPrintf(4, "RecordType = %02X\n", RecordType); if (RecordType == 0x00) // 00 - Data record { /* * Binary Offset is defined as soon as first data record read */ BinaryOffsetDefined = 1; // Memory for binary file big enough ? while (RealAddress + RecordLength - IspEnvironment->BinaryOffset > BinaryMemSize) { if(!BinaryMemSize) BinaryMemSize = FileLength * 2; else BinaryMemSize <<= 1; IspEnvironment->BinaryContent = realloc(IspEnvironment->BinaryContent, BinaryMemSize); } // We need to know, what the highest address is, // how many bytes / sectors we must flash if (RealAddress + RecordLength - IspEnvironment->BinaryOffset > IspEnvironment->BinaryLength) { IspEnvironment->BinaryLength = RealAddress + RecordLength - IspEnvironment->BinaryOffset; DebugPrintf(3, "Image size now: %ld\n", IspEnvironment->BinaryLength); } for (i = 0; i < RecordLength; i++) { Hexvalue = Ascii2Hex(FileContent[Pos++]); Hexvalue <<= 4; Hexvalue |= Ascii2Hex(FileContent[Pos++]); IspEnvironment->BinaryContent[RealAddress + i - IspEnvironment->BinaryOffset] = Hexvalue; } } else if (RecordType == 0x01) // 01 - End of file record { break; } else if (RecordType == 0x02) // 02 - Extended segment address record { for (i = 0; i < RecordLength * 2; i++) // double amount of nibbles { RealAddress <<= 4; if (i == 0) { RealAddress = Ascii2Hex(FileContent[Pos++]); } else { RealAddress |= Ascii2Hex(FileContent[Pos++]); } } RealAddress <<= 4; } else if (RecordType == 0x03) // 03 - Start segment address record { unsigned long cs,ip; StartAddress = 0; for (i = 0; i < RecordLength * 2; i++) // double amount of nibbles { StartAddress <<= 4; if (i == 0) { StartAddress = Ascii2Hex(FileContent[Pos++]); } else { StartAddress |= Ascii2Hex(FileContent[Pos++]); } } cs = StartAddress >> 16; //high part ip = StartAddress & 0xffff; //low part StartAddress = cs*16+ip; //segmented 20-bit space DebugPrintf(1,"Start Address = 0x%08X\n", StartAddress); IspEnvironment->StartAddress = StartAddress; } else if (RecordType == 0x04) // 04 - Extended linear address record, used by IAR { for (i = 0; i < RecordLength * 2; i++) // double amount of nibbles { RealAddress <<= 4; if (i == 0) { RealAddress = Ascii2Hex(FileContent[Pos++]); } else { RealAddress |= Ascii2Hex(FileContent[Pos++]); } } RealAddress <<= 16; if (!BinaryOffsetDefined) { // set startaddress of BinaryContent // use of LPC_FLASHMASK to allow a memory range, not taking the first // [04] record as actual start-address. IspEnvironment->BinaryOffset = RealAddress & LPC_FLASHMASK; } else { if ((RealAddress & LPC_FLASHMASK) != IspEnvironment->BinaryOffset) { DebugPrintf(1, "New Extended Linear Address Record [04] out of memory range\n"); DebugPrintf(1, "Current Memory starts at: 0x%08X, new Address is: 0x%08X", IspEnvironment->BinaryOffset, RealAddress); return ERR_MEMORY_RANGE; } } } else if (RecordType == 0x05) // 05 - Start linear address record { StartAddress = 0; for (i = 0; i < RecordLength * 2; i++) // double amount of nibbles { StartAddress <<= 4; if (i == 0) { StartAddress = Ascii2Hex(FileContent[Pos++]); } else { StartAddress |= Ascii2Hex(FileContent[Pos++]); } } DebugPrintf(1,"Start Address = 0x%08X\n", StartAddress); IspEnvironment->StartAddress = StartAddress; } else { free( FileContent); DebugPrintf( 1, "Error %d RecordType %02X not yet implemented\n", ERR_RECORD_TYPE_LOADFILE, RecordType); return( ERR_RECORD_TYPE_LOADFILE); } while (FileContent[Pos++] != 0x0a) // Search till line end { } } DebugPrintf(2, "\tconverted to binary format...\n"); // When debugging is switched on, output result of conversion to file debugout.bin if (debug_level >= 4) { int fdout; fdout = open("debugout.bin", O_RDWR | O_BINARY | O_CREAT | O_TRUNC, 0777); write(fdout, IspEnvironment->BinaryContent, IspEnvironment->BinaryLength); close(fdout); } free( FileContent); // Done with file contents } else // FORMAT_BINARY { IspEnvironment->BinaryContent = FileContent; IspEnvironment->BinaryLength = FileLength; } DebugPrintf(2, "\timage size : %ld\n", IspEnvironment->BinaryLength); return 0; } /***************************** LoadFiles1 ********************************/ /** Loads the requested files to download into memory. \param [in] IspEnvironment structure containing input filename(s). \param [in] file simple linked list of files to read \return 0 if successful, otherwise an error code. */ static int LoadFiles1(ISP_ENVIRONMENT *IspEnvironment, const FILE_LIST *file) { int ret_val; if( file->prev != 0) { DebugPrintf( 3, "Follow file list %s\n", file->name); ret_val = LoadFiles1( IspEnvironment, file->prev); if( ret_val != 0) { return ret_val; } } DebugPrintf( 3, "Attempt to read File %s\n", file->name); if(file->hex_flag != 0) { ret_val = LoadFile(IspEnvironment, file->name, FORMAT_HEX); } else { ret_val = LoadFile(IspEnvironment, file->name, FORMAT_BINARY); } if( ret_val != 0) { return ret_val; } return 0; } /***************************** LoadFiles ********************************/ /** Loads the requested files to download into memory. \param [in] IspEnvironment structure containing input filename(s). \param [in] file simple linked list of files to read \return 0 if successful, otherwise an error code. */ static int LoadFiles(ISP_ENVIRONMENT *IspEnvironment) { int ret_val; ret_val = LoadFiles1(IspEnvironment, IspEnvironment->f_list); if( ret_val != 0) { exit(1); // return ret_val; } DebugPrintf( 2, "Image size : %ld\n", IspEnvironment->BinaryLength); // check length to flash for correct alignment, can happen with broken ld-scripts if (IspEnvironment->BinaryLength % 4 != 0) { unsigned long NewBinaryLength = ((IspEnvironment->BinaryLength + 3)/4) * 4; DebugPrintf( 2, "Warning: data not aligned to 32 bits, padded (length was %lX, now %lX)\n", IspEnvironment->BinaryLength, NewBinaryLength); IspEnvironment->BinaryLength = NewBinaryLength; } // When debugging is switched on, output result of conversion to file debugout.bin if(debug_level >= 4) { int fdout; DebugPrintf( 1, "Dumping image file.\n"); fdout = open("debugout.bin", O_RDWR | O_BINARY | O_CREAT | O_TRUNC, 0777); write(fdout, IspEnvironment->BinaryContent, IspEnvironment->BinaryLength); close(fdout); } return 0; } #endif // !defined COMPILE_FOR_LPC21 #ifndef COMPILE_FOR_LPC21 int PerformActions(ISP_ENVIRONMENT *IspEnvironment) { int downloadResult = -1; DebugPrintf(2, "lpc21isp version " VERSION_STR "\n"); /* Download requested, read in the input file. */ if (IspEnvironment->ProgramChip) { LoadFiles(IspEnvironment); } OpenSerialPort(IspEnvironment); /* Open the serial port to the microcontroller. */ ResetTarget(IspEnvironment, PROGRAM_MODE); ClearSerialPortBuffers(IspEnvironment); /* Perform the requested download. */ if (IspEnvironment->ProgramChip || IspEnvironment->DetectOnly) { switch (IspEnvironment->micro) { #ifdef LPC_SUPPORT case NXP_ARM: downloadResult = NxpDownload(IspEnvironment); break; #endif #ifdef AD_SUPPORT case ANALOG_DEVICES_ARM: downloadResult = AnalogDevicesDownload(IspEnvironment); break; #endif } if (downloadResult != 0) { CloseSerialPort(IspEnvironment); exit(downloadResult); } } if (IspEnvironment->StartAddress == 0 || IspEnvironment->TerminalOnly) { /* Only reset target if startaddress = 0 * Otherwise stay with the running program as started in Download() */ ResetTarget(IspEnvironment, RUN_MODE); } debug_level = 1; /* From now on there is no more debug output !! */ /* Therefore switch it off... */ #ifdef TERMINAL_SUPPORT // Pass control to Terminal which will provide a terminal if one was asked for // User asked for terminal emulation, provide a really dumb terminal. Terminal(IspEnvironment); #endif CloseSerialPort(IspEnvironment); /* All done, close the serial port to the */ return 0; } #endif /***************************** main *************************************/ /** main. Everything starts from here. \param [in] argc the number of arguments. \param [in] argv an array of pointers to the arguments. */ #if !defined COMPILE_FOR_LPC21 #if defined INTEGRATED_IN_WIN_APP int AppDoProgram(int argc, char *argv[]) #else int main(int argc, char *argv[]) #endif { ISP_ENVIRONMENT IspEnvironment; // Initialize debug level debug_level = 2; // Initialize ISP Environment memset(&IspEnvironment, 0, sizeof(IspEnvironment)); // Clear the IspEnviroment to a known value IspEnvironment.micro = NXP_ARM; // Default Micro IspEnvironment.FileFormat = FORMAT_HEX; // Default File Format IspEnvironment.ProgramChip = TRUE; // Default to Programming the chip IspEnvironment.nQuestionMarks = 100; IspEnvironment.DoNotStart = 0; ReadArguments(&IspEnvironment, argc, argv); // Read and parse the command line return PerformActions(&IspEnvironment); // Do as requested ! } #endif // !defined COMPILE_FOR_LPC21 /***************************** DumpString ******************************/ /** Prints an area of memory to stdout. Converts non-printables to hex. \param [in] level the debug level of the block to be dumped. If this is less than or equal to the current debug level than the dump will happen otherwise this just returns. \param [in] b pointer to an area of memory. \param [in] size the length of the memory block to print. \param [in] prefix string is a pointer to a prefix string. */ void DumpString(int level, const void *b, size_t size, const char *prefix_string) { size_t i; const char * s = (const char*) b; unsigned char c; DebugPrintf(level, prefix_string); DebugPrintf(level, "'"); for (i = 0; i < size; i++) { c = s[i]; if (c >= 0x20 && c <= 0x7e) /*isprint?*/ { DebugPrintf(level, "%c", c); } else { DebugPrintf(level, "(%02X)", c); } } DebugPrintf(level, "'\n"); } #if !defined COMPILE_FOR_LPC21 int lpctest(char* FileName) { ISP_ENVIRONMENT IspEnvironment; // Initialize debug level debug_level = 2; // Initialize ISP Environment memset(&IspEnvironment, 0, sizeof(IspEnvironment)); // Clear the IspEnviroment to a known value IspEnvironment.micro = NXP_ARM; // Default Micro IspEnvironment.FileFormat = FORMAT_HEX; // Default File Format IspEnvironment.ProgramChip = TRUE; // Default to Programming the chip // IspEnvironment.input_file = FileName; IspEnvironment.ControlLines = TRUE; IspEnvironment.serial_port = "COM2"; IspEnvironment.baud_rate = "19200"; IspEnvironment.nQuestionMarks = 100; IspEnvironment.DoNotStart = 0; strcpy(IspEnvironment.StringOscillator, "25000"); return PerformActions(&IspEnvironment); // Do as requested ! } #endif