PDMCC26XX.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015-2016, Texas Instruments Incorporated
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * *  Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * *  Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * *  Neither the name of Texas Instruments Incorporated nor the names of
 *    its contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
#ifndef ti_drivers_pdm_PDMCC26XX__include
#define ti_drivers_pdm_PDMCC26XX__include

#ifdef __cplusplus
extern "C" {
#endif

#define ti_sysbios_family_arm_m3_Hwi__nolocalnames

#include <ti/sysbios/knl/Semaphore.h>
#include <ti/drivers/PIN.h>
#include <ti/sysbios/family/arm/m3/Hwi.h>
#include <ti/drivers/Power.h>
#include <ti/drivers/power/PowerCC26XX.h>

/*********************************************************************
 * CONSTANTS
 */
#define PDM_TASK_STACK_SIZE             500

#define PDM_NUM_OF_CHANNELS             2

#define PDM_BLOCK_SIZE_IN_SAMPLES       64

#define PDM_BUFFER_SIZE_IN_BLOCKS       3

#define PCM_COMPRESSION_RATE            4

#define PCM_METADATA_SIZE               4

#define PDM_SAMPLE_SIZE                 16 // 24

#define PCM_SAMPLE_SIZE                 16 // Only 16 bits supported for now

#define PDM_NUMBER_OF_PINS              1       // Only one pin to control microphone power

/* Events */
#define PDM_EVT_BLK_RDY                 Event_Id_00

#define PDM_EVT_START                   Event_Id_01

#define PDM_EVT_BLK_ERROR               Event_Id_02

#define PDM_EVT_CLOSE                   Event_Id_03

#define PDM_DECIMATION_STARTUP_DELAY_IN_SAMPLES 32

/* PDM rollback vector bit masks. Each bit mask corresponds to an action that PDMCC26XX_rollbackDriverInitialisation() commits */
#define PDM_ROLLBACK_OPEN                   1 << 0

#define PDM_ROLLBACK_ACTIVE_PCM_BUFFER      1 << 1

#define PDM_ROLLBACK_I2S_DRIVER             1 << 2

#define PDM_ROLLBACK_PIN                    1 << 3



#define PDMCC26XX_COMPR_ITER_OUTPUT_SIZE 16

#define PDMCC26XX_CPY_ITER_OUTPUT_SIZE   64
/*********************************************************************
 * MACROS
 */

/*********************************************************************
 * TYPEDEFS
*/
#if (defined PDM_SAMPLE_SIZE) && (PDM_SAMPLE_SIZE == 24)
typedef __packed struct {
    uint8_t pdmSampleLsb;
    uint16_t pdmSampleMsb;
} pdmSample_t;
#elif (defined PDM_SAMPLE_SIZE) && (PDM_SAMPLE_SIZE == 16)
typedef uint16_t pdmSample_t;
#else
#error Unsupported PDM samples size (16 or 24)
#endif

#if (defined PCM_SAMPLE_SIZE) && (PCM_SAMPLE_SIZE == 16)
typedef int16_t pcmSample_t;
#else
#error Unsupported PCM samples size (16)
#endif

typedef struct {
    uint8_t seqNum;     
    int8_t si;          
    int16_t pv;         
} PDMCC26XX_metaData;

typedef struct {
    PDMCC26XX_metaData metaData;    
    uint8_t pBuffer[];              
} PDMCC26XX_pcmBuffer;

typedef void *(*PDMCC26XX_MallocFxn)(size_t memSize);

typedef void (*PDMCC26XX_FreeFxn)(void *ptr, size_t memSize);

typedef struct PDMCC26XX_Config {
    void                        *object;

    void                const   *hwAttrs;
} PDMCC26XX_Config;

extern const PDMCC26XX_Config PDMCC26XX_config[];

typedef struct PDMCC26XX_HWAttrs {
    PIN_Id           micPower;
    int              taskPriority;
} PDMCC26XX_HWAttrs;

typedef struct PDMCC26XX_Config *PDMCC26XX_Handle;

typedef enum PDMCC26XX_Status {
    PDMCC26XX_STREAM_IDLE,              
    PDMCC26XX_STREAM_BLOCK_READY,       
    PDMCC26XX_STREAM_BLOCK_READY_BUT_PDM_OVERFLOW,      
    PDMCC26XX_STREAM_ERROR,             
    PDMCC26XX_STREAM_STOPPING,          
    PDMCC26XX_STREAM_STOPPED,           
    PDMCC26XX_STREAM_FAILED_TO_STOP     
} PDMCC26XX_Status;

typedef enum PDMCC26XX_Gain {
    PDMCC26XX_GAIN_24,  
    PDMCC26XX_GAIN_18,  
    PDMCC26XX_GAIN_12,  
    PDMCC26XX_GAIN_6,   
    PDMCC26XX_GAIN_0,   
    PDMCC26XX_GAIN_END  
} PDMCC26XX_Gain;

typedef struct PDMCC26XX_StreamNotification {
    void      *arg;             
    PDMCC26XX_Status status;    
} PDMCC26XX_StreamNotification;

typedef void (*PDMCC26XX_CallbackFxn) (PDMCC26XX_Handle handle, PDMCC26XX_StreamNotification *streamNotification);

typedef struct PDMCC26XX_BufferRequest {
    PDMCC26XX_pcmBuffer      *buffer;           
    PDMCC26XX_Status status;                    
} PDMCC26XX_BufferRequest;

typedef struct PDMCC26XX_Params {
    /* PDM control variables */
    PDMCC26XX_CallbackFxn callbackFxn;            
    bool                  useDefaultFilter;       
    int32_t               *decimationFilter;      
    PDMCC26XX_Gain        micGain;                
    bool                  micPowerActiveHigh;     
    bool                  applyCompression;       
    uint32_t              startupDelayWithClockInSamples; 
    uint16_t              retBufSizeInBytes;      
    PDMCC26XX_MallocFxn   mallocFxn;              
    PDMCC26XX_FreeFxn     freeFxn;                
    uintptr_t             custom;                 
} PDMCC26XX_Params;

typedef struct PDMCC26XX_Object {
    /* PDM control variables */
    PDMCC26XX_CallbackFxn           callbackFxn;            
    bool                            useDefaultFilter;       
    int32_t                         *decimationFilter;      
    PDMCC26XX_Gain                  micGain;                
    bool                            micPowerActiveHigh;     
    bool                            applyCompression;       
    uint32_t                        startupDelayWithClockInSamples; 
    uint16_t                        retBufSizeInBytes;      
    PDMCC26XX_MallocFxn             mallocFxn;              
    PDMCC26XX_FreeFxn               freeFxn;                
    PDMCC26XX_StreamNotification    *streamNotification;   
    bool                            bStreamStarted;         
    /* PDM SYS/BIOS objects */
    ti_sysbios_family_arm_m3_Hwi_Struct hwi;            
    Semaphore_Struct                blockComplete;          
    /* PIN driver state object and handle */
    PIN_State                       pinState;               
    PIN_Handle                      pinHandle;              
    bool                            isOpen;                 
} PDMCC26XX_Object;

extern void PDMCC26XX_init(PDMCC26XX_Handle handle);

extern PDMCC26XX_Handle  PDMCC26XX_open(PDMCC26XX_Params *params);

extern void PDMCC26XX_close(PDMCC26XX_Handle handle);

extern bool PDMCC26XX_startStream(PDMCC26XX_Handle handle);

extern bool PDMCC26XX_stopStream(PDMCC26XX_Handle handle);

extern bool PDMCC26XX_requestBuffer(PDMCC26XX_Handle handle, PDMCC26XX_BufferRequest *bufferRequest);


/* Do not interfere with the app if they include the family Hwi module */
#undef ti_sysbios_family_arm_m3_Hwi__nolocalnames

#ifdef __cplusplus
}
#endif

#endif /* ti_drivers_pdm_PDMCC26XX__include */