i2api.h

RAID卡的测试程序

/*******************************************************************************
 * Filename    : i2api.h
 * Description : I2 API header file
 *               It declares all of I2 APIs
 * Created on  : 02/05/2004
 * CVS Version : $Id: i2api.h,v 1.1 2004/03/24 03:24:12 weny Exp $
 *
 * Copyright (C) 2004-2004 Promise Technology Inc.
 * All Rights Reserved
 ******************************************************************************/

#ifndef I2_API_H
#define I2_API_H

/* --- standard C lib header files ----------------------------------------- */

/* --- internal header files ----------------------------------------------- */
#include "i2types.h"

/* --- constant definitions ------------------------------------------------ */
#define I2API_SIGNATURE 0xbaba0000

#define I2API_VERSION   (I2API_SIGNATURE | 0x00000001)

/* read/write control */
#define I2IPC_RW_NONE 0
#define I2IPC_RW_READ 0x01
#define I2IPC_RW_WRITE 0x02
//add end 20060524

/* --- data structures ----------------------------------------------------- */

/* --- functional routines ------------------------------------------------- */

extern "C"
{u32 i2_initialize(i2api_param_t * pParam);}
u32 i2_finalize();

u32 i2_discover(boolean_t bRescan);
u32 i2_discoverByProductAndCommPath(u16 u16ProductId, u8 u8CommPath);
u32 i2_getNumberOfSubsystem(u32 * pu32NumOfSubsys);
u32 i2_getNumberOfHBA(u32 * pu32NumOfHBA);
#define MIN_DISCOVER_PATH_SIZE (sizeof(DataBufferHeader_t) + sizeof(device_discover_path_t))
u32 i2_getDiscoverPath(device_id_t di, u8 * pu8Data, u32 u32DataSize);

u32 i2_getSubsystemInfo(device_id_t di, session_id_t si, req_data_subsys_info_t * pData);
u32 i2_getSubsystemSettings(device_id_t di, session_id_t si, req_data_subsys_settings_t * pData);
u32 i2_setSubsystemSettings(device_id_t di, session_id_t si,  req_data_subsys_settings_t * pData);

u32 i2_getControllerInfo(device_id_t di, session_id_t si, req_param_ctrl_info_t * pParam, req_data_ctrl_info_t * pData, u32 u32DataSize);
u32 i2_getControllerSettings(device_id_t di, session_id_t si, req_param_ctrl_settings_t * pParam, req_data_ctrl_settings_t * pData,     u32 u32DataSize);
u32 i2_setControllerSettings(device_id_t di, session_id_t si, req_param_ctrl_settings_t * pParam, req_data_ctrl_settings_t * pData, u32 u32DataSize);

u32 i2_getPhyDrvInfo(device_id_t di, session_id_t si, req_param_phydrv_info_t * pParam, req_data_phydrv_info_t * pData, u32 u32DataSize);
u32 i2_getPhyDrvSettings(device_id_t di, session_id_t si, req_param_phydrv_settings_t * pParam, req_data_phydrv_settings_t * pData, u32 u32DataSize);
u32 i2_setPhyDrvSettings(device_id_t di, session_id_t si, req_param_phydrv_settings_t * pParam, req_data_phydrv_settings_t * pData, u32 u32DataSize);
u32 i2_locatePhyDrv(device_id_t di, session_id_t si, u16 u16PhyDrvId, u32 u32Duration);
u32 i2_stopLocatePhyDrv(device_id_t di, session_id_t si, u16 u16PhyDrvId);
u32 i2_getPhyDrvLocateStatus(device_id_t di, session_id_t si, u16 u16PhyDrvId, u8* pu8Status);
u32 i2_getMissingPhyDrvInfo(device_id_t di, session_id_t si, req_param_phydrv_info_t * pParam, req_data_phydrv_info_t * pData, u32 u32DataSize);
u32 i2_getTransitionPhyDrvInfo(device_id_t di, session_id_t si, 
    req_param_array_info_t *pParam, req_data_phydrv_info_t *pData, 
    u32 u32DataSize);
u32 i2_getHBABSL(device_id_t di, session_id_t si, u16 u16PhyDrvId, req_data_hbabsl_info_t * pData, u32 u32DataSize);

