1. AW30N 传统玩具应用模式介绍

AW30N 的mbox_flash 除了其特有的蓝牙模块外,还有其他传统玩具应用模式。

本章简单介绍传统玩具应用各个模式:

  1. 音乐解码模式(MUSIC_MODE)

  2. 普通解码模式(SIMPLE_DEC_MODE)

  3. 录音模式(RECORD_MODE)

  4. linein模式(AUX_MODE)

  5. MIDI模式(MIDI_MODE)

  6. MIDI琴模式(MIDI_CTRL_MODE)

  7. 扩音模式(LOUDSPEAKER_MODE)

  8. RTC模式(RTC_MODE)

  9. USB从机模式(USB_SLAVE_MODE)


1.1. 音乐解码模式(MUSIC_MODE)

音乐解码模式主要功能为解码播歌,可以实现内置flash,外置flash,sd卡,U盘随意切换来播放支持的解码格式音乐文件;
用户可通过按键来暂停/播放,上下一曲,切换播放设备等等操作;
涉及的文件目录:appsappsrcmbox_flashmusic;

1.2. 普通解码模式(SIMPLE_DEC_MODE)

普通解码模式主要功能为解码播歌,是最简单实现解码播放的应用,目的是为了让用户更容易了解解码播放的整个流程。
用户可通过按键来暂停/播放,上下一曲,切换播放设备等等操作。
涉及的文件目录:appsappsrcmbox_flashsimple_decode;
下面简要介绍主要涉及函数:

1.2.1. 函数u32 simple_dev_fs_mount(play_control *ppctl)

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

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

1.2.2. 函数u32 simple_dev_fs_close(play_control *ppctl)

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

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

1.2.3. 函数u32 simple_play_file_byindex(play_control *ppctl)

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

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

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

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

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

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

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

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

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

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

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

1.3. 录音模式(RECORD_MODE)

录音模式主要功能为录音并播放录音文件。
用户可通过按键来开始/播放录音,变速变调等操作;
涉及的文件目录:appsappsrcmbox_flashrecord;

1.3.1. 函数int encode_start(Encode_Control *obj)

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

其中参数::

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

1.3.2. 函数void encode_stop(Encode_Control *obj)

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

1、obj:编码器句柄指针;
2、返回值:无;

1.3.3. 函数int fatfs_enc_file_create(Encode_Control *obj)

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

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

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

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

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

1.3.5. 函数int norfs_enc_file_create(Encode_Control *obj)

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

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

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

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

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

1.4. linein模式(AUX_MODE)

Linein模式支持数字LINEIN模式。
用户在开发板上只需把AUXL 和 AUXR 一并连接到 PA4即可实现 PC linein 连接小机播放PC端音频(具体io更好可以在cpu_config.c里的audio_adc_aux_input_mode替换);
涉及的文件目录:appsappsrcmbox_flashlinein;

1.5. MIDI模式(MIDI_MODE)

MIDI模式支持播放MIDI格式文件 并 叠加a文件解码播放。
用户在通过按键来切换midi模式,上下一曲等操作;
涉及的文件目录:appsappsrcmbox_flashmidi_dec;

1.6. MIDI琴模式(MIDI_CTRL_MODE)

MIDI琴模式支持通过函数驱动midi解码,该应用依赖我司自定义的mid音色库,用户可通过我司mid工具进行转换,详情请看《JLmidi工具使用说明》;
用户在通过按键来模拟乐器打击,弯音轮等操作;
涉及的文件目录:appsappsrcmbox_flashmidi_keyoboard;

1.7. 扩音模式(LOUDSPEAKER_MODE)

扩音模式为mic采集音频数据,串联一个或多个音效算法并将处理后的数据输出至DAC出声的功能,常用于扩音喇叭等应用;
扩音模式支持多种音效串联,但需要注意各音效之间是否overlay同一块区域,具体可观察app_ld.c里每个音效段是否为同级关系,是则不能同时开该音效。
目前可串联的音效有:
  • 1)speed实时变调音效;

  • 2)echo混响音效;

  • 3)voice_pich变音音效;

  • 4)notcch_howling陷波啸叫抑制音效;

  • 5)pitchshift_howling移频啸叫抑制音效;

  • 6)pcm_eq音效;

以上音效可在speaker._api.c文件中通过link函数形式串联到数据流中;
涉及的文件目录:appsappsrcmbox_flashloudspeaker;

1.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可选采样率


1.8. RTC模式(RTC_MODE)

RTC模式主要功能为展示系统RTC使用,
涉及的文件目录:appsappsrcmbox_flashrtc,

1.9. USB从机模式(USB_SLAVE_MODE)

USB从机模式主要功能为USB从机模式,具体表现为PC端通过USB连接小机来实现读卡器,音频播放等功能;
具体功能用户可以通过app_config.h里的USB_DEVICE_CLASS_CONFIG来开启所需功能(”USB模块配置”);
涉及的文件目录:appsappsrcmbox_flashusb_slave;