關於基於WinCE下的聲音系統調試的一些經驗總結之驱动程式部分

 

關於基於WinCE下的聲音系統調試的一些經驗總結之驱动程式部分

分类： 工作积累-WINCE应用层 2008-12-05 17:12 1100人阅读 评论(2) 收藏 举报

/////////////////////////////////////////////////////////////
//Author:Mercury Xu
//Date:2008-12-05
//Descrption:聲音作為WinCE系統中一個比較基礎的配置大家已經都不會陌生。
//           本文主要是總結下作者在調試WM9715聲卡驅動芯片
//           過程中遇到的一些問題
//OS:WinCE5.0
/////////////////////////////////////////////////////////////
正文：

最近一直在調試關於WM9715的東東，整體調試下來感覺9715的確是個很好很強大的芯片。下面我們按照我的開發思路來整理下關於9715開發的一些心得體會。

首先我們來看下WinCE的聲音處理部分的一些基礎知識。如果您對這一部分已經爛熟於心了，請跳到下一個segment。如果您對WM971X系列爛熟於心了。。I'm sorry。看我的文实在是浪费您的时间了。

另外。大家可以参考下《Windows CE实用开发技术》之 8.10 驱动程序实例分析，這裡張老師已經將驅動的結構講的非常清晰了。大家可以參考下。張老師的書中所提及的是ES1371,我以下的文章針對芯片為WM9715.關於9715的datasheet，大家可以參考wolfson的官方站上的datasheet。

Segment I: WinCE的声音驱动部分

WinCE的声音驱动其实很清晰的给了我们大家。以samsung24X0系来说。你会在X:/WINCE500/PUBLIC/COMMON/OAK/CSP/ARM/SAMSUNG/S3C2410X/WAVEDEV类似的目录下找到他们。以下为我Tree以后他的文件结构

2. 文件夹 PATH 列表
3. 卷序列号码为 000028F4 409E:08D7
4. C:.
5. │  audiosys.h
6. │  devctxt.cpp
7. │  devctxt.h
8. │  hwctxt.cpp
9. │  hwctxt.h
10. │  i2s.cpp
11. │  i2s.h
12. │  input.cpp
13. │  makefile
14. │  midinote.cpp
15. │  midistrm.cpp
16. │  midistrm.h
17. │  mixerdrv.cpp
18. │  mixerdrv.h
19. │  output.cpp
20. │  sources
21. │  strmctxt.cpp
22. │  strmctxt.h
23. │  wavemain.cpp
24. │  wavemain.h
25. │  wavepdd.h
26. │  wfmtmidi.h
27. │ 
28. └─obj
29.     └─ARMV4I
30.         └─retail
31.                 devctxt.obj
32.                 hwctxt.obj
33.                 i2s.obj
34.                 input.obj
35.                 midinote.obj
36.                 midistrm.obj
37.                 mixerdrv.obj
38.                 output.obj
39.                 strmctxt.obj
40.                 wavemain.obj
41.                 _objects.mac

很清晰的程序结构。其实很多公司的都是参照这个结构来定制自己声音部分的程式代码。而我们需要注意的这是以下几个文件：

1. │  hwctxt.cpp
2. │  hwctxt.h
3. │  wavemain.cpp
4. │  wavemain.h

这几个基本上算是做好了对声音驱动部分的所有接口。如果您要基于WinCE5.0开发一些声音控制方面的App.第一个方法您可以对注册表的一些键值进行修改。比如说触摸屏按键音，音频音量等等。另外，你也可以通过操作以上提及到的文件中的一些接口来对声音处理芯片进行控制，已实现我们所要实现的效果。这里我只分析下我说到的几个文件。其他的例如I2S之类的大家可以看一下。（I2S是一种通讯方式，数字音频传输采用这种方式来处理，WM9715就是I2S来传送系统部分的声音。）

我们先看看HWCTXT.h文件中的一些信息，直接了解他的接口部分内容。

