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

随机唐诗按钮

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

需要准备的

所需材料：

1. ESP8266

2. TTS 串口文字转语音模块

   

3. 扬声器

4. 按钮

所需工具：

1. 电烙铁
2. windows 10 PC 电脑

所需软件：

1. arduino
2. python3

引用他人代码

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

1. 唐诗数据库

   https://github.com/chinese-poetry/chinese-poetry/tree/master/json

2. json 到 sqlite 转换工具

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

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

3. 繁体转简体

   https://github.com/skydark/nstools/tree/master/zhtools

4. flask 框架

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

   API 部分使用 flask 框架。

5. arduino 的 esp8266 支持库

   在 arduino 的首选项中，增加如下内容：

   https://arduino.esp8266.com/stable/package_esp8266com_index.json
   

   打开开发板管理器，搜索 esp8266 并安装。

   

6. 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 的串口。蓝色框选处连接按钮。

需要注意的是：

1. ESP8266 的 TX 要连接 TTS_B719 的 RX。ESP8266 的 RX 要连接 TTS_B719 的 TX。

2. 按钮是低电平触发，按钮焊接 D4 和 ESP8266 上随便找个 GND 即可。

演示

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

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