Initial working m5stack cardputer setup

[jamesjnadeau]

No description provided.

[dhalbert]

I'm going to put this into draft mode so we don't merge it too soon. Take it out of draft mode when you're ready -- thanks.

[jamesjnadeau]

I have updated the pins file per your request.

I'm still trying some things out, so I think leaving this in draft for another week is probably a good idea, thanks!

[panguin6010]

// Microphone pins
{ MP_ROM_QSTR(MP_QSTR_MIC_DATA), MP_ROM_PTR(&pin_GPIO46) },
{ MP_ROM_QSTR(MP_QSTR_MIC_CLK), MP_ROM_PTR(&pin_GPIO43) },

@jamesjnadeau Here are the lines for microphone support in pins.c

[jamesjnadeau]

@dhalbert I'm moving this out of draft as it's confirmed working by others and we've sussed out the peripherals.

[tannewt]

Two tweaks since the cardputer comes with a StampS3. Not a core.

[CDarius]

Cardputer has two different SPI bus: one for the display and one for the SD card.
I think it's best to configure both busses

[CDarius]

The I2C bus exposed in pins.c is not defined anyware

[CDarius]

The display initializations can be sped up.
In addition it's possible to set the color word endianing in the display and avoid to swap the word in software

[RetiredWizard]

I tried to implement I2S audio in this branch, but I haven't gotten it working yet:

Unfortunately, I pulled the trigger on purchasing my Cardputer from the manufacturer rather than a local distributor without thinking first so I won't have one to test for a month or two. I suspect that I2S Audio out will work without your PDMIn updates though. I assume you're trying to get the Mic to work using the PDMIn module?

import synthio
import audiobusio
import board
import time

i2s = audiobusio.I2SOut(board.I2S_BIT_CLOCK, board.I2S_WORD_SELECT, board.I2S_DATA)
synth = synthio.Synthesizer(sample_rate=22050)
e = synthio.Envelope(attack_time=0,decay_time=0,release_time=0,attack_level=.3,sustain_level=.3)
note = synthio.Note(frequency=261.626,envelope=e)

i2s.play(synth)

synth.press(note)
time.sleep(1)
synth.release(note)

[tannewt]

Thanks for the updates! Getting close!

[jamesjnadeau]

correct @RetiredWizard, I got the mic/speaker crossed. Thanks for the reply and let me know if you give it a try.

[JetForMe]

@jamesjnadeau I happen to try to connect a PDM mic to a Feather S3 today, only to discover PDMIn hadn't been implemented yet. As I started looking into doing so, I was directed to this PR and to your fork of CP. Is there anything I can do to help get PDM working?

[FoamyGuy]

@jamesjnadeau may I ask how to get this flashed onto the device?

I found your post here: https://www.reddit.com/r/CardPuter/comments/19f7num/how_to_start_writing_your_own_codefirmware/kjhv4dg/ that mentions loading the bootloader using the instructions from the UM Feather S3 page. I followed those instructions and I think that I loaded the combined.bin bootloader successfully. Once that is loaded the device connects as a serial port but I don't seem to ever get it connected as a BOOT drive for copying UF2 file. Perhaps I am misunderstanding and it's not that type of bootloader?

In any case Once I've followed the instructions to load the bootloader, and successfully built circuitpython from this branch, what do I need to do next in order to flash the resulting build?

[FoamyGuy]

I managed to get Circuitpython loaded. For anyone that might find this page in the future before there are steps published elsewhere these are the steps I took, I'm not entirely certain if they were all 100% necessary, but I got there in the end.

• Loaded the combined.bin bootloader using the instructions from the UM Feather S3 download page at circuitpython.org (hold GO while powering on to get into bootloader to use with the web flasher)
• Inside of this branch in ports/esspressif/ ran make BOARD=m5stack_cardputer PORT=/dev/ttyACM1 flash.
• That finished successfully then I pressed the reset button and it came back up to the BOOT drive
• Copied the firmware.uf2 that was built onto the BOOT drive with this command: cp build-m5stack_cardputer/firmware.uf2 /media/timc/UFTHRS3BOOT/

[foopod]

@tannewt @dhalbert it seems like all the requested changes have been incorporated here. Is there anything else this is waiting on?

[dhalbert]

@foopod There is an unresolved question about the SPI buses: #8816 (comment)

[FoamyGuy]

I made a new branch from this and pushed in that requested change to expose the second SPI bus, that branch is here: https://github.com/FoamyGuy/circuitpython/tree/m5stack_cardputer_multi_spi with the specific change being inside pins here: https://github.com/FoamyGuy/circuitpython/blob/m5stack_cardputer_multi_spi/ports/espressif/boards/m5stack_cardputer/pins.c#L69-L70

with that change both SPI busses are listed on the board object:

>>> import board
>>> dir(board)
['__class__', '__name__', 'BOOT0', 'BUTTON', 'D1', 'D2', 'DISPLAY', 'I2C', 'I2S_BIT_CLOCK', 'I2S_WORD_SELECT', 'IR_TX', 'IS2_DATA', 'KB_A_0', 'KB_A_1', 'KB_A_2', 'KB_COL_0', 'KB_COL_1', 'KB_COL_2', 'KB_COL_3', 'KB_COL_4', 'KB_COL_5', 'KB_COL_6', 'MIC_CLK', 'MIC_DATA', 'NEOPIXEL', 'PORTA1', 'PORTA2', 'PORTA_I2C', 'RX', 'SD_CS', 'SD_MISO', 'SD_MOSI', 'SD_SCK', 'SD_SPI', 'TFT_BACKLIGHT', 'TFT_BL', 'TFT_CS', 'TFT_DATA', 'TFT_DC', 'TFT_MOSI', 'TFT_RESET', 'TFT_RS', 'TFT_RST', 'TFT_SCK', 'TFT_SPI', 'TX', '__dict__', 'board_id']

I did a very brief test of this using this code to mount the SDCard and print the contents of a test file:

sdcard = sdcardio.SDCard(board.SD_SPI(), board.SD_CS, baudrate=20_000_000)
vfs = storage.VfsFat(sdcard)
storage.mount(vfs, "/sd")

print(os.listdir("/sd"))

f = open(f"/sd/{os.listdir('/sd')[0]}", "r")
print(f.read())
f.close()

The pre-existing display initialization inside of board init is using the TFT_SPI and that appears to still function normally as well so far as I can tell.

If that is the only remaining change needed for this I could commit it here potentially, or make a new PR from my branch that has that commit on it. Let me know if there is anything else I can help to get this moved along, I'd love to see support for it added more officially than the PR.

[dhalbert]

If that is the only remaining change needed for this I could commit it here potentially, or make a new PR from my branch that has that commit on it. Let me know if there is anything else I can help to get this moved along, I'd love to see support for it added more officially than the PR.

You can add https://github.com/jamesjnadeau/circuitpython as a remote in a clone of your own repo, pull it, and check out that remote's m5stack_cardputer branch. Then cherry-pick your changes from your own branch, and push. Assuming the usual permission box is checked for the PR, that should work to update this PR.

[FoamyGuy]

Thank you! I've added that commit now.

[dhalbert]

Any comments from anyone before we merge this? Thanks.

[dhalbert]

I think the requested changes are now in. Any further fixes could be PR'd.

two SPI buses now present