查看“开源音乐播放器/zh”的源代码

{| style="width: 800px;"
|-
|
==概述==
*项目名称：Microduino开源音乐播放器
*目的：读取SD卡中的歌曲播放
*难度：中
*耗时：2小时
*制作者：
*简介:
**开源音乐播放器是一款能够读取SD卡并独自解码的开源音箱
**外观简洁、精简按键设计、OLED屏幕显示、轻松使用
**这套系统完全由Microduino来实现，用户可以体验手工DIY的乐趣

==材料清单==
*Microduino设备
{|class="wikitable"
|-
|模块||数量||功能
|-
|[[Microduino-Core/zh]]||1||核心板
|-
|[[Microduino-USBTTL/zh]] ||1||下载程序
|-
|[[Microduino-Audio/zh]](with shield) ||1||解码，存储音乐文件
|-
|[[Microduino-Amplifier/zh]] ||1||攻放
|-
|[[Microduino-OLED/zh]] ||1||显示
|-
|[[Microduino-Cube-S1/zh]] ||1||扩展板OLED接口
|}
*其他设备
{|class="wikitable"
|-
|模块||数量||功能
|-
|固定板材||1||结构固定
|-
|OLED连接线||1||连接
|-
|Micro-USB线 ||1||下载程序、供电
|-
|喇叭||2||播放音频
|-
|MicroSD卡（可选） ||1||存储音乐文件
|-
|M2尼龙螺丝 ||8||固定
|-
|M2尼龙螺柱 ||4||固定
|-
|M2尼龙螺母 ||8||固定
|}
'''【图片需要更新，Core/Core+，排版】'''
[[File:音乐盒物料.jpg||600px|center]]
[[File:Musicmaterial.jpg||300px|center]]

==程序下载==
*音乐播放器代码Github:'''[https://github.com/Microduino/Simple_player_V2 Simple_Player_v2]'''

==程序烧写==
*将'''[[Microduino-Core/zh]]'''、'''[[Microduino-USBTTL/zh]]'''堆叠在一起。
**用数据线连接其中的'''[[Microduino-USBTTL/zh]]'''准备上传程序。
**注意：最好不要将所有模块堆叠在一起之后再上传程序
*打开Arduino IDE for Microduino,环境，（搭建参考：'''[[AVR核心：Getting started/zh]]'''）
*点击'''【工具】'''，确认'''板卡（Microduino-Core）处理器（Atmega328P@16M,5V）'''选择无误，并选中对应'''端口号(COMX)'''
*点击'''【文件】'''->'''【打开】'''，浏览到项目程序地址，点击'''“Simple_player_V2.ino”'''程序打开
*几项都无误后，点击'''"→"'''按钮下载程序到开发板上

==存储音频==
*音频文件需要提前储存在储存器，播放器就可以对其进行播放，有两种储存方式：
**模块板载FLASH：'''[[Microduino-Audio/zh]]'''板载了4MByte的FLASH
***音频存储方法请参考以下页面：'''[https://www.microduino.cn/wiki/index.php/Microduino-Module_Audio/zh#.E5.BC.80.E5.8F.91 音频下载]'''
**SD外扩容量:使用'''[[Microduino-Audio/zh]]'''模块的'''Shield'''进行'''MicroSD卡扩容'''
***SD卡最大支持32G容量

==搭建步骤==
*'''Step1'''
*按图1-1所示用'''尼龙螺丝'''和'''尼龙螺母'''将'''[[Microduino-OLED/zh]]'''固定在'''结构-A1'''上
*'''注意:'''注意OLED显示屏的安装方向，请以'''“Microduino”'''LOGO作为参考，LOGO位于'''正方向'''，说明安装方向正确。
[[File:Musicstep1-1.jpg||450px|center]]
*OLED显示屏安装完后，请将传感器线接入OLED背面的接口
[[File:Musicstep1-2.jpg||450px|center]]
*'''Step2'''
*按图2-1所示将'''结构-D1'''插入'''结构-B1'''的对应接口
[[File:Musicstep2-1.jpg||450px|center]]
*按图2-2所示将'''结构-C2'''插入'''结构-B1'''的对应接口
[[File:Musicstep2-2.jpg||450px|center]]
*步骤2完成后组成'''播放器骨架'''
[[File:Musicstep2-3.jpg||450px|center]]
*'''Step3'''
*按图3-1所示将'''喇叭'''嵌入如图位置，注意'''喇叭'''的安装方向，'''喇叭线'''需要提前穿到'''结构-B1'''后面
[[File:Musicstep3-1.jpg||450px|center]]
*按图3-2所示将安装好OLED显示屏的'''结构-A1'''拼到'''播放器骨架'''的前面，然后用'''结构-D3'''卡入'''结构-A1'''和'''结构-B1'''的卡槽内
[[File:Musicstep3-2.jpg||450px|center]]
*步骤3完成后播放器的正面已组装完成
[[File:Musicstep3-3.jpg||450px|center]]
*'''Step4'''
*按图4-1所示翻到播放器的背面，用'''结构-D2'''卡住'''结构-D3'''的卡槽
**注意用力均匀，避免用力过大折断，同时将2个'''喇叭'''线和OLED线从背面的过孔穿出来
[[File:Musicstep4-1.jpg||450px|center]]
*按图4-2所示用'''尼龙螺丝'''、'''尼龙螺柱'''和'''尼龙螺母'''将'''[[Microduino-Cube-S1/zh]]'''底板固定在'''结构-C2'''上
**注意'''[[Microduino-Cube-S1/zh]]'''底板上的USB口需要朝外
[[File:Musicstep4-2.jpg||450px|center]]
*步骤4完成组成图如下:
[[File:Musicstep4-3.jpg||450px|center]]
*'''Step5'''
*按图5-1所示将'''结构-C1'''插在播放器的背面
[[File:Musicstep5-1.jpg||450px|center]]
*按图5-2所示用'''结构-D4'''卡住'''结构-C1'''的边角，同时将2个'''喇叭'''线和OLED线从'''结构-C1'''的过孔穿出来
[[File:Musicstep5-2.jpg||450px|center]]
*按图5-3所示将以下模块叠加到'''[[Microduino-Cube-S1/zh]]'''底板上,注意提前将'''MicroSD卡'''安装到'''[[Microduino-Module Audio/zh]]'''的'''Shield'''模块上
**'''[[Microduino-Core/zh]]'''
**'''[[Microduino-Module Audio/zh]]'''
**'''[[Microduino-Module Amplifier/zh]]'''
[[File:Musicstep5-3.jpg||450px|center]]
*'''Step6'''
*按图6-1所示将OLED线接到到'''[[Microduino-Cube-S1/zh]]'''底板左侧的IIC接口（接口附近标有SCL,SDA字样）
*再将2个'''喇叭'''线接到'''[[Microduino-Module Amplifier/zh]]'''模块上的音频接口
[[File:Musicstep6-1.jpg||450px|center]]
*至此开源音乐播放器已搭建完成
[[File:Musicstep6-2.jpg||450px|center]]

==操作说明==
===播放器供电===
*按下图所示，将USB供电线接到'''[[Microduino-Cube-S1/zh]]'''底板的USB接口上
**USB供电可使用电脑USB口，USB充电器，移动电源等多种形式
[[File:Musicpower.jpg||600px|center]]

===播放器使用===
*在'''[[Microduino-Module Audio/zh]]'''的'''shield'''模块上有一个拨轮开关，可通关该拨轮开关控制音乐播放，控制方式如下
{|class="wikitable"
|-
|拨轮开关使用方式||功能
|-
|拨轮按一下||音乐播放和暂停切换
|-
|拨轮长按||播放模式切换，如循环播放，单曲播放等
|-
|拨轮左拨一下||切换到上一首播放
|-
|拨轮右拨一下||切换到下一首播放
|-
|拨轮左长拨||播放音量减少
|-
|拨轮右长拨||播放音量增加
|}
*播放器上电之后默认是选中SD卡的第一首歌曲，并处于暂停状态，可以按一下拨轮开始播放音乐
*播放器的音量范围是0~30，数字越大，音量越大，播放器默认选择音量20

==代码说明==
*在'''“userDef.h”'''文件是我们的配置文件
*以下代码可以设置拨轮开关的阈值
<source lang = "cpp">
#define PUSH_BUTTON    50
#define LEFT_BUTTON    100
#define RIGHT_BUTTON   200
</source>
*如果发生：只能增加音量不能减少音量，只能增加歌曲号不能减少歌曲号，或反之。
原因：“userDef.h”中拨轮开关阈值设定不合理。
{|class="wikitable"
|-
|波轮动作||A6实测电压(V)||对应编码(电压/5*1023)||阈值设定
|-
|Default||3.3||675.18||>600
|-
|向下 ||0||0||0~50
|-
|向左||1.6||327.36||150~400
|-
|向右 ||2.6||531.96||450~600
|}
请在“userDef.h”中更改阈值设定到拨轮的实际使用值

==视频==