Skip to main content

Helper library for the Adafruit MagTag

Project description

Introduction

Documentation Status Discord Build Status Code Style: Ruff

Helper library for the Adafruit MagTag.

Dependencies

This driver depends on:

Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloading the Adafruit library and driver bundle.

Usage Example

# SPDX-FileCopyrightText: 2017 Scott Shawcroft, written for Adafruit Industries
#
# SPDX-License-Identifier: Unlicense
import time
import terminalio
from adafruit_magtag.magtag import MagTag

magtag = MagTag()

magtag.add_text(
    text_font=terminalio.FONT,
    text_position=(
        50,
        (magtag.graphics.display.height // 2) - 1,
    ),
    text_scale=3,
)

magtag.set_text("Hello World")

buttons = magtag.peripherals.buttons
button_colors = ((255, 0, 0), (255, 150, 0), (0, 255, 255), (180, 0, 255))
button_tones = (1047, 1318, 1568, 2093)
timestamp = time.monotonic()

while True:
    for i, b in enumerate(buttons):
        if not b.value:
            print("Button %c pressed" % chr((ord("A") + i)))
            magtag.peripherals.neopixel_disable = False
            magtag.peripherals.neopixels.fill(button_colors[i])
            magtag.peripherals.play_tone(button_tones[i], 0.25)
            break
    else:
        magtag.peripherals.neopixel_disable = True
    time.sleep(0.01)

Documentation

API documentation for this library can be found on Read the Docs.

For information on building library documentation, please check out this guide.

Contributing

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

adafruit_circuitpython_magtag-2.2.18.tar.gz (27.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

adafruit_circuitpython_magtag-2.2.18-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

File details

Details for the file adafruit_circuitpython_magtag-2.2.18.tar.gz.

File metadata

File hashes

Hashes for adafruit_circuitpython_magtag-2.2.18.tar.gz
Algorithm Hash digest
SHA256 aa5571e8f0764799632520ae6404cbfae40688d43626c79872e417b5a03e6218
MD5 8ad23d6c44e281c3ac96f9bc5c5e221d
BLAKE2b-256 dad7fd06f2f65dbb336d4ea788a036f9a6edba4fe418833082014ee51e5df8ae

See more details on using hashes here.

File details

Details for the file adafruit_circuitpython_magtag-2.2.18-py3-none-any.whl.

File metadata

File hashes

Hashes for adafruit_circuitpython_magtag-2.2.18-py3-none-any.whl
Algorithm Hash digest
SHA256 ac99cfb8475fc5e97a5a861dc03940dd84955617d0e2e0139d63456622721e09
MD5 3cd0e79917a3630a3af518a2b134c01d
BLAKE2b-256 de4d18017ac1326fe84ae26965837eb49e59604dce60b12106d90de63da3a963

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page