seiichi horie / unzen_lpcxpresso_4337

First Publish. Works fine.

Dependents:   unzen_sample_lpcxpresso_4337_callbacks

unzen.h@1:9710fb328a08, 2016-04-12 (annotated)

Committer:
shorie
Date:
Tue Apr 12 05:51:45 2016 +0000
Revision:
1:9710fb328a08
Parent:
0:5ac19c994288
Child:
2:6613e62da521
added umb-adau1361 support

Who changed what in which revision?

UserRevisionLine numberNew contents of line
shorie 0:5ac19c994288 1 /**
shorie 0:5ac19c994288 2 * \brief header file for the unzen audio frame work
shorie 0:5ac19c994288 3 * \arthur SeiichiHorie
shorie 0:5ac19c994288 4 * \date 6/Apr/2016
shorie 0:5ac19c994288 5 */
shorie 0:5ac19c994288 6
shorie 0:5ac19c994288 7 #ifndef _unzen_h_
shorie 0:5ac19c994288 8 #define _unzen_h_
shorie 0:5ac19c994288 9
shorie 0:5ac19c994288 10 #include "mbed.h"
shorie 0:5ac19c994288 11 /**
shorie 0:5ac19c994288 12 \brief audio framework name space.
shorie 0:5ac19c994288 13 */
shorie 0:5ac19c994288 14 namespace unzen
shorie 0:5ac19c994288 15 {
shorie 0:5ac19c994288 16 /**
shorie 0:5ac19c994288 17 \brief error status type.
shorie 0:5ac19c994288 18 */
shorie 0:5ac19c994288 19 enum error_type {
shorie 0:5ac19c994288 20 no_error,
shorie 0:5ac19c994288 21 memory_allocation_error
shorie 0:5ac19c994288 22 };
shorie 0:5ac19c994288 23
shorie 0:5ac19c994288 24 /**
shorie 0:5ac19c994288 25 \brief singleton style audio frame work. Create a object and execute the \ref framework::start() method.
shorie 0:5ac19c994288 26 */
shorie 0:5ac19c994288 27 class framework
shorie 0:5ac19c994288 28 {
shorie 0:5ac19c994288 29 private:
shorie 0:5ac19c994288 30 /**
shorie 0:5ac19c994288 31 \constructor
shorie 0:5ac19c994288 32 \details
shorie 0:5ac19c994288 33 initialize the internal variables and set up all interrrupt / I2S related peripheral.
shorie 0:5ac19c994288 34 If needed, power up the peripheral, assign the clock and pins.
shorie 0:5ac19c994288 35 At the end of this constructor, the audio framework is ready to run, but still paused.
shorie 0:5ac19c994288 36 To start the real processing, call the \ref start method.
shorie 0:5ac19c994288 37
shorie 0:5ac19c994288 38 Note that this constructor set the block size ( interval count which audio processing
shorie 0:5ac19c994288 39 call back is called )
shorie 0:5ac19c994288 40 as 1. If it is needed to use other value, call \ref set_brock_size() method.
shorie 0:5ac19c994288 41 */
shorie 0:5ac19c994288 42 framework(void);
shorie 0:5ac19c994288 43 public:
shorie 0:5ac19c994288 44 /**
shorie 0:5ac19c994288 45 \brief getting the singleton object for processing.
shorie 0:5ac19c994288 46 \returns a framework type object.
shorie 0:5ac19c994288 47 \details
shorie 0:5ac19c994288 48 TO call the object method, use this method to retrieve the singleton object.
shorie 0:5ac19c994288 49 */
shorie 1:9710fb328a08 50 static framework * get() { static framework singleton; return &singleton ; }
shorie 0:5ac19c994288 51
shorie 0:5ac19c994288 52 /**
shorie 0:5ac19c994288 53 \brief set the interval interrupt count for each time call back is called.
shorie 0:5ac19c994288 54 \param block_size An integer parameter > 1. If set to n, for each n interrupts, the audio call back is called.
shorie 0:5ac19c994288 55 \returns show the error status
shorie 0:5ac19c994288 56 \details
shorie 0:5ac19c994288 57 This method re-allocate the internal buffer. Then, the memory allocation error could occur. To detect the
shorie 0:5ac19c994288 58 memory allocation error, use \ref get_error() method.
shorie 0:5ac19c994288 59 */
shorie 0:5ac19c994288 60 error_type set_block_size( unsigned int new_block_size );
shorie 0:5ac19c994288 61
shorie 0:5ac19c994288 62 /**
shorie 0:5ac19c994288 63 \brief the real audio signal transfer. Trigger the I2S interrupt and call the call back.
shorie 0:5ac19c994288 64 */
shorie 0:5ac19c994288 65 void start(void);
shorie 0:5ac19c994288 66
shorie 0:5ac19c994288 67 /**
shorie 0:5ac19c994288 68 \brief Set the user call back for audio processing.
shorie 0:5ac19c994288 69 \param cb The call back function
shorie 0:5ac19c994288 70 \details
shorie 0:5ac19c994288 71 Set the call back function. This function is called for each time the rx buffer is filled. The call back has 5 parameters.
shorie 0:5ac19c994288 72 \li left_rx Received data from I2S rx port. Left data only.
shorie 0:5ac19c994288 73 \li right_rx Received data from I2S rx port. Right data only.
shorie 0:5ac19c994288 74 \li left_tx Buffer to fill the transmission data. This buffer mus be filled by call back. Left data only
shorie 0:5ac19c994288 75 \li right_tx Buffer to fill the transmission data. This buffer mus be filled by call back. Right data only
shorie 0:5ac19c994288 76 \li length length of above buffers.
shorie 0:5ac19c994288 77
shorie 0:5ac19c994288 78 The call back is called for each time interrupt comes n times. Where n is the value which is specified by \ref set_block_size()
shorie 0:5ac19c994288 79 function. This n is also passed to call back as above length parameter.
shorie 0:5ac19c994288 80
shorie 0:5ac19c994288 81 Note that the call back is called at interrupt context. Not the thread level context.
shorie 0:5ac19c994288 82 That mean, it is better to avoid to call mbed API except the mbed-RTOS API for interrupt handler.
shorie 0:5ac19c994288 83 */
shorie 0:5ac19c994288 84 void set_process_callback( void (* cb ) (float[], float[], float[], float[], unsigned int));
shorie 0:5ac19c994288 85
shorie 0:5ac19c994288 86 /**
shorie 0:5ac19c994288 87 \brief Debug hook for interrupt handler.
shorie 0:5ac19c994288 88 \param cb A call back which is called at the beggining of I2S interrupt.
shorie 0:5ac19c994288 89 \details
shorie 0:5ac19c994288 90 Parameter cb is call at the beggining of the I2S interrupt. This call back can be
shorie 0:5ac19c994288 91 used to mesure the timing of interrupt by toggling the GPIO pin.
shorie 0:5ac19c994288 92
shorie 0:5ac19c994288 93 Passing 0 to cb parameter let the framwork ignore the callback.
shorie 0:5ac19c994288 94 */
shorie 0:5ac19c994288 95 void set_pre_interrupt_callback( void (* cb ) (void));
shorie 0:5ac19c994288 96
shorie 0:5ac19c994288 97 /**
shorie 0:5ac19c994288 98 \brief Debug hook for interrupt handler.
shorie 0:5ac19c994288 99 \param cb A call back which is called at the end of I2S interrupt.
shorie 0:5ac19c994288 100 \details
shorie 0:5ac19c994288 101 Parameter cb is call at the end of the I2S interrupt. This call back can be
shorie 0:5ac19c994288 102 used to mesure the timing of interrupt by toggling the GPIO pin.
shorie 0:5ac19c994288 103
shorie 0:5ac19c994288 104 Passing 0 to cb parameter let the framwork ignore the callback.
shorie 0:5ac19c994288 105 */
shorie 0:5ac19c994288 106 void set_post_interrupt_callback( void (* cb ) (void));
shorie 0:5ac19c994288 107
shorie 0:5ac19c994288 108 /**
shorie 0:5ac19c994288 109 \brief Debug hook for processing handler.
shorie 0:5ac19c994288 110 \param cb A call back which is called at the beggining of processing.
shorie 0:5ac19c994288 111 \details
shorie 0:5ac19c994288 112 Parameter cb is call at the beggining of the signal processing. This call back can be
shorie 0:5ac19c994288 113 used to mesure the load of CPU by toggling the GPIO pin.
shorie 0:5ac19c994288 114
shorie 0:5ac19c994288 115 Passing 0 to cb parameter let the framwork ignore the callback.
shorie 0:5ac19c994288 116 */
shorie 0:5ac19c994288 117 void set_pre_process_callback( void (* cb ) (void));
shorie 0:5ac19c994288 118
shorie 0:5ac19c994288 119 /**
shorie 0:5ac19c994288 120 \brief Debug hook for processing handler.
shorie 0:5ac19c994288 121 \param cb A call back which is called at the end of processing.
shorie 0:5ac19c994288 122 \details
shorie 0:5ac19c994288 123 Parameter cb is call at the end of the signal processing. This call back can be
shorie 0:5ac19c994288 124 used to mesure the load of CPU by toggling the GPIO pin.
shorie 0:5ac19c994288 125
shorie 0:5ac19c994288 126 Passing 0 to cb parameter let the framwork ignore the callback.
shorie 0:5ac19c994288 127 */
shorie 0:5ac19c994288 128 void set_post_process_callback( void (* cb ) (void));
shorie 0:5ac19c994288 129
shorie 0:5ac19c994288 130 /**
shorie 0:5ac19c994288 131 \brief optional priority control for I2S IRQ.
shorie 0:5ac19c994288 132 \param pri Priority of IRQ.
shorie 0:5ac19c994288 133 \details
shorie 0:5ac19c994288 134 This is optional control. Usually, user doesn't need to call this method.
shorie 0:5ac19c994288 135 In case the framework has serious irq priority contention with other software,
shorie 0:5ac19c994288 136 this API help programmer to change the priority of the Unzen framework.
shorie 0:5ac19c994288 137
shorie 0:5ac19c994288 138 Value must be acceptable to CMSIS NVIC_SetPriority(). For LPC4337, it is range of 0..7. The 0 is highest priority.
shorie 0:5ac19c994288 139
shorie 0:5ac19c994288 140
shorie 0:5ac19c994288 141 By default, the framework set this priority as +2 higher than the lowest.
shorie 0:5ac19c994288 142
shorie 0:5ac19c994288 143 The priority set by this API must be higher than priority set by \ref set_process_irq_priority
shorie 0:5ac19c994288 144 */
shorie 0:5ac19c994288 145 void set_i2s_irq_priority( unsigned int pri );
shorie 0:5ac19c994288 146
shorie 0:5ac19c994288 147 /**
shorie 0:5ac19c994288 148 \brief optional priority control for Signal Processing IRQ.
shorie 0:5ac19c994288 149 \param pri Priority of IRQ.
shorie 0:5ac19c994288 150 \details
shorie 0:5ac19c994288 151 This is optional control. Usually, user doesn't need to call this method.
shorie 0:5ac19c994288 152 In case the framework has serious irq priority contention with other software,
shorie 0:5ac19c994288 153 this API help programmer to change the priority of the Unzen framework
shorie 0:5ac19c994288 154
shorie 0:5ac19c994288 155 Value must be acceptable to CMSIS NVIC_SetPriority(). For LPC4337, it is range of 0..7. The 0 is highest priority.
shorie 0:5ac19c994288 156
shorie 0:5ac19c994288 157 By default, the framework set this priority as +2 higher than the lowest.
shorie 0:5ac19c994288 158
shorie 0:5ac19c994288 159 */
shorie 0:5ac19c994288 160 void set_process_irq_priority( unsigned int pri );
shorie 0:5ac19c994288 161
shorie 0:5ac19c994288 162 private:
shorie 0:5ac19c994288 163 void (* pre_interrupt_callback )(void);
shorie 0:5ac19c994288 164 void (* post_interrupt_callback )(void);
shorie 0:5ac19c994288 165 void (* pre_process_callback )(void);
shorie 0:5ac19c994288 166 void (* post_process_callback )(void);
shorie 0:5ac19c994288 167
shorie 0:5ac19c994288 168 void (* process_callback )( float left_in[], float right_in[], float left_out[], float right_out[], unsigned int length );
shorie 0:5ac19c994288 169
shorie 0:5ac19c994288 170 // Size of the blocks ( interval of interrupt to call process_callback )
shorie 0:5ac19c994288 171 int block_size;
shorie 0:5ac19c994288 172
shorie 0:5ac19c994288 173 // Index for indentifying the buffer. 0 or 1.
shorie 0:5ac19c994288 174 int buffer_index, process_index;
shorie 0:5ac19c994288 175
shorie 0:5ac19c994288 176 // Index of the position data in the buffer.
shorie 0:5ac19c994288 177 int tx_sample_index, rx_sample_index;
shorie 0:5ac19c994288 178
shorie 0:5ac19c994288 179 // buffer for interrupt handler.
shorie 0:5ac19c994288 180 // data format is LRLR...
shorie 0:5ac19c994288 181 int *tx_int_buffer[2];
shorie 0:5ac19c994288 182 int *rx_int_buffer[2];
shorie 0:5ac19c994288 183
shorie 0:5ac19c994288 184 // buffers for passing
shorie 0:5ac19c994288 185 float * tx_left_buffer, * tx_right_buffer;
shorie 0:5ac19c994288 186 float * rx_left_buffer, * rx_right_buffer;
shorie 0:5ac19c994288 187
shorie 0:5ac19c994288 188 // real processing method.
shorie 0:5ac19c994288 189 void do_i2s_irq(void);
shorie 0:5ac19c994288 190 void do_process_irq(void);
shorie 0:5ac19c994288 191
shorie 0:5ac19c994288 192 // handler for NIVC
shorie 0:5ac19c994288 193 static void i2s_irq_handler();
shorie 0:5ac19c994288 194 static void process_irq_handler();
shorie 0:5ac19c994288 195 };
shorie 1:9710fb328a08 196
shorie 1:9710fb328a08 197 class umb_adau1361
shorie 1:9710fb328a08 198 {
shorie 1:9710fb328a08 199 public:
shorie 1:9710fb328a08 200 umb_adau1361( I2C * );
shorie 1:9710fb328a08 201 void start(void);
shorie 1:9710fb328a08 202 private:
shorie 1:9710fb328a08 203 I2C *i2c;
shorie 1:9710fb328a08 204 };
shorie 1:9710fb328a08 205
shorie 0:5ac19c994288 206 }
shorie 0:5ac19c994288 207
shorie 0:5ac19c994288 208 #endif