afw.h

説明を見る。

/** \file afw.h
 *  \brief フレームワーク宣言ファイル
 *  \author アナログ・デバイセズ株式会社
 *  \version 1.0
 *  \date    2006.Sep.8
 *
 * 各種パラメータの宣言ファイル。パラメータのうち、afw::SAMPLE_PER_INTRはユーザーが変更して
 * もよい。メインルーチンからはafw::initとafw::startAudioを呼び出してオーディオ処理を開始する。
 */
#pragma once

/** オーディオ・フレームワーク
*
* ADSP-BF537 EZ-KIT Lite上で動作するオーディオフレームワーク関連の関数および変数を含む名前空間。
* プログラマは以下の関数を呼んでオーディオ処理を開始する。
* - afw::init
* - afw::startAudio
*/
//--------------------------------------------------------------------------//
// Header files                                                             //
//--------------------------------------------------------------------------//
//#include <sys\exception.h>
#include <signal.h>
#include <cdefBF537.h>
#include <shortfract>

namespace afw{

    //--------------------------------------------------------------------------//
    // Symbolic constants                                                       //
    //--------------------------------------------------------------------------//
    /** 左チャンネル指定定数
      *
      * audioRxBufferおよび、audioTxBufferにアクセスする際、最下位の添え字を指定
      * するときに使う。
      *
      */
    const int LEFT_CH = 0;
    /** 右チャンネル指定定数
      *
      * audioRxBufferおよび、audioTxBufferにアクセスする際、最下位の添え字を指定
      * するときに使う。
      *
      */
    const int RIGHT_CH = 1;

    /** バッファ数宣言定数
      *
      * DMA用のバッファ領域を格納する際に、割り込みいくつ分のバッファを用意するかを宣言する。
      * 具体的にいえば、トリプルバッファなので3を宣言する。過去3回の割り込み分のデータをバッファに
      * 格納できるということである。
      *
      */
    const int INTR_PER_BUFFER  = 3; // 変更してはならない。トリプルバッファのために3つの領域を確保

    /** サンプルあたりチャンネル数の宣言
      *
      * サンプルあたり何チャンネルのデータを伝送するか宣言する。I2Sはステレオなので、この値は2である。
      * この値はユーザーが変更してはならない。
      *
      */
    const int CH_PER_SAMPLE  = 2;   // 変更してはならない。I2Sはサンプルあたり2チャンネルのデータを持つ

    /** 割り込みあたりのサンプル数
      *
      * 何サンプルのデータを受信したら割り込みをかけるかを指定する。この値を大きくするほど
      * 効率がよくなるが、遅延も増大し、また、必要なメモリ量も増える。したがって、これらの
      * バランスを考えながらユーザーが値を決めることになる。
      */
    const int SAMPLE_PER_INTR = 8;  // 変更可能。何サンプルごとに割り込みをかけるか指定する。

    /** オーディオ・コーデックのリセット時間
      *
      * EZ-KIT Lite BF537では、オーディオ・コーデックのリセット信号がADSP-BF537のPF12に
      * 接続されている。コーデックの使用に先立って、この信号をアサートしなければならない。
      *
      * このマクロは、リセット信号をアサートする時間を与える。時間はループの繰り返し
      * 回数なので、あまり精度は高くない。注意深い値が必要である。
      */
    const int CODEC_RESET_PULS_WIDTH  = 0x10000;

    /** SPORT0のワード長
      *
      * SPORT0設定時に使うワード長である。EZ-KIT BF537に搭載されているコーデックは
      * I2S回線のデータを24bit使うので、ここでは24を用意している。
      */
    const int SPORT0_SLEN_24 = 0x0017;


    //--------------------------------------------------------------------------//
    // 大域変数                                                                 //
    //--------------------------------------------------------------------------//

    /** SPORT0 DMA 送信バッファ
      *
      * DMAが利用するバッファ。トリプル・バッファ構成をとるので、
      * 3D配列の最上位の添え字は、そのバッファ切り替えに使う。2番めの添え字は
      * 割り込み内のサンプル位置、3番目の添え字はサンプル内のチャンネル位置を
      * 与える。
      */
    extern volatile int txBuffer[][SAMPLE_PER_INTR][CH_PER_SAMPLE];
    /** SPORT0 DMA 受信バッファ
      *
      * DMAが利用するバッファ。トリプル・バッファ構成をとるので、
      * 3D配列の最上位の添え字は、そのバッファ切り替えに使う。2番めの添え字は
      * 割り込み内のサンプル位置、3番目の添え字はサンプル内のチャンネル位置を
      * 与える。
      */
    extern volatile int rxBuffer[][SAMPLE_PER_INTR][CH_PER_SAMPLE];

    //--------------------------------------------------------------------------//
    // 関数プロトタイプ                                                         //
    //--------------------------------------------------------------------------//

    void init(void);
    void startAudio(void);

    void rxISR( int signal );

        // processdata.cpp
    void initProcessData();
    void processData( 
                     const shortfract leftIn[], 
                     const shortfract rightIn[], 
                     shortfract leftOut[], 
                     shortfract rightOut[],
                     int count
                    );
};

---