1. class HardwareContext
2. {
3. public:
4.     static BOOL CreateHWContext(DWORD Index);
5.     HardwareContext();
6.     ~HardwareContext();
8.     void Lock()   {EnterCriticalSection(&m_Lock);}
9.     void Unlock() {LeaveCriticalSection(&m_Lock);}
11.     DWORD GetNumInputDevices()  {return 1;}
12.     DWORD GetNumOutputDevices() {return 1;}
13.     DWORD GetNumMixerDevices()  {return 1;}
15.     DeviceContext *GetInputDeviceContext(UINT DeviceId)
16.     {
17.         return &m_InputDeviceContext;
18.     }
20.     DeviceContext *GetOutputDeviceContext(UINT DeviceId)
21.     {
22.         return &m_OutputDeviceContext;
23.     }
25.     BOOL Init(DWORD Index);                                     
26.     BOOL Deinit();
28.     void PowerUp();
29.     void PowerDown();
31.     BOOL StartInputDMA();
32.     BOOL StartOutputDMA();
34.     void StopInputDMA();
35.     void StopOutputDMA();
37.     void InterruptThread();
39.     DWORD       GetOutputGain (void);
40.     MMRESULT    SetOutputGain (DWORD dwVolume);
41.     DWORD       GetInputGain (void);
42.     MMRESULT    SetInputGain (DWORD dwVolume);
44.     BOOL        GetOutputMute (void);
45.     MMRESULT    SetOutputMute (BOOL fMute);
46.     BOOL        GetInputMute (void);
47.     MMRESULT    SetInputMute (BOOL fMute);
50. protected:
51.     DWORD m_dwOutputGain;
52.     DWORD m_dwInputGain;
53.     BOOL  m_fInputMute;
54.     BOOL  m_fOutputMute;
57.     DWORD m_MicrophoneRouting;
58.     DWORD m_SpeakerRouting;
59.     DWORD m_InternalRouting;
60.     DWORD m_MasterOutputGain;
62.     BOOL InitInterruptThread();
64.     BOOL InitInputDMA();
65.     BOOL InitOutputDMA();
66.     BOOL Codec_channel();
67.     BOOL InitCodec();
68.     
69.     BOOL MapRegisters();
70.     BOOL UnmapRegisters();
71.     BOOL MapDMABuffers();
72.     BOOL UnmapDMABuffers();
74.     ULONG TransferInputBuffer(ULONG NumBuf);
75.     ULONG TransferOutputBuffer(ULONG NumBuf);
76.     ULONG TransferInputBuffers(DWORD dwDCSR);
77.     ULONG TransferOutputBuffers(DWORD dwDCSR);
80.     DWORD GetInterruptThreadPriority();
82.     DWORD m_DriverIndex;
83.     CRITICAL_SECTION m_Lock;
85.     BOOL m_Initialized;
86.     BOOL m_InPowerHandler;
87.     DWORD m_dwSysintrOutput;
88.     DWORD m_dwSysintrInput;
90.     InputDeviceContext m_InputDeviceContext;
91.     OutputDeviceContext m_OutputDeviceContext;
93.     PBYTE       m_Input_pbDMA_PAGES[2];
94.     PBYTE       m_Output_pbDMA_PAGES[2];
96.     BOOL m_InputDMARunning;
97.     BOOL m_OutputDMARunning;
98.     ULONG m_OutBytes[2];
99.     ULONG m_InBytes[2];
101.     WORD  m_nOutputVolume;                  // Current HW Playback Volume 
102.     WORD  m_nInputVolume;                   // Current HW Input (Microphone) Volume 
104.     HANDLE m_hAudioInterrupt;               // Handle to Audio Interrupt event.
105.     HANDLE m_hAudioInterruptThread;         // Handle to thread which waits on an audio interrupt event.
107.     //----------------------- Platform specific members ----------------------------------
109.     DWORD  m_OutputDMAStatus;                   // Output DMA channel's status
110.     DWORD  m_InputDMAStatus;                    // Input DMA channel's status
112.     BOOL AudioMute(DWORD channel, BOOL bMute);  
113.     //------------------------------------------------------------------------------------
115. };
117. void CallInterruptThread(HardwareContext *pHWContext);
120. //----------------------------------- Helper Functions and Macros ----------------------------------------
122. //======== Record =========
123. #define ioRecordPointerLow                      (g_pDMAregs->DIDST1)
124. #define ioRecordPointerHigh                     (g_pDMAregs->DIDST1)
126. #define RECORD_DMA_BUFFER_PHYS                  (g_PhysDMABufferAddr.LowPart + 2 * AUDIO_DMA_PAGE_SIZE)
128. #define AUDIO_RESET_RECORD_POINTER()            {ioRecordPointerLow  = (RECORD_DMA_BUFFER_PHYS);    /
129.                                                  ioRecordPointerHigh = (RECORD_DMA_BUFFER_PHYS+ AUDIO_DMA_PAGE_SIZE); }
131. #define AUDIO_IN_CLEAR_INTERRUPTS()             (g_pDMAregs->DCON1 = g_pDMAregs->DCON1)
133. #define AUDIO_IN_DMA_ENABLE()                   {   g_pDMAregs->DMASKTRIG1 = ENABLE_DMA_CHANNEL; /
134.                                                     g_pDMAregs->DMASKTRIG1 &= STOP_DMA_TRANSFER; /
135.                                                     g_pIISregs->IISFCON |= ( RECEIVE_FIFO_ACCESS_DMA  | RECEIVE_FIFO_ENABLE);   /
136.                                                     g_pIISregs->IISCON  |= RECEIVE_DMA_REQUEST_ENABLE;   }
137.                                                     
138. #define AUDIO_IN_DMA_DISABLE()                  {   StopI2SClock(); /
139.                                                     g_pIISregs->IISCON &= ~RECEIVE_DMA_REQUEST_ENABLE;  /
140.                                                     g_pIISregs->IISFCON &= ( RECEIVE_FIFO_ACCESS_DMA  | RECEIVE_FIFO_ENABLE);   /
141.                                                     g_pDMAregs->DMASKTRIG1 |= STOP_DMA_TRANSFER;    }
143. #define SELECT_AUDIO_DMA_INPUT_BUFFER_A()       (g_pDMAregs->DIDST1 = (int)(g_PhysDMABufferAddr.LowPart+2*AUDIO_DMA_PAGE_SIZE) )
144. #define SELECT_AUDIO_DMA_INPUT_BUFFER_B()       (g_pDMAregs->DIDST1 = (int)(g_PhysDMABufferAddr.LowPart+3*AUDIO_DMA_PAGE_SIZE) )
147. //======== Playback =========
148. #define ioPlaybackPointerLow                    (g_pDMAregs->DISRC2)
149. #define ioPlaybackPointerHigh                   (g_pDMAregs->DISRC2)
151. #define AUDIO_RESET_PLAYBACK_POINTER()          {ioPlaybackPointerLow  = (g_PhysDMABufferAddr.LowPart); /
152.                                                  ioPlaybackPointerHigh = (g_PhysDMABufferAddr.LowPart + AUDIO_DMA_PAGE_SIZE); }   
154. #define AUDIO_OUT_CLEAR_INTERRUPTS()            (g_pDMAregs->DCON2 = g_pDMAregs->DCON2)
156. #define AUDIO_OUT_DMA_ENABLE()                  {   StartI2SClock(); /
157.                                                     g_pDMAregs->DMASKTRIG2 |= ENABLE_DMA_CHANNEL;  }
158.                                                     
159. #define AUDIO_OUT_DMA_DISABLE()                 { StopI2SClock();  g_pDMAregs->DMASKTRIG2 &= ~ENABLE_DMA_CHANNEL; }
161. #define SELECT_AUDIO_DMA_OUTPUT_BUFFER_A()      (g_pDMAregs->DISRC2 = (int)(g_PhysDMABufferAddr.LowPart) )
162. #define SELECT_AUDIO_DMA_OUTPUT_BUFFER_B()      (g_pDMAregs->DISRC2 = (int)(g_PhysDMABufferAddr.LowPart+AUDIO_DMA_PAGE_SIZE) )
164. //------------------------------------------ Externs ----------------------------------------------
165. extern HardwareContext *g_pHWContext;