u32 i2_getLogDrvInfo(device_id_t di, session_id_t si, req_param_logdrv_info_t * pParam, req_data_logdrv_info_t * pData, u32 u32DataSize);
u32 i2_getLogDrvSettings(device_id_t di, session_id_t si, req_param_logdrv_settings_t * pParam, req_data_logdrv_settings_t * pData, u32 u32DataSize);
u32 i2_setLogDrvSettings(device_id_t di, session_id_t si, req_param_logdrv_settings_t * pParam, req_data_logdrv_settings_t * pData, u32 u32DataSize);
u32 i2_getErrorTable(device_id_t di, session_id_t si, req_param_error_table_t *pParam, req_data_error_table_t *pData, u32 u32DataSize) ;
u32 i2_locateLogDrv(device_id_t di, session_id_t si, u16 u16LogDrvId, u32 u32Duration);
u32 i2_stopLocateLogDrv(device_id_t di, session_id_t si, u16 u16LogDrvId);
u32 i2_activateLogDrv(device_id_t di, session_id_t si, u16 u16LogDrvId);

u32 i2_getDiskArrayConfig(device_id_t di, session_id_t si, req_param_array_cfg_t * pParam, req_data_array_cfg_t * pData, u32 u32DataSize);
u32 i2_getDiskArrayInfo(device_id_t di, session_id_t si, req_param_array_info_t * pParam, req_data_array_info_t * pData, u32 u32DataSize);
u32 i2_getDiskArraySettings(device_id_t di, session_id_t si, req_param_array_settings_t * pParam, req_data_array_settings_t * pData, u32 u32DataSize);
u32 i2_setDiskArraySettings(device_id_t di, session_id_t si, req_param_array_settings_t * pParam, req_data_array_settings_t * pData, u32 u32DataSize);
u32 i2_locateDiskArray(device_id_t di, session_id_t si, u16 u16ArrayId);

u32 i2_addDiskArray(device_id_t di, session_id_t si,  req_param_array_add_t * pParam);
u32 i2_addHBAArray(device_id_t di, session_id_t si, req_param_hbaarray_add_t * pParam);
u32 i2_delDiskArray(device_id_t di, session_id_t si,  req_param_array_del_t * pParam, u32 u32ParamSize);
u32 i2_delAllDiskArray(device_id_t di, session_id_t si);
u32 i2_addLogDrv(device_id_t di, session_id_t si,  req_param_logdrv_add_t * pParam, u32 u32ParamSize);
u32 i2_delLogDrv(device_id_t di, session_id_t si,  req_param_logdrv_del_t * pParam, u32 u32ParamSize);
u32 i2_processIncompleteArray(device_id_t di, session_id_t si, req_param_array_process_t *pParam);
u32 i2_migrateDiskArray(device_id_t di, session_id_t si,     req_param_migrate_t * pParam);
u32 i2_migrateHBAArray(device_id_t di, session_id_t si,     req_param_hba_migrate_t * pParam);
u32 i2_getMigrationProgress(device_id_t di, session_id_t si, req_param_device_ids_t * pParam, req_data_migrate_progress_t * pData, u32 u32DataSize);
u32 i2_PauseMigration(device_id_t di, session_id_t si, req_param_device_ids_t * pParam);
u32 i2_ResumeMigration(device_id_t di, session_id_t si, req_param_device_ids_t * pParam);
/*u32 i2_onlineArrayProcessing(device_id_t di, session_id_t si);*/

u32 i2_getSpareInfo(device_id_t di, session_id_t si, req_param_spare_info_t * pParam, req_data_spare_info_t * pData, u32 u32DataSize);
u32 i2_getAllSpareInfo(device_id_t di, session_id_t si, req_data_spare_info_t * pData, u32 u32DataSize);
u32 i2_setSpareDriveSettings(device_id_t di, session_id_t si, req_param_sparecfg_t * prps);
u32 i2_addSpare(device_id_t di, session_id_t si, req_param_spare_add_t * pParam, u32 u32ParamSize);
u32 i2_delSpare(device_id_t di, session_id_t si, req_param_spare_del_t * pParam, u32 u32ParamSize);
/*u32 i2_delAllSpare(device_id_t di, session_id_t si);*/

u32 i2_splitHBAExtentEx(device_id_t di, session_id_t si, req_param_hbaextent_ids_t * pParam, u64 u64Offset);
u32 i2_splitHBAExtent(device_id_t di, session_id_t si, req_param_hbaextent_ids_t * pParam, u32 u64Offset);
u32 i2_freeHBAExtent(device_id_t di, session_id_t si, req_param_hbaextent_ids_t * pParam);
u32 i2_spareHBAExtent(device_id_t di, session_id_t si, req_param_hbaextent_ary_op_t * pParam);
u32 i2_addHBAExtentToArray(device_id_t di, session_id_t si, req_param_hbaextent_ary_op_t * pParam);
u32 i2_deleteHBAExtent(device_id_t di, session_id_t si, req_param_hbaextent_ids_t * pParam);

u32 i2_removeHBADiskMDD(device_id_t di, session_id_t si, req_param_device_ids_t * pParam);

