USBDM  V4.12
USBDM_ErrorMessages.h File Reference

USBDM error codes. More...

Enumerations

enum  USBDM_ErrorCode {
  BDM_RC_ERROR_HANDLED = 0x10000, BDM_RC_OK = 0, BDM_RC_ILLEGAL_PARAMS = 1, BDM_RC_FAIL = 2,
  BDM_RC_BUSY = 3, BDM_RC_ILLEGAL_COMMAND = 4, BDM_RC_NO_CONNECTION = 5, BDM_RC_OVERRUN = 6,
  BDM_RC_CF_ILLEGAL_COMMAND = 7, BDM_RC_DEVICE_OPEN_FAILED = 8, BDM_RC_USB_DEVICE_BUSY = 9, BDM_RC_USB_DEVICE_NOT_INSTALLED = 10,
  BDM_RC_USB_DEVICE_REMOVED = 11, BDM_RC_USB_RETRY_OK = 12, BDM_RC_UNEXPECTED_RESET = 13, BDM_RC_CF_NOT_READY = 14,
  BDM_RC_UNKNOWN_TARGET = 15, BDM_RC_NO_TX_ROUTINE = 16, BDM_RC_NO_RX_ROUTINE = 17, BDM_RC_BDM_EN_FAILED = 18,
  BDM_RC_RESET_TIMEOUT_FALL = 19, BDM_RC_BKGD_TIMEOUT = 20, BDM_RC_SYNC_TIMEOUT = 21, BDM_RC_UNKNOWN_SPEED = 22,
  BDM_RC_WRONG_PROGRAMMING_MODE = 23, BDM_RC_FLASH_PROGRAMING_BUSY = 24, BDM_RC_VDD_NOT_REMOVED = 25, BDM_RC_VDD_NOT_PRESENT = 26,
  BDM_RC_VDD_WRONG_MODE = 27, BDM_RC_CF_BUS_ERROR = 28, BDM_RC_USB_ERROR = 29, BDM_RC_ACK_TIMEOUT = 30,
  BDM_RC_FAILED_TRIM = 31, BDM_RC_FEATURE_NOT_SUPPORTED = 32, BDM_RC_RESET_TIMEOUT_RISE = 33, BDM_RC_WRONG_BDM_REVISION = 34,
  BDM_RC_WRONG_DLL_REVISION = 35, BDM_RC_NO_USBDM_DEVICE = 36, BDM_RC_JTAG_UNMATCHED_REPEAT = 37, BDM_RC_JTAG_UNMATCHED_RETURN = 38,
  BDM_RC_JTAG_UNMATCHED_IF = 39, BDM_RC_JTAG_STACK_ERROR = 40, BDM_RC_JTAG_ILLEGAL_SEQUENCE = 41, BDM_RC_TARGET_BUSY = 42,
  BDM_RC_JTAG_TOO_LARGE = 43, BDM_RC_DEVICE_NOT_OPEN = 44, BDM_RC_UNKNOWN_DEVICE = 45, BDM_RC_DEVICE_DATABASE_ERROR = 46,
  BDM_RC_ARM_PWR_UP_FAIL = 47, BDM_RC_ARM_ACCESS_ERROR = 48, BDM_JTAG_TOO_MANY_DEVICES = 49, BDM_RC_SECURED = 50,
  BDM_RC_ARM_PARITY_ERROR = 51, BDM_RC_ARM_FAULT_ERROR = 52, BDM_RC_UNEXPECTED_RESPONSE = 53, BDM_RC_HCS_ACCESS_ERROR = 54,
  BDM_RC_SELECTED_BDM_NOT_FOUND = 55, BDM_RC_NOT_INITIALISED = 56, BDM_RC_OPERATION_NOT_SUPPORTED = 57, PROGRAMMING_RC_OK = 0,
  PROGRAMMING_RC_ERROR_FIRST_MESSAGE = 101, PROGRAMMING_RC_ERROR_ILLEGAL_PARAMS = 101, PROGRAMMING_RC_ERROR_WRONG_SDID = 102, PROGRAMMING_RC_ERROR_FAILED_VERIFY = 103,
  PROGRAMMING_RC_ERROR_BDM = 104, PROGRAMMING_RC_ERROR_NOT_BLANK = 105, PROGRAMMING_RC_ERROR_BDM_NO_DEVICES = 106, PROGRAMMING_RC_ERROR_BDM_OPEN = 107,
  PROGRAMMING_RC_ERROR_BDM_CONNECT = 108, PROGRAMMING_RC_ERROR_BDM_TARGET = 109, PROGRAMMING_RC_ERROR_BDM_WRITE = 110, PROGRAMMING_RC_ERROR_BDM_READ = 111,
  PROGRAMMING_RC_ERROR_BDM_RESET = 112, PROGRAMMING_RC_ERROR_TRIM = 113, PROGRAMMING_RC_ERROR_SECURED = 114, PROGRAMMING_RC_ERROR_FAILED_FLASH_COMMAND = 115,
  PROGRAMMING_RC_ERROR_NO_VALID_FCDIV_VALUE = 116, PROGRAMMING_RC_ERROR_CHECKSUM = 117, PROGRAMMING_RC_ERROR_FAILED_CLOCK = 118, PROGRAMMING_RC_ERROR_INTERNAL_CHECK_FAILED = 119,
  PROGRAMMING_RC_ERROR_FILE_OPEN_FAIL = 120, PROGRAMMING_RC_ERROR_PPAGE_FAIL = 121, PROGRAMMING_RC_ERROR_EPAGE_FAIL = 122, PROGRAMMING_RC_ERROR_SPEED_APPROX = 123,
  PROGRAMMING_RC_ERROR_CHIP_UNSUPPORTED = 124, PROGRAMMING_RC_ERROR_TCL_SCRIPT = 125, PROGRAMMING_RC_ERROR_TCL_UNSECURE_SCRIPT = 126, PROGRAMMING_RC_ERROR_TCL_PREPROGRAM_SCRIPT = 127,
  PROGRAMMING_RC_ERROR_TCL_POSTPROGRAM_SCRIPT = 128, PROGRAMMING_RC_ERROR_OUTSIDE_TARGET_FLASH = 129, PROGRAMMING_RC_ERROR_ILLEGAL_SECURITY = 130, PROGRAMMING_RC_FLEXNVM_CONFIGURATION_FAILED = 131,
  SFILE_RC_OK = 0, SFILE_RC_FIRST_MESSAGE = 201, SFILE_RC_CHECKSUM = 201, SFILE_RC_ILLEGAL_LINE = 202,
  SFILE_RC_FILE_OPEN_FAILED = 203, SFILE_RC_ELF_FORMAT_ERROR = 204, SFILE_RC_UNKNOWN_FILE_FORMAT = 205, SFILE_RC_ELF_WRONG_TARGET = 206,
  SFILE_RC_IMAGE_OVERLAPS = 207
}
 Error codes returned from BDM routines and BDM commands. More...
 