好了，到這裡大家估計已經基本上暈了，我來給大家刪除點東西。大家就能看的非常清晰

1. class HardwareContext
2. {
3. public:
4.   
   
5. //通用接口部分
   
6. 
   
7. 
   
8. protected:
9.  
   //保护接口部分
   
10. 
    
11. 
    
12.     //----------------------- Platform specific members ----------------------------------
13. //成员
    
14.     //------------------------------------------------------------------------------------
15. 
    
16. };
17. 
    
18. void CallInterruptThread(HardwareContext *pHWContext);
19. 
    
20. 
    
21. //----------------------------------- Helper Functions and Macros ----------------------------------------
22. 
    
23. //======== Record =========
24. 
    
25. //------------------------------------------ Externs ----------------------------------------------
26. extern HardwareContext *g_pHWContext;

好了。通用接口部分我们可以自由使用，接口再wavemain.cpp中都已经给我们做好了流式驱动通用的接口。大家只要简单的了解下格式就可以很容易的去使用他。

现在，我们准备自由发挥了。在自由发挥前，我们再做个热身运动，看一看wavemain.cpp.

1. BOOL CALLBACK DllMain(HANDLE hDLL,
2.                       DWORD dwReason,
3.                       LPVOID lpvReserved)
4. {
5.     switch (dwReason) {
6.         case DLL_PROCESS_ATTACH :
7.             DEBUGREGISTER((HINSTANCE)hDLL);
8.             DisableThreadLibraryCalls((HMODULE) hDLL);
9.             break;
11.         case DLL_PROCESS_DETACH :
12.             break;
14.         case DLL_THREAD_DETACH :
15.             break;
17.         case DLL_THREAD_ATTACH :
18.             break;
20.         default :
21.             break;
22.     }
23.     return TRUE;
24. }
27. // -----------------------------------------------------------------------------
28. //
29. // @doc     WDEV_EXT
30. //
31. // @topic   WAV Device Interface | Implements the WAVEDEV.DLL device
32. //          interface. These functions are required for the device to
33. //          be loaded by DEVICE.EXE.
34. //
35. // @xref                          <nl>
36. //          <f WAV_Init>,         <nl>
37. //          <f WAV_Deinit>,       <nl>
38. //          <f WAV_Open>,         <nl>
39. //          <f WAV_Close>,        <nl>
40. //          <f WAV_Read>,         <nl>
41. //          <f WAV_Write>,        <nl>
42. //          <f WAV_Seek>,         <nl>
43. //          <f WAV_PowerUp>,      <nl>
44. //          <f WAV_PowerDown>,    <nl>
45. //          <f WAV_IOControl>     <nl>
46. //
47. // -----------------------------------------------------------------------------
48. //
49. // @doc     WDEV_EXT
50. //
51. ---------
52. extern "C" DWORD WAV_Init(DWORD Index)
53. {
54.     return((DWORD)HardwareContext::CreateHWContext(Index));
55. }
57. 
    
