This was caused by a missing double quotation mark in a file name in an "Execute code" block.....

You want UNbuckled "Grove" connectors to fit all M5Stack devices. For example, the M5StickC-Plus will accept both unbuckled and bucked connectors, but the Core2 will only accept an unbuckled connector. If you have the buckled type, you can always cut the clip off so it will fit.

Generically, these connectors are called "HY2.0-4P" although nearly all vendors sell them as "Grove".

There's no standard for the Vcc and logic levels! So make sure your devices match. M5Stack devices supply 5V on the red conductor, but the logic levels are 3.3V.

Using //https://101010.fun/iot/m5stickc-plus-firststep.html
for inspiration, we can upload this program:

#include <M5StickCPlus.h>

void setup() {
M5.begin();
M5.Lcd.setTextSize(3);
M5.Lcd.setRotation(3);
M5.Lcd.setTextColor(TFT_ORANGE);
}

void loop() {
M5.update();
soundTest();
}

void soundTest() {
for (int tone=100; tone < 4000; tone=tone+50) {
M5.Lcd.fillScreen(BLACK);
M5.Lcd.setCursor(80, 50);
M5.Lcd.printf("%d", tone);
M5.Beep.tone(tone);
M5.Beep.update();
delay(200);
}
}

According to my ears there is a definite peak about 2500 Hz, with frequencies under 250 Hz and over 3000 not audible. Your ears may vary .....

I am trying to get the program to ignore failure to connect to WiFi. I tried to place a Wifi Connect block inside a try/except (with a bogus SSID/password):

Instead, the program hangs, before the LED comes on, because the python that gets generated places the wifiCfg.doConnect up at the top of the program (line 20):

and the try/except block is empty, much later in the program at line 87:

Is there a way to create an exception for WiFi failure to connect?

I also notice that UIFlow does not have a "pass" block. I just put a wait() in mine - ???

Isn't the method called pushSprite?

On a M5StickC-Plus, I use:

setup():
TFT_eSprite sgraph = TFT_eSprite(&M5.Lcd);
...
sgraph.createSprite(GRAPHW, GRAPHH);
...

loop():
...
sgraph.pushSprite(TEXTW, 0);
....

I got the bar graph demo to work:

• Using the latest M5 board package, you should see a board "M5PaperS3", so the requirement to downgrade the esp32 board package to 3.0.6 is not necessary. Use the "M5PaperS3" board definition instead of the generic ESP32S3 one.

• The instructions to install epdiy are somewhat vague. Simply clone the epdiy library to your arduino library directory and it will work, doing a "make" is not necessary.

• Follow the rest of the instructions at https://docs.m5stack.com/en/arduino/m5papers3/program, pay careful attention to the special board settings for OPI PSRAM, etc.

@wsanders SOLUTION: Use "Original Network Function" blocks instead.

Mt RTC is set to UTC. Somehow, this magically works:

    setenv("TZ","PST8PDT",1);
    tzset();
    auto tm = localtime(&t);
    M5.Display.printf("ESP32 %04d/%02d/%02d (%s)  %02d:%02d:%02d\r\n",
          tm->tm_year+1900, tm->tm_mon+1, tm->tm_mday,
          wd[tm->tm_wday],
          tm->tm_hour, tm->tm_min, tm->tm_sec);

Just posting here in case someone is mystified by the Rtc.ino example, since it doesn't set the TZ "environmen variable" the calls to localtime and gmtime will return the same.

@felmue I did not see that error.

The afterimages have gone away. Leaving the screen all black and powered off a few minutes will help clear it, this is common EPD behavior.

@felmue That PR did not work, only random lines on screen. The random lines burned an afterimage on the screen. I don't think the screen was permanently damaged; after a few cycles of leaving the screen all-black for several minutes the afterimage seems to be slowly going away.

But you had the right idea: On further investigation I added a "#include <epdiy.h>" and the program works now.

Has anyone gotten the PaperS3 peripherals to work with M5United?

My program compiles OK with #include <M5Unified.h> but when I include the call to M5.begin(); at the top of my setup() code, the program crashes and is stuck in a crash/restart loop.

For now, I have a working simple badge program here: https://github.com/wsanders/M5PaperS3-Stuff/tree/main

