View source for 83Plus:Software:usb8x/Error Codes

Error codes may be returned via both the [[../Asm_Interface|assembly language interface]] and the [[../BASIC_Interface|BASIC interface]].  In the BASIC interface, the error code is returned in the first element of the return list.  In the assembly language interface, an error is generally indicated by a return with the carry flag set.  The error code can then be read from an offset of offErrorCode from the start of the usb8x driver buffer.  There may be an additional error code located at offErrorCode+1.  Error code equates are located in usb8x.inc.
== Error Codes ==
{| border="1" cellpadding="2"  cellspacing="0" 
!Error # !! Name !! Info
|-
|0 || OK || No error occured
|-
|1 || Port82 || An error occured while waiting for a value from port 82.  This generally happens during initialization.
|-
|2 || Port91Bit2 || An error condition was detected via port 91 (NAK?)
|-
|3 || Port91Bit4 || An error condition was detected via port 91 (Stall?)
|-
|4 || Port4C || Port 4C did not hold the expected value.  This generally happens during initialization.
|-
|5 || Port4D || Port 4D did not hold the expected value.  This generally happens during initialization.
|-
|6 || Port3A || Port 3A did not hold the expected value.  This generally happens during initialization.
|-
|7 || Port81 || Port 81 did not hold the expected value.  This generally happens during initialization.
|-
|8 || Port8C || The frame counter did not start.  This indicates a problem during initialization.
|-
|9 || Port8F || Port 8F did not hold the expected value.  This generally happens during initialization.
|-
|10 || EPIndex || A non existant entry point was called.  Be sure to check for the minimum required version of usb8x before calling entry points.
|-
|11 || EPGetDes || An unsupported descriptor was requested from [[../Asm_Interface/ReadDescriptor|ReadDescriptor]].
|-
|12 || NoDevice || No Device is connected.
|-
|13 || FindDescriptor || An error occured in [[../Asm_Interface/FindDescriptor|FindDescriptor]].
|-
|14 || BadClass || The attached device does not have the required class.  (i.e. a keyboard is connected when [[../Asm_Interface/MouseInit|MouseInit]] is called).
|-
|15 || Timeout || A timeout occured while waiting for data.  This currently is only returned by [[../BASIC_Interface/MouseDo|MouseDo]].
|-
|16 || BadID || The attached device does not have the required vendor or device ID.
|-
|17 || ReadDescriptor || An error occured in [[../Asm_Interface/ReadDescriptor|ReadDescriptor]].  Check sub error code for additional information.
|-
|18 || Init || An error occured during initialization.  Check sub error code for more information.
|-
|19 || AutoSetup || An error occured during [[../Asm_Interface/AutoSetup|AutoSetup]].  Check sub error code for more information.
|-
|20 || Demo || An error occured in demo code.  This should not be returned via either of the programming interfaces.
|-
|21 || FindPipe || An error occured in [[../Asm_Interface/FindPipe|FindPipe]].  This error may occasionally improperly be listed a sub error code, because AutoSetup generates a FindPipe error during normal operation.
|-
|22 || Stub || Returned by stub routines (not current used).
|-
|23 || GetMaxPacketSize || An error occured while trying to determine the maximum supported packet size.
|-
|24 || SetAddress || An error occured while trying to set the device address
|}
Be aware that the error codes listed on this page are in decimal, while the error codes displayed in USBInfo are in hexadecimal.