58. extern "C" BOOL WAV_Deinit(DWORD dwData)
59. {
60.     return(g_pHWContext->Deinit());
61. }
63. 
    
64. extern "C" PDWORD WAV_Open( DWORD dwData,
65.               DWORD dwAccess,
66.               DWORD dwShareMode)
67. {
68.     // allocate and return handle context to efficiently verify caller trust level
69.     return new DWORD(NULL); // assume untrusted. Can't tell for sure until WAV_IoControl
70. }
72. 
    
73. extern "C" BOOL WAV_Close(PDWORD pdwData)
74. {
75.     // we trust the device manager to give us a valid context to free.
76.     delete pdwData;
77.     return(TRUE);
78. }
80. 
    
81. extern "C" DWORD WAV_Read(DWORD dwData,
82.                LPVOID pBuf,
83.                DWORD Len)
84. {
85.     // Return length read
86.     return(0);
87. }
89. 
    
90. extern "C" DWORD WAV_Write(DWORD dwData,
91.                 LPCVOID pBuf,
92.                 DWORD Len)
93. {
94.     // return number of bytes written (or -1 for error)
95.     return(0);
96. }
98. 
    
99. extern "C" DWORD WAV_Seek(DWORD dwData,
100.                long pos,
101.                DWORD type)
102. {
103.     // return an error
104.     return((DWORD)-1);
105. }
107. 
     