Detailed Description

USBDM error codes.

 Copyright (C) 2010  Peter O'Donoghue

 Based on material from OSBDM-JM60 Target Interface Software Package
 Copyright (C) 2009  Freescale

 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or
 (at your option) any later version.

 This program 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 General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 Change History
+====================================================================
|    May 2010 | Created
+====================================================================

Enumeration Type Documentation

◆ USBDM_ErrorCode

Error codes returned from BDM routines and BDM commands.

Enumerator
BDM_RC_ERROR_HANDLED 

Indicates error has already been notified to user.

BDM_RC_OK 

No error.

BDM_RC_ILLEGAL_PARAMS 

Illegal parameters to command.

BDM_RC_FAIL 

General Fail.

BDM_RC_BUSY 

Busy with last command - try again - don't change.

BDM_RC_ILLEGAL_COMMAND 

Illegal (unknown) command (may be in wrong target mode)

BDM_RC_NO_CONNECTION 

No connection to target.

BDM_RC_OVERRUN 

New command before previous command completed.

BDM_RC_CF_ILLEGAL_COMMAND 

Coldfire BDM interface did not recognize the command.

BDM_RC_DEVICE_OPEN_FAILED 

BDM Open Failed - Other LIBUSB error on open.

BDM_RC_USB_DEVICE_BUSY 

BDM Open Failed - LIBUSB_ERROR_ACCESS on open - Probably open in another app.

BDM_RC_USB_DEVICE_NOT_INSTALLED 

BDM Open Failed - LIBUSB_ERROR_ACCESS on claim I/F - Probably driver not installed.

BDM_RC_USB_DEVICE_REMOVED 

BDM Open Failed - LIBUSB_ERROR_NO_DEVICE - enumerated device has been removed.

