Loading...
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 | /***********************************************************************/ /** AudioScience HPI driver Copyright (C) 1997-2011 AudioScience Inc. <support@audioscience.com> This program is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation; 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 \file Functions for reading DSP code to load into DSP */ /***********************************************************************/ #ifndef _HPIDSPCD_H_ #define _HPIDSPCD_H_ #include "hpi_internal.h" /** Code header version is decimal encoded e.g. 4.06.10 is 40601 */ #define HPI_VER_DECIMAL ((int)(HPI_VER_MAJOR(HPI_VER) * 10000 + \ HPI_VER_MINOR(HPI_VER) * 100 + HPI_VER_RELEASE(HPI_VER))) /** Header structure for dsp firmware file This structure must match that used in s2bin.c for generation of asidsp.bin */ /*#ifndef DISABLE_PRAGMA_PACK1 */ /*#pragma pack(push, 1) */ /*#endif */ struct code_header { /** Size in bytes including header */ u32 size; /** File type tag "CODE" == 0x45444F43 */ u32 type; /** Adapter model number */ u32 adapter; /** Firmware version*/ u32 version; /** Data checksum */ u32 checksum; }; /*#ifndef DISABLE_PRAGMA_PACK1 */ /*#pragma pack(pop) */ /*#endif */ /*? Don't need the pragmas? */ compile_time_assert((sizeof(struct code_header) == 20), code_header_size); /** Descriptor for dspcode from firmware loader */ struct dsp_code { /** copy of file header */ struct code_header header; /** Expected number of words in the whole dsp code,INCL header */ u32 block_length; /** Number of words read so far */ u32 word_count; /** internal state of DSP code reader */ struct dsp_code_private *pvt; }; /** Prepare *psDspCode to refer to the requested adapter's firmware. Code file name is obtained from HpiOs_GetDspCodePath \return 0 for success, or error code if requested code is not available */ short hpi_dsp_code_open( /** Code identifier, usually adapter family */ u32 adapter, void *pci_dev, /** Pointer to DSP code control structure */ struct dsp_code *ps_dsp_code, /** Pointer to dword to receive OS specific error code */ u32 *pos_error_code); /** Close the DSP code file */ void hpi_dsp_code_close(struct dsp_code *ps_dsp_code); /** Rewind to the beginning of the DSP code file (for verify) */ void hpi_dsp_code_rewind(struct dsp_code *ps_dsp_code); /** Read one word from the dsp code file \return 0 for success, or error code if eof, or block length exceeded */ short hpi_dsp_code_read_word(struct dsp_code *ps_dsp_code, /**< DSP code descriptor */ u32 *pword /**< Where to store the read word */ ); /** Get a block of dsp code into an internal buffer, and provide a pointer to that buffer. (If dsp code is already an array in memory, it is referenced, not copied.) \return Error if requested number of words are not available */ short hpi_dsp_code_read_block(size_t words_requested, struct dsp_code *ps_dsp_code, /* Pointer to store (Pointer to code buffer) */ u32 **ppblock); #endif |