@felmue You are correct. I put some code in my program to blink a filled circle on the display, e.g.

void loop(void)
{
  display.startWrite();
  if (color == 0)
  {  
     display.fillCircle(500,910,20,TFT_WHITE);
  }  
  else
  {  
     display.fillCircle(500,910,20,TFT_BLACK);
  }
  display.endWrite();
  color = (color + 1) % 2;
  sleep(3);
}

If I double click the switch while the device is connected to USB it turns off. This is using the Arduino IDE. If the device is off and I press-and-hold the switch the device does not reboot or power on.

[Some corrections - see followup comments.]

I have not started reverse engineering the power states on my PaperS3 yet but as far as I can tell with the Arduino IDE, clicking the button once will power up the device and double clicking will power it off. Pushing and holding the device will cause it to re-run whatever boot stack is on it, which for a Arduino IDE-installed program in the same as powering it up.

The device cannot be turned off when the USB is connected to a power souce.

There is no way to control the LEDs so if you need to test if the device is running you can work something up with the screen, sound, and touch.

Being an e-ink device the objective is to leave the device off most of the time, and only wake it to update the screen every once in a while.

The feature I would like to see documented, if it exists, is a way to power the gyro off and on. The product page says, "Low power mode: DC 4.2V / 9.28µA (main power off, gyroscope in low power mode); Standby mode: DC 4.2V / 949.58µA (main power off, gyroscope on)" Which means the battery could last for weeks if you didn't need the gyro.

Now that I think of it, I could not get drawJpgFile to work in a previous project (a fake Nixie watch), and I see from the PaperS3 demo program sample code that the Jpg is stored as a static array.

I got my simple badge display program to work by storing the image as a C array (exported from GIMP) and walking through the pixels, which is how I did it in my previous project. Suprisingly it's not incredibly slow but of course data in this format is incredibly bulky.

This github code is an example of how to convert a file into a statoc C array: https://github.com/notisrac/FileToCArray

In the next few days, maybe I'll figure out if SPIFFS works on the PaperS3 and report back.

This is probably a problem with SPIFFs. If I change the file open to

  File file = SPIFFS.open("/NONEXISTENT");

the open still succeeds even though the file doesn't exist.So I have no way to know if drawJpgFile even works or not.

Anybody get drawJpgFile and SPIFFS to work with M5 PaperS3? The following program finds the file "badge.jpg" but the jpeg is not displayed. I have turned jpg optimization and progressive off since that has been a source of problems in the past:

#include <epdiy.h>
#include <SPIFFS.h>
#include <M5GFX.h>

M5GFX display;

void setup(void)
{ 
  display.init();
  display.startWrite();
  display.fillScreen(TFT_WHITE);
  display.setTextSize(5.0);
  if (display.isEPD())
  { 
    display.setEpdMode(epd_mode_t::epd_fastest);
  }
  // eyelet at top
  display.setRotation(display.getRotation() ^ 2);
  
  display.println("I RUN");
  if(!SPIFFS.begin(true)){
    display.println("An Error has occurred while mounting SPIFFS");
  }
  display.println("SPIFFS OK");
  File file = SPIFFS.open("/badge.jpg");
  if(!file){
    display.println("Failed to open file");
  }
  file.close();
  display.println("Open OK");
  
  display.drawJpgFile(SPIFFS, "/badge.jpg" , 0, 0);
  display.display();
}

If I cant get drawJpgFile to work, has someone written a script to put the result in a const array such as in the example file at https://github.com/m5stack/M5GFX/blob/2c12f148d6e3df64ead33b04c7989fe6d90a7a83/examples/Basic/drawImageData/drawImageData.ino?

I got the bar graph demo to work:

• Using the latest M5 board package, you should see a board "M5PaperS3", so the requirement to downgrade the esp32 board package to 3.0.6 is not necessary. Use the "M5PaperS3" board definition instead of the generic ESP32S3 one.

• The instructions to install epdiy are somewhat vague. Simply clone the epdiy library to your arduino library directory and it will work, doing a "make" is not necessary.

• Follow the rest of the instructions at https://docs.m5stack.com/en/arduino/m5papers3/program, pay careful attention to the special board settings for OPI PSRAM, etc.