Unit Joystick2

案例程序

from m5stack import *
from m5ui import *
from uiflow import *
import unit

joystick2_0 = unit.get(unit.JOYSTICKV2, unit.PORTA)

joystick2_0.init_i2c_address(0x63)
joystick2_0.set_led_brightness(50)
while True:
  print(joystick2_0.get_axis_position())
  print(joystick2_0.get_x_position())
  print(joystick2_0.get_y_position())
  print(joystick2_0.get_adc_value())
  print(joystick2_0.get_x_raw())
  print(joystick2_0.get_y_raw())
  print(joystick2_0.get_button_status())
  print(joystick2_0.get_firmware_version())
  wait_ms(2)

功能说明

joystick2_0.init_i2c_address(0x63)

• 设置操纵杆模块的I2C地址。地址范围为 0x08 到 0x77，默认值为 0x63。

joystick2_0.get_axis_position()

• 获取操纵杆的当前位置（X 和 Y 坐标），返回一个元组。

joystick2_0.get_x_position()

• 获取操纵杆的 X 轴位置值。

joystick2_0.get_y_position()

• 获取操纵杆的 Y 轴位置值。

joystick2_0.get_adc_value()

• 获取操纵杆的 X 和 Y 轴的 ADC 值（模拟值），返回一个元组。

joystick2_0.get_x_raw()

• 获取操纵杆的 X 轴 ADC 值。

joystick2_0.get_y_raw()

• 获取操纵杆的 Y 轴 ADC 值。

joystick2_0.get_button_status()

• 获取操纵杆按键的状态。如果按下，返回 True；否则返回 False。

joystick2_0.get_firmware_version()

• 获取操纵杆模块的固件版本，返回一个整数值。

joystick2_0.set_axis_x_invert(True)

• 反转 X 轴方向。设置为 True 时，X 轴输出值将被反转。

joystick2_0.set_axis_y_invert(True)

• 反转 Y 轴方向。设置为 True 时，Y 轴输出值将被反转。

joystick2_0.set_axis_swap(True)

• 交换 X 轴和 Y 轴的输出值。设置为 True 时，X 和 Y 轴数据将互换。

joystick2_0.set_deadzone_position(0, 0)

• 设置操纵杆位置的死区范围。死区内的值会被视为中心位置，避免噪声干扰。参数范围为 0 到 4096。

joystick2_0.set_deadzone_adc(0, 0)

• 设置操纵杆 ADC 值的死区范围。参数范围为 0 到 32768。

joystick2_0.fill_color(0xff0000)

• 设置操纵杆 LED 的填充颜色（如模块上的指示灯颜色）。

joystick2_0.set_led_brightness(50)

• 设置操纵杆 LED 的亮度，范围为 0% 到 100%。

joystick2_0.set_i2c_address(0x63)

• 改变操纵杆模块的 I2C 地址。用于在多模块环境下避免地址冲突。

joystick2_0.set_axis_x_mapping(0, 0, 0, 0)

• 设置 X 轴的映射参数：
  • Min negative ADC value: X 轴负向最小 ADC 值（最左或最下）。
  • Max negative ADC value: X 轴负向最大 ADC 值。
  • Min positive ADC value: X 轴正向最小 ADC 值（最右或最上）。
  • Max positive ADC value: X 轴正向最大 ADC 值。

joystick2_0.set_axis_y_mapping(0, 0, 0, 0)

• 设置 Y 轴的映射参数：
  • Min negative ADC value: Y 轴负向最小 ADC 值（最左或最下）。
  • Max negative ADC value: Y 轴负向最大 ADC 值。
  • Min positive ADC value: Y 轴正向最小 ADC 值（最右或最上）。
  • Max positive ADC value: Y 轴正向最大 ADC 值。