phantom_dbg.h

来自「QPSK Tuner details, for conexant chipset」· C头文件 代码 · 共 83 行

#ifndef _PHANTOM_DBG_H_
#define _PHANTOM_DBG_H_

/* phantom_dbg.h */
/*+++ *******************************************************************\
*
*  Abstract:
*
*       Contains definitions and typedefs used by the debug module.
*
*
*  Created: 5/24/2004
*
*  Author: Amarnath Puttur
*
*  Copyright and Disclaimer: 
*  
*     --------------------------------------------------------------- 
*     This software is provided "AS IS" without warranty of any kind, 
*     either expressed or implied, including but not limited to the 
*     implied warranties of noninfringement, merchantability and/or 
*     fitness for a particular purpose.
*     --------------------------------------------------------------- 
*   
*     Copyright (c) 2004 Conexant Systems, Inc. 
*     All rights reserved. 
*
\******************************************************************* ---*/

#if PHANTOM_INCLUDE_DEBUG

#ifdef __cplusplus
extern "C" {
#endif  /* __cplusplus */

/*******************************************************************************************************/
/* error codes                                                                                         */
/*******************************************************************************************************/
typedef enum  _PHANTOMErrno  {               /* standardized method to relate error numbers to err strings */
    PHANTOM_NOERR = 0,                       /*   0 = no error.  (first enum err item must be 0) */
    PHANTOM_BADPTR,                          /*   bad pointer value passed by caller */
    PHANTOM_INVALID_NIM,                     /*   PHANTOM_NIM passed was invalid */
    PHANTOM_NIM_OPENED,                      /*   PHANTOM_NIM passed was already opened */
    PHANTOM_SBIO_NULL,                       /*   user-supplied SBRead or SBWrite funct is NULL */
    PHANTOM_NIM_NULL,                        /*   nim passed by caller is NULL */
    PHANTOM_IO_READERR,                      /*   error encountered at read demod */
    PHANTOM_IO_WRITERR,                      /*   error encountered at write demod */
    PHANTOM_RANGE,                           /*   Warning: caller wrote register with value out-of-bounds */
    PHANTOM_BAD_PARM,                        /*   bad parameter passed by caller -- see file/line to determine error */
    PHANTOM_PARM_RANGE,                      /*   parm value passed was out of valid range */
    PHANTOM_BAD_RTNVAL,                      /*   unexpected return value received from hardware (register) */
    PHANTOM_LOCKIND_ERR,                     /*   unable to read a lockind at PHANTOM_GetLockIndicators() */
    PHANTOM_INIT_XTAL,                       /*   initenv...() - crystal freq is out-of-bounds */
    PHANTOM_INIT_MPEG,                       /*   initenv...() - mpeg (default settings) struct is NULL */
    PHANTOM_DEMOD_ERR,                       /*   demod register read has invalid setting */
    PHANTOM_VITSETTING,                      /*   demod viterbi setting is zero */
    PHANTOM_NOTSUPPORT,                      /*   feature not supported by driver */
    PHANTOM_BAD_DIV,                         /*   API: Averted div by zero error -- results are undef */
    PHANTOM_VITSET,                          /*   viterbi settings are incorrect */
    PHANTOM_CXTYPE,                          /*   unable to determine demod type (CxType) */
    PHANTOM_LNB_MSGLEN,                      /*   LNB message less-than 3 bytes in length */
    PHANTOM_LNB_STALLED,                     /*   LNB message could not be sent in time allocated */
    PHANTOM_LNB_BUSY,                        /*   LNB message busy flag is not set (should be set) */
    PHANTOM_DISEQC_RXLEN,                    /*   Rx buffer passed-into API was too short */
    PHANTOM_DISEQC_VERSION,                  /*   Wrong version to Rx Diseqc Messages */
    PHANTOM_DISEQC_TIMEOUT,                  /*   demod took to long to rx diseqc message */
    PHANTOM_DEMOD_UNSUPPORTED,               /*   demod is not supported by the driver */
    PHANTOM_FIRMWARE_DOWNLOAD_FAILED,        /*   Firmware download failed   */
    PHANTOM_FIRMWARE_DOWNLOAD_BAD_LENGTH,    /*   Bad firmware image length  */
    PHANTOM_FIRMWARE_DOWNLOAD_BAD_IMAGE,     /*   Bad firmware image pointer */
    /* software download errors */
    DOWNLOAD_MAX_RETRIES_EXHAUSTED,      /*   Maximum download retries exhausted */
    /* -- Register, LLF, FIFO errors -- */
    /* Reg: map Processing errors */
    PHANTOM_REG_MATCH_IDX_ERR,                   /* Register array in phantom_cmd.h is corrupt */
    PHANTOM_REG_MATCH_TRAN_ERR,                  /* Raw data (HW bit-field) to external data translation error */
    PHANTOM_REG_MATCH_DTRAN_ERR,                 /* External data to raw data (HW bit-field) translation error */
    /* Reg: verification errors */
    PHANTOM_REG_VERIFY_IDX_ERR,                  /* Register map index(bit-field enums) are not contiguous */
    PHANTOM_REG_VERIFY_ADDR_ERR,                 /* Reg map addr variable is inconsistent with expected range */
    PHANTOM_REG_VERIFY_REGRW_ERR,                /* Reg map access field (RO/WO/RW) contains invalid data */
    PHANTOM_REG_VERFY_REGDTP_ERR,                /* Reg data (BIT,BYTE,MULTI-BYTE...) type field is invalid */
    PHANTOM_REG_VERFY_DTLEN_ERR,                 /* When field is bit, but len>1bit; When multi-byte, len<=8bits)