Atomic Speaker Base

The following products are supported:

Below is the detailed support for Speaker on the host:

Controller	NS4168	SDCard
Atom Echo	⭕	⭕
Atom Lite	✅	✅
Atom Matrix	⭕	✅
AtomS3	⭕	✅
AtomS3 Lite	✅	✅
AtomS3R	✅	✅
AtomS3R-CAM	✅	✅
AtomS3R-Ext	✅	✅

✅: Supported.

⭕: Optional, It conflicts with some internal resource of the host.

Micropython Example:

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

import os, sys, io
import M5
from M5 import *
from base import SpeakerBase
from hardware import sdcard


base_spk = None


def setup():
    global base_spk

    M5.begin()
    base_spk = SpeakerBase(1, 5, 39, 38)
    sdcard.SDCard(slot=3, width=1, sck=7, miso=8, mosi=6, cs=None, freq=20000000)
    base_spk.playWavFile("/flash/res/audio/66.wav")
    base_spk.playWavFile("/sd/66.wav")


def loop():
    global base_spk
    M5.update()


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

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

UIFLOW2 Example:

atoms3_speaker_example.m5f2

class SpeakerBase

Constructors

class SpeakerBase(_id, sck, ws, sd)

Create an SpeakerBase object.

Parameters:

• _id (int) – The I2S port number.

• sck (int) – The I2S SCK pin.

• ws (int) – The I2S WS pin.

• sd (int) – The I2S DI pin.

UIFLOW2:

Micropython:

from base import SpeakerBase

# atoms3 lite / atoms3 / atoms3r / atoms3r-cam / atoms3-ext
spk = SpeakerBase(1, 5, 39, 38)

# atom lite / atom matrix / atom echo
spk = SpeakerBase(1, 22, 21, 25)

SpeakerBase class inherits M5.Speaker class, See hardware.Speaker.Methods for more details.

class SDCard

Constructors

class SDCard(slot=2, width=1, sck=None, miso=None, mosi=None, cs=None, freq=20000000)

Create an SDCard object.

Parameters:

• slot (int) – The slot number of the SD card. Default is 2.

• width (int) – width selects the bus width for the SD/MMC interface.

• sck (int) – sck can be used to specify an SPI clock pin.

• miso (int) – miso can be used to specify an SPI miso pin.

• mosi (int) – mosi can be used to specify an SPI mosi pin.

• cs (int) – cs can be used to specify an SPI chip select pin.

• freq (int) – freq selects the SD/MMC interface frequency in Hz.

UIFLOW2:

Micropython:

from hardware import sdcard

# atoms lite / atom martrix / atom echo: SPI2
sd = sdcard.SDCard(slot=3, width=1, sck=23, miso=33, mosi=19, cs=None, freq=20000000)

# atoms3 / atoms3 lite / atoms3r / atoms3r-cam / atoms3-ext: SPI2
sd = SDCard(slot=3, width=1, sck=7, miso=8, mosi=6, cs=None, freq=20000000)