u32 i2_getLogDrvSynchProgress(device_id_t di, session_id_t si, req_param_ld_synch_t * pParam, req_data_synchprogress_t * pData, u32 u32DataSize);

u32 i2_getLogDrvInitProgress(device_id_t di, session_id_t si, req_param_ld_init_t * pParam, req_data_ldiprogress_t * pData, u32 u32DataSize);
u32 i2_startLogDrvInit(device_id_t di, session_id_t si, req_param_ld_init_t * pParam, u32 u32ParamSize);
u32 i2_stopLogDrvInit(device_id_t di, session_id_t si, req_param_ld_init_t * pParam);
u32 i2_pauseLogDrvInit(device_id_t di, session_id_t si, req_param_ld_init_t * pParam);
u32 i2_resumeLogDrvInit(device_id_t di, session_id_t si, req_param_ld_init_t * pParam);

u32 i2_getRedundancyCheckProgress(device_id_t di, session_id_t si, req_param_rc_t * pParam, req_data_rcprogress_t * pData, u32 u32DataSize);
u32 i2_startRedundancyCheck(device_id_t di, session_id_t si, req_param_rc_t * pParam);
u32 i2_stopRedundancyCheck(device_id_t di, session_id_t si, req_param_rc_t * pParam);
u32 i2_pauseRedundancyCheck(device_id_t di, session_id_t si, req_param_rc_t * pParam);
u32 i2_resumeRedundancyCheck(device_id_t di, session_id_t si, req_param_rc_t * pParam);

u32 i2_getRebuildProgress(device_id_t di, session_id_t si, req_param_rbprogress_t * pParam, req_data_rbprogress_t * pData, u32 u32DataSize);
u32 i2_startRebuild(device_id_t di, session_id_t si, req_param_rbctrl_t * pParam);
u32 i2_startHBARebuildExtent(device_id_t di, session_id_t si, u8 u8Count, req_param_hba_rbctrl_t * pParam);
u32 i2_stopRebuild(device_id_t di, session_id_t si, req_param_rbctrl_t * pParam);
u32 i2_pauseRebuild(device_id_t di, session_id_t si, req_param_rbctrl_t * pParam);
u32 i2_resumeRebuild(device_id_t di, session_id_t si, req_param_rbctrl_t * pParam);
u32 i2_restartRebuild(device_id_t di, session_id_t si, req_param_rbctrl_t * pParam);

u32 i2_getMediaPatrolProgress(device_id_t di, session_id_t si, req_param_device_ids_t * pParam, req_data_mpprogress_t * pData, u32 u32DataSize);
u32 i2_startMediaPatrol(device_id_t di, session_id_t si);
u32 i2_stopMediaPatrol(device_id_t di, session_id_t si);
u32 i2_pauseMediaPatrol(device_id_t di, session_id_t si);
u32 i2_resumeMediaPatrol(device_id_t di, session_id_t si);

u32 i2_getHBAMediaPatrolProgress(device_id_t di, session_id_t si, req_param_device_ids_t * pParam, req_data_hba_mpprogress_t * pData, u32 u32DataSize);
u32 i2_startHBAMediaPatrol(device_id_t di, session_id_t si, req_param_device_ids_t * pParam);
u32 i2_stopHBAMediaPatrol(device_id_t di, session_id_t si, req_param_device_ids_t * pParam);
u32 i2_pauseHBAMediaPatrol(device_id_t di, session_id_t si, req_param_device_ids_t * pParam);
u32 i2_resumeHBAMediaPatrol(device_id_t di, session_id_t si, req_param_device_ids_t * pParam);

/* TBD - transitioning and mirroring */

u32 i2_getEnclosureInfo(device_id_t di, session_id_t si, req_param_encl_info_t *pParam, req_data_encl_info_t * pData, u32 u32DataSize);
u32 i2_getEnclosureStatus(device_id_t di, session_id_t si, req_param_encl_info_t * pParam, u8 * pData, u32 u32DataSize);
/* TBD - locate enclosure */
u32 i2_getFRUInfo(device_id_t di, session_id_t si, req_param_fru_info_t *pParam, req_data_fru_info_t * pData, u32 u32DataSize);
u32 i2_getBatteryInfo(device_id_t di, session_id_t si, req_param_bat_info_t *pParam, req_data_bat_info_t * pData, u32 u32DataSize);
u32 i2_startBatteryReconditioning(device_id_t di, session_id_t si, req_param_bat_info_t *pParam);
u32 i2_getBuzzerStatus(device_id_t di, session_id_t si, u8 * pData, u32 u32DataSize);
u32 i2_turnOnBuzzer(device_id_t di, session_id_t si);
u32 i2_turnOffBuzzer(device_id_t di, session_id_t si);