按一下，就读一首唐诗（你千万别体验）

随机唐诗按钮

按一下，就能随机读一首唐诗。

需要准备的

所需材料：

ESP8266
TTS 串口文字转语音模块
扬声器
按钮

所需工具：

电烙铁
windows 10 PC 电脑

所需软件：

arduino
python3

引用他人代码

本项目使用了如下项目及代码：

唐诗数据库

https://github.com/chinese-poetry/chinese-poetry/tree/master/json
json 到 sqlite 转换工具

https://github.com/animalize/QuanTangshi/blob/master/tools/ok_make_db.py

这是一个安卓项目，作者提供了一个转换工具。我在其基础上增加了繁体转简体。以及删掉了标题、内容中包含括号、书名号等字符的诗。
繁体转简体

https://github.com/skydark/nstools/tree/master/zhtools
flask 框架

https://palletsprojects.com/p/flask/

API 部分使用 flask 框架。
arduino 的 esp8266 支持库

在 arduino 的首选项中，增加如下内容：
```
https://arduino.esp8266.com/stable/package_esp8266com_index.json
```
打开开发板管理器，搜索 esp8266 并安装。
wifimanager

能让 arduino 方便配网的库。可自定义热点名称。连接后输入 192.168.4.1 进行配网，从而让 esp8266 可以联网。

打开库管理器，搜索 wifimanager tzapu，按照下图所示，点击安装。

项目实施

克隆本项目，进入 api/json2sqlite 目录，执行 python3 get.py 把 json 数据库转为 sqlite。

然后到 api 目录，执行 python3 web.py 开启服务。

git clone https://github.com/my-products/tangshi.git
cd tangshi
cd api
cd json2sqlite
python3 get.py
cd ..
python3 web.py

访问 http://localhost:5000/json 可以随机获得一首唐诗（ json 格式）

为了方便语音合成，还可以访问 http://localhost:5000/text/utf8 随机获得一首唐诗（纯文本格式）。

使用 arduino 打开目录 arduino\tangshi，tangshi.ino 是源代码。打开后直接使用 arduino 烧录即可。

如果你懒得打开那个文件，这里直接粘贴出源码：


#include <ESP8266WiFi.h>
#include <DNSServer.h>
#include <ESP8266WebServer.h>
#include <WiFiManager.h>
#include <ESP8266HTTPClient.h>

WiFiManager wifiManager;
HTTPClient http;
const unsigned long HTTP_TIMEOUT = 5000;
int buttonState = 0;
String response;
int button_pin = D4;//触发按钮
char const *ap_name = "TangshiAP";//ap name
boolean debug_mode = false;//debug?
String debug_wifi_name = "chinaunion";
String debug_wifi_pass = "chinaunion";
//由于 tts 语音模块需要 ansi 编码。故，每次串口输出都需经过转码。可用 python3 的.encode("gbk")来实现

void setup() {
  //  Serial.swap();//调用映射方法 GPIO1(TX),GPIO3(RX)   不调用，同样可用，因为是 TX0/RX0。调用后，arduino 监控台无输出。
  pinMode(button_pin, INPUT_PULLUP);
  if (debug_mode) {
    WiFi.mode(WIFI_STA);
    WiFi.begin(debug_wifi_name, debug_wifi_pass);
    WiFi.setAutoConnect(true);
  } else {
    wifiManager.autoConnect(ap_name);
  }
  while (WiFi.status() != WL_CONNECTED) {
    delay(1000);
  }
  Serial.begin(9600);
  Serial.println("\xcd\xf8\xc2\xe7\xc1\xac\xbd\xd3\xb3\xc9\xb9\xa6");//网络连接成功
  http.begin("http://106.12.133.66:5000/text/gbk");
  http.setTimeout(HTTP_TIMEOUT);
  http.setUserAgent("esp8266");//用户代理版本
  //  http.setAuthorization("esp8266","123456");//用户校验信息
}

void loop() {
  buttonState = digitalRead(button_pin);
  if (buttonState == LOW) {
    Serial.printf("\xd5\xfd\xd4\xda\xc7\xeb\xc7\xf3 API");//正在请求 API
    int httpCode = http.GET();
    Serial.println( httpCode);
    if ( httpCode == HTTP_CODE_OK) {
      response = http.getString();
      Serial.println(response);//输出内容
    } else {
      Serial.printf("API \xc1\xac\xbd\xd3\xca\xa7\xb0\xdc");//API 连接失败
    }
    http.end();
    delay(5000);
  }
}

tangshi.ino.nodemcu.bin 是生成的二进制。如果你想直接用，可以使用 esp8266 的烧录工具直接烧录。烧录地址，0x00。烧录工具：乐鑫官方地址下载 https://www.espressif.com/sites/default/files/tools/flash_download_tools_v3.6.7.zip

直接使用乐鑫烧录时，需要注意的是，在需要做配置的地方，参考 arduino 的参数即可：

该固件中，API 调用的 http://106.12.133.66:5000/text/gbk 是我临时的服务器地址，没准儿什么时候会停止，所以建议大家还是使用自己的 API。

坑

然而，utf8 格式的文本，tts 语音合成模块竟然不认。去卖家店铺看了一下详细说明，发现这个模块支持的是 ansi 编码。

解决的方法有两种，可以在 arduino 上面让 tts 模块读出汉字。

方法 1

ino 源文件以 ansi 编码保存。

这种方法不好。arduino 再编辑，又是 utf8 格式的。除非你每次烧录前用记事本保存为 ansi 格式，使用 arduino 别点击保存，直接烧录。

方法 2

输出 ansi 编码给串口。使用 python3，在控制台可以通过.encode("ansi")进行转换。但是，linux 下似乎无效，提示找不到这个 ansi 编码。在 linux 下，可以使用.encode("gbk")来获得 ansi 字符。

所以，API 也提供了 ansi 和 gbk 两种方式调用。如访问 http://localhost:5000/text/gbk 随机获得一首唐诗（ gbk 格式）。

流程

按钮会触发一个低电平，ESP8266 得到这个触发事件，去调用 API 获得一首随机唐诗，直接给转到串口，这时 TTS 就工作了。

硬件连接

ESP8266 的针脚如图所示：

TTS_B719 的背面很清晰，按照标识连接即可。黄色框选处连接 TTS_B719 的电源，红色框选处连接 TTS_B719 的串口。蓝色框选处连接按钮。

需要注意的是：

ESP8266 的 TX 要连接 TTS_B719 的 RX。ESP8266 的 RX 要连接 TTS_B719 的 TX。
按钮是低电平触发，按钮焊接 D4 和 ESP8266 上随便找个 GND 即可。

演示

https://github.com/my-products/tangshi/raw/master/readme-images/demo.mp4

最后，千万别用这玩意儿，破声音，听着头疼。