跳转到主要内容

用于Pimoroni发明者HAT迷你板的库

项目描述

发明者HAT迷你

Build Status Coverage Status PyPi Package Python Versions

一款适用于Raspberry Pi的多功能电机、伺服和音频驱动HAT。让你的机械发明、创作和装置栩栩如生!

购买链接: https://shop.pimoroni.com/products/inventor-hat-mini

获取库

稳定库(无示例)来自PyPi

  • 只需运行 sudo python3 -m pip install inventorhatmini

这将在root用户下安装库。这是使用发明者HAT迷你板的RGB LED所必需的,这些LED依赖于rpi_ws281x包

在某些情况下,您可能需要使用以下命令安装pip:sudo apt install python3-pip

稳定库,包含GitHub上的最新示例

  • git clone https://github.com/pimoroni/inventorhatmini-python
  • cd inventorhatmini-python
  • ./install.sh

来自GitHub的最新/开发库和示例

  • git clone https://github.com/pimoroni/inventorhatmini-python
  • cd inventorhatmini-python
  • ./install.sh --unstable

配置你的Raspberry Pi

启用I2C

为了使用Inventor HAT Mini的电机、伺服和IO功能,您需要启用Raspberry Pi的I2C接口。这可以在终端中通过运行以下命令来完成:

  • sudo raspi-config nonint do_i2c 0

或者,您可以通过以下方式启用I2C接口:

  • 运行 sudo raspi-config 并在 接口选项 下启用选项。
  • 首选项 菜单打开图形化的 Raspberry Pi配置 应用程序。

启用I2C后,您可能需要重启系统以使更改生效。

增加I2C波特率

为了充分利用Inventor HAT Mini,建议您使用比默认的100KHz更高的I2C波特率来运行Raspberry Pi。这可以通过修改Pi的配置文件来实现。为此,运行 sudo nano /boot/config.txt 以打开终端文本编辑器。

在编辑器中导航到行 dtparam=i2c_arm=on。如果该行显示为 off 或用 # 注释,请利用这个机会将其更改。现在在它下面插入以下行, dtparam=i2c_baudrate=400000 以增加波特率。

完成文件修改后,按键盘上的 CTRL+X,然后当提示 Save modified buffer? 时按 Y

修改后重启系统以使更改生效。

启用音频

要使用Inventor HAT Mini的音频输出,您需要修改Pi的配置文件。为此,运行 sudo nano /boot/config.txt 以打开终端文本编辑器。

在编辑器中导航到文件底部,包括行 dtoverlay=hifiberry-dacgpio=25=op,dh。第一行将音频切换为使用Pi的GPIO引脚进行音频输出,第二行将使Pi在启动时启用音频输出,通过将引脚BCM 25设置为高电平。然后导航到行 dtparam=i2s=on。如果该行显示为 off 或用 # 注释,取消注释并更改为 on

根据您的设置,您可能还需要禁用Pi的其他音频输出(例如HDMI上的音频)。在文件中查找对 dtparam=audio=on 的任何现有提及,并将其更改为 dtparam=audio=off。可能存在 dtoverlay=vc4-kms-v3d 的行。将其修改为 dtoverlay=vc4-kms-v3d,noaudio

完成文件修改后,按键盘上的 CTRL+X,然后当提示 Save modified buffer? 时按 Y

修改后重启系统以使更改生效。

示例和用法

有许多示例可以帮助您开始使用Inventor HAT Mini。在Raspberry Pi上安装库后,这些示例可以在 ~/Pimoroni/inventorhatmini/examples 目录中找到。有关每个示例功能的详细信息,请参阅 示例readme

要进一步了解Inventor HAT Mini,完整API描述可以在 库参考 中找到。

移除库

仅移除库(保留所有示例)

  • 只需运行 sudo python3 -m pip uninstall inventorhatmini

或者如果您已从Github获取库

  • cd inventorhatmini-python
  • ./uninstall.sh

1.0.0

  • 将Pi 5移植到gpiod/gpiodevice
  • 使用Pi 5的虚拟LED

0.0.1

  • 首次发布

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源分布

inventorhatmini-1.0.0.tar.gz (199.4 kB 查看哈希)

上传时间

构建分布

inventorhatmini-1.0.0-py3-none-any.whl (215.5 kB 查看哈希值)

上传时间: Python 3