BDM_RC_USB_RETRY_OK 

USB Debug use only.

BDM_RC_UNEXPECTED_RESET 

Target reset was detected.

BDM_RC_CF_NOT_READY 

Coldfire 2,3,4 Not ready response (running?)

BDM_RC_UNKNOWN_TARGET 

Target unknown or not supported by this BDM.

BDM_RC_NO_TX_ROUTINE 

No Tx routine available at measured BDM communication speed.

BDM_RC_NO_RX_ROUTINE 

No Rx routine available at measured BDM communication speed.

BDM_RC_BDM_EN_FAILED 

Failed to enable BDM mode in target (warning)

BDM_RC_RESET_TIMEOUT_FALL 

RESET signal failed to fall.

BDM_RC_BKGD_TIMEOUT 

BKGD signal failed to rise/fall.

BDM_RC_SYNC_TIMEOUT 

No response to SYNC sequence.

BDM_RC_UNKNOWN_SPEED 

Communication speed is not known or cannot be determined.

BDM_RC_WRONG_PROGRAMMING_MODE 

Attempted Flash programming when in wrong mode (e.g. Vpp off)

BDM_RC_FLASH_PROGRAMING_BUSY 

Busy with last Flash programming command.

BDM_RC_VDD_NOT_REMOVED 

Target Vdd failed to fall.

BDM_RC_VDD_NOT_PRESENT 

Target Vdd not present/failed to rise.

BDM_RC_VDD_WRONG_MODE 

Attempt to cycle target Vdd when not controlled by BDM interface.

BDM_RC_CF_BUS_ERROR 

Illegal bus cycle on target (Coldfire)

BDM_RC_USB_ERROR 

Indicates USB transfer failed (returned by driver not BDM)

BDM_RC_ACK_TIMEOUT 

Indicates an expected ACK was missing.

BDM_RC_FAILED_TRIM 

Trimming of target clock failed (out of clock range?).

BDM_RC_FEATURE_NOT_SUPPORTED 

Feature not supported by this version of hardware/firmware.

BDM_RC_RESET_TIMEOUT_RISE 

RESET signal failed to rise.

BDM_RC_WRONG_BDM_REVISION 

BDM Hardware is incompatible with driver/program.

BDM_RC_WRONG_DLL_REVISION 

Program is incompatible with DLL.

BDM_RC_NO_USBDM_DEVICE 

No usbdm device was located.

BDM_RC_JTAG_UNMATCHED_REPEAT 

Unmatched REPEAT-END_REPEAT.

BDM_RC_JTAG_UNMATCHED_RETURN 

Unmatched CALL-RETURN.

BDM_RC_JTAG_UNMATCHED_IF 

Unmatched IF-END_IF.

BDM_RC_JTAG_STACK_ERROR 

Underflow in call/return sequence, unmatched REPEAT etc.

BDM_RC_JTAG_ILLEGAL_SEQUENCE 

Illegal JTAG sequence.

BDM_RC_TARGET_BUSY 

Target is busy (executing?)

BDM_RC_JTAG_TOO_LARGE 

Subroutine is too large to cache.

BDM_RC_DEVICE_NOT_OPEN 

USBDM Device has not been opened.

BDM_RC_UNKNOWN_DEVICE 

Device is not in database.

BDM_RC_DEVICE_DATABASE_ERROR 

Device database not found or failed to open/parse.

BDM_RC_ARM_PWR_UP_FAIL 

ARM System power failed.

BDM_RC_ARM_ACCESS_ERROR 

ARM Access error.

BDM_JTAG_TOO_MANY_DEVICES 

JTAG chain is too long (or greater than 1!)

BDM_RC_SECURED 

ARM Device is secured (& operation failed?)

BDM_RC_ARM_PARITY_ERROR 

ARM PARITY error.

BDM_RC_ARM_FAULT_ERROR 

ARM FAULT response error.

BDM_RC_UNEXPECTED_RESPONSE 

Unexpected/inconsistent response from BDM.

BDM_RC_HCS_ACCESS_ERROR 

Memory access failed due to target in stop or wait state.

BDM_RC_SELECTED_BDM_NOT_FOUND 

Selected BDM not found (removed)

BDM_RC_NOT_INITIALISED 

Interface not initialised before use e.g. failed to call USBDM_Init()

BDM_RC_OPERATION_NOT_SUPPORTED 

