查看“13.3inch Magic Mirror”的源代码

<div class="tabber">
<div class="tabbertab" title="说明">
{{外围模块|colorscheme=blue
|name = 13.3inch HDMI LCD (H)
|img=<div class="tabber"><div class="tabbertab" title="标准版">[[File:13.3inch-HDMI-LCD-H-with-Holder-intro.jpg|360px |alt=13.3inch HDMI LCD (H) (带外壳)|link=http://{{SERVERNAME}}/shop/13.3inch-HDMI-LCD-H-with-Holder.htm | 13.3inch HDMI LCD (H) (带外壳)]]</div>
<div class="tabbertab" title="V2版本">[[File:13.3inch-HDMI-LCD-H-with-Holder-V2-1.jpg|360px |alt=13.3inch HDMI LCD (H) (带外壳) V2|link=http://{{SERVERNAME}}/shop/13.3inch-HDMI-LCD-H-with-Holder-V2.htm | 13.3inch HDMI LCD (H) (带外壳) V2]]</div>
</div>
|category1=树莓派LCD
|category2=树莓派
|category3=IPS
|category4=电容屏
|category5=显示屏
|brand=Waveshare
|feature = 13.3寸树莓派电容屏 免驱 多系统支持
|feature-name1= 分辨率
|feature-value1= 1920×1080
|feature-name2= 适用范围
|feature-value2= 树莓派,BB Black,Banana Pi...
| interface1 =USB
| interface2 =HDMI
| Product1 = [http://{{SERVERNAME}}/shop/13.3inch-HDMI-LCD-H-with-Holder.htm 13.3inch HDMI LCD (H) (带外壳)]
}}
=='''产品概述'''==
本产品是通用HDMI显示屏，1920x1080超清分辨率，带钢化玻璃电容触摸面板。 支持树莓派和各种mini PC，也可以当成计算机显示器。

==''' 产品特点''' ==
*IPS屏，1920×1080超清分辨率
*钢化玻璃电容触摸面板，硬度达6H
*支持Raspberry Pi、BB Black等主流mini PC
*配合Raspberry Pi使用时，支持Raspbian / Ubuntu / Kali / Retropie和WIN10 IoT，免驱
*作为计算机显示器使用时，支持Windows 10 / 8.1 / 8 / 7，十点触控，免驱
*支持多国语言OSD菜单（可用于电源控制，调节亮度/对比度等）
*带3.5mm音频接口，支持HDMI音频输出
*内置黑磁高保真喇叭（无需外接音箱）
*支持VGA输入（需另配VGA转接线）
*支持通用的挂壁架，背面有75×75mm的挂壁固定孔(M4螺丝孔)
*自带75°倾斜角度支架

== '''如何使用''' ==
您可以通过两种方法使用	Magic Mirros：方法一，使用预配置的镜像。方法二，在树莓派原始镜像上配置环境运行程序。

<font color=#FF0000>新手或者首次安装推荐安装预配置的镜像，预配置镜像已安装需要的库和驱动，程序开机自动运行。</font>

=== '''方法一，使用预配置的镜像''' ===
:1) 这里提供预配置的镜像，解压并把镜像写入到TF卡中（打开[http://www.waveshare.net/w/upload/7/76/Win32DiskImager.zip Win32DiskImager.exe]软件，选择.img文件，点击「write」烧写镜像）。
*[https://pan.baidu.com/s/19XFYXDQANJHTybPrQ2Wwsw  Pi2/Pi3/Pi3+启动镜像]------------提取码：c16g
:2) 烧写完成后，把卡插入树莓派上，连接上网线，打开电源开关。正常就会启动系统了。
:3) 魔镜支持中英文语音对话，中文采用科大讯飞的AIUI ，英文采用Google Assistant Service，搭载Snowboy唤醒词检测引擎。
:程序默认有两个唤醒词"魔镜魔镜"和"snowboy"。使用“魔镜魔镜”唤醒会识别为中文调用科大讯飞API。使用“snowboy”唤醒会识别为英文调用Google Assistant API。
:注意：镜像中snowboy唤醒采用的是私有模型，只对作者本人有效。其他用户需要到snowboy官方注册账号训练自己的模型。
:snowboy:https://snowboy.kitt.ai/
:科大讯飞AIUI:https://aiui.iflyos.cn/index-aiui
:Google Assistant:https://developers.google.com/assistant/sdk/guides/service/python

=== '''方法二，在树莓派原始镜像上配置环境运行程序(非专业人士可以跳过)''' ===
==1.安装树莓派镜像==
: 1）将树莓派镜像写入到TF卡中，在TF卡更目录下新建一个名为SSH的空白文件开启SSH,编辑TF卡根目录下的config.txt文件设置屏幕分辨率。在config.txt文件末尾添加：
<pre>
hdmi_group=2
hdmi_mode=82
hdmi_cvt 1920 1080 60 6 0 0 0
</pre>
: 必须确保等号两边没有空格。
: 2) 保存并将TF卡插入树莓派, Magic Mirror接上网线，树莓派上电后正常等待几秒后可正常显示。
: 3)树莓派正常启动后可以通过鼠标键盘操作,也可以通过SSH或VNC操作。

==2.安装WM8960声卡驱动==
:请勿切换软件源，切换了软件源可能会安装失败，需要重新烧录镜像<br />
<pre>
git clone https://github.com/waveshare/WM8960-Audio-HAT
cd WM8960-Audio-HAT
#需要等待一定的时间
sudo ./install.sh 
sudo reboot
</pre>

:编辑/boot/config.txt,注释掉默认音频
<pre>
#dtparam=audio=on
</pre>

:重启后运行如下命令看下驱动是否加载成功。<br />
<pre>
pi@raspberrypi:~ $ sudo dkms status 
wm8960-soundcard, 1.0, 4.19.58-v7l+, armv7l: installed
</pre>

:检测声卡
*检查播放：aplay -l
<pre>
pi@raspberrypi:~ $ aplay -l
**** List of PLAYBACK Hardware Devices ****
card 0: wm8960soundcard [wm8960-soundcard], device 0: bcm2835-i2s-wm8960-hifi wm8960-hifi-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0
</pre>

*检查录音：arecord -l 
<pre>
pi@raspberrypi:~ $ arecord -l
**** List of CAPTURE Hardware Devices ****
card 0: wm8960soundcard [wm8960-soundcard], device 0: bcm2835-i2s-wm8960-hifi wm8960-hifi-0 []
  Subdevices: 1/1
  Subdevice #0: subdevice #0
</pre>

==3.安装Magic Mirror==
<pre>
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs
git clone https://github.com/MichMich/MagicMirror
cd MagicMirror/
npm install
</pre>

:安装成功后运行如下命令显示
<pre>
DISPLAY=:0 npm start
</pre>
:屏幕显示如图
:[[File:MgicMirror-1.png|300px]]

==4.安装Python3虚拟环境==
<pre>
sudo apt-get update
sudo apt-get install python3-dev python3-venv
python3 -m venv env
env/bin/python -m pip install --upgrade pip setuptools wheel
source env/bin/activate
</pre>
:注意：之后的所有操作都是在虚拟环境中进行，重新打开终端需运行如下命令进入到虚拟环境中。
<pre>
source ~/env/bin/activate
</pre>
==5.snowboy 安装==
:安装依赖库
<pre>
sudo apt-get install swig
sudo apt-get install libatlas-base-dev
sudo apt-get install portaudio19-dev
sudo apt-get install flac
pip3 install PyAudio
pip3 install SpeechRecognition

</pre>
:下载编译snowboy
<pre>
git clone https://github.com/Kitt-AI/snowboy.git
cd snowboy/swig/Python3
make
cd ../../examples/Python3
</pre>
:修改snowboydecoder.py文件,将from . import snowboydetect 改为 import snowboydetect，去掉 from .

==Google Assistant Service 安装==
注意：在中国，无法直接使用Google的服务。需要科学上网，必须搭建可以访问google的路由器，然后树莓派连接到路由器。
注意：自2019年6月28日起，不再支持Python的Google Assistant Library 。只能用 Google Assistant Service。

:在主目录(/home/pi)中新建 .asoundrc 文件，确保Google Assistant可以使用正确的麦克风和扬声器。
<pre>
nano .asoundrc
</pre>
:新建 .asoundrc文件，将以下配置添加到文件中保存。
<pre>
pcm.!default {
  type asym
  capture.pcm "mic"
  playback.pcm "speaker"
}
pcm.mic {
  type plug
  slave {
    pcm "hw:0,0"
  }
}
pcm.speaker {
  type plug
  slave {
    pcm "hw:0,0"
  }
}
</pre>

在开始使用Google Assistant之前,需要将Google Assistant Service 安装到树莓派中。以下是Google官方指导的链接。
请根据指南第三步，配置开发人员项目和配置账户，并创建一个OAuth Client ID JSON文件。 不要忘记将JSON文件复制到您的Raspberry Pi。
请根据指南第四步，注册设备模型。

安装Google Assistant SDK
<pre>
(env) $ sudo apt-get install portaudio19-dev libffi-dev libssl-dev
(env) $ python -m pip install --upgrade google-assistant-sdk[samples]
</pre>

授权Google Assistant SDK
安装或更新授权工具
<pre>
(env) $ python -m pip install --upgrade google-auth-oauthlib[tool]
</pre>
生成凭据以能够运行示例代码和工具。引用您在上一步中下载的JSON文件 ；您可能需要将其复制到设备。不要重命名该文件。
<pre>
(env) $ google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
      --save --headless --client-secrets /path/to/client_secret_ client-id .json
</pre>
可以在终端中看到一个URL：
<pre>
Please visit this URL to authorize this application: https://...
</pre>
复制URL并将其粘贴到浏览器中（可以在任何计算机上完成）。该页面将要求您登录您的Google帐户。登录到上一步中创建开发人员项目的Google帐户 。
从API批准许可请求后，浏览器中将显示一个代码，例如“ 4 / XXXX”。将此代码复制并粘贴到终端中：
<pre>
Please go to this URL: https://...
Enter the authorization code:
</pre>
如果授权成功，您将看到类似于以下的响应。如果您看到InvalidGrantError，则输入了无效的代码。请重试，请小心复制并粘贴整个代码。
<pre>
credentials saved: /path/to/.config/google-oauthlib-tool/credentials.json
</pre>
运行如下命令测试
my-dev-project为创建的Actions Console项目的Google Cloud Platform项目ID。要在Actions Console中找到项目ID 、
my-model为在上一步中注册设备模型的名称。
<pre>
googlesamples-assistant-pushtotalk --project-id my-dev-project --device-model-id my-model
</pre>
按Enter键，然后尝试以下一些查询
Who am I?
What time is it?
正常情况Google Assitant 会回应。
==设置开机启动==
安装PM2
<pre>
sudo npm install -g pm2
</pre>
设置PM2开机启动
<pre>
pm2 startup
</pre>
运行此命令后会显示一个类似如下的命令，复制此命令到终端运行。
<pre>
[PM2] To setup the Startup Script, copy/paste the following command:
sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u pi --hp /home/pi
</pre>
创建MagicMirror 开机脚本
<pre>
cd MagicMirror/modules/MMM-VoiceAssistant/pi
nano mm.sh
</pre>
添加如下语句
<pre>
cd ~/MagicMirror
DISPLAY=:0 npm start
</pre>
添加可执行属性
<pre>
chmod +x mm.sh
</pre>
使用PM2启动MagicMirror
<pre>
pm2 start mm.sh
</pre>

==显示屏幕常亮==
打开 lightdm.conf<br />
<pre>
sudo vi /etc/lightdm/lightdm.conf
</pre>
修改 lightdm.conf
找到[SeatDefaults]段下的’xserver-command’,取消注释,修改为如下:
<pre>
#xserver-command=X
</pre>
修改为
<pre>
xserver-command=X -s 0 -dpms
</pre>
*-s # –设置屏幕保护不启用
*dpms 关闭电源节能管理
重启<br />
<pre>
sudo reboot
</pre>

== '''按键介绍 '''==
[[File:13.3inch-HDMI-LCD-H-Manual-02.jpg|150px]]
*1：打开或关闭LCD显示，如长时间不使用LCD，可通过该按键关闭LCD显示，以降低功耗。
*2：方向键
*3：确定功能
*4：打开菜单和返回功能
</div>
<div class="tabbertab" title="资料">

==视频==
*[[13.3inch-HDMI-LCD-H-Video|演示视频]][[File:video-logo.png|23px|link=13.3inch-HDMI-LCD-H-Video]]
==3D 图纸==
*[[:File:13.3inch HDMI LCD 3D file.rar | 13.3inch HDMI LCD 3D 图纸]]

==软件==
*[http://www.waveshare.net/w/upload/5/56/Putty.zip putty]
*[http://www.waveshare.net/w/upload/d/d7/Panasonic_SDFormatter.zip Panasonic_SDFormatter-SD卡格式化软件]
*[http://www.waveshare.net/w/upload/7/76/Win32DiskImager.zip Win32DiskImager-烧录镜像软件]
==其他教程==
*[http://www.waveshare.net/w/upload/a/a2/Working_with_volumio_cn.pdf 安装使用Volumio系统]
==教程==
*[[RPI-LCD_Datasheets|开发教程]]
{{Raspberry Pi Study}}
==认证资料==
*[http://www.waveshare.net/w/upload/4/46/13.3inch_HDMI_LCD_%28H%29_Certification.rar CE RoHS]
<br /><big>批量下载教程——请戳<big><big><big>☛</big></big></big></big>[[File:download-icon.png|link=批量下载教程]]

<!--{{Join_us}}-->
</div>
<div class="tabbertab" title="FAQ"><br />
{{RPI-HDMI-LCD-FAQ}}

{{FAQ|13.3inch HDMI LCD (H)正常工作的工作电流是？|
13.3inch HDMI LCD (H) 一共通过两部分取电，一个是POWER接口，该接口需要接入12V 1A电源适配器，正常工作时工作电流大约是12V 0.6A。

另一个是TOUCH接口，该接口一般需要接到主机的USB接口，通过USB接口取电，工作电流大约是5V 80mA。
|||}}

</div>
<div class="tabbertab" title="售后"><br />{{Service13}}</div>