Fusion Hat Python library for Raspberry Pi.
Quick Links:
Fusion HAT is a multifunctional expansion board that allows Raspberry Pi to be quickly turned into a robot. An MCU is on board to extend the PWM output and ADC input for the Raspberry Pi, as well as a motor driver chip. I2S audio module and mono speaker. As well as the GPIOs that lead out of the Raspberry Pi itself.
Install Fusion Hat
curl -sSL https://raw.githubusercontent.com/sunfounder/sunfounder-installer-scripts/main/install-fusion-hat.sh | sudo bashAfter install finished, please reboot your Raspberry Pi. After reboot, Run this command again to enable audio
sudo /opt/setup_fusion_hat_audio.shAPI reference is auto generated by Sphinx. But you need to create rst file manually.
cd docs
sphinx-apidoc -f -d 1 -e -M -P -T -o source/api ../fusion_hat-fForce to overwrite existing files.-d 1Set the maximum depth of the module documentation.-eput documentation for each module on its own page.-Mput module documentation before submodule documentation.-Pinclude "_private" modules.-Tdon't create a table of contents file.-o source/apiSpecify the output directory for the generated rst files.../fusion_hatSpecify the path to the fusion_hat package.
sudo pip uninstall --break fusion_hat -y && sudo pip install --break git+https://github.com/sunfounder/fusion-hat.git@1.1.x
sudo pip uninstall --break fusion_hat -y && sudo pip install ~/fusion-hat/ --break-system-packages --no-deps --no-build-isolation
sudo pip install ~/fusion-hat/ --break-system-packages --no-deps --no-build-isolation
cd ~/fusion-hat/driver && make all && sudo make install
cd ~/fusion-hat/examplesAfter installing the library, use the fusion_hat command:
fusion_hat <command>| Command | Description |
|---|---|
info |
Show device info, library/driver/firmware versions, battery, button, LED, and speaker state. |
doctor |
Run driver and hardware health checks: EEPROM, module file, module load, sysfs, I2C MCU (0x17), DKMS. |
doctor --fix |
Run health checks and auto-repair issues (e.g. load the kernel module if not loaded, or build and install the driver). |
version |
Print the library version. |
scan_i2c |
Scan the I2C bus and list detected device addresses. |
enable_speaker |
Enable the onboard speaker. |
disable_speaker |
Disable the onboard speaker. |
test_speaker |
Enable speaker, play a test tone, then disable speaker. |
Example output:
$ fusion_hat doctor
==================================================
Fusion Hat Driver Status
==================================================
[OK] EEPROM detected
[OK] Module file
[OK] Module loaded
[OK] sysfs interface
[OK] I2C MCU (0x17)
[OK] DKMS : fusion_hat/1.0.2, 6.12.47+rpt-rpi-2712, aarch64: installed
==================================================$ fusion_hat info
==================================================
Fusion Hat Device Info
==================================================
Name: Fusion Hat
ID: fusion_hat
UUID: 9daeea78-0000-0774-000a-582369ac3e02
Product ID: 1908
Product Ver: 10
Vendor: SunFounder
Library Version: 1.2.0
Firmware Version: 1.0.2
Driver Version: 1.0.2
User Button State: Released
Speaker State: Disabled
User LED State: Off
Battery level: 83%
Battery voltage: 8.06 V
Battery charging: No
==================================================SunFounder is a technology company focused on Raspberry Pi and Arduino open source community development. Committed to the promotion of open source culture, we strives to bring the fun of electronics making to people all around the world and enable everyone to be a maker. Our products include learning kits, development boards, robots, sensor modules and development tools. In addition to high quality products, SunFounder also offers video tutorials to help you make your own project. If you have interest in open source or making something cool, welcome to join us!
website: www.sunfounder.com