# DFRobot_ASR

**Repository Path**: dfrobot/DFRobot_ASR

## Basic Information

- **Project Name**: DFRobot_ASR
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-09-16
- **Last Updated**: 2022-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DFRobot_ASR
- [English Version](./README.md)

  让声音为您的项目增添一抹特色！连接上语音识别模块，再添加几行简单的码，您的项目就可以听懂您说的话。无
  需机器学习，无需特定人语音，无需联网，随时随地都可以进行语音识别，结合语音合成模块还可以实现语音对话。
  使用Gravity 
  I2C接口通信，兼容绝大部分主控，非常适合接入教育场景使用。三种语音识别模式和三种语音输入方式使模块可以集
  成入更多的场景。

![产品效果图片](./resources/images/DFR0715.png)


## 产品链接（https://www.dfrobot.com.cn/goods-3011.html）

    DFR0715：Gravity: I2C语音识别模块
   
## 目录

  * [概述](#概述)
  * [库安装](#库安装)
  * [方法](#方法)
  * [兼容性](#兼容性)
  * [历史](#历史)
  * [创作者](#创作者)

## 概述
  1.向语音识别模块添加词条,每一个词条会附带一个编号<br>
  2.当模块识别到添加的词条时,会返回对应的编号<br>
## 库安装
To use this library, please download the library file first, and paste it into the \Arduino\libraries directory, then open the examples folder and run the demo in the folder.

## 方法

```C++

  /**
   * @fn begin
   * @brief 初始化函数
   * @param mode 语音识别模式
   * @param miMode 麦克风模式
   * @return 返回0表示初始化成功，返回其他值表示初始化失败，返回错误码
  */
  int begin(eMode_t mode = LOOP,eMicrophoneMode_t miMode = MIC);
  
  /**
   * @fn start
   * @brief 语音模块开始识别.
   */
  void start();
   
  /**
   * @fn addCommand
   * @brief 向模块添加词条
   * @param words 代表词条的字符串
   * @param idNum 词条的识别号
   * @return Boolean type, the result of seted
   * @retval 添加词条成功
   * @retval 添加词条失败
   */
  bool addCommand( char *words, char idNum);
  
  /**
   * @fn setI2CAddr
   * @brief 设置模块的i2c地址(从新上电后生效)
   * @param addr 需要设置的i2c地址(0~127)
  */
  void setI2CAddr(uint8_t addr);
   
  /**
   * @fn read
   * @brief 读取识别到的词条.
   * @return 返回代表词条的识别号
  */
  int read();

```

## 兼容性
MCU                | Work Well    | Work Wrong   | Untested    | Remarks
------------------ | :----------: | :----------: | :---------: | -----
Arduino Uno        |      √       |              |             | 
FireBeetle-ESP8266        |      √       |              |             | 
FireBeetle-ESP32        |      √       |              |             | 
Arduino MEGA2560        |      √       |              |             | 
Arduino Leonardo|      √       |              |             | 
Micro:bit        |      √       |              |             | 
FireBeetle-M0        |      √       |              |             | 
Raspberry Pi      |      √       |              |             | 

## 历史

- 2029/8/25 - Version 1.0.0 released.

## 创作者

Written by fengli(li.feng@dfrobot.com), 2019.8.25 (Welcome to our [website](https://www.dfrobot.com/))