4D Systems Sound Module Library
Dependents: STM32F030R8_SOMO-14D
SOMO-14D
The SOMO-14D is a tiny Audio-Sound module that can play back pre-stored audio files such as voice and music from a micro-SD memory card. The module supports 4-bit ADPCM audio files with sample rates from 6Khz up to 32Khz. By using the freely available software tool, any WAVE(.wav) or MP3(.mp3) file can be easily converted to the ADPCM(.ad4) format which can then be can be saved to a micro-SD memory card. The compact 14pin drop-in-module takes up very minimal board space and is ideal for any application that requires embedded audio.
The SERIAL-MODE provides a simple 2-wire interface to any micro-controller via its DATA and CLK lines. Audio operations such as PLAY, PAUSE,STOP and VOLUME control functions are all available to the host micro via simple serial commands.
SOMO-14D Library
The SOMO library handles all basic functions that access the hardware to set the commands that ensure SERIAL-MODE interfacing.
Some of the functions can make control of: - Initialization - Activity - Command
Initialization Function
- void SOMO14DInit(void (*pfunc)(void));
Activity Function
- INT8U SOMO14DisBusy(void);
Commanding Functions
- void SOMO14DSerialOut(INT16U SOMO14Duint16);
- void SOMO14DPause(void);
- void SOMO14DStop(void);
- void SOMO14DSetVol(INT8U *SOMO14DVol);
- void SOMO14DSetAudio(INT16U SOMO14DAudioFileNo);
For check the function by capability please check the "functions" wiki
Diff: SOMO14D.h
- Revision:
- 0:41f21e0cf86f
- Child:
- 2:673ecbaff67b
diff -r 000000000000 -r 41f21e0cf86f SOMO14D.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/SOMO14D.h Fri Mar 13 01:12:55 2015 +0000 @@ -0,0 +1,62 @@ +/* +******************************************************************************* +* CERES CONTROLS +* PANAMA, REPULIC OF PANAMA +* +* File : SOMO14D.h +* Programmer(s) : Rangel Alvarado +* Language : ANSI-C +* Description : SOMO14D is an acronym of SOund MOdule 1 4D SYSTEMS INC. +* The file mlist all public functions which can be called on +* your application. +* +* Note : Dependancies of mbed libraries... +* - InterruptIn +* - DigitalOut +* +* ---------------------------------------------------------------------------- +* HISTORY +* DD MM AA +* 09 03 15 Created. +* 09 03 15 Modified. +* 12 03 15 Import to mbed platform. +******************************************************************************* +*/ + + +/* +******************************************************************************* +* CONSTANTS AND MACROS +******************************************************************************* +*/ + +#define SOMO_BUSY_PIN PC_0 /* BUSY signal. Active HIGH output. */ +#define SOMO_DATA_PIN PC_1 /* Serial DATA input from host MCU */ +#define SOMO_CLK_PIN PC_2 /* Serial Clock input from host MCU */ +#define SOMO_RESET_PIN PC_3 /* Master Reset. Active LOW trigger. */ +#define SOMO_WAIT_BIT 0.01 /* Wait between bits, base = 1 sec. */ +#define SOMO_WAIT_IDLE 0.05 /* Wait between idle, base = 1 sec. */ + + +#define SOMO_SONG_CMD_MAX 0x01FF /* 0x0000 = first; 0x01FF = last */ +#define SOMO_VOL_CMD_OFFSET 0xFFF0 /* 0xFFF0 = Vol 0; 0xFFF7 = Vol 7 */ +#define SOMO_PAUSE_CMD_OFFSET 0xFFFE /* Hold or pause/play command */ +#define SOMO_STOP_CMD_OFFSET 0xFFFF /* Stop audio command */ +#define SOMO_VOL_UNF 0xFF /* Volume underflow (app specific) */ +#define SOMO_VOL_MIN 0 /* Volume minimun */ +#define SOMO_VOL_MAX 7 /* Volume maximum */ + + +/* +******************************************************************************* +* FUNCTION PROTOTYPES +******************************************************************************* +*/ + +INT8U SOMO14DisBusy(void); /* Check if SOMO is doing something */ +void SOMO14DInit(void (*pfunc)(void)); /* Initialize the sound module */ +void SOMO14DSerialOut(INT16U SOMO14Duint16); /* Serial out command */ +void SOMO14DPause(void); /* Hold the current song */ +void SOMO14DStop(void); /* Stop audio and go to sleep mode */ +void SOMO14DSetVol(INT8U *SOMO14DVol); /* Increase/Decrease the volume */ +void SOMO14DSetAudio(INT16U SOMO14DAudioFileNo); /* Set audio file */