Operation not supported for target.

PROGRAMMING_RC_OK 

0 Success

PROGRAMMING_RC_ERROR_FIRST_MESSAGE 
PROGRAMMING_RC_ERROR_ILLEGAL_PARAMS 

1 Programming parameters incorrect

PROGRAMMING_RC_ERROR_WRONG_SDID 

2 Incorrect target device

PROGRAMMING_RC_ERROR_FAILED_VERIFY 

3 Verification of Flash failed

PROGRAMMING_RC_ERROR_BDM 

4 General BDM error

PROGRAMMING_RC_ERROR_NOT_BLANK 

5 Device is not blank/failed erase

PROGRAMMING_RC_ERROR_BDM_NO_DEVICES 

6 No USBDM devices found

PROGRAMMING_RC_ERROR_BDM_OPEN 

7 Failed to open USBDM device

PROGRAMMING_RC_ERROR_BDM_CONNECT 

8 Failed to connect to target

PROGRAMMING_RC_ERROR_BDM_TARGET 

9 Failed to set target type

PROGRAMMING_RC_ERROR_BDM_WRITE 

10 Failed to write to target

PROGRAMMING_RC_ERROR_BDM_READ 

11 Failed to read from target

PROGRAMMING_RC_ERROR_BDM_RESET 

12 Failed to reset target

PROGRAMMING_RC_ERROR_TRIM 

13 Trimming target clock failed

PROGRAMMING_RC_ERROR_SECURED 

14 Target is secured and cannot be programmed

PROGRAMMING_RC_ERROR_FAILED_FLASH_COMMAND 

15 Flash command failed

PROGRAMMING_RC_ERROR_NO_VALID_FCDIV_VALUE 

16 Failed to find a suitable FCDIV value (clock problem?)

PROGRAMMING_RC_ERROR_CHECKSUM 

17 Checksum of SREC invalid

PROGRAMMING_RC_ERROR_FAILED_CLOCK 

18 Failed setup of target clock (connection lost)

PROGRAMMING_RC_ERROR_INTERNAL_CHECK_FAILED 

19 Failed an internal software check - should be impossible!

PROGRAMMING_RC_ERROR_FILE_OPEN_FAIL 

20 Failed to open S1S9 file

PROGRAMMING_RC_ERROR_PPAGE_FAIL 

21 Access to PPAGE register failed

PROGRAMMING_RC_ERROR_EPAGE_FAIL 

22 Access to EPAGE register failed

PROGRAMMING_RC_ERROR_SPEED_APPROX 

23 Can only approximate the target bus speed

PROGRAMMING_RC_ERROR_CHIP_UNSUPPORTED 

24 This chip and/or operation is supported due to target hardware bug

PROGRAMMING_RC_ERROR_TCL_SCRIPT 

25 Execution of TCL script returned a error

PROGRAMMING_RC_ERROR_TCL_UNSECURE_SCRIPT 

26 Execution of TCL script returned a error

PROGRAMMING_RC_ERROR_TCL_PREPROGRAM_SCRIPT 

27 Execution of TCL script returned a error

PROGRAMMING_RC_ERROR_TCL_POSTPROGRAM_SCRIPT 

28 Execution of TCL script returned a error

PROGRAMMING_RC_ERROR_OUTSIDE_TARGET_FLASH 

29 Image is outside target Flash memory

PROGRAMMING_RC_ERROR_ILLEGAL_SECURITY 

30 Illegal Security value (will lock chip forever)

PROGRAMMING_RC_FLEXNVM_CONFIGURATION_FAILED 

31 Failed to program FlexNVM Configuration values.

SFILE_RC_OK 

No error.

SFILE_RC_FIRST_MESSAGE 
SFILE_RC_CHECKSUM 

S-record has incorrect checksum.

SFILE_RC_ILLEGAL_LINE 

S-record has invalid/unsupported record.

SFILE_RC_FILE_OPEN_FAILED 

Hex file failed to open (fopen() failed)

SFILE_RC_ELF_FORMAT_ERROR 

ELF file does not have the expected format.

SFILE_RC_UNKNOWN_FILE_FORMAT 

File is not recognised as ELF or SREC.

SFILE_RC_ELF_WRONG_TARGET 

ELF is intended for another target.

SFILE_RC_IMAGE_OVERLAPS 

File being loaded overlaps existing contents (will still be loaded)