Chain Angle

AngleChain 是用于 Chain 总线上角度传感器设备的辅助类。它提供了以不同分辨率（12 位和 8 位 ADC）读取角度值以及配置顺时针旋转方向的方法。

支持以下产品：

UiFlow2 示例

角度读取与 RGB 亮度控制

在 UiFlow2 中打开 m5core_chain_angle_basic_example.m5f2 项目。

此示例演示如何从 Chain 角度传感器读取角度值，并根据角度值控制 RGB 亮度。该示例读取 8 位 ADC 值（0-255）并将其映射到亮度值（0-100）以提供视觉反馈。

UiFlow2 代码块：

示例输出：

无

MicroPython 示例

角度读取与 RGB 亮度控制

此示例演示如何从 Chain 角度传感器读取角度值，并根据角度值控制 RGB 亮度。该示例读取 8 位 ADC 值（0-255）并将其映射到亮度值（0-100）以提供视觉反馈。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
from chain import ChainBus
from chain import AngleChain
import time
import m5utils


title0 = None
label_brightness = None
label_val = None
bus2 = None
chain_angle_0 = None
last_time = None
value = None
brightness = None


def setup():
    global title0, label_brightness, label_val, bus2, chain_angle_0, last_time, value, brightness
    M5.begin()
    Widgets.setRotation(1)
    Widgets.fillScreen(0x222222)
    title0 = Widgets.Title("Chain Angle Example", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu24)
    label_brightness = Widgets.Label(
        "Brightness: ", 5, 117, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu24
    )
    label_val = Widgets.Label("Value:", 5, 69, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu24)
    bus2 = ChainBus(2, tx=21, rx=22)
    chain_angle_0 = AngleChain(bus2, 1)
    chain_angle_0.set_rgb_color(0x00CCCC)


def loop():
    global title0, label_brightness, label_val, bus2, chain_angle_0, last_time, value, brightness
    M5.update()
    if (time.ticks_diff((time.ticks_ms()), last_time)) >= 100:
        last_time = time.ticks_ms()
        value = chain_angle_0.get_adc8()
        brightness = int(m5utils.remap(value, 0, 255, 0, 100))
        label_val.setText(str((str("Value: ") + str(value))))
        label_brightness.setText(str((str("Brightness: ") + str(brightness))))
        chain_angle_0.set_rgb_brightness(brightness, save=False)


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            bus2.deinit()
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

无

API

AngleChain

class chain.angle.AngleChain(bus, device_id)

基类：KeyChain

用于通过 Chain 总线与角度设备交互的 Angle Chain 类。

参数:

bus (ChainBus) – Chain 总线实例。
device_id (int) – Chain 总线上角度传感器的设备 ID。

UiFlow2 代码块：

MicroPython 代码块：

from chain import ChainBus
from chain import AngleChain

chainbus_0 = ChainBus(2, 32, 33, verbose=True)
angle_0 = AngleChain(chainbus_0, 1)

有关其他按钮和一些通用方法，请参考 ChainKey 类。

get_adc12()

获取 12 位 ADC 分辨率的角度值。

返回:: 12 位 ADC 角度值（0-4095），失败时返回 None。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

angle = angle_0.get_adc12()

get_adc8()

获取 8 位 ADC 分辨率的角度值。

返回:: 8 位 ADC 角度值（0-255），失败时返回 None。
返回类型:: int

UiFlow2 代码块：

MicroPython 代码块：

angle = angle_0.get_adc8()

set_cw_increase(increase=True, save=False)

设置顺时针旋转是否增加角度值。

参数:

increase (bool) – 顺时针旋转是否增加。False 表示顺时针减少，True 表示顺时针增加。
save (bool) – 是否保存到 Flash。False 表示不保存，True 表示保存。

返回:

设置成功返回 True，否则返回 False。

返回类型:

bool

UiFlow2 代码块：

MicroPython 代码块：

success = angle_0.set_cw_increase(True, False)

get_cw_increase()

获取顺时针旋转是否增加角度值。

返回:: 顺时针旋转是否增加。False 表示顺时针减少，True 表示顺时针增加。失败时返回 False。
返回类型:: bool

UiFlow2 代码块：

MicroPython 代码块：

increase = angle_0.get_cw_increase()