📄 song.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <HTML><HEAD> <META NAME="GENERATOR" CONTENT="langdoc 1.0.1"> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> <TITLE> song </TITLE> </HEAD> <BODY> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="6"> <TR> <TD ALIGN=CENTER VALIGN=MIDDLE BGCOLOR=BLUE> <H1> <FONT COLOR="#FFFFFF"> song </FONT> </H1> </TD> </TR> </TABLE><P ALIGN=RIGHT> <I> Copyright (c) 2003</I> </P><H2> Library Usage </H2><H3> Package Description </H3><H3> Package Summary </H3><H4> Constants </H4><PRE></PRE><H4> Global Variables </H4><PRE></PRE><H4> Macros </H4><PRE></PRE><H4> Functions </H4><PRE><A HREF="#song_audio_init">song_audio_init</A> <A HREF="#song_get_level">song_get_level</A> <A HREF="#song_get_sound">song_get_sound</A> <A HREF="#song_init">song_init</A> <A HREF="#song_pause">song_pause</A> <A HREF="#song_snd_dec">song_snd_dec</A> <A HREF="#song_snd_inc">song_snd_inc</A> <A HREF="#song_snd_init">song_snd_init</A> <A HREF="#song_snd_select">song_snd_select</A> <A HREF="#song_start">song_start</A> <A HREF="#song_stop">song_stop</A> <A HREF="#song_task">song_task</A> <A HREF="#song_task_init">song_task_init</A> </PRE><H3> Files List </H3><UL><LI><B><A NAME="song_drv.c"></A> song_drv.c</B><BR></LI><UL>This file contains the song driver routines</UL><LI><B><A NAME="song_drv.h"></A> song_drv.h</B><BR></LI><UL>This file contains the song driver definition</UL><LI><B><A NAME="song_task.c"></A> song_task.c</B><BR></LI><UL>This file contains the song task and attached routines CONFIGURATION Three #define must be set in config.h: - PLAYER_PLAY_MODE PLAY_DIR play selected dir PLAY_DISK play whole disk including sub-directory - PLAYER_PLAY_START START_PLAY start playing after power-up START_STOP do not play after power-up - PLAYER_PLAY_LOOP PLAY_LOOP loop after last file of dir or disk has been played PLAY_NO_LOOP no loop after last file of dir or disk has been played NOTES: Global Variables: - gl_key_press: bit in bdata space - gl_key: byte in idata space - gl_mem_failure: bit in bdata space</UL><LI><B><A NAME="song_task.h"></A> song_task.h</B><BR></LI><UL>This file contains the song task definition</UL></UL><H3> Included Files </H3><UL><LI><B>board.h" / * board definition * / </B><BR></LI><LI><B>config.h" / * system configuration * / </B><BR></LI><LI><B>dac\dac_drv.h" / * dac driver definition * / </B><BR></LI><LI><B>lib_mcu\aud\aud_drv.h" / * audio driver definition * / </B><BR></LI><LI><B>lib_mcu\clock\clock.h" / * clock definition * / </B><BR></LI><LI><B>lib_mcu\mp3\mp3_drv.h" / * mp3 driver definition * / </B><BR></LI><LI><B>modules\display\disp.h" / * display definition * / </B><BR></LI><LI><B>modules\display\disp_task.h" / * display definition * / </B><BR></LI><LI><B>modules\file\file.h" / * file definition * / </B><BR></LI><LI><B>modules\mem\mem_task.h" / * memory task definition * / </B><BR></LI><LI><B>modules\mode\mode_task.h" / * mode task definition * / </B><BR></LI><LI><B>song_drv.h" / * song driver definition * / </B><BR></LI><LI><B>song_task.h" / * song task definition * / </B><BR></LI></UL><H2> Constant Macros </H2><H2> Global Variables </H2><H2> Function Macros </H2><H2> Functions </H2><A NAME="song_audio_init"></A><H3> song_audio_init </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_audio_init">song_audio_init</A> ( void ) </PRE></TD></TABLE><P>Audio interface initialization in song mode<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><H4> Note </H4><P>DAC_NB_BIT defined in config.h<HR><A NAME="song_get_level"></A><H3> song_get_level </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>Byte <A HREF="#song_get_level">song_get_level</A> ( void ) </PRE></TD></TABLE><P>Returns selected sound level<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return: level of sound selected</PRE></TD></TABLE><HR><A NAME="song_get_sound"></A><H3> song_get_sound </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>Byte <A HREF="#song_get_sound">song_get_sound</A> ( void ) </PRE></TD></TABLE><P>Returns selected sound control<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return: sound selected: SND_VOLUME, SND_BASS, SND_MEDIUM, SND_TREBLE</PRE></TD></TABLE><HR><A NAME="song_init"></A><H3> song_init </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>Byte <A HREF="#song_init">song_init</A> ( void ) </PRE></TD></TABLE><P>Search frame header and initialize song playing according to this header<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return: header status: SONG_NO_ERR: header ok SONG_LAYER_ERR: not a layer 3 file SONG_BR_ERR: bit rate not supported SONG_FS_ERR: bad frequency sampling SONG_SYNC_ERR: no header found</PRE></TD></TABLE><H4> Note </H4><P>Header search is stopped when errors number exceeds<HR><A NAME="song_pause"></A><H3> song_pause </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_pause">song_pause</A> ( void ) </PRE></TD></TABLE><P>Stop song playing<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><H4> Note </H4><P>clocks are not disabled by this functions<HR><A NAME="song_snd_dec"></A><H3> song_snd_dec </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_snd_dec">song_snd_dec</A> ( void ) </PRE></TD></TABLE><P>Decrement the selected sound control<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><H4> Note </H4><P>The number of the current selected sound control is stored in thevariable snd_select (0.Volume; 1.Bass; 2.Medium; 3. Trebble)<HR><A NAME="song_snd_inc"></A><H3> song_snd_inc </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_snd_inc">song_snd_inc</A> ( void ) </PRE></TD></TABLE><P>Increment the selected sound control<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><H4> Note </H4><P>The number of the current selected sound control is stored in thevariable snd_select (0.Volume; 1.Bass; 2.Medium; 3. Trebble)<HR><A NAME="song_snd_init"></A><H3> song_snd_init </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_snd_init">song_snd_init</A> ( void ) </PRE></TD></TABLE><P>Sound control initialization<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><H4> Note </H4><P>Initializes the sound controls to their medium value<HR><A NAME="song_snd_select"></A><H3> song_snd_select </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_snd_select">song_snd_select</A> ( void ) </PRE></TD></TABLE><P>Select next sound control<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><HR><A NAME="song_start"></A><H3> song_start </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_start">song_start</A> ( void ) </PRE></TD></TABLE><P>Start song playing<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><HR><A NAME="song_stop"></A><H3> song_stop </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_stop">song_stop</A> ( void ) </PRE></TD></TABLE><P>Stop song playing<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><HR><A NAME="song_task"></A><H3> song_task </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_task">song_task</A> ( void ) </PRE></TD></TABLE><P>Song playing task<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><HR><A NAME="song_task_init"></A><H3> song_task_init </H3><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#D6E8FF" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>void <A HREF="#song_task_init">song_task_init</A> ( void ) </PRE></TD></TABLE><P>Song playing task initialization<P><TABLE BORDER="0" WIDTH="100 %" BGCOLOR="#FFD0D0" CELLPADDING="6"><TR> <TD VALIGN=MIDDLE><PRE>*return:</PRE></TD></TABLE><HR></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -