# DFRobot_GP8XXX

**Repository Path**: dfrobot/DFRobot_GP8XXX

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-06-15
- **Last Updated**: 2023-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DFRobot_GP8XXX
* [English Version](./README.md)

GP8XXX 系列在Arduino IDE 上的驱动库（目前已经兼容GP8101，GP8211S，GP8413，GP8501，GP8503，GP8512，GP8403，GP8302）

## 产品链接([www.dfrobot.com](www.dfrobot.com))

SUK：

1. DFR1034 --- GP8503
2. DFR1035 --- GP8512
3. DFR1036 --- GP8101S
4. DFR1037 --- GP8501
5. DFR1071 --- GP8211S
6. DFR1073 --- GP8413
7. DFR0971 --- GP8403
8. DFR0972 --- GP8302

## 目录

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

## 概述

  此库已经争对目前兼容的6款产品分别提供了示例demo,用户可以根据名称进行对应使用

## 库安装

这里有2种安装方法：
1. 使用此库前，请首先下载库文件，将其粘贴到\Arduino\libraries目录中，然后打开examples文件夹并在该文件夹中运行演示。
2. 直接在Arduino软件库管理中搜索下载 DFRobot_GP8XXX 库

## 方法

```C++

/**************************************************************************
                                  PWM 系列
 **************************************************************************/

	/**
     * @fn begin
     * @brief 初始化函数
     * @return 0
     */
    int begin();

    /**
     * @fn setDACOutVoltage
     * @brief 设置不同通道输出DAC值
     * @param data pwm 脉宽
     * @param channel 输出通道
     * @n  0:通道0  (配置PWM0输出时有效)
     * @n  1:通道1  (配置PWM1输出时有效)
     * @n  2:全部通道 (配置双通道输出时有效)
     * @return NONE
     */
    void setDACOutVoltage(uint16_t data, uint8_t channel=0);

/**************************************************************************
                                  I2C 系列
 **************************************************************************/
    /**
     * @fn begin
     * @brief 初始化函数
     * @return 返回0表示成功，其他值表示失败 
     */
    int begin(void);

    /**
     * @fn setDACOutRange
     * @brief 设置DAC输出范围
     * @param range DAC输出范围
     * @n     eOutputRange0_5V(0-5V)
     * @n     eOutputRange0_10V(0-10V)
     * @return NONE
     */	
    void setDACOutRange(eOutPutRange_t range);

    /**
     * @fn setDACOutVoltage
     * @brief 设置不同通道输出DAC值
     * @param data 电压值对应的数据值
     * @param channel 输出通道
     * @n  0:通道0  (配置PWM0输出时有效)
     * @n  1:通道1  (配置PWM1输出时有效)
     * @n  2:全部通道 (配置双通道输出时有效)
     * @return NONE
     */
    void setDACOutVoltage(uint16_t data, uint8_t channel=0);
	
    /**
     * @fn store
     * @brief 将设置的电压保存在芯片内部
     * @return NONE
     */
    void store(void);

```

## 兼容性

主板               | 通过          | 未通过      | 未测试   | 备注
------------------ | :----------: | :----------: | :---------: | -----
Arduino Uno        |       √       |              |             | 
Mega2560           |      √       |              |             | 
Leonardo           |      √       |              |             | 
ESP32              |      √       |              |             | 
ESP8266            |      √       |              |             | 
micro:bit          |      √       |              |             | 
FireBeetle M0      |      √       |              |             | 


## 历史

- 2023/5/10 - 1.0.0 版本

## 创作者

- Written by fary( feng.yang@dfrobot.com), 2023. (Welcome to our [website](https://www.dfrobot.com/))