108. extern "C" VOID WAV_PowerUp(VOID)
109. {
110.     g_pHWContext->PowerUp();
111.     return;
112. }
114. 
     
115. extern "C" VOID WAV_PowerDown(VOID)
116. {
117.     g_pHWContext->PowerDown();
118.     return;
119. }
122. BOOL HandleWaveMessage(PMMDRV_MESSAGE_PARAMS pParams, DWORD *pdwResult)
123. {
124.     //  set the error code to be no error first
125.     SetLastError(MMSYSERR_NOERROR);
127.     UINT uMsg = pParams->uMsg;
128.     UINT uDeviceId = pParams->uDeviceId;
129.     DWORD dwParam1 = pParams->dwParam1;
130.     DWORD dwParam2 = pParams->dwParam2;
131.     DWORD dwUser   = pParams->dwUser;
132.     StreamContext *pStreamContext = (StreamContext *)dwUser;
134.     DWORD dwRet;
136.     g_pHWContext->Lock();
137.     switch (uMsg)
138.     {
139.         //很多个CASE,我们就省略掉了，大家自己看看找到自己要用的           
     
140.         default:
141.         dwRet  = MMSYSERR_NOTSUPPORTED;
142.     }
143.     g_pHWContext->Unlock();
145.     // Pass the return code back via pBufOut
146.     //这个地方的处理很奇妙哦。很好的方法。
     
147.     if (pdwResult)
148.     {
149.         *pdwResult = dwRet;
150.     }
152.     return(TRUE);
153. }
155. 
     
156. extern "C" BOOL WAV_IOControl(PDWORD  pdwOpenData,
157.                    DWORD  dwCode,
158.                    PBYTE  pBufIn,
159.                    DWORD  dwLenIn,
160.                    PBYTE  pBufOut,
161.                    DWORD  dwLenOut,
162.                    PDWORD pdwActualOut)
163. {
165.     // check caller trust. if context hasn't been initialized, load from CeGetCallerTrust.
166.     if (*pdwOpenData != OEM_CERTIFY_TRUST) {
167.         if (OEM_CERTIFY_TRUST != (*pdwOpenData = CeGetCallerTrust())) {
168.             PRINTMSG(ZONE_WARN, (TEXT("WAV_IoControl: untrusted process/r/n")));
169.             SetLastError(ERROR_ACCESS_DENIED);
170.             return FALSE;
171.         }
172.     }
173. //以下为无敌的出错处理部分，非常指的我们学习的。
     
175.     _try
176.     {
177.         switch (dwCode)
178.         {
179.         case IOCTL_MIX_MESSAGE:
180.                         return HandleMixerMessage((PMMDRV_MESSAGE_PARAMS)pBufIn, (DWORD *)pBufOut);
182.         case IOCTL_WAV_MESSAGE:
183.             return HandleWaveMessage((PMMDRV_MESSAGE_PARAMS)pBufIn, (DWORD *)pBufOut);
184.         }
186.     }
187.     _except (GetExceptionCode() == STATUS_ACCESS_VIOLATION ? EXCEPTION_EXECUTE_HANDLER : EXCEPTION_CONTINUE_SEARCH)
188.     {
189.         RETAILMSG(1, (TEXT("EXCEPTION IN WAV_IOControl!!!!/r/n")));
190.         SetLastError(E_FAIL);
191.     }

以上的部分就是我们做APP程序最终的接口部分了。我们会用到 WAV_IOControl作为最后的app调用的入口来对那些看的眼花缭乱的case进行调用操作。关于CASE和case所对应的函数就是针对不同的芯片处理的不同功能，针对不同的芯片有不同的处理函数实现，这个需要大家静下心来仔细阅读芯片的datasheet了。

下一篇我们就来一起看看WM9715这个传说中的芯片。很牛X的。