DFRobot_MY9221SS LED驱动库

DFRobot_MY9221SS是基于MY9221SS芯片的LED驱动库，可以通过PWM调光控制LED灯，LED灯要求连接17V以内的电源供电
该库包含的功能有：单色灯及其常用亮灯方案，RGB灯混色、闪烁和亮度渐变，RGB灯常用亮灯方案，芯片模式设置，芯片级联控制，芯片每个输出引脚状态控制
该驱动支持级联，可以将多个驱动串联，驱动可级联，每次发送一组数据并锁存后，后一个驱动会继承前一个驱动的工作状态；每次发送N组数据再锁存后可以同时控制离主控最近的N个驱动。
每个驱动最多可控制4颗RGB灯，或12颗单色灯

Product Link （链接到英文商城）

SKU：产品名称

Table of Contents

• Summary
• Installation
• Methods
• Compatibility
• History
• Credits

Summary

• 控制12路单色LED灯的亮度
  
• 分别控制4路带RGB和12V电源引脚的LED灯闪烁、亮度和变色.
  
• 驱动可级联，每个驱动的每个引脚的恒流输出均可控.
  

Installation

To use this library, first download the library file, paste it into the \Arduino\libraries directory, then open the examples folder and run the demo in the folder.

Methods

  /**
   *@brief 构造函数
   */
  DFRobot_MY9221SS(void);

  /**
   *@brief 初始化
   *@param clockPin 时钟引脚
   *@param dataPin  数据引脚
   */
  void begin(uint32_t clockPin, uint32_t dataPin);

  /**
   *@brief 设置模式
   *@param temp 保留位元
   *@param hspd 输出电流反应速度选择
   *@param bs  灰阶选择
   *@param gck 内置灰阶时钟频率选择
   *@param sep 输出电流打散与不打散选择
   *@param osc 灰阶时钟频率来源选择
   *@param pol 输出电流极性选择
   *@param cntset 自动更换画面模式或强制更换画面模式选择
   *@param onest 画面重复显示或只亮一次选择
   */
  void setMode(uint8_t temp=0, uint8_t hspd=0, uint8_t bs=0,\
               uint8_t gck=0, uint8_t sep=1, uint8_t osc=0,\
               uint8_t pol=0, uint8_t cntset=0, uint8_t onest=0);

  /**
   *@brief 发送一组完整的数据，数组的元素从11到0分别控制引脚C0 B0 A0 C1 B1 A1 C2 B2 A2 C3 B3 A3
   *@param buf 12*2字节的数组的首地址
   */
  void write(uint16_t* buf);

  /**
   *@brief 发送锁存信号使所有驱动工作
   */
  void latch();

  /**
   * @brief 用宏定义指定LED灯，并通过RGB各分量控制颜色，向芯片发送一组完整的数据
   * @param ledNo 宏定义灯名，一共四路/颗灯，LED0~LED3
   * @param R     设置RGB红色分量，硬件应连接引脚B，8位灰阶数据模式时取值范围为0~255，16位时取值范围为0~65535
   * @param G     设置RGB绿色分量，硬件应连接引脚A，8位灰阶数据模式时取值范围为0~255，16位时取值范围为0~65535
   * @param B     设置RGB蓝色分量，硬件应连接引脚C，8位灰阶数据模式时取值范围为0~255，16位时取值范围为0~65535
  */
  void setRgbLed(uint8_t ledNo, uint16_t R, uint16_t G, uint16_t B);

  /**
   * @brief 用宏定义指定引脚并控制引脚上单色灯的亮度，向芯片发送一组完整的数据
   * @param pinNo      宏定义引脚名
   * @param brightness 亮度，8位灰阶数据模式时取值范围为0~255，16位时取值范围为0~65535
  */
  void setMonochromeLed(uint16_t pinNo, uint16_t brightness);

  /**
   * @brief 颜色随机，渐亮渐灭一次
  */
  void autoColorChange(void);

Compatibility

MCU	Work Well	Work Wrong	Untested	Remarks
Arduino uno	√
Mega2560	√
Leonardo	√
ESP32	√
ESP8266	√
FireBeetle-M0	√

History

• Data 2020-3-31
• Version V0.1

Credits

Written by(hangyu.ye@dfrobot.com), 2020. (Welcome to our website)