2. FLASH工程应用流程

AD16N 的FLASH工程拥有更大的存储空间，在OTP工程的Music模式、USB从机模式以及LINEIN模式的基础上，新增了玩具多路解码模式、录音模式、MIDI解码模式、MIDI琴模式等应用。

2.1. 音乐解码模式

音乐解码模式在OTP小音箱Music模式的基础上，增加了内置flash设备播放。涉及的文件目录：appsappsrcmbox_flashmusic，涉及应用函数请参考《OTP小音箱应用流程》->《音乐解码模式》。

2.2. USB从机模式

同《OTP小音箱应用流程》中的USB从机模式。

2.3. LINEIN模式

同《OTP小音箱应用流程》中的LINEIN模式。

2.4. MIDI解码 / MIDI琴模式

MIDI具体内容请参考《杰理AD14N_AD15N_MIDI应用说明文档.pdf》。

2.5. 玩具多路解码模式

多路解码模式使用了SYD文件系统，能够播放打包成dir文件的F1A/B/C/X、UMP3，并叠加A文件解码，同时支持外挂FLASH解码。该模式还具备VM记忆，可记录解码文件序号与断点。多路解码使用play_control结构体，其成员如下：

"图5.1 play_control结构体成员"

图5.1 play_control结构体成员

涉及的文件目录：appsappsrcmbox_flashsimple_decode，涉及的应用函数如下：

2.5.1. 函数u32 simple_dev_fs_mount(play_control *ppctl)

此函数是多路解码挂载设备和SYD文件系统，其中参数：

1、ppctl：音乐播放器句柄指针；
2、返回值：
    成功 返回0；
    失败 错误值可查看errno-base.h；

2.5.2. 函数u32 simple_dev_fs_close(play_control *ppctl)

此函数实现多路解码释放文件、文件系统句柄，并关闭设备；释放的句柄分别是结构体play_control中的成员pfile，pfs以及device，其中参数：

1、ppctl：音乐播放器句柄指针；
2、返回值：0；

2.5.3. 函数u32 simple_play_file_byindex(play_control *ppctl)

此函数实现多路解码按文件序号播放指定文件，播放的文件序号使用结构体play_control中的成员findex，其中参数：

1、ppctl：音乐播放器句柄指针；
2、返回值：0；

2.5.4. 5.4 函数u32 get_decoder_status(dec_obj *obj)

此函数实现获取多路解码当前的状态，分别有播放停止（MUSIC_STOP）、播放暂停（MUSIC_PAUSE）以及播放中（MUSIC_PLAY）三种状态，其中参数：

1、obj：解码句柄；
2、返回值：返回当前解码器播放状态；

2.5.5. 函数static bool simple_switch_device(play_control *ppctl)

此函数实现多路解码切换下一个设备（内置flash<–>外挂flash），函数中需要停止解码器，关闭上次播放的文件与设备，重新初始化下一个需要播放的设备并开始解码，其中参数：

1、ppctl：音乐播放器句柄指针；
2、返回值：
    成功 true；
    失败 false；

2.5.6. 函数static bool simple_next_dir(play_control *ppctl)

此函数实现多路解码切换下一个dir文件夹，函数中需要停止解码器，关闭上次播放的文件与设备，重新初始化下一个需要播放的设备并开始解码，其中参数：

1、      ppctl：音乐播放器句柄指针；
2、返回值：
    成功 true；
    失败 false；

2.6. 录音模式

录音模式支持内置flash、SD卡/U盘录音与播放，同时支持变速变调音效。

内置flash录音时挂载NORFS文件系统，支持录制UMP3、A格式音频；SD卡/U盘录音时挂载FAT文件系统，支持录制标准MP2格式音频；各编码格式支持的采样率以及码率范围请参考《第六章 编码接口》介绍。

编码使用Encode_Control结构体，其成员如下：

"图5.1 编码结构体Encode_Control说明"

图5.1 编码结构体Encode_Control说明

涉及的文件目录：appsappsrcmbox_flashrecord，涉及的应用函数如下面几个小节；

2.6.1. 函数int encode_start(Encode_Control *obj)

此函数实现配置AUDIO_ADC采样率，并识别当前在线设备进行编码，SD卡/U盘挂载fat文件系统录制标准mp2音频，内置flash挂载norfs文件系统录制ump3或a格式音频，其中参数：

1、obj：编码器句柄指针；
2、返回值：
    成功 返回0；
    失败 错误值可查看errno-base.h；

2.6.2. 函数void encode_stop(Encode_Control *obj)

此函数实现停止编码器工作，并保存录制完成的文件，其中参数：

1、obj：编码器句柄指针；
2、返回值：无；

2.6.3. 函数int fatfs_enc_file_create(Encode_Control *obj)

此函数实现打开SD卡/U盘设备，并创建固定命名格式的文件，创建的文件名遵循”AD16****.mp3”格式，可录制文件”AD160000.mp3”至”AD169999.mp3”，文件系统能识别最大后缀序号，并自增作为新建文件名，其中参数：

1、obj：编码器句柄指针；
2、返回值：
    成功 返回0；
    失败 错误值可查看errno-base.h；

2.6.4. 函数dec_obj *fatfs_enc_file_decode(Encode_Control *obj, u16 dec_type)

此函数实现播放SD卡/U盘设备录制的标准mp2编码文件，其中参数：

1、obj：编码器句柄指针；
2、dec_type：解码格式、音效选择；
3、返回值：
    成功 返回解码器句柄；
    失败 返回NULL；

2.6.5. 函数int norfs_enc_file_create(Encode_Control *obj)

此函数实现内置flash挂载norfs文件系统录制ump3/a格式音频，norfs为循环管理的可读写文件系统，写满后会自动覆盖最开始的数据，该文件系统只能用文件序号打开文件，创建新文件时，会返回最新文件序号，其中参数：

1、obj：编码器句柄指针；
2、返回值：
    成功 返回0；
    失败 错误值可查看errno-base.h；

2.6.6. 函数dec_obj *norfs_enc_file_decode(Encode_Control *obj, u16 dec_type)

此函数实现播放内置flash录制的ump3/a编码文件，其中参数：

1、      bj：编码器句柄指针；
2、dec_type：解码格式、音效选择；
3、返回值：
    成功 返回解码器句柄；
    失败 返回NULL；

2.7. LoudSpeaker扩音模式

扩音模式为mic采集音频数据，串联一个或多个音效算法并将处理后的数据输出至DAC出声的功能，常用于扩音喇叭等应用。

目前可串联的音效有：

  • 1）speed实时变调音效；

  • 2）echo混响音效；

  • 3）voice_pich变音音效；

  • 4）notcch_howling陷波啸叫抑制音效；

  • 5）pitchshift_howling移频啸叫抑制音效；

  • 6）EQ音效；

以上音效可在speaker._api.c文件中通过link函数形式串联到数据流中；

其中，（1）~（3）音效资源互斥，同时只可开启其中一个。

在audio DAC出数过程中，如遇到打印‘*’号，可能是算法运算时间较长，数据处理不过来，可尝试提高系统时钟解决。

各音效算法的介绍请查看《音效》章节说明。

2.7.1. 函数void audio_adc_speaker_start(u32 sr)

此函数实现启动mic直通喇叭功能，其中参数：

1、sr：speaker工作采样率，可选采样率如下表所示；

序号

AUDIO ADC可选采样率

1

8000

2

11025

3

12000

4

16000

5

22050

6

24000

7

32000

8

44100

9

48000

表1 AUDIO ADC可选采样率

2.7.2. 函数void audio_adc_speaker_reless(void)

此函数实现关闭mic直通喇叭功能；