Christian Schmiljun / VS1053b

Library for VLSI VS1053b - Ogg Vorbis / MP3 / AAC / WMA / FLAC / MIDI Audio Codec Chip for a complete sample see Lib_VS1053b

Dependents:   Lab3_1 RTOS-VS1053b-mp3_semaphore RTOS-VS1053b-mp3_v01

VS1053.h@5:ead95c0f7800, 2010-12-25 (annotated)

Committer:
christi_s
Date:
Sat Dec 25 00:29:04 2010 +0000
Revision:
5:ead95c0f7800
Parent:
4:cacb5e663fa9
Child:
6:eed008905159
add doxygen documentation

remove obsolete functions

Who changed what in which revision?

UserRevisionLine numberNew contents of line
christi_s 1:ced2c297cc1b 1 /* mbed VLSI VS1053b library
christi_s 1:ced2c297cc1b 2 * Copyright (c) 2010 Christian Schmiljun
christi_s 1:ced2c297cc1b 3 *
christi_s 1:ced2c297cc1b 4 * Permission is hereby granted, free of charge, to any person obtaining a copy
christi_s 1:ced2c297cc1b 5 * of this software and associated documentation files (the "Software"), to deal
christi_s 1:ced2c297cc1b 6 * in the Software without restriction, including without limitation the rights
christi_s 1:ced2c297cc1b 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
christi_s 1:ced2c297cc1b 8 * copies of the Software, and to permit persons to whom the Software is
christi_s 1:ced2c297cc1b 9 * furnished to do so, subject to the following conditions:
christi_s 1:ced2c297cc1b 10 *
christi_s 1:ced2c297cc1b 11 * The above copyright notice and this permission notice shall be included in
christi_s 1:ced2c297cc1b 12 * all copies or substantial portions of the Software.
christi_s 1:ced2c297cc1b 13 *
christi_s 1:ced2c297cc1b 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
christi_s 1:ced2c297cc1b 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
christi_s 1:ced2c297cc1b 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
christi_s 1:ced2c297cc1b 17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
christi_s 1:ced2c297cc1b 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
christi_s 1:ced2c297cc1b 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
christi_s 1:ced2c297cc1b 20 * THE SOFTWARE.
christi_s 1:ced2c297cc1b 21 */
christi_s 1:ced2c297cc1b 22
christi_s 1:ced2c297cc1b 23 /* This code based on:
christi_s 1:ced2c297cc1b 24 * mbeduino_MP3_Shield_MP3Player
christi_s 1:ced2c297cc1b 25 * http://mbed.org/users/xshige/programs/mbeduino_MP3_Shield_MP3Player/lgcx63
christi_s 1:ced2c297cc1b 26 * 2010-10-16
christi_s 1:ced2c297cc1b 27 */
christi_s 1:ced2c297cc1b 28
christi_s 2:5bab956cb59e 29 #ifndef _VS1053_H
christi_s 2:5bab956cb59e 30 #define _VS1053_H
christi_s 1:ced2c297cc1b 31
christi_s 0:7728d9c6c487 32 // ----------------------------------------------------------------------------
christi_s 0:7728d9c6c487 33 // Extended settings
christi_s 0:7728d9c6c487 34 // ----------------------------------------------------------------------------
christi_s 1:ced2c297cc1b 35 // Enable debug output (Output -> printf ...)
christi_s 1:ced2c297cc1b 36 // --------------------------------------------------------------------------
christi_s 2:5bab956cb59e 37 // #define DEBUG
christi_s 2:5bab956cb59e 38 // #define DEBUGOUT (x,y...) printf(x, ##y);
christi_s 0:7728d9c6c487 39 // Patches, Addons
christi_s 0:7728d9c6c487 40 // --------------------------------------------------------------------------
christi_s 2:5bab956cb59e 41 // #define VS1053_PATCH_1_4_FLAC
christi_s 2:5bab956cb59e 42 // #define VS1053_PATCH_1_5
christi_s 2:5bab956cb59e 43 // #define VS1053_PATCH_1_5_FLAC
christi_s 2:5bab956cb59e 44 // #define VS1053_SPECANA
christi_s 2:5bab956cb59e 45 // #define VS1053B_PCM_RECORDER_0_9
christi_s 0:7728d9c6c487 46 // ----------------------------------------------------------------------------
christi_s 0:7728d9c6c487 47
christi_s 2:5bab956cb59e 48 #include "defines.h"
christi_s 2:5bab956cb59e 49 #include "mbed.h"
christi_s 2:5bab956cb59e 50
christi_s 1:ced2c297cc1b 51 #if defined(VS1053_PATCH_1_4_FLAC) && defined(VS1053_PATCH_1_5) && defined(VS1053_PATCH_1_5_FLAC) && defined(VS1053_SPECANA) && defined(VS1053B_PCM_RECORDER_0_9)
christi_s 1:ced2c297cc1b 52 #error "VS1053: Exclusive use of patch and app versions."
christi_s 1:ced2c297cc1b 53 #endif
christi_s 1:ced2c297cc1b 54 #if defined(VS1053_PATCH_1_4_FLAC) || defined(VS1053_PATCH_1_5) || defined(VS1053_PATCH_1_5_FLAC) || defined(VS1053_SPECANA) || defined(VS1053B_PCM_RECORDER_0_9)
christi_s 1:ced2c297cc1b 55 #define VS_PATCH
christi_s 0:7728d9c6c487 56 #endif
christi_s 0:7728d9c6c487 57
christi_s 2:5bab956cb59e 58 #ifndef DEBUGOUT
christi_s 2:5bab956cb59e 59 #define DEBUGOUT(x,y...)
christi_s 2:5bab956cb59e 60 #endif
christi_s 2:5bab956cb59e 61
christi_s 0:7728d9c6c487 62
christi_s 2:5bab956cb59e 63 #define DEFAULT_BALANCE_DIFERENCE_LEFT_RIGHT 0.0f
christi_s 2:5bab956cb59e 64 #define DEFAULT_VOLUME -40.0f
christi_s 2:5bab956cb59e 65 #define DEFAULT_BASS_AMPLITUDE 5 // 0 - 15 dB
christi_s 2:5bab956cb59e 66 #define DEFAULT_BASS_FREQUENCY 100 // 20 - 150 Hz
christi_s 2:5bab956cb59e 67 #define DEFAULT_TREBLE_AMPLITUDE 0 // -8 - 7 dB
christi_s 2:5bab956cb59e 68 #define DEFAULT_TREBLE_FREQUENCY 15000 //1000 - 15000 Hz
christi_s 0:7728d9c6c487 69
christi_s 4:cacb5e663fa9 70 #define BUFFER_SIZE (16 * 1024 + 1)
christi_s 4:cacb5e663fa9 71
christi_s 0:7728d9c6c487 72 // SCI register address assignment
christi_s 3:88a645490529 73 #define SCI_MODE 0x00
christi_s 3:88a645490529 74 #define SCI_STATUS 0x01
christi_s 3:88a645490529 75 #define SCI_BASS 0x02
christi_s 3:88a645490529 76 #define SCI_CLOCKF 0x03
christi_s 3:88a645490529 77 #define SCI_DECODE_TOME 0x04
christi_s 3:88a645490529 78 #define SCI_AUDATA 0x05
christi_s 3:88a645490529 79 #define SCI_WRAM 0x06
christi_s 3:88a645490529 80 #define SCI_WRAMADDR 0x07
christi_s 3:88a645490529 81 #define SCI_HDAT0 0x08
christi_s 3:88a645490529 82 #define SCI_HDAT1 0x09
christi_s 3:88a645490529 83 #define SCI_AIADDR 0x0A
christi_s 3:88a645490529 84 #define SCI_VOL 0x0B
christi_s 3:88a645490529 85 #define SCI_AICTRL0 0x0C
christi_s 3:88a645490529 86 #define SCI_AICTRL1 0x0D
christi_s 3:88a645490529 87 #define SCI_AICTRL2 0x0E
christi_s 3:88a645490529 88 #define SCI_AICTRL3 0x0F
christi_s 0:7728d9c6c487 89
christi_s 0:7728d9c6c487 90
christi_s 0:7728d9c6c487 91 //SCI_MODE register bits as of p.38 of the datasheet
christi_s 3:88a645490529 92 #define SM_DIFF 0x0001
christi_s 3:88a645490529 93 #define SM_LAYER12 0x0002
christi_s 3:88a645490529 94 #define SM_RESET 0x0004
christi_s 3:88a645490529 95 #define SM_CANCEL 0x0008
christi_s 3:88a645490529 96 #define SM_EARSPEAKER_LO 0x0010
christi_s 3:88a645490529 97 #define SM_TESTS 0x0020
christi_s 3:88a645490529 98 #define SM_STREAM 0x0040
christi_s 3:88a645490529 99 #define SM_EARSPEAKER_HI 0x0080
christi_s 3:88a645490529 100 #define SM_DACT 0x0100
christi_s 3:88a645490529 101 #define SM_SDIORD 0x0200
christi_s 3:88a645490529 102 #define SM_SDISHARE 0x0400
christi_s 3:88a645490529 103 #define SM_SDINEW 0x0800
christi_s 3:88a645490529 104 #define SM_ADPCM 0x1000
christi_s 3:88a645490529 105 #define SM_B13 0x2000
christi_s 3:88a645490529 106 #define SM_LINE1 0x4000
christi_s 3:88a645490529 107 #define SM_CLK_RANGE 0x8000
christi_s 0:7728d9c6c487 108
christi_s 0:7728d9c6c487 109 //SCI_CLOCKF register bits as of p.42 of the datasheet
christi_s 3:88a645490529 110 #define SC_ADD_NOMOD 0x0000
christi_s 3:88a645490529 111 #define SC_ADD_10x 0x0800
christi_s 3:88a645490529 112 #define SC_ADD_15x 0x1000
christi_s 3:88a645490529 113 #define SC_ADD_20x 0x1800
christi_s 3:88a645490529 114 #define SC_MULT_XTALI 0x0000
christi_s 3:88a645490529 115 #define SC_MULT_XTALIx20 0x2000
christi_s 3:88a645490529 116 #define SC_MULT_XTALIx25 0x4000
christi_s 3:88a645490529 117 #define SC_MULT_XTALIx30 0x6000
christi_s 3:88a645490529 118 #define SC_MULT_XTALIx35 0x8000
christi_s 3:88a645490529 119 #define SC_MULT_XTALIx40 0xA000
christi_s 3:88a645490529 120 #define SC_MULT_XTALIx45 0xC000
christi_s 3:88a645490529 121 #define SC_MULT_XTALIx50 0xE000
christi_s 0:7728d9c6c487 122
christi_s 0:7728d9c6c487 123 // Extra Parameter in X memory (refer to p.58 of the datasheet)
christi_s 3:88a645490529 124 #define para_chipID_0 0x1E00
christi_s 3:88a645490529 125 #define para_chipID_1 0x1E01
christi_s 3:88a645490529 126 #define para_version 0x1E02
christi_s 3:88a645490529 127 #define para_config1 0x1E03
christi_s 3:88a645490529 128 #define para_playSpeed 0x1E04
christi_s 3:88a645490529 129 #define para_byteRate 0x1E05
christi_s 3:88a645490529 130 #define para_endFillByte 0x1E06
christi_s 0:7728d9c6c487 131 //
christi_s 3:88a645490529 132 #define para_positionMsec_0 0x1E27
christi_s 3:88a645490529 133 #define para_positionMsec_1 0x1E28
christi_s 3:88a645490529 134 #define para_resync 0x1E29
christi_s 4:cacb5e663fa9 135
christi_s 4:cacb5e663fa9 136 #define INTERRUPT_HANDLER_ENABLE _DREQ_INTERUPT_IN.rise(this, &VS1053::dataRequestHandler); timer.attach_us(this, &VS1053::dataRequestHandler, 1000)
christi_s 4:cacb5e663fa9 137 #define INTERRUPT_HANDLER_DISABLE _DREQ_INTERUPT_IN.rise(NULL); timer.detach()
christi_s 0:7728d9c6c487 138
christi_s 2:5bab956cb59e 139 /** Class for VS1053 - Ogg Vorbis / MP3 / AAC / WMA / FLAC / MIDI Audio Codec Chip.
christi_s 2:5bab956cb59e 140 *
christi_s 2:5bab956cb59e 141 * This code based on:
christi_s 2:5bab956cb59e 142 * mbeduino_MP3_Shield_MP3Player
christi_s 2:5bab956cb59e 143 * http://mbed.org/users/xshige/programs/mbeduino_MP3_Shield_MP3Player/lgcx63
christi_s 2:5bab956cb59e 144 * 2010-10-16
christi_s 2:5bab956cb59e 145 *
christi_s 2:5bab956cb59e 146 * For the use of this class, a file "defines.h" must be created.
christi_s 2:5bab956cb59e 147 * It controls debug output and vs1053 patches.
christi_s 1:ced2c297cc1b 148 *
christi_s 2:5bab956cb59e 149 * defines.h:
christi_s 2:5bab956cb59e 150 *@code
christi_s 2:5bab956cb59e 151 * #ifndef _DEFINES_H
christi_s 2:5bab956cb59e 152 * #define _DEFINES_H
christi_s 2:5bab956cb59e 153 * // ----------------------------------------------------------------------------
christi_s 2:5bab956cb59e 154 * // debug output
christi_s 2:5bab956cb59e 155 * // ----------------------------------------------------------------------------
christi_s 2:5bab956cb59e 156 * // optional
christi_s 2:5bab956cb59e 157 * #define DEBUG
christi_s 2:5bab956cb59e 158 * #ifdef DEBUG
christi_s 2:5bab956cb59e 159 * # define DEBUGOUT(x,y...) printf(x, ##y);
christi_s 2:5bab956cb59e 160 * #else
christi_s 2:5bab956cb59e 161 * # define DEBUGOUT(x,y...)
christi_s 2:5bab956cb59e 162 * #endif
christi_s 2:5bab956cb59e 163 * // ----------------------------------------------------------------------------
christi_s 2:5bab956cb59e 164 * // VLSI VS1053b library, patch, apps
christi_s 2:5bab956cb59e 165 * // ----------------------------------------------------------------------------
christi_s 2:5bab956cb59e 166 * // optional, ONLY ONE
christi_s 2:5bab956cb59e 167 * //#define VS1053_PATCH_1_4_FLAC
christi_s 2:5bab956cb59e 168 * //#define VS1053_PATCH_1_5
christi_s 2:5bab956cb59e 169 * #define VS1053_PATCH_1_5_FLAC
christi_s 2:5bab956cb59e 170 * //#define VS1053_SPECANA
christi_s 2:5bab956cb59e 171 * //#define VS1053B_PCM_RECORDER_0_9
christi_s 2:5bab956cb59e 172 *
christi_s 2:5bab956cb59e 173 * #endif //_DEFINES_H
christi_s 1:ced2c297cc1b 174 *
christi_s 3:88a645490529 175 *@endcode
christi_s 1:ced2c297cc1b 176 */
christi_s 0:7728d9c6c487 177 class VS1053 {
christi_s 0:7728d9c6c487 178
christi_s 0:7728d9c6c487 179 public:
christi_s 1:ced2c297cc1b 180 /** Create a vs1053b object.
christi_s 1:ced2c297cc1b 181 *
christi_s 2:5bab956cb59e 182 * @param mosi
christi_s 2:5bab956cb59e 183 * SPI Master Out, Slave In pin to vs1053b.
christi_s 2:5bab956cb59e 184 * @param miso
christi_s 2:5bab956cb59e 185 * SPI Master In, Slave Out pin to vs1053b.
christi_s 2:5bab956cb59e 186 * @param sck
christi_s 2:5bab956cb59e 187 * SPI Clock pin to vs1053b.
christi_s 2:5bab956cb59e 188 * @param cs
christi_s 2:5bab956cb59e 189 * Pin to vs1053b control chip select.
christi_s 2:5bab956cb59e 190 * @param rst
christi_s 2:5bab956cb59e 191 * Pin to vs1053b reset.
christi_s 2:5bab956cb59e 192 * @param dreq
christi_s 2:5bab956cb59e 193 * Pin to vs1053b data request.
christi_s 2:5bab956cb59e 194 * @param dcs
christi_s 2:5bab956cb59e 195 * Pin to vs1053b data chip select.
christi_s 1:ced2c297cc1b 196 */
christi_s 0:7728d9c6c487 197 VS1053(
christi_s 1:ced2c297cc1b 198 PinName mosi,
christi_s 1:ced2c297cc1b 199 PinName miso,
christi_s 1:ced2c297cc1b 200 PinName sck,
christi_s 1:ced2c297cc1b 201 PinName cs,
christi_s 1:ced2c297cc1b 202 PinName rst,
christi_s 1:ced2c297cc1b 203 PinName dreq,
christi_s 1:ced2c297cc1b 204 PinName dcs
christi_s 4:cacb5e663fa9 205 );
christi_s 0:7728d9c6c487 206
christi_s 1:ced2c297cc1b 207 /** Reset the vs1053b. (hardware reset)
christi_s 1:ced2c297cc1b 208 *
christi_s 1:ced2c297cc1b 209 */
christi_s 2:5bab956cb59e 210 void reset(void);
christi_s 5:ead95c0f7800 211
christi_s 5:ead95c0f7800 212 /** Stop the playback if the song is completed.
christi_s 5:ead95c0f7800 213 * You must call this function for default playback.
christi_s 5:ead95c0f7800 214 *
christi_s 5:ead95c0f7800 215 */
christi_s 1:ced2c297cc1b 216 void terminateStream(void);
christi_s 1:ced2c297cc1b 217
christi_s 2:5bab956cb59e 218 /** Initialize the vs1053b device.
christi_s 1:ced2c297cc1b 219 *
christi_s 2:5bab956cb59e 220 * @return
christi_s 2:5bab956cb59e 221 * TRUE on success, FALSE on failure.
christi_s 1:ced2c297cc1b 222 */
christi_s 2:5bab956cb59e 223 bool initialize(void);
christi_s 1:ced2c297cc1b 224
christi_s 2:5bab956cb59e 225 /** Set the volume.
christi_s 2:5bab956cb59e 226 *
christi_s 2:5bab956cb59e 227 * @param volume
christi_s 2:5bab956cb59e 228 * Volume -0.5dB, -1.0dB, .. -64.0dB.
christi_s 2:5bab956cb59e 229 */
christi_s 2:5bab956cb59e 230 void setVolume(float volume = DEFAULT_VOLUME);
christi_s 2:5bab956cb59e 231
christi_s 2:5bab956cb59e 232 /** Get the volume.
christi_s 2:5bab956cb59e 233 *
christi_s 2:5bab956cb59e 234 * @return
christi_s 2:5bab956cb59e 235 * Return the volume in dB.
christi_s 2:5bab956cb59e 236 */
christi_s 1:ced2c297cc1b 237 float getVolume();
christi_s 1:ced2c297cc1b 238
christi_s 2:5bab956cb59e 239 /** Set the balance - volume difference between left-right.
christi_s 2:5bab956cb59e 240 *
christi_s 2:5bab956cb59e 241 * @param balance
christi_s 2:5bab956cb59e 242 * Difference in dB.
christi_s 2:5bab956cb59e 243 */
christi_s 2:5bab956cb59e 244 void setBalance(float balance = DEFAULT_BALANCE_DIFERENCE_LEFT_RIGHT);
christi_s 2:5bab956cb59e 245
christi_s 2:5bab956cb59e 246 /** Get the balance - volume difference between left-right.
christi_s 2:5bab956cb59e 247 *
christi_s 2:5bab956cb59e 248 * @return
christi_s 2:5bab956cb59e 249 * Difference in dB.
christi_s 2:5bab956cb59e 250 */
christi_s 1:ced2c297cc1b 251 float getBalance();
christi_s 2:5bab956cb59e 252
christi_s 2:5bab956cb59e 253 /** Get the treble frequency limit.
christi_s 2:5bab956cb59e 254 *
christi_s 2:5bab956cb59e 255 * @return
christi_s 2:5bab956cb59e 256 * Frequenzy 1000, 2000 .. 15000Hz.
christi_s 2:5bab956cb59e 257 */
christi_s 2:5bab956cb59e 258 int getTrebleFrequency(void);
christi_s 2:5bab956cb59e 259 /** Set the treble frequency limit.
christi_s 2:5bab956cb59e 260 *
christi_s 2:5bab956cb59e 261 * @param frequency
christi_s 2:5bab956cb59e 262 * Frequenzy 1000, 2000, .. 15000Hz.
christi_s 2:5bab956cb59e 263 */
christi_s 2:5bab956cb59e 264 void setTrebleFrequency(int frequency = DEFAULT_TREBLE_FREQUENCY);
christi_s 1:ced2c297cc1b 265
christi_s 2:5bab956cb59e 266 /** Get the treble amplitude.
christi_s 2:5bab956cb59e 267 *
christi_s 2:5bab956cb59e 268 * @return
christi_s 2:5bab956cb59e 269 * Amplitude -8 .. 7dB (in 1.5dB steps); 0 = off.
christi_s 2:5bab956cb59e 270 */
christi_s 2:5bab956cb59e 271 int getTrebleAmplitude(void);
christi_s 2:5bab956cb59e 272 /** Set the treble amplitude.
christi_s 2:5bab956cb59e 273 *
christi_s 2:5bab956cb59e 274 * @param amplitude
christi_s 2:5bab956cb59e 275 * Amplitude -8 .. 7dB (in 1.5dB steps); 0 = off.
christi_s 2:5bab956cb59e 276 */
christi_s 2:5bab956cb59e 277 void setTrebleAmplitude(int amplitude = DEFAULT_TREBLE_AMPLITUDE);
christi_s 1:ced2c297cc1b 278
christi_s 2:5bab956cb59e 279 /** Get the bass frequency limit.
christi_s 2:5bab956cb59e 280 *
christi_s 2:5bab956cb59e 281 * @return
christi_s 2:5bab956cb59e 282 * Frequenzy 20, 30, .. 150Hz.
christi_s 2:5bab956cb59e 283 */
christi_s 2:5bab956cb59e 284 int getBassFrequency(void);
christi_s 2:5bab956cb59e 285 /** Set the bass frequency limit.
christi_s 2:5bab956cb59e 286 *
christi_s 2:5bab956cb59e 287 * @param frequency
christi_s 2:5bab956cb59e 288 * Frequenzy 20, 30, .. 150Hz.
christi_s 2:5bab956cb59e 289 */
christi_s 2:5bab956cb59e 290 void setBassFrequency(int frequency= DEFAULT_BASS_FREQUENCY);
christi_s 2:5bab956cb59e 291
christi_s 2:5bab956cb59e 292 /** Get the bass amplitude.
christi_s 2:5bab956cb59e 293 *
christi_s 2:5bab956cb59e 294 * @return
christi_s 2:5bab956cb59e 295 * Amplitude 0 .. 15dB (in 1dB steps); 0 = off.
christi_s 2:5bab956cb59e 296 */
christi_s 2:5bab956cb59e 297 int getBassAmplitude(void);
christi_s 2:5bab956cb59e 298 /** Set the bass amplitude.
christi_s 2:5bab956cb59e 299 *
christi_s 2:5bab956cb59e 300 * @param amplitude
christi_s 2:5bab956cb59e 301 * Amplitude 0 .. 15dB (in 1dB steps); 0 = off.
christi_s 2:5bab956cb59e 302 */
christi_s 2:5bab956cb59e 303 void setBassAmplitude(int amplitude = DEFAULT_BASS_AMPLITUDE);
christi_s 2:5bab956cb59e 304
christi_s 2:5bab956cb59e 305 /** Set the speed of a playback.
christi_s 2:5bab956cb59e 306 *
christi_s 2:5bab956cb59e 307 * @param speed
christi_s 5:ead95c0f7800 308 * Speed 0, 1, .. (0, 1 normal speed).
christi_s 5:ead95c0f7800 309 * Speeds greater 2 are not recommended, buffer must be filled quickly enough.
christi_s 2:5bab956cb59e 310 */
christi_s 4:cacb5e663fa9 311 void setPlaySpeed(unsigned short speed);
christi_s 4:cacb5e663fa9 312
christi_s 5:ead95c0f7800 313 /** Copy a byte into the audio data buffer.
christi_s 5:ead95c0f7800 314 *
christi_s 5:ead95c0f7800 315 * @param c
christi_s 5:ead95c0f7800 316 * Data for the buffer.
christi_s 5:ead95c0f7800 317 *
christi_s 5:ead95c0f7800 318 * @return
christi_s 5:ead95c0f7800 319 * TRUE on success; FALSE on failure, c isn't copied in the buffer.
christi_s 5:ead95c0f7800 320 */
christi_s 4:cacb5e663fa9 321 bool bufferSetByte(unsigned char c);
christi_s 5:ead95c0f7800 322
christi_s 5:ead95c0f7800 323 /** Copy a array of bytes into the audio data buffer.
christi_s 5:ead95c0f7800 324 *
christi_s 5:ead95c0f7800 325 * @param s
christi_s 5:ead95c0f7800 326 * Data for the buffer.
christi_s 5:ead95c0f7800 327 *
christi_s 5:ead95c0f7800 328 * @param length
christi_s 5:ead95c0f7800 329 * Size of data array.
christi_s 5:ead95c0f7800 330 *
christi_s 5:ead95c0f7800 331 * @return
christi_s 5:ead95c0f7800 332 * TRUE on success; FALSE on failure, s isn't copied in the buffer.
christi_s 5:ead95c0f7800 333 */
christi_s 4:cacb5e663fa9 334 bool bufferPutStream(const unsigned char *s, unsigned int length);
christi_s 5:ead95c0f7800 335
christi_s 5:ead95c0f7800 336 /** Get the free space of the audio data buffer.
christi_s 5:ead95c0f7800 337 *
christi_s 5:ead95c0f7800 338 * @return
christi_s 5:ead95c0f7800 339 * Space 0 .. BUFFER_SIZE - 1.
christi_s 5:ead95c0f7800 340 */
christi_s 4:cacb5e663fa9 341 unsigned int bufferFree(void);
christi_s 5:ead95c0f7800 342
christi_s 5:ead95c0f7800 343 /** Get the busy space of the audio data buffer.
christi_s 5:ead95c0f7800 344 *
christi_s 5:ead95c0f7800 345 * @return
christi_s 5:ead95c0f7800 346 * Space 0 .. BUFFER_SIZE - 1.
christi_s 5:ead95c0f7800 347 */
christi_s 4:cacb5e663fa9 348 unsigned int bufferCount(void);
christi_s 4:cacb5e663fa9 349
christi_s 5:ead95c0f7800 350 /** Start playing audio from buffer.
christi_s 5:ead95c0f7800 351 *
christi_s 5:ead95c0f7800 352 */
christi_s 4:cacb5e663fa9 353 void play(void);
christi_s 5:ead95c0f7800 354
christi_s 5:ead95c0f7800 355 /** Interrupt the playback.
christi_s 5:ead95c0f7800 356 *
christi_s 5:ead95c0f7800 357 */
christi_s 4:cacb5e663fa9 358 void pause(void);
christi_s 5:ead95c0f7800 359
christi_s 5:ead95c0f7800 360 /** Stop the playback in the middle of a song.
christi_s 5:ead95c0f7800 361 * After this call, you can now send the next audio file to buffer.
christi_s 5:ead95c0f7800 362 *
christi_s 5:ead95c0f7800 363 */
christi_s 4:cacb5e663fa9 364 void stop(void);
christi_s 1:ced2c297cc1b 365
christi_s 1:ced2c297cc1b 366 protected:
christi_s 1:ced2c297cc1b 367 unsigned short int wram_read(unsigned short int);
christi_s 1:ced2c297cc1b 368 void wram_write(unsigned short int, unsigned short int);
christi_s 1:ced2c297cc1b 369 void write_plugin(const unsigned short* , unsigned int);
christi_s 0:7728d9c6c487 370 void cs_low(void);
christi_s 0:7728d9c6c487 371 void cs_high(void);
christi_s 0:7728d9c6c487 372 void dcs_low(void);
christi_s 0:7728d9c6c487 373 void dcs_high(void);
christi_s 0:7728d9c6c487 374 void sci_en(void);
christi_s 0:7728d9c6c487 375 void sci_dis(void);
christi_s 0:7728d9c6c487 376 void sdi_en(void);
christi_s 0:7728d9c6c487 377 void sdi_dis(void);
christi_s 0:7728d9c6c487 378
christi_s 1:ced2c297cc1b 379 void spi_initialise(void);
christi_s 1:ced2c297cc1b 380
christi_s 0:7728d9c6c487 381 void sdi_initialise(void);
christi_s 0:7728d9c6c487 382
christi_s 0:7728d9c6c487 383 void sci_write(unsigned char, unsigned short int);
christi_s 0:7728d9c6c487 384 void sdi_write(unsigned char);
christi_s 0:7728d9c6c487 385 unsigned short int sci_read(unsigned short int);
christi_s 0:7728d9c6c487 386 void sine_test_activate(unsigned char);
christi_s 0:7728d9c6c487 387
christi_s 0:7728d9c6c487 388 void sine_test_deactivate(void);
christi_s 0:7728d9c6c487 389
christi_s 1:ced2c297cc1b 390 void changeVolume(void);
christi_s 4:cacb5e663fa9 391
christi_s 1:ced2c297cc1b 392
christi_s 2:5bab956cb59e 393 // TODO
christi_s 2:5bab956cb59e 394 void power_down(void);
christi_s 4:cacb5e663fa9 395
christi_s 2:5bab956cb59e 396 void changeBass(void);
christi_s 1:ced2c297cc1b 397
christi_s 4:cacb5e663fa9 398 unsigned char bufferGetByte(void);
christi_s 4:cacb5e663fa9 399 void bufferReset(void);
christi_s 4:cacb5e663fa9 400 void dataRequestHandler(void);
christi_s 2:5bab956cb59e 401
christi_s 4:cacb5e663fa9 402 SPI _spi;
christi_s 4:cacb5e663fa9 403 DigitalOut _CS;
christi_s 4:cacb5e663fa9 404 DigitalOut _RST;
christi_s 4:cacb5e663fa9 405 DigitalOut _DCS;
christi_s 4:cacb5e663fa9 406 DigitalIn _DREQ;
christi_s 4:cacb5e663fa9 407 InterruptIn _DREQ_INTERUPT_IN;
christi_s 4:cacb5e663fa9 408
christi_s 4:cacb5e663fa9 409 unsigned char _buffer[BUFFER_SIZE];
christi_s 4:cacb5e663fa9 410 unsigned char* _bufferReadPointer;
christi_s 4:cacb5e663fa9 411 unsigned char* _bufferWritePointer;
christi_s 4:cacb5e663fa9 412
christi_s 4:cacb5e663fa9 413 bool _isIdle;
christi_s 4:cacb5e663fa9 414
christi_s 2:5bab956cb59e 415 // variables to save
christi_s 2:5bab956cb59e 416 // volume, values in db
christi_s 4:cacb5e663fa9 417 float _balance;
christi_s 4:cacb5e663fa9 418 float _volume;
christi_s 2:5bab956cb59e 419 // bass enhancer settings
christi_s 4:cacb5e663fa9 420 int _sb_amplitude;
christi_s 4:cacb5e663fa9 421 int _sb_freqlimit;
christi_s 4:cacb5e663fa9 422 int _st_amplitude;
christi_s 4:cacb5e663fa9 423 int _st_freqlimit;
christi_s 4:cacb5e663fa9 424
christi_s 4:cacb5e663fa9 425 Ticker timer;
christi_s 4:cacb5e663fa9 426
christi_s 0:7728d9c6c487 427 };
christi_s 4:cacb5e663fa9 428
christi_s 0:7728d9c6c487 429 #endif