CoreP4X
Support the following products:
Supported Components
CoreP4X supports the following components:
Supported Display Fonts
The CoreP4X firmware includes the following Montserrat fonts for LVGL and M5UI: lv.font_montserrat_12, lv.font_montserrat_14, lv.font_montserrat_16, lv.font_montserrat_18, lv.font_montserrat_20, lv.font_montserrat_22, lv.font_montserrat_24, lv.font_montserrat_30, lv.font_montserrat_36, lv.font_montserrat_40, lv.font_montserrat_44, lv.font_montserrat_48.
For M5.Lcd.FONTS, the firmware also provides AlibabaPuHuiTiCN24, AlibabaSansJA24, and AlibabaSansKR24 for Chinese, Japanese, and Korean text respectively.
Board Features
CoreP4X supports the following built-in functions and peripherals:
480 x 480 display and capacitive touch input.
IMU accelerometer and gyroscope readings.
RTC date and time display and adjustment.
USB and battery voltage monitoring, charging status, and Port A 5 V output control.
Speaker tone playback, volume adjustment, and PA control.
Microphone recording and speaker playback.
Infrared NEC transmission and reception.
UiFlow2 Example
RTC Clock
Open the corep4x_rtc_example.m5f2 project in UiFlow2.
Display the date and a blue HH:MM:SS clock from the built-in RTC, using UTC. Tap SET TIME to adjust hours, minutes, and seconds with the + and - buttons. Tap SAVE to update the RTC while preserving the date, or CANCEL to discard the changes.
UiFlow2 Code Block:
Example output:
None
IMU Sensor
Open the corep4x_imu_example.m5f2 project in UiFlow2.
Display the X, Y, and Z readings from the built-in accelerometer and gyroscope. Acceleration is shown in g, and angular velocity in degrees per second (dps). Tilt or rotate the device to observe the readings.
UiFlow2 Code Block:
Example output:
None
Power Management
Open the corep4x_power_example.m5f2 project in UiFlow2.
Display USB VBUS and battery voltages in mV, charging status, Port A 5 V output, and charge control. The battery voltage turns green while the battery is charging. Tap PORT A to toggle external output and CHARGE to enable or disable charging. Battery percentage is not displayed.
UiFlow2 Code Block:
Example output:
None
Speaker Tone
Open the corep4x_speaker_tone_example.m5f2 project in UiFlow2.
Use separate sliders to adjust frequency from 200 to 4000 Hz and volume from 0 to 100%. The default values are 1000 Hz and 70%. Tap Start tone or Stop tone to control playback. The PA switch controls the amplifier independently; it is enabled at startup, while tone playback is stopped. Turning PA off mutes the output without stopping the tone.
UiFlow2 Code Block:
Example output:
None
Audio Recording and Playback
Open the corep4x_audio_example.m5f2 project in UiFlow2.
Record audio in memory at 8 kHz, mono, 16 bit. Tap RECORD to start and STOP REC to finish, with a maximum duration of 30 seconds. Tap PLAY to play the recording or STOP PLAY to stop playback. The volume slider ranges from 0 to 100%, with a default of 70%. PA is enabled automatically for playback.
UiFlow2 Code Block:
Example output:
None
Infrared Transmission and Reception
Open the corep4x_ir_example.m5f2 project in UiFlow2.
Use the built-in infrared receiver on G13 and transmitter on G49. Tap the send button to transmit an NEC frame with address 0x08 and an incrementing data byte. The screen shows transmitted data, received address and data, and the receive count. Use an NEC-compatible infrared remote control to test reception.
UiFlow2 Code Block:
Example output:
None
MicroPython Example
RTC Clock
Display the date and a blue HH:MM:SS clock from the built-in RTC, using UTC. Tap SET TIME to adjust hours, minutes, and seconds with the + and - buttons. Tap SAVE to update the RTC while preserving the date, or CANCEL to discard the changes.
MicroPython Code Block:
1# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD 2# 3# SPDX-License-Identifier: MIT 4 5import os, sys, io 6import M5 7from M5 import * 8import m5ui 9import lvgl as lv 10from hardware import RTC 11import time 12 13 14page_live = None 15page_edit = None 16label_title = None 17label_date = None 18label_live_hour = None 19label_live_colon_1 = None 20label_live_min = None 21label_live_colon_2 = None 22label_live_sec = None 23button_set = None 24label_edit_title = None 25label_hour_name = None 26label_min_name = None 27label_sec_name = None 28label_hour = None 29label_min = None 30label_sec = None 31button_hour_plus = None 32button_hour_minus = None 33button_min_plus = None 34button_min_minus = None 35button_sec_plus = None 36button_sec_minus = None 37button_cancel = None 38button_save = None 39rtc = None 40 41 42edit_hour = None 43edit_min = None 44edit_sec = None 45 46 47def button_set_clicked_event(event_struct): 48 global \ 49 page_live, \ 50 page_edit, \ 51 label_title, \ 52 label_date, \ 53 label_live_hour, \ 54 label_live_colon_1, \ 55 label_live_min, \ 56 label_live_colon_2, \ 57 label_live_sec, \ 58 button_set, \ 59 label_edit_title, \ 60 label_hour_name, \ 61 label_min_name, \ 62 label_sec_name, \ 63 label_hour, \ 64 label_min, \ 65 label_sec, \ 66 button_hour_plus, \ 67 button_hour_minus, \ 68 button_min_plus, \ 69 button_min_minus, \ 70 button_sec_plus, \ 71 button_sec_minus, \ 72 button_cancel, \ 73 button_save, \ 74 rtc, \ 75 edit_hour, \ 76 edit_min, \ 77 edit_sec 78 page_edit.screen_load() 79 edit_hour = (rtc.datetime())[4] 80 edit_min = (rtc.datetime())[5] 81 edit_sec = (rtc.datetime())[6] 82 if edit_hour < 10: 83 label_hour.set_text(str((str("0") + str(edit_hour)))) 84 else: 85 label_hour.set_text(str(edit_hour)) 86 if edit_min < 10: 87 label_min.set_text(str((str("0") + str(edit_min)))) 88 else: 89 label_min.set_text(str(edit_min)) 90 if edit_sec < 10: 91 label_sec.set_text(str((str("0") + str(edit_sec)))) 92 else: 93 label_sec.set_text(str(edit_sec)) 94 95 96def button_hour_plus_clicked_event(event_struct): 97 global \ 98 page_live, \ 99 page_edit, \ 100 label_title, \ 101 label_date, \ 102 label_live_hour, \ 103 label_live_colon_1, \ 104 label_live_min, \ 105 label_live_colon_2, \ 106 label_live_sec, \ 107 button_set, \ 108 label_edit_title, \ 109 label_hour_name, \ 110 label_min_name, \ 111 label_sec_name, \ 112 label_hour, \ 113 label_min, \ 114 label_sec, \ 115 button_hour_plus, \ 116 button_hour_minus, \ 117 button_min_plus, \ 118 button_min_minus, \ 119 button_sec_plus, \ 120 button_sec_minus, \ 121 button_cancel, \ 122 button_save, \ 123 rtc, \ 124 edit_hour, \ 125 edit_min, \ 126 edit_sec 127 edit_hour = (edit_hour + 1) % 24 128 if edit_hour < 10: 129 label_hour.set_text(str((str("0") + str(edit_hour)))) 130 else: 131 label_hour.set_text(str(edit_hour)) 132 133 134def button_hour_minus_clicked_event(event_struct): 135 global \ 136 page_live, \ 137 page_edit, \ 138 label_title, \ 139 label_date, \ 140 label_live_hour, \ 141 label_live_colon_1, \ 142 label_live_min, \ 143 label_live_colon_2, \ 144 label_live_sec, \ 145 button_set, \ 146 label_edit_title, \ 147 label_hour_name, \ 148 label_min_name, \ 149 label_sec_name, \ 150 label_hour, \ 151 label_min, \ 152 label_sec, \ 153 button_hour_plus, \ 154 button_hour_minus, \ 155 button_min_plus, \ 156 button_min_minus, \ 157 button_sec_plus, \ 158 button_sec_minus, \ 159 button_cancel, \ 160 button_save, \ 161 rtc, \ 162 edit_hour, \ 163 edit_min, \ 164 edit_sec 165 edit_hour = (edit_hour + -1) % 24 166 if edit_hour < 10: 167 label_hour.set_text(str((str("0") + str(edit_hour)))) 168 else: 169 label_hour.set_text(str(edit_hour)) 170 171 172def button_min_plus_clicked_event(event_struct): 173 global \ 174 page_live, \ 175 page_edit, \ 176 label_title, \ 177 label_date, \ 178 label_live_hour, \ 179 label_live_colon_1, \ 180 label_live_min, \ 181 label_live_colon_2, \ 182 label_live_sec, \ 183 button_set, \ 184 label_edit_title, \ 185 label_hour_name, \ 186 label_min_name, \ 187 label_sec_name, \ 188 label_hour, \ 189 label_min, \ 190 label_sec, \ 191 button_hour_plus, \ 192 button_hour_minus, \ 193 button_min_plus, \ 194 button_min_minus, \ 195 button_sec_plus, \ 196 button_sec_minus, \ 197 button_cancel, \ 198 button_save, \ 199 rtc, \ 200 edit_hour, \ 201 edit_min, \ 202 edit_sec 203 edit_min = (edit_min + 1) % 60 204 if edit_min < 10: 205 label_min.set_text(str((str("0") + str(edit_min)))) 206 else: 207 label_min.set_text(str(edit_min)) 208 209 210def button_min_minus_clicked_event(event_struct): 211 global \ 212 page_live, \ 213 page_edit, \ 214 label_title, \ 215 label_date, \ 216 label_live_hour, \ 217 label_live_colon_1, \ 218 label_live_min, \ 219 label_live_colon_2, \ 220 label_live_sec, \ 221 button_set, \ 222 label_edit_title, \ 223 label_hour_name, \ 224 label_min_name, \ 225 label_sec_name, \ 226 label_hour, \ 227 label_min, \ 228 label_sec, \ 229 button_hour_plus, \ 230 button_hour_minus, \ 231 button_min_plus, \ 232 button_min_minus, \ 233 button_sec_plus, \ 234 button_sec_minus, \ 235 button_cancel, \ 236 button_save, \ 237 rtc, \ 238 edit_hour, \ 239 edit_min, \ 240 edit_sec 241 edit_min = (edit_min + -1) % 60 242 if edit_min < 10: 243 label_min.set_text(str((str("0") + str(edit_min)))) 244 else: 245 label_min.set_text(str(edit_min)) 246 247 248def button_sec_plus_clicked_event(event_struct): 249 global \ 250 page_live, \ 251 page_edit, \ 252 label_title, \ 253 label_date, \ 254 label_live_hour, \ 255 label_live_colon_1, \ 256 label_live_min, \ 257 label_live_colon_2, \ 258 label_live_sec, \ 259 button_set, \ 260 label_edit_title, \ 261 label_hour_name, \ 262 label_min_name, \ 263 label_sec_name, \ 264 label_hour, \ 265 label_min, \ 266 label_sec, \ 267 button_hour_plus, \ 268 button_hour_minus, \ 269 button_min_plus, \ 270 button_min_minus, \ 271 button_sec_plus, \ 272 button_sec_minus, \ 273 button_cancel, \ 274 button_save, \ 275 rtc, \ 276 edit_hour, \ 277 edit_min, \ 278 edit_sec 279 edit_sec = (edit_sec + 1) % 60 280 if edit_sec < 10: 281 label_sec.set_text(str((str("0") + str(edit_sec)))) 282 else: 283 label_sec.set_text(str(edit_sec)) 284 285 286def button_sec_minus_clicked_event(event_struct): 287 global \ 288 page_live, \ 289 page_edit, \ 290 label_title, \ 291 label_date, \ 292 label_live_hour, \ 293 label_live_colon_1, \ 294 label_live_min, \ 295 label_live_colon_2, \ 296 label_live_sec, \ 297 button_set, \ 298 label_edit_title, \ 299 label_hour_name, \ 300 label_min_name, \ 301 label_sec_name, \ 302 label_hour, \ 303 label_min, \ 304 label_sec, \ 305 button_hour_plus, \ 306 button_hour_minus, \ 307 button_min_plus, \ 308 button_min_minus, \ 309 button_sec_plus, \ 310 button_sec_minus, \ 311 button_cancel, \ 312 button_save, \ 313 rtc, \ 314 edit_hour, \ 315 edit_min, \ 316 edit_sec 317 edit_sec = (edit_sec + -1) % 60 318 if edit_sec < 10: 319 label_sec.set_text(str((str("0") + str(edit_sec)))) 320 else: 321 label_sec.set_text(str(edit_sec)) 322 323 324def button_cancel_clicked_event(event_struct): 325 global \ 326 page_live, \ 327 page_edit, \ 328 label_title, \ 329 label_date, \ 330 label_live_hour, \ 331 label_live_colon_1, \ 332 label_live_min, \ 333 label_live_colon_2, \ 334 label_live_sec, \ 335 button_set, \ 336 label_edit_title, \ 337 label_hour_name, \ 338 label_min_name, \ 339 label_sec_name, \ 340 label_hour, \ 341 label_min, \ 342 label_sec, \ 343 button_hour_plus, \ 344 button_hour_minus, \ 345 button_min_plus, \ 346 button_min_minus, \ 347 button_sec_plus, \ 348 button_sec_minus, \ 349 button_cancel, \ 350 button_save, \ 351 rtc, \ 352 edit_hour, \ 353 edit_min, \ 354 edit_sec 355 page_live.screen_load() 356 357 358def button_save_clicked_event(event_struct): 359 global \ 360 page_live, \ 361 page_edit, \ 362 label_title, \ 363 label_date, \ 364 label_live_hour, \ 365 label_live_colon_1, \ 366 label_live_min, \ 367 label_live_colon_2, \ 368 label_live_sec, \ 369 button_set, \ 370 label_edit_title, \ 371 label_hour_name, \ 372 label_min_name, \ 373 label_sec_name, \ 374 label_hour, \ 375 label_min, \ 376 label_sec, \ 377 button_hour_plus, \ 378 button_hour_minus, \ 379 button_min_plus, \ 380 button_min_minus, \ 381 button_sec_plus, \ 382 button_sec_minus, \ 383 button_cancel, \ 384 button_save, \ 385 rtc, \ 386 edit_hour, \ 387 edit_min, \ 388 edit_sec 389 rtc.init( 390 ( 391 ((rtc.datetime())[0]), 392 ((rtc.datetime())[1]), 393 ((rtc.datetime())[2]), 394 edit_hour, 395 edit_min, 396 edit_sec, 397 0, 398 0, 399 ) 400 ) 401 page_live.screen_load() 402 403 404def button_set_event_handler(event_struct): 405 global \ 406 page_live, \ 407 page_edit, \ 408 label_title, \ 409 label_date, \ 410 label_live_hour, \ 411 label_live_colon_1, \ 412 label_live_min, \ 413 label_live_colon_2, \ 414 label_live_sec, \ 415 button_set, \ 416 label_edit_title, \ 417 label_hour_name, \ 418 label_min_name, \ 419 label_sec_name, \ 420 label_hour, \ 421 label_min, \ 422 label_sec, \ 423 button_hour_plus, \ 424 button_hour_minus, \ 425 button_min_plus, \ 426 button_min_minus, \ 427 button_sec_plus, \ 428 button_sec_minus, \ 429 button_cancel, \ 430 button_save, \ 431 rtc, \ 432 edit_hour, \ 433 edit_min, \ 434 edit_sec 435 event = event_struct.code 436 if event == lv.EVENT.CLICKED and True: 437 button_set_clicked_event(event_struct) 438 return 439 440 441def button_hour_plus_event_handler(event_struct): 442 global \ 443 page_live, \ 444 page_edit, \ 445 label_title, \ 446 label_date, \ 447 label_live_hour, \ 448 label_live_colon_1, \ 449 label_live_min, \ 450 label_live_colon_2, \ 451 label_live_sec, \ 452 button_set, \ 453 label_edit_title, \ 454 label_hour_name, \ 455 label_min_name, \ 456 label_sec_name, \ 457 label_hour, \ 458 label_min, \ 459 label_sec, \ 460 button_hour_plus, \ 461 button_hour_minus, \ 462 button_min_plus, \ 463 button_min_minus, \ 464 button_sec_plus, \ 465 button_sec_minus, \ 466 button_cancel, \ 467 button_save, \ 468 rtc, \ 469 edit_hour, \ 470 edit_min, \ 471 edit_sec 472 event = event_struct.code 473 if event == lv.EVENT.CLICKED and True: 474 button_hour_plus_clicked_event(event_struct) 475 return 476 477 478def button_hour_minus_event_handler(event_struct): 479 global \ 480 page_live, \ 481 page_edit, \ 482 label_title, \ 483 label_date, \ 484 label_live_hour, \ 485 label_live_colon_1, \ 486 label_live_min, \ 487 label_live_colon_2, \ 488 label_live_sec, \ 489 button_set, \ 490 label_edit_title, \ 491 label_hour_name, \ 492 label_min_name, \ 493 label_sec_name, \ 494 label_hour, \ 495 label_min, \ 496 label_sec, \ 497 button_hour_plus, \ 498 button_hour_minus, \ 499 button_min_plus, \ 500 button_min_minus, \ 501 button_sec_plus, \ 502 button_sec_minus, \ 503 button_cancel, \ 504 button_save, \ 505 rtc, \ 506 edit_hour, \ 507 edit_min, \ 508 edit_sec 509 event = event_struct.code 510 if event == lv.EVENT.CLICKED and True: 511 button_hour_minus_clicked_event(event_struct) 512 return 513 514 515def button_min_plus_event_handler(event_struct): 516 global \ 517 page_live, \ 518 page_edit, \ 519 label_title, \ 520 label_date, \ 521 label_live_hour, \ 522 label_live_colon_1, \ 523 label_live_min, \ 524 label_live_colon_2, \ 525 label_live_sec, \ 526 button_set, \ 527 label_edit_title, \ 528 label_hour_name, \ 529 label_min_name, \ 530 label_sec_name, \ 531 label_hour, \ 532 label_min, \ 533 label_sec, \ 534 button_hour_plus, \ 535 button_hour_minus, \ 536 button_min_plus, \ 537 button_min_minus, \ 538 button_sec_plus, \ 539 button_sec_minus, \ 540 button_cancel, \ 541 button_save, \ 542 rtc, \ 543 edit_hour, \ 544 edit_min, \ 545 edit_sec 546 event = event_struct.code 547 if event == lv.EVENT.CLICKED and True: 548 button_min_plus_clicked_event(event_struct) 549 return 550 551 552def button_min_minus_event_handler(event_struct): 553 global \ 554 page_live, \ 555 page_edit, \ 556 label_title, \ 557 label_date, \ 558 label_live_hour, \ 559 label_live_colon_1, \ 560 label_live_min, \ 561 label_live_colon_2, \ 562 label_live_sec, \ 563 button_set, \ 564 label_edit_title, \ 565 label_hour_name, \ 566 label_min_name, \ 567 label_sec_name, \ 568 label_hour, \ 569 label_min, \ 570 label_sec, \ 571 button_hour_plus, \ 572 button_hour_minus, \ 573 button_min_plus, \ 574 button_min_minus, \ 575 button_sec_plus, \ 576 button_sec_minus, \ 577 button_cancel, \ 578 button_save, \ 579 rtc, \ 580 edit_hour, \ 581 edit_min, \ 582 edit_sec 583 event = event_struct.code 584 if event == lv.EVENT.CLICKED and True: 585 button_min_minus_clicked_event(event_struct) 586 return 587 588 589def button_sec_plus_event_handler(event_struct): 590 global \ 591 page_live, \ 592 page_edit, \ 593 label_title, \ 594 label_date, \ 595 label_live_hour, \ 596 label_live_colon_1, \ 597 label_live_min, \ 598 label_live_colon_2, \ 599 label_live_sec, \ 600 button_set, \ 601 label_edit_title, \ 602 label_hour_name, \ 603 label_min_name, \ 604 label_sec_name, \ 605 label_hour, \ 606 label_min, \ 607 label_sec, \ 608 button_hour_plus, \ 609 button_hour_minus, \ 610 button_min_plus, \ 611 button_min_minus, \ 612 button_sec_plus, \ 613 button_sec_minus, \ 614 button_cancel, \ 615 button_save, \ 616 rtc, \ 617 edit_hour, \ 618 edit_min, \ 619 edit_sec 620 event = event_struct.code 621 if event == lv.EVENT.CLICKED and True: 622 button_sec_plus_clicked_event(event_struct) 623 return 624 625 626def button_sec_minus_event_handler(event_struct): 627 global \ 628 page_live, \ 629 page_edit, \ 630 label_title, \ 631 label_date, \ 632 label_live_hour, \ 633 label_live_colon_1, \ 634 label_live_min, \ 635 label_live_colon_2, \ 636 label_live_sec, \ 637 button_set, \ 638 label_edit_title, \ 639 label_hour_name, \ 640 label_min_name, \ 641 label_sec_name, \ 642 label_hour, \ 643 label_min, \ 644 label_sec, \ 645 button_hour_plus, \ 646 button_hour_minus, \ 647 button_min_plus, \ 648 button_min_minus, \ 649 button_sec_plus, \ 650 button_sec_minus, \ 651 button_cancel, \ 652 button_save, \ 653 rtc, \ 654 edit_hour, \ 655 edit_min, \ 656 edit_sec 657 event = event_struct.code 658 if event == lv.EVENT.CLICKED and True: 659 button_sec_minus_clicked_event(event_struct) 660 return 661 662 663def button_cancel_event_handler(event_struct): 664 global \ 665 page_live, \ 666 page_edit, \ 667 label_title, \ 668 label_date, \ 669 label_live_hour, \ 670 label_live_colon_1, \ 671 label_live_min, \ 672 label_live_colon_2, \ 673 label_live_sec, \ 674 button_set, \ 675 label_edit_title, \ 676 label_hour_name, \ 677 label_min_name, \ 678 label_sec_name, \ 679 label_hour, \ 680 label_min, \ 681 label_sec, \ 682 button_hour_plus, \ 683 button_hour_minus, \ 684 button_min_plus, \ 685 button_min_minus, \ 686 button_sec_plus, \ 687 button_sec_minus, \ 688 button_cancel, \ 689 button_save, \ 690 rtc, \ 691 edit_hour, \ 692 edit_min, \ 693 edit_sec 694 event = event_struct.code 695 if event == lv.EVENT.CLICKED and True: 696 button_cancel_clicked_event(event_struct) 697 return 698 699 700def button_save_event_handler(event_struct): 701 global \ 702 page_live, \ 703 page_edit, \ 704 label_title, \ 705 label_date, \ 706 label_live_hour, \ 707 label_live_colon_1, \ 708 label_live_min, \ 709 label_live_colon_2, \ 710 label_live_sec, \ 711 button_set, \ 712 label_edit_title, \ 713 label_hour_name, \ 714 label_min_name, \ 715 label_sec_name, \ 716 label_hour, \ 717 label_min, \ 718 label_sec, \ 719 button_hour_plus, \ 720 button_hour_minus, \ 721 button_min_plus, \ 722 button_min_minus, \ 723 button_sec_plus, \ 724 button_sec_minus, \ 725 button_cancel, \ 726 button_save, \ 727 rtc, \ 728 edit_hour, \ 729 edit_min, \ 730 edit_sec 731 event = event_struct.code 732 if event == lv.EVENT.CLICKED and True: 733 button_save_clicked_event(event_struct) 734 return 735 736 737def setup(): 738 global \ 739 page_live, \ 740 page_edit, \ 741 label_title, \ 742 label_date, \ 743 label_live_hour, \ 744 label_live_colon_1, \ 745 label_live_min, \ 746 label_live_colon_2, \ 747 label_live_sec, \ 748 button_set, \ 749 label_edit_title, \ 750 label_hour_name, \ 751 label_min_name, \ 752 label_sec_name, \ 753 label_hour, \ 754 label_min, \ 755 label_sec, \ 756 button_hour_plus, \ 757 button_hour_minus, \ 758 button_min_plus, \ 759 button_min_minus, \ 760 button_sec_plus, \ 761 button_sec_minus, \ 762 button_cancel, \ 763 button_save, \ 764 rtc, \ 765 edit_hour, \ 766 edit_min, \ 767 edit_sec 768 769 M5.begin() 770 Widgets.setRotation(0) 771 m5ui.init() 772 page_live = m5ui.M5Page(bg_c=0x080808) 773 page_edit = m5ui.M5Page(bg_c=0x080808) 774 label_title = m5ui.M5Label( 775 "RTC (UTC)", 776 x=24, 777 y=22, 778 text_c=0xF1F5F7, 779 bg_c=0x101820, 780 bg_opa=0, 781 font=lv.font_montserrat_24, 782 parent=page_live, 783 ) 784 label_date = m5ui.M5Label( 785 "---- -- --", 786 x=175, 787 y=104, 788 text_c=0xF1F5F7, 789 bg_c=0x101820, 790 bg_opa=0, 791 font=lv.font_montserrat_24, 792 parent=page_live, 793 ) 794 label_live_hour = m5ui.M5Label( 795 "--", 796 x=105, 797 y=160, 798 text_c=0x4DA6FF, 799 bg_c=0x101820, 800 bg_opa=0, 801 font=lv.font_montserrat_48, 802 parent=page_live, 803 ) 804 label_live_colon_1 = m5ui.M5Label( 805 ":", 806 x=175, 807 y=156, 808 text_c=0x4DA6FF, 809 bg_c=0x101820, 810 bg_opa=0, 811 font=lv.font_montserrat_48, 812 parent=page_live, 813 ) 814 label_live_min = m5ui.M5Label( 815 "--", 816 x=205, 817 y=160, 818 text_c=0x4DA6FF, 819 bg_c=0x101820, 820 bg_opa=0, 821 font=lv.font_montserrat_48, 822 parent=page_live, 823 ) 824 label_live_colon_2 = m5ui.M5Label( 825 ":", 826 x=275, 827 y=156, 828 text_c=0x4DA6FF, 829 bg_c=0x101820, 830 bg_opa=0, 831 font=lv.font_montserrat_48, 832 parent=page_live, 833 ) 834 label_live_sec = m5ui.M5Label( 835 "--", 836 x=305, 837 y=160, 838 text_c=0x4DA6FF, 839 bg_c=0x101820, 840 bg_opa=0, 841 font=lv.font_montserrat_48, 842 parent=page_live, 843 ) 844 button_set = m5ui.M5Button( 845 text="SET TIME", 846 x=32, 847 y=368, 848 bg_c=0x245A85, 849 text_c=0xFFFFFF, 850 font=lv.font_montserrat_18, 851 parent=page_live, 852 ) 853 label_edit_title = m5ui.M5Label( 854 "Set UTC Time", 855 x=158, 856 y=22, 857 text_c=0xF1F5F7, 858 bg_c=0x101820, 859 bg_opa=0, 860 font=lv.font_montserrat_24, 861 parent=page_edit, 862 ) 863 label_hour_name = m5ui.M5Label( 864 "HOUR", 865 x=62, 866 y=72, 867 text_c=0xA9BAC4, 868 bg_c=0x101820, 869 bg_opa=0, 870 font=lv.font_montserrat_18, 871 parent=page_edit, 872 ) 873 label_min_name = m5ui.M5Label( 874 "MIN", 875 x=212, 876 y=72, 877 text_c=0xA9BAC4, 878 bg_c=0x101820, 879 bg_opa=0, 880 font=lv.font_montserrat_18, 881 parent=page_edit, 882 ) 883 label_sec_name = m5ui.M5Label( 884 "SEC", 885 x=362, 886 y=72, 887 text_c=0xA9BAC4, 888 bg_c=0x101820, 889 bg_opa=0, 890 font=lv.font_montserrat_18, 891 parent=page_edit, 892 ) 893 label_hour = m5ui.M5Label( 894 "00", 895 x=56, 896 y=190, 897 text_c=0x4DA6FF, 898 bg_c=0x101820, 899 bg_opa=0, 900 font=lv.font_montserrat_48, 901 parent=page_edit, 902 ) 903 label_min = m5ui.M5Label( 904 "00", 905 x=206, 906 y=190, 907 text_c=0x4DA6FF, 908 bg_c=0x101820, 909 bg_opa=0, 910 font=lv.font_montserrat_48, 911 parent=page_edit, 912 ) 913 label_sec = m5ui.M5Label( 914 "00", 915 x=356, 916 y=190, 917 text_c=0x4DA6FF, 918 bg_c=0x101820, 919 bg_opa=0, 920 font=lv.font_montserrat_48, 921 parent=page_edit, 922 ) 923 button_hour_plus = m5ui.M5Button( 924 text="+", 925 x=36, 926 y=106, 927 bg_c=0x176C48, 928 text_c=0xFFFFFF, 929 font=lv.font_montserrat_18, 930 parent=page_edit, 931 ) 932 button_hour_minus = m5ui.M5Button( 933 text="-", 934 x=36, 935 y=270, 936 bg_c=0x7A2731, 937 text_c=0xFFFFFF, 938 font=lv.font_montserrat_18, 939 parent=page_edit, 940 ) 941 button_min_plus = m5ui.M5Button( 942 text="+", 943 x=186, 944 y=106, 945 bg_c=0x176C48, 946 text_c=0xFFFFFF, 947 font=lv.font_montserrat_18, 948 parent=page_edit, 949 ) 950 button_min_minus = m5ui.M5Button( 951 text="-", 952 x=186, 953 y=270, 954 bg_c=0x7A2731, 955 text_c=0xFFFFFF, 956 font=lv.font_montserrat_18, 957 parent=page_edit, 958 ) 959 button_sec_plus = m5ui.M5Button( 960 text="+", 961 x=336, 962 y=106, 963 bg_c=0x176C48, 964 text_c=0xFFFFFF, 965 font=lv.font_montserrat_18, 966 parent=page_edit, 967 ) 968 button_sec_minus = m5ui.M5Button( 969 text="-", 970 x=336, 971 y=270, 972 bg_c=0x7A2731, 973 text_c=0xFFFFFF, 974 font=lv.font_montserrat_18, 975 parent=page_edit, 976 ) 977 button_cancel = m5ui.M5Button( 978 text="CANCEL", 979 x=32, 980 y=368, 981 bg_c=0x3B4850, 982 text_c=0xFFFFFF, 983 font=lv.font_montserrat_18, 984 parent=page_edit, 985 ) 986 button_save = m5ui.M5Button( 987 text="SAVE", 988 x=252, 989 y=368, 990 bg_c=0x245A85, 991 text_c=0xFFFFFF, 992 font=lv.font_montserrat_18, 993 parent=page_edit, 994 ) 995 996 button_set.add_event_cb(button_set_event_handler, lv.EVENT.ALL, None) 997 button_hour_plus.add_event_cb(button_hour_plus_event_handler, lv.EVENT.ALL, None) 998 button_hour_minus.add_event_cb(button_hour_minus_event_handler, lv.EVENT.ALL, None) 999 button_min_plus.add_event_cb(button_min_plus_event_handler, lv.EVENT.ALL, None) 1000 button_min_minus.add_event_cb(button_min_minus_event_handler, lv.EVENT.ALL, None) 1001 button_sec_plus.add_event_cb(button_sec_plus_event_handler, lv.EVENT.ALL, None) 1002 button_sec_minus.add_event_cb(button_sec_minus_event_handler, lv.EVENT.ALL, None) 1003 button_cancel.add_event_cb(button_cancel_event_handler, lv.EVENT.ALL, None) 1004 button_save.add_event_cb(button_save_event_handler, lv.EVENT.ALL, None) 1005 1006 page_live.screen_load() 1007 rtc = RTC() 1008 button_set.set_size(416, 72) 1009 button_hour_plus.set_size(108, 54) 1010 button_hour_minus.set_size(108, 54) 1011 button_min_plus.set_size(108, 54) 1012 button_min_minus.set_size(108, 54) 1013 button_sec_plus.set_size(108, 54) 1014 button_sec_minus.set_size(108, 54) 1015 button_cancel.set_size(196, 72) 1016 button_save.set_size(196, 72) 1017 label_date.align_to(page_live, lv.ALIGN.TOP_MID, 0, 104) 1018 1019 1020def loop(): 1021 global \ 1022 page_live, \ 1023 page_edit, \ 1024 label_title, \ 1025 label_date, \ 1026 label_live_hour, \ 1027 label_live_colon_1, \ 1028 label_live_min, \ 1029 label_live_colon_2, \ 1030 label_live_sec, \ 1031 button_set, \ 1032 label_edit_title, \ 1033 label_hour_name, \ 1034 label_min_name, \ 1035 label_sec_name, \ 1036 label_hour, \ 1037 label_min, \ 1038 label_sec, \ 1039 button_hour_plus, \ 1040 button_hour_minus, \ 1041 button_min_plus, \ 1042 button_min_minus, \ 1043 button_sec_plus, \ 1044 button_sec_minus, \ 1045 button_cancel, \ 1046 button_save, \ 1047 rtc, \ 1048 edit_hour, \ 1049 edit_min, \ 1050 edit_sec 1051 M5.update() 1052 label_date.set_text( 1053 str( 1054 ( 1055 str( 1056 ( 1057 str((str((str("") + str(((rtc.datetime())[0])))) + str("-"))) 1058 + str(((rtc.datetime())[1])) 1059 ) 1060 ) 1061 + str((str("-") + str(((rtc.datetime())[2])))) 1062 ) 1063 ) 1064 ) 1065 if (rtc.datetime())[4] < 10: 1066 label_live_hour.set_text(str((str("0") + str(((rtc.datetime())[4]))))) 1067 else: 1068 label_live_hour.set_text(str((rtc.datetime())[4])) 1069 if (rtc.datetime())[5] < 10: 1070 label_live_min.set_text(str((str("0") + str(((rtc.datetime())[5]))))) 1071 else: 1072 label_live_min.set_text(str((rtc.datetime())[5])) 1073 if (rtc.datetime())[6] < 10: 1074 label_live_sec.set_text(str((str("0") + str(((rtc.datetime())[6]))))) 1075 else: 1076 label_live_sec.set_text(str((rtc.datetime())[6])) 1077 label_date.align_to(page_live, lv.ALIGN.TOP_MID, 0, 104) 1078 time.sleep_ms(100) 1079 1080 1081if __name__ == "__main__": 1082 try: 1083 setup() 1084 while True: 1085 loop() 1086 except (Exception, KeyboardInterrupt) as e: 1087 try: 1088 m5ui.deinit() 1089 from utility import print_error_msg 1090 1091 print_error_msg(e) 1092 except ImportError: 1093 print("please update to latest firmware")
Example output:
None
IMU Sensor
Display the X, Y, and Z readings from the built-in accelerometer and gyroscope. Acceleration is shown in g, and angular velocity in degrees per second (dps). Tilt or rotate the device to observe the readings.
MicroPython Code Block:
1# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD 2# 3# SPDX-License-Identifier: MIT 4 5import os, sys, io 6import M5 7from M5 import * 8import m5ui 9import lvgl as lv 10import time 11 12 13page0 = None 14label_title = None 15label_subtitle = None 16label_acc_x = None 17label_acc_y = None 18label_acc_z = None 19label_gyro_x = None 20label_gyro_y = None 21label_gyro_z = None 22label_gyro_title = None 23accel = None 24gyro = None 25acc_x = None 26acc_y = None 27acc_z = None 28gyro_x = None 29gyro_y = None 30gyro_z = None 31 32 33def setup(): 34 global \ 35 page0, \ 36 label_title, \ 37 label_subtitle, \ 38 label_acc_x, \ 39 label_acc_y, \ 40 label_acc_z, \ 41 label_gyro_x, \ 42 label_gyro_y, \ 43 label_gyro_z, \ 44 label_gyro_title, \ 45 accel, \ 46 gyro, \ 47 acc_x, \ 48 acc_y, \ 49 acc_z, \ 50 gyro_x, \ 51 gyro_y, \ 52 gyro_z 53 54 M5.begin() 55 Widgets.setRotation(0) 56 m5ui.init() 57 page0 = m5ui.M5Page(bg_c=0x080808) 58 label_title = m5ui.M5Label( 59 "IMU", 60 x=24, 61 y=18, 62 text_c=0xF1F5F7, 63 bg_c=0x101820, 64 bg_opa=0, 65 font=lv.font_montserrat_24, 66 parent=page0, 67 ) 68 label_subtitle = m5ui.M5Label( 69 "Accel (g)", 70 x=199, 71 y=82, 72 text_c=0xA9BAC4, 73 bg_c=0x101820, 74 bg_opa=0, 75 font=lv.font_montserrat_18, 76 parent=page0, 77 ) 78 label_acc_x = m5ui.M5Label( 79 "X: -- g", 80 x=48, 81 y=116, 82 text_c=0x45D483, 83 bg_c=0x101820, 84 bg_opa=0, 85 font=lv.font_montserrat_24, 86 parent=page0, 87 ) 88 label_acc_y = m5ui.M5Label( 89 "Y: -- g", 90 x=48, 91 y=156, 92 text_c=0x45D483, 93 bg_c=0x101820, 94 bg_opa=0, 95 font=lv.font_montserrat_24, 96 parent=page0, 97 ) 98 label_acc_z = m5ui.M5Label( 99 "Z: -- g", 100 x=48, 101 y=196, 102 text_c=0x45D483, 103 bg_c=0x101820, 104 bg_opa=0, 105 font=lv.font_montserrat_24, 106 parent=page0, 107 ) 108 label_gyro_x = m5ui.M5Label( 109 "X: -- dps", 110 x=48, 111 y=300, 112 text_c=0xFFD04D, 113 bg_c=0x101820, 114 bg_opa=0, 115 font=lv.font_montserrat_24, 116 parent=page0, 117 ) 118 label_gyro_y = m5ui.M5Label( 119 "Y: -- dps", 120 x=48, 121 y=340, 122 text_c=0xFFD04D, 123 bg_c=0x101820, 124 bg_opa=0, 125 font=lv.font_montserrat_24, 126 parent=page0, 127 ) 128 label_gyro_z = m5ui.M5Label( 129 "Z: -- dps", 130 x=48, 131 y=380, 132 text_c=0xFFD04D, 133 bg_c=0x101820, 134 bg_opa=0, 135 font=lv.font_montserrat_24, 136 parent=page0, 137 ) 138 label_gyro_title = m5ui.M5Label( 139 "Gyro (dps)", 140 x=192, 141 y=266, 142 text_c=0xA9BAC4, 143 bg_c=0x101820, 144 bg_opa=0, 145 font=lv.font_montserrat_18, 146 parent=page0, 147 ) 148 149 page0.screen_load() 150 151 152def loop(): 153 global \ 154 page0, \ 155 label_title, \ 156 label_subtitle, \ 157 label_acc_x, \ 158 label_acc_y, \ 159 label_acc_z, \ 160 label_gyro_x, \ 161 label_gyro_y, \ 162 label_gyro_z, \ 163 label_gyro_title, \ 164 accel, \ 165 gyro, \ 166 acc_x, \ 167 acc_y, \ 168 acc_z, \ 169 gyro_x, \ 170 gyro_y, \ 171 gyro_z 172 M5.update() 173 accel = Imu.getAccel() 174 gyro = Imu.getGyro() 175 acc_x = accel[0] 176 acc_y = accel[1] 177 acc_z = accel[2] 178 gyro_x = gyro[0] 179 gyro_y = gyro[1] 180 gyro_z = gyro[2] 181 label_acc_x.set_text(str((str("X: ") + str((str(acc_x) + str(" g")))))) 182 label_acc_y.set_text(str((str("Y: ") + str((str(acc_y) + str(" g")))))) 183 label_acc_z.set_text(str((str("Z: ") + str((str(acc_z) + str(" g")))))) 184 label_gyro_x.set_text(str((str("X: ") + str((str(gyro_x) + str(" dps")))))) 185 label_gyro_y.set_text(str((str("Y: ") + str((str(gyro_y) + str(" dps")))))) 186 label_gyro_z.set_text(str((str("Z: ") + str((str(gyro_z) + str(" dps")))))) 187 time.sleep_ms(200) 188 189 190if __name__ == "__main__": 191 try: 192 setup() 193 while True: 194 loop() 195 except (Exception, KeyboardInterrupt) as e: 196 try: 197 m5ui.deinit() 198 from utility import print_error_msg 199 200 print_error_msg(e) 201 except ImportError: 202 print("please update to latest firmware")
Example output:
None
Power Management
Display USB VBUS and battery voltages in mV, charging status, Port A 5 V output, and charge control. The battery voltage turns green while the battery is charging. Tap PORT A to toggle external output and CHARGE to enable or disable charging. Battery percentage is not displayed.
MicroPython Code Block:
1# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD 2# 3# SPDX-License-Identifier: MIT 4 5import os, sys, io 6import M5 7from M5 import * 8import m5ui 9import lvgl as lv 10import time 11 12 13page0 = None 14label_title = None 15label_vbus = None 16label_battery = None 17label_charging = None 18label_port_a = None 19label_charge_control = None 20label_action = None 21label_vbus_name = None 22label_battery_name = None 23label_charging_name = None 24label_port_a_name = None 25label_charge_control_name = None 26button_port_a = None 27button_charge = None 28 29 30port_a_enabled = None 31charge_enabled = None 32 33 34def button_port_a_clicked_event(event_struct): 35 global \ 36 page0, \ 37 label_title, \ 38 label_vbus, \ 39 label_battery, \ 40 label_charging, \ 41 label_port_a, \ 42 label_charge_control, \ 43 label_action, \ 44 label_vbus_name, \ 45 label_battery_name, \ 46 label_charging_name, \ 47 label_port_a_name, \ 48 label_charge_control_name, \ 49 button_port_a, \ 50 button_charge, \ 51 port_a_enabled, \ 52 charge_enabled 53 port_a_enabled = not port_a_enabled 54 if port_a_enabled: 55 Power.setExtOutput(True, 1) 56 else: 57 Power.setExtOutput(False, 1) 58 if port_a_enabled: 59 button_port_a.set_btn_text(str("PORT A: ON")) 60 label_port_a.set_text(str("ON")) 61 else: 62 button_port_a.set_btn_text(str("PORT A: OFF")) 63 label_port_a.set_text(str("OFF")) 64 label_action.set_text(str("Port A 5V updated")) 65 66 67def button_charge_clicked_event(event_struct): 68 global \ 69 page0, \ 70 label_title, \ 71 label_vbus, \ 72 label_battery, \ 73 label_charging, \ 74 label_port_a, \ 75 label_charge_control, \ 76 label_action, \ 77 label_vbus_name, \ 78 label_battery_name, \ 79 label_charging_name, \ 80 label_port_a_name, \ 81 label_charge_control_name, \ 82 button_port_a, \ 83 button_charge, \ 84 port_a_enabled, \ 85 charge_enabled 86 charge_enabled = not charge_enabled 87 if charge_enabled: 88 Power.setBatteryCharge(True) 89 else: 90 Power.setBatteryCharge(False) 91 if charge_enabled: 92 button_charge.set_btn_text(str("CHARGE: ON")) 93 label_charge_control.set_text(str("ON")) 94 else: 95 button_charge.set_btn_text(str("CHARGE: OFF")) 96 label_charge_control.set_text(str("OFF")) 97 label_action.set_text(str("Charge control updated")) 98 99 100def button_port_a_event_handler(event_struct): 101 global \ 102 page0, \ 103 label_title, \ 104 label_vbus, \ 105 label_battery, \ 106 label_charging, \ 107 label_port_a, \ 108 label_charge_control, \ 109 label_action, \ 110 label_vbus_name, \ 111 label_battery_name, \ 112 label_charging_name, \ 113 label_port_a_name, \ 114 label_charge_control_name, \ 115 button_port_a, \ 116 button_charge, \ 117 port_a_enabled, \ 118 charge_enabled 119 event = event_struct.code 120 if event == lv.EVENT.CLICKED and True: 121 button_port_a_clicked_event(event_struct) 122 return 123 124 125def button_charge_event_handler(event_struct): 126 global \ 127 page0, \ 128 label_title, \ 129 label_vbus, \ 130 label_battery, \ 131 label_charging, \ 132 label_port_a, \ 133 label_charge_control, \ 134 label_action, \ 135 label_vbus_name, \ 136 label_battery_name, \ 137 label_charging_name, \ 138 label_port_a_name, \ 139 label_charge_control_name, \ 140 button_port_a, \ 141 button_charge, \ 142 port_a_enabled, \ 143 charge_enabled 144 event = event_struct.code 145 if event == lv.EVENT.CLICKED and True: 146 button_charge_clicked_event(event_struct) 147 return 148 149 150def setup(): 151 global \ 152 page0, \ 153 label_title, \ 154 label_vbus, \ 155 label_battery, \ 156 label_charging, \ 157 label_port_a, \ 158 label_charge_control, \ 159 label_action, \ 160 label_vbus_name, \ 161 label_battery_name, \ 162 label_charging_name, \ 163 label_port_a_name, \ 164 label_charge_control_name, \ 165 button_port_a, \ 166 button_charge, \ 167 port_a_enabled, \ 168 charge_enabled 169 170 M5.begin() 171 Widgets.setRotation(0) 172 m5ui.init() 173 page0 = m5ui.M5Page(bg_c=0x080808) 174 label_title = m5ui.M5Label( 175 "Power", 176 x=24, 177 y=18, 178 text_c=0xF1F5F7, 179 bg_c=0x101820, 180 bg_opa=0, 181 font=lv.font_montserrat_24, 182 parent=page0, 183 ) 184 label_vbus = m5ui.M5Label( 185 "---- mV", 186 x=284, 187 y=82, 188 text_c=0xF1F5F7, 189 bg_c=0x101820, 190 bg_opa=0, 191 font=lv.font_montserrat_18, 192 parent=page0, 193 ) 194 label_battery = m5ui.M5Label( 195 "---- mV", 196 x=284, 197 y=124, 198 text_c=0xF1F5F7, 199 bg_c=0x101820, 200 bg_opa=0, 201 font=lv.font_montserrat_18, 202 parent=page0, 203 ) 204 label_charging = m5ui.M5Label( 205 "--", 206 x=284, 207 y=166, 208 text_c=0xF1F5F7, 209 bg_c=0x101820, 210 bg_opa=0, 211 font=lv.font_montserrat_18, 212 parent=page0, 213 ) 214 label_port_a = m5ui.M5Label( 215 "OFF", 216 x=284, 217 y=208, 218 text_c=0xF1F5F7, 219 bg_c=0x101820, 220 bg_opa=0, 221 font=lv.font_montserrat_18, 222 parent=page0, 223 ) 224 label_charge_control = m5ui.M5Label( 225 "ON", 226 x=284, 227 y=250, 228 text_c=0xF1F5F7, 229 bg_c=0x101820, 230 bg_opa=0, 231 font=lv.font_montserrat_18, 232 parent=page0, 233 ) 234 label_action = m5ui.M5Label( 235 "Power controls ready", 236 x=24, 237 y=342, 238 text_c=0xA9BAC4, 239 bg_c=0x101820, 240 bg_opa=0, 241 font=lv.font_montserrat_18, 242 parent=page0, 243 ) 244 label_vbus_name = m5ui.M5Label( 245 "USB VBUS", 246 x=24, 247 y=82, 248 text_c=0xA9BAC4, 249 bg_c=0x101820, 250 bg_opa=0, 251 font=lv.font_montserrat_18, 252 parent=page0, 253 ) 254 label_battery_name = m5ui.M5Label( 255 "Battery", 256 x=24, 257 y=124, 258 text_c=0xA9BAC4, 259 bg_c=0x101820, 260 bg_opa=0, 261 font=lv.font_montserrat_18, 262 parent=page0, 263 ) 264 label_charging_name = m5ui.M5Label( 265 "Charging", 266 x=24, 267 y=166, 268 text_c=0xA9BAC4, 269 bg_c=0x101820, 270 bg_opa=0, 271 font=lv.font_montserrat_18, 272 parent=page0, 273 ) 274 label_port_a_name = m5ui.M5Label( 275 "Port A 5 V", 276 x=24, 277 y=208, 278 text_c=0xA9BAC4, 279 bg_c=0x101820, 280 bg_opa=0, 281 font=lv.font_montserrat_18, 282 parent=page0, 283 ) 284 label_charge_control_name = m5ui.M5Label( 285 "Charge control", 286 x=24, 287 y=250, 288 text_c=0xA9BAC4, 289 bg_c=0x101820, 290 bg_opa=0, 291 font=lv.font_montserrat_18, 292 parent=page0, 293 ) 294 button_port_a = m5ui.M5Button( 295 text="PORT A: OFF", 296 x=24, 297 y=388, 298 bg_c=0x245A85, 299 text_c=0xF1F5F7, 300 font=lv.font_montserrat_18, 301 parent=page0, 302 ) 303 button_charge = m5ui.M5Button( 304 text="CHARGE: ON", 305 x=252, 306 y=388, 307 bg_c=0x245A85, 308 text_c=0xF1F5F7, 309 font=lv.font_montserrat_18, 310 parent=page0, 311 ) 312 313 button_port_a.add_event_cb(button_port_a_event_handler, lv.EVENT.ALL, None) 314 button_charge.add_event_cb(button_charge_event_handler, lv.EVENT.ALL, None) 315 316 page0.screen_load() 317 Power.setExtOutput(False, 1) 318 Power.setBatteryCharge(True) 319 port_a_enabled = False 320 charge_enabled = True 321 button_port_a.set_size(204, 64) 322 button_charge.set_size(204, 64) 323 324 325def loop(): 326 global \ 327 page0, \ 328 label_title, \ 329 label_vbus, \ 330 label_battery, \ 331 label_charging, \ 332 label_port_a, \ 333 label_charge_control, \ 334 label_action, \ 335 label_vbus_name, \ 336 label_battery_name, \ 337 label_charging_name, \ 338 label_port_a_name, \ 339 label_charge_control_name, \ 340 button_port_a, \ 341 button_charge, \ 342 port_a_enabled, \ 343 charge_enabled 344 M5.update() 345 label_vbus.set_text(str((str("") + str((str((Power.getVBUSVoltage())) + str(" mV")))))) 346 label_battery.set_text(str((str("") + str((str((Power.getBatteryVoltage())) + str(" mV")))))) 347 if Power.isCharging(): 348 label_charging.set_text(str("YES")) 349 label_battery.set_text_color(0x8EDA91, 255, 0) 350 else: 351 label_charging.set_text(str("NO")) 352 label_battery.set_text_color(0xF1F5F7, 255, 0) 353 time.sleep_ms(500) 354 355 356if __name__ == "__main__": 357 try: 358 setup() 359 while True: 360 loop() 361 except (Exception, KeyboardInterrupt) as e: 362 try: 363 m5ui.deinit() 364 from utility import print_error_msg 365 366 print_error_msg(e) 367 except ImportError: 368 print("please update to latest firmware")
Example output:
None
Speaker Tone
Use separate sliders to adjust frequency from 200 to 4000 Hz and volume from 0 to 100%. The default values are 1000 Hz and 70%. Tap Start tone or Stop tone to control playback. The PA switch controls the amplifier independently; it is enabled at startup, while tone playback is stopped. Turning PA off mutes the output without stopping the tone.
MicroPython Code Block:
1# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD 2# 3# SPDX-License-Identifier: MIT 4 5import os, sys, io 6import M5 7from M5 import * 8import m5ui 9import lvgl as lv 10import time 11 12 13page0 = None 14label_title = None 15label_output = None 16label_pa = None 17pa_switch = None 18label_frequency_title = None 19label_frequency = None 20frequency_slider = None 21label_frequency_min = None 22label_frequency_max = None 23label_volume_title = None 24label_volume = None 25volume_slider = None 26label_volume_min = None 27label_volume_max = None 28tone_button = None 29 30 31pa_requested = None 32frequency = None 33tone_toggle_pending = None 34volume = None 35pa_change_pending = None 36frequency_change_pending = None 37volume_change_pending = None 38tone_enabled = None 39pa_enabled = None 40 41 42def pa_switch_checked_event(event_struct): 43 global \ 44 page0, \ 45 label_title, \ 46 label_output, \ 47 label_pa, \ 48 pa_switch, \ 49 label_frequency_title, \ 50 label_frequency, \ 51 frequency_slider, \ 52 label_frequency_min, \ 53 label_frequency_max, \ 54 label_volume_title, \ 55 label_volume, \ 56 volume_slider, \ 57 label_volume_min, \ 58 label_volume_max, \ 59 tone_button, \ 60 pa_requested, \ 61 frequency, \ 62 tone_toggle_pending, \ 63 volume, \ 64 pa_change_pending, \ 65 frequency_change_pending, \ 66 volume_change_pending, \ 67 tone_enabled, \ 68 pa_enabled 69 pa_requested = pa_switch.has_state(lv.STATE.CHECKED) 70 pa_change_pending = True 71 72 73def pa_switch_unchecked_event(event_struct): 74 global \ 75 page0, \ 76 label_title, \ 77 label_output, \ 78 label_pa, \ 79 pa_switch, \ 80 label_frequency_title, \ 81 label_frequency, \ 82 frequency_slider, \ 83 label_frequency_min, \ 84 label_frequency_max, \ 85 label_volume_title, \ 86 label_volume, \ 87 volume_slider, \ 88 label_volume_min, \ 89 label_volume_max, \ 90 tone_button, \ 91 pa_requested, \ 92 frequency, \ 93 tone_toggle_pending, \ 94 volume, \ 95 pa_change_pending, \ 96 frequency_change_pending, \ 97 volume_change_pending, \ 98 tone_enabled, \ 99 pa_enabled 100 pa_requested = pa_switch.has_state(lv.STATE.CHECKED) 101 pa_change_pending = True 102 103 104def frequency_slider_value_changed_event(event_struct): 105 global \ 106 page0, \ 107 label_title, \ 108 label_output, \ 109 label_pa, \ 110 pa_switch, \ 111 label_frequency_title, \ 112 label_frequency, \ 113 frequency_slider, \ 114 label_frequency_min, \ 115 label_frequency_max, \ 116 label_volume_title, \ 117 label_volume, \ 118 volume_slider, \ 119 label_volume_min, \ 120 label_volume_max, \ 121 tone_button, \ 122 pa_requested, \ 123 frequency, \ 124 tone_toggle_pending, \ 125 volume, \ 126 pa_change_pending, \ 127 frequency_change_pending, \ 128 volume_change_pending, \ 129 tone_enabled, \ 130 pa_enabled 131 frequency = frequency_slider.get_value() 132 label_frequency.set_text(str((str(frequency) + str(" Hz")))) 133 label_frequency.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 152) 134 frequency_change_pending = True 135 136 137def tone_button_clicked_event(event_struct): 138 global \ 139 page0, \ 140 label_title, \ 141 label_output, \ 142 label_pa, \ 143 pa_switch, \ 144 label_frequency_title, \ 145 label_frequency, \ 146 frequency_slider, \ 147 label_frequency_min, \ 148 label_frequency_max, \ 149 label_volume_title, \ 150 label_volume, \ 151 volume_slider, \ 152 label_volume_min, \ 153 label_volume_max, \ 154 tone_button, \ 155 pa_requested, \ 156 frequency, \ 157 tone_toggle_pending, \ 158 volume, \ 159 pa_change_pending, \ 160 frequency_change_pending, \ 161 volume_change_pending, \ 162 tone_enabled, \ 163 pa_enabled 164 tone_toggle_pending = True 165 166 167def volume_slider_value_changed_event(event_struct): 168 global \ 169 page0, \ 170 label_title, \ 171 label_output, \ 172 label_pa, \ 173 pa_switch, \ 174 label_frequency_title, \ 175 label_frequency, \ 176 frequency_slider, \ 177 label_frequency_min, \ 178 label_frequency_max, \ 179 label_volume_title, \ 180 label_volume, \ 181 volume_slider, \ 182 label_volume_min, \ 183 label_volume_max, \ 184 tone_button, \ 185 pa_requested, \ 186 frequency, \ 187 tone_toggle_pending, \ 188 volume, \ 189 pa_change_pending, \ 190 frequency_change_pending, \ 191 volume_change_pending, \ 192 tone_enabled, \ 193 pa_enabled 194 volume = volume_slider.get_value() 195 label_volume.set_text(str((str(volume) + str("%")))) 196 label_volume.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 272) 197 volume_change_pending = True 198 199 200def pa_switch_event_handler(event_struct): 201 global \ 202 page0, \ 203 label_title, \ 204 label_output, \ 205 label_pa, \ 206 pa_switch, \ 207 label_frequency_title, \ 208 label_frequency, \ 209 frequency_slider, \ 210 label_frequency_min, \ 211 label_frequency_max, \ 212 label_volume_title, \ 213 label_volume, \ 214 volume_slider, \ 215 label_volume_min, \ 216 label_volume_max, \ 217 tone_button, \ 218 pa_requested, \ 219 frequency, \ 220 tone_toggle_pending, \ 221 volume, \ 222 pa_change_pending, \ 223 frequency_change_pending, \ 224 volume_change_pending, \ 225 tone_enabled, \ 226 pa_enabled 227 event = event_struct.code 228 obj = event_struct.get_target_obj() 229 if event == lv.EVENT.VALUE_CHANGED: 230 if obj.has_state(lv.STATE.CHECKED): 231 pa_switch_checked_event(event_struct) 232 else: 233 pa_switch_unchecked_event(event_struct) 234 return 235 236 237def frequency_slider_event_handler(event_struct): 238 global \ 239 page0, \ 240 label_title, \ 241 label_output, \ 242 label_pa, \ 243 pa_switch, \ 244 label_frequency_title, \ 245 label_frequency, \ 246 frequency_slider, \ 247 label_frequency_min, \ 248 label_frequency_max, \ 249 label_volume_title, \ 250 label_volume, \ 251 volume_slider, \ 252 label_volume_min, \ 253 label_volume_max, \ 254 tone_button, \ 255 pa_requested, \ 256 frequency, \ 257 tone_toggle_pending, \ 258 volume, \ 259 pa_change_pending, \ 260 frequency_change_pending, \ 261 volume_change_pending, \ 262 tone_enabled, \ 263 pa_enabled 264 event = event_struct.code 265 if event == lv.EVENT.VALUE_CHANGED and True: 266 frequency_slider_value_changed_event(event_struct) 267 return 268 269 270def tone_button_event_handler(event_struct): 271 global \ 272 page0, \ 273 label_title, \ 274 label_output, \ 275 label_pa, \ 276 pa_switch, \ 277 label_frequency_title, \ 278 label_frequency, \ 279 frequency_slider, \ 280 label_frequency_min, \ 281 label_frequency_max, \ 282 label_volume_title, \ 283 label_volume, \ 284 volume_slider, \ 285 label_volume_min, \ 286 label_volume_max, \ 287 tone_button, \ 288 pa_requested, \ 289 frequency, \ 290 tone_toggle_pending, \ 291 volume, \ 292 pa_change_pending, \ 293 frequency_change_pending, \ 294 volume_change_pending, \ 295 tone_enabled, \ 296 pa_enabled 297 event = event_struct.code 298 if event == lv.EVENT.CLICKED and True: 299 tone_button_clicked_event(event_struct) 300 return 301 302 303def volume_slider_event_handler(event_struct): 304 global \ 305 page0, \ 306 label_title, \ 307 label_output, \ 308 label_pa, \ 309 pa_switch, \ 310 label_frequency_title, \ 311 label_frequency, \ 312 frequency_slider, \ 313 label_frequency_min, \ 314 label_frequency_max, \ 315 label_volume_title, \ 316 label_volume, \ 317 volume_slider, \ 318 label_volume_min, \ 319 label_volume_max, \ 320 tone_button, \ 321 pa_requested, \ 322 frequency, \ 323 tone_toggle_pending, \ 324 volume, \ 325 pa_change_pending, \ 326 frequency_change_pending, \ 327 volume_change_pending, \ 328 tone_enabled, \ 329 pa_enabled 330 event = event_struct.code 331 if event == lv.EVENT.VALUE_CHANGED and True: 332 volume_slider_value_changed_event(event_struct) 333 return 334 335 336def setup(): 337 global \ 338 page0, \ 339 label_title, \ 340 label_output, \ 341 label_pa, \ 342 pa_switch, \ 343 label_frequency_title, \ 344 label_frequency, \ 345 frequency_slider, \ 346 label_frequency_min, \ 347 label_frequency_max, \ 348 label_volume_title, \ 349 label_volume, \ 350 volume_slider, \ 351 label_volume_min, \ 352 label_volume_max, \ 353 tone_button, \ 354 pa_requested, \ 355 frequency, \ 356 tone_toggle_pending, \ 357 volume, \ 358 pa_change_pending, \ 359 frequency_change_pending, \ 360 volume_change_pending, \ 361 tone_enabled, \ 362 pa_enabled 363 364 M5.begin() 365 Widgets.setRotation(0) 366 m5ui.init() 367 page0 = m5ui.M5Page(bg_c=0x080808) 368 label_title = m5ui.M5Label( 369 "Speaker", 370 x=24, 371 y=24, 372 text_c=0xF4F4F5, 373 bg_c=0x080808, 374 bg_opa=0, 375 font=lv.font_montserrat_24, 376 parent=page0, 377 ) 378 label_output = m5ui.M5Label( 379 "Stopped", 380 x=384, 381 y=28, 382 text_c=0x9A9A9F, 383 bg_c=0x080808, 384 bg_opa=0, 385 font=lv.font_montserrat_18, 386 parent=page0, 387 ) 388 label_pa = m5ui.M5Label( 389 "Amplifier on", 390 x=24, 391 y=96, 392 text_c=0x8EDA91, 393 bg_c=0x080808, 394 bg_opa=0, 395 font=lv.font_montserrat_18, 396 parent=page0, 397 ) 398 pa_switch = m5ui.M5Switch( 399 x=384, 400 y=84, 401 w=72, 402 h=40, 403 bg_c=0x38383C, 404 bg_c_checked=0x8EDA91, 405 circle_c=0xF4F4F5, 406 parent=page0, 407 ) 408 label_frequency_title = m5ui.M5Label( 409 "Frequency", 410 x=24, 411 y=158, 412 text_c=0x9A9A9F, 413 bg_c=0x080808, 414 bg_opa=0, 415 font=lv.font_montserrat_18, 416 parent=page0, 417 ) 418 label_frequency = m5ui.M5Label( 419 "1000 Hz", 420 x=320, 421 y=152, 422 text_c=0xF4F4F5, 423 bg_c=0x080808, 424 bg_opa=0, 425 font=lv.font_montserrat_24, 426 parent=page0, 427 ) 428 frequency_slider = m5ui.M5Slider( 429 x=40, 430 y=206, 431 w=400, 432 h=16, 433 mode=lv.slider.MODE.NORMAL, 434 min_value=200, 435 max_value=4000, 436 value=1000, 437 bg_c=0x38383C, 438 color=0x4DA6FF, 439 parent=page0, 440 ) 441 label_frequency_min = m5ui.M5Label( 442 "200", 443 x=40, 444 y=232, 445 text_c=0x9A9A9F, 446 bg_c=0x080808, 447 bg_opa=0, 448 font=lv.font_montserrat_18, 449 parent=page0, 450 ) 451 label_frequency_max = m5ui.M5Label( 452 "4000", 453 x=384, 454 y=232, 455 text_c=0x9A9A9F, 456 bg_c=0x080808, 457 bg_opa=0, 458 font=lv.font_montserrat_18, 459 parent=page0, 460 ) 461 label_volume_title = m5ui.M5Label( 462 "Volume", 463 x=24, 464 y=278, 465 text_c=0x9A9A9F, 466 bg_c=0x080808, 467 bg_opa=0, 468 font=lv.font_montserrat_18, 469 parent=page0, 470 ) 471 label_volume = m5ui.M5Label( 472 "70%", 473 x=320, 474 y=272, 475 text_c=0xF4F4F5, 476 bg_c=0x080808, 477 bg_opa=0, 478 font=lv.font_montserrat_24, 479 parent=page0, 480 ) 481 volume_slider = m5ui.M5Slider( 482 x=40, 483 y=326, 484 w=400, 485 h=16, 486 mode=lv.slider.MODE.NORMAL, 487 min_value=0, 488 max_value=100, 489 value=70, 490 bg_c=0x38383C, 491 color=0x4DA6FF, 492 parent=page0, 493 ) 494 label_volume_min = m5ui.M5Label( 495 "0", 496 x=40, 497 y=352, 498 text_c=0x9A9A9F, 499 bg_c=0x080808, 500 bg_opa=0, 501 font=lv.font_montserrat_18, 502 parent=page0, 503 ) 504 label_volume_max = m5ui.M5Label( 505 "100%", 506 x=384, 507 y=352, 508 text_c=0x9A9A9F, 509 bg_c=0x080808, 510 bg_opa=0, 511 font=lv.font_montserrat_18, 512 parent=page0, 513 ) 514 tone_button = m5ui.M5Button( 515 text="Start tone", 516 x=24, 517 y=388, 518 bg_c=0x245A85, 519 text_c=0xF4F4F5, 520 font=lv.font_montserrat_18, 521 parent=page0, 522 ) 523 524 pa_switch.add_event_cb(pa_switch_event_handler, lv.EVENT.ALL, None) 525 frequency_slider.add_event_cb(frequency_slider_event_handler, lv.EVENT.ALL, None) 526 tone_button.add_event_cb(tone_button_event_handler, lv.EVENT.ALL, None) 527 volume_slider.add_event_cb(volume_slider_event_handler, lv.EVENT.ALL, None) 528 529 page0.screen_load() 530 Speaker.stop() 531 frequency = 1000 532 frequency_change_pending = False 533 pa_requested = True 534 pa_change_pending = False 535 Speaker.setPA(True) 536 pa_enabled = True 537 tone_toggle_pending = False 538 tone_enabled = False 539 volume = 70 540 volume_change_pending = False 541 pa_requested = pa_enabled 542 pa_switch.set_state(lv.STATE.CHECKED, pa_enabled) 543 Speaker.setVolume(int((volume * 255 + 50) / 100)) 544 if pa_enabled: 545 label_pa.set_text(str("Amplifier on")) 546 label_pa.set_text_color(0x8EDA91, 255, 0) 547 else: 548 label_pa.set_text(str("Amplifier off")) 549 label_pa.set_text_color(0x9A9A9F, 255, 0) 550 if tone_enabled and (Speaker.isPlaying()): 551 label_output.set_text(str("Playing")) 552 label_output.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 28) 553 label_output.set_text_color(0x8EDA91, 255, 0) 554 else: 555 label_output.set_text(str("Stopped")) 556 label_output.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 28) 557 label_output.set_text_color(0x9A9A9F, 255, 0) 558 if tone_enabled: 559 tone_button.set_btn_text(str("Stop tone")) 560 tone_button.set_bg_color(0x8EDA91, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 561 tone_button.set_text_color(0x000000, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 562 else: 563 tone_button.set_btn_text(str("Start tone")) 564 tone_button.set_bg_color(0x245A85, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 565 tone_button.set_text_color(0xF4F4F5, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 566 tone_button.set_size(432, 64) 567 label_frequency.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 152) 568 label_volume.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 272) 569 label_frequency_max.align_to(page0, lv.ALIGN.TOP_RIGHT, -40, 232) 570 label_volume_max.align_to(page0, lv.ALIGN.TOP_RIGHT, -40, 352) 571 frequency_slider.set_bg_color(0x4DA6FF, 255, lv.PART.KNOB | lv.STATE.DEFAULT) 572 volume_slider.set_bg_color(0x4DA6FF, 255, lv.PART.KNOB | lv.STATE.DEFAULT) 573 frequency_slider.set_bg_color(0x38383C, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 574 volume_slider.set_bg_color(0x38383C, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 575 576 577def loop(): 578 global \ 579 page0, \ 580 label_title, \ 581 label_output, \ 582 label_pa, \ 583 pa_switch, \ 584 label_frequency_title, \ 585 label_frequency, \ 586 frequency_slider, \ 587 label_frequency_min, \ 588 label_frequency_max, \ 589 label_volume_title, \ 590 label_volume, \ 591 volume_slider, \ 592 label_volume_min, \ 593 label_volume_max, \ 594 tone_button, \ 595 pa_requested, \ 596 frequency, \ 597 tone_toggle_pending, \ 598 volume, \ 599 pa_change_pending, \ 600 frequency_change_pending, \ 601 volume_change_pending, \ 602 tone_enabled, \ 603 pa_enabled 604 M5.update() 605 if pa_change_pending: 606 pa_change_pending = False 607 if pa_requested: 608 Speaker.setPA(True) 609 pa_enabled = True 610 else: 611 Speaker.setPA(False) 612 pa_enabled = False 613 if pa_enabled: 614 label_pa.set_text(str("Amplifier on")) 615 label_pa.set_text_color(0x8EDA91, 255, 0) 616 else: 617 label_pa.set_text(str("Amplifier off")) 618 label_pa.set_text_color(0x9A9A9F, 255, 0) 619 if tone_enabled and (Speaker.isPlaying()): 620 label_output.set_text(str("Playing")) 621 label_output.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 28) 622 label_output.set_text_color(0x8EDA91, 255, 0) 623 else: 624 label_output.set_text(str("Stopped")) 625 label_output.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 28) 626 label_output.set_text_color(0x9A9A9F, 255, 0) 627 if tone_enabled: 628 tone_button.set_btn_text(str("Stop tone")) 629 tone_button.set_bg_color(0x8EDA91, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 630 tone_button.set_text_color(0x000000, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 631 else: 632 tone_button.set_btn_text(str("Start tone")) 633 tone_button.set_bg_color(0x245A85, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 634 tone_button.set_text_color(0xF4F4F5, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 635 if tone_toggle_pending: 636 tone_toggle_pending = False 637 tone_enabled = not tone_enabled 638 if tone_enabled: 639 Speaker.tone(frequency, 60000) 640 else: 641 Speaker.stop() 642 if pa_enabled: 643 label_pa.set_text(str("Amplifier on")) 644 label_pa.set_text_color(0x8EDA91, 255, 0) 645 else: 646 label_pa.set_text(str("Amplifier off")) 647 label_pa.set_text_color(0x9A9A9F, 255, 0) 648 if tone_enabled and (Speaker.isPlaying()): 649 label_output.set_text(str("Playing")) 650 label_output.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 28) 651 label_output.set_text_color(0x8EDA91, 255, 0) 652 else: 653 label_output.set_text(str("Stopped")) 654 label_output.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 28) 655 label_output.set_text_color(0x9A9A9F, 255, 0) 656 if tone_enabled: 657 tone_button.set_btn_text(str("Stop tone")) 658 tone_button.set_bg_color(0x8EDA91, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 659 tone_button.set_text_color(0x000000, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 660 else: 661 tone_button.set_btn_text(str("Start tone")) 662 tone_button.set_bg_color(0x245A85, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 663 tone_button.set_text_color(0xF4F4F5, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 664 if frequency_change_pending: 665 frequency_change_pending = False 666 if tone_enabled: 667 Speaker.stop() 668 Speaker.tone(frequency, 60000) 669 if pa_enabled: 670 label_pa.set_text(str("Amplifier on")) 671 label_pa.set_text_color(0x8EDA91, 255, 0) 672 else: 673 label_pa.set_text(str("Amplifier off")) 674 label_pa.set_text_color(0x9A9A9F, 255, 0) 675 if tone_enabled and (Speaker.isPlaying()): 676 label_output.set_text(str("Playing")) 677 label_output.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 28) 678 label_output.set_text_color(0x8EDA91, 255, 0) 679 else: 680 label_output.set_text(str("Stopped")) 681 label_output.align_to(page0, lv.ALIGN.TOP_RIGHT, -24, 28) 682 label_output.set_text_color(0x9A9A9F, 255, 0) 683 if tone_enabled: 684 tone_button.set_btn_text(str("Stop tone")) 685 tone_button.set_bg_color(0x8EDA91, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 686 tone_button.set_text_color(0x000000, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 687 else: 688 tone_button.set_btn_text(str("Start tone")) 689 tone_button.set_bg_color(0x245A85, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 690 tone_button.set_text_color(0xF4F4F5, 255, lv.PART.MAIN | lv.STATE.DEFAULT) 691 if tone_enabled and not (Speaker.isPlaying()): 692 Speaker.tone(frequency, 60000) 693 time.sleep_ms(10) 694 if volume_change_pending: 695 volume_change_pending = False 696 Speaker.setVolume(int((volume * 255 + 50) / 100)) 697 698 699if __name__ == "__main__": 700 try: 701 setup() 702 while True: 703 loop() 704 except (Exception, KeyboardInterrupt) as e: 705 try: 706 m5ui.deinit() 707 from utility import print_error_msg 708 709 print_error_msg(e) 710 except ImportError: 711 print("please update to latest firmware")
Example output:
None
Audio Recording and Playback
Record audio in memory at 8 kHz, mono, 16 bit. Tap RECORD to start and STOP REC to finish, with a maximum duration of 30 seconds. Tap PLAY to play the recording or STOP PLAY to stop playback. The volume slider ranges from 0 to 100%, with a default of 70%. PA is enabled automatically for playback.
MicroPython Code Block:
1# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD 2# 3# SPDX-License-Identifier: MIT 4 5import os, sys, io 6import M5 7from M5 import * 8import m5ui 9import lvgl as lv 10import time 11 12 13page0 = None 14label_title = None 15label_state = None 16label_duration = None 17label_message = None 18label_volume_name = None 19label_volume = None 20volume_slider = None 21record_button = None 22play_button = None 23 24 25record_pending = None 26play_pending = None 27volume = None 28volume_pending = None 29stop_requested = None 30record_buffer = None 31state = None 32queued_chunks = None 33next_is_a = None 34recorded_bytes = None 35buffer_a = None 36buffer_b = None 37record_start = None 38speaker_ready = None 39play_started = None 40 41 42def record_button_clicked_event(event_struct): 43 global \ 44 page0, \ 45 label_title, \ 46 label_state, \ 47 label_duration, \ 48 label_message, \ 49 label_volume_name, \ 50 label_volume, \ 51 volume_slider, \ 52 record_button, \ 53 play_button, \ 54 record_pending, \ 55 play_pending, \ 56 volume, \ 57 volume_pending, \ 58 stop_requested, \ 59 record_buffer, \ 60 state, \ 61 queued_chunks, \ 62 next_is_a, \ 63 recorded_bytes, \ 64 buffer_a, \ 65 buffer_b, \ 66 record_start, \ 67 speaker_ready, \ 68 play_started 69 record_pending = True 70 71 72def play_button_clicked_event(event_struct): 73 global \ 74 page0, \ 75 label_title, \ 76 label_state, \ 77 label_duration, \ 78 label_message, \ 79 label_volume_name, \ 80 label_volume, \ 81 volume_slider, \ 82 record_button, \ 83 play_button, \ 84 record_pending, \ 85 play_pending, \ 86 volume, \ 87 volume_pending, \ 88 stop_requested, \ 89 record_buffer, \ 90 state, \ 91 queued_chunks, \ 92 next_is_a, \ 93 recorded_bytes, \ 94 buffer_a, \ 95 buffer_b, \ 96 record_start, \ 97 speaker_ready, \ 98 play_started 99 play_pending = True 100 101 102def volume_slider_value_changed_event(event_struct): 103 global \ 104 page0, \ 105 label_title, \ 106 label_state, \ 107 label_duration, \ 108 label_message, \ 109 label_volume_name, \ 110 label_volume, \ 111 volume_slider, \ 112 record_button, \ 113 play_button, \ 114 record_pending, \ 115 play_pending, \ 116 volume, \ 117 volume_pending, \ 118 stop_requested, \ 119 record_buffer, \ 120 state, \ 121 queued_chunks, \ 122 next_is_a, \ 123 recorded_bytes, \ 124 buffer_a, \ 125 buffer_b, \ 126 record_start, \ 127 speaker_ready, \ 128 play_started 129 volume = volume_slider.get_value() 130 label_volume.set_text(str((str(volume) + str("%")))) 131 volume_pending = True 132 133 134def record_button_event_handler(event_struct): 135 global \ 136 page0, \ 137 label_title, \ 138 label_state, \ 139 label_duration, \ 140 label_message, \ 141 label_volume_name, \ 142 label_volume, \ 143 volume_slider, \ 144 record_button, \ 145 play_button, \ 146 record_pending, \ 147 play_pending, \ 148 volume, \ 149 volume_pending, \ 150 stop_requested, \ 151 record_buffer, \ 152 state, \ 153 queued_chunks, \ 154 next_is_a, \ 155 recorded_bytes, \ 156 buffer_a, \ 157 buffer_b, \ 158 record_start, \ 159 speaker_ready, \ 160 play_started 161 event = event_struct.code 162 if event == lv.EVENT.CLICKED and True: 163 record_button_clicked_event(event_struct) 164 return 165 166 167def play_button_event_handler(event_struct): 168 global \ 169 page0, \ 170 label_title, \ 171 label_state, \ 172 label_duration, \ 173 label_message, \ 174 label_volume_name, \ 175 label_volume, \ 176 volume_slider, \ 177 record_button, \ 178 play_button, \ 179 record_pending, \ 180 play_pending, \ 181 volume, \ 182 volume_pending, \ 183 stop_requested, \ 184 record_buffer, \ 185 state, \ 186 queued_chunks, \ 187 next_is_a, \ 188 recorded_bytes, \ 189 buffer_a, \ 190 buffer_b, \ 191 record_start, \ 192 speaker_ready, \ 193 play_started 194 event = event_struct.code 195 if event == lv.EVENT.CLICKED and True: 196 play_button_clicked_event(event_struct) 197 return 198 199 200def volume_slider_event_handler(event_struct): 201 global \ 202 page0, \ 203 label_title, \ 204 label_state, \ 205 label_duration, \ 206 label_message, \ 207 label_volume_name, \ 208 label_volume, \ 209 volume_slider, \ 210 record_button, \ 211 play_button, \ 212 record_pending, \ 213 play_pending, \ 214 volume, \ 215 volume_pending, \ 216 stop_requested, \ 217 record_buffer, \ 218 state, \ 219 queued_chunks, \ 220 next_is_a, \ 221 recorded_bytes, \ 222 buffer_a, \ 223 buffer_b, \ 224 record_start, \ 225 speaker_ready, \ 226 play_started 227 event = event_struct.code 228 if event == lv.EVENT.VALUE_CHANGED and True: 229 volume_slider_value_changed_event(event_struct) 230 return 231 232 233def setup(): 234 global \ 235 page0, \ 236 label_title, \ 237 label_state, \ 238 label_duration, \ 239 label_message, \ 240 label_volume_name, \ 241 label_volume, \ 242 volume_slider, \ 243 record_button, \ 244 play_button, \ 245 record_pending, \ 246 play_pending, \ 247 volume, \ 248 volume_pending, \ 249 stop_requested, \ 250 record_buffer, \ 251 state, \ 252 queued_chunks, \ 253 next_is_a, \ 254 recorded_bytes, \ 255 buffer_a, \ 256 buffer_b, \ 257 record_start, \ 258 speaker_ready, \ 259 play_started 260 261 M5.begin() 262 Widgets.setRotation(0) 263 m5ui.init() 264 page0 = m5ui.M5Page(bg_c=0x080808) 265 label_title = m5ui.M5Label( 266 "Audio", 267 x=24, 268 y=24, 269 text_c=0xF4F4F5, 270 bg_c=0x080808, 271 bg_opa=0, 272 font=lv.font_montserrat_24, 273 parent=page0, 274 ) 275 label_state = m5ui.M5Label( 276 "IDLE", 277 x=48, 278 y=90, 279 text_c=0xF4F4F5, 280 bg_c=0x080808, 281 bg_opa=0, 282 font=lv.font_montserrat_48, 283 parent=page0, 284 ) 285 label_duration = m5ui.M5Label( 286 "0.0 / 30 s", 287 x=48, 288 y=170, 289 text_c=0x9A9A9F, 290 bg_c=0x080808, 291 bg_opa=0, 292 font=lv.font_montserrat_24, 293 parent=page0, 294 ) 295 label_message = m5ui.M5Label( 296 "Tap RECORD to start", 297 x=48, 298 y=227, 299 text_c=0x9A9A9F, 300 bg_c=0x080808, 301 bg_opa=0, 302 font=lv.font_montserrat_18, 303 parent=page0, 304 ) 305 label_volume_name = m5ui.M5Label( 306 "Volume", 307 x=24, 308 y=280, 309 text_c=0x9A9A9F, 310 bg_c=0x080808, 311 bg_opa=0, 312 font=lv.font_montserrat_18, 313 parent=page0, 314 ) 315 label_volume = m5ui.M5Label( 316 "70%", 317 x=384, 318 y=280, 319 text_c=0xF4F4F5, 320 bg_c=0x080808, 321 bg_opa=0, 322 font=lv.font_montserrat_24, 323 parent=page0, 324 ) 325 volume_slider = m5ui.M5Slider( 326 x=40, 327 y=335, 328 w=400, 329 h=16, 330 mode=lv.slider.MODE.NORMAL, 331 min_value=0, 332 max_value=100, 333 value=70, 334 bg_c=0x38383C, 335 color=0x8EDA91, 336 parent=page0, 337 ) 338 record_button = m5ui.M5Button( 339 text="RECORD", 340 x=24, 341 y=388, 342 bg_c=0x7A2731, 343 text_c=0xF4F4F5, 344 font=lv.font_montserrat_18, 345 parent=page0, 346 ) 347 play_button = m5ui.M5Button( 348 text="PLAY", 349 x=252, 350 y=388, 351 bg_c=0x303034, 352 text_c=0xF4F4F5, 353 font=lv.font_montserrat_18, 354 parent=page0, 355 ) 356 357 record_button.add_event_cb(record_button_event_handler, lv.EVENT.ALL, None) 358 play_button.add_event_cb(play_button_event_handler, lv.EVENT.ALL, None) 359 volume_slider.add_event_cb(volume_slider_event_handler, lv.EVENT.ALL, None) 360 361 page0.screen_load() 362 Speaker.stop() 363 Speaker.end() 364 Mic.end() 365 record_buffer = bytearray(0) 366 buffer_a = bytearray(4000) 367 buffer_b = bytearray(4000) 368 Speaker.setPA(True) 369 state = "IDLE" 370 volume = 70 371 record_pending = False 372 play_pending = False 373 volume_pending = False 374 next_is_a = True 375 queued_chunks = 0 376 stop_requested = False 377 record_start = 0 378 recorded_bytes = 0 379 speaker_ready = False 380 play_started = False 381 record_button.set_size(204, 64) 382 play_button.set_size(204, 64) 383 384 385def loop(): 386 global \ 387 page0, \ 388 label_title, \ 389 label_state, \ 390 label_duration, \ 391 label_message, \ 392 label_volume_name, \ 393 label_volume, \ 394 volume_slider, \ 395 record_button, \ 396 play_button, \ 397 record_pending, \ 398 play_pending, \ 399 volume, \ 400 volume_pending, \ 401 stop_requested, \ 402 record_buffer, \ 403 state, \ 404 queued_chunks, \ 405 next_is_a, \ 406 recorded_bytes, \ 407 buffer_a, \ 408 buffer_b, \ 409 record_start, \ 410 speaker_ready, \ 411 play_started 412 M5.update() 413 if record_pending: 414 record_pending = False 415 if state == "RECORDING": 416 stop_requested = True 417 state = "STOPPING" 418 label_state.set_text(str(state)) 419 label_message.set_text(str("Finishing recording...")) 420 else: 421 if state != "STOPPING": 422 Speaker.stop() 423 Speaker.end() 424 play_button.set_btn_text(str("PLAY")) 425 Mic.end() 426 Mic.setSampleRate(8000) 427 Mic.begin() 428 record_buffer = bytearray(0) 429 recorded_bytes = 0 430 queued_chunks = 0 431 next_is_a = True 432 stop_requested = False 433 label_duration.set_text(str((str((recorded_bytes / 16000)) + str(" / 30 s")))) 434 if Mic.isRunning(): 435 Mic.record(buffer_a, 8000, False) 436 Mic.record(buffer_b, 8000, False) 437 if (Mic.isRecording()) == 2: 438 queued_chunks = 2 439 record_start = time.ticks_ms() 440 state = "RECORDING" 441 label_state.set_text(str(state)) 442 label_message.set_text(str("Tap STOP REC to finish")) 443 record_button.set_btn_text(str("STOP REC")) 444 else: 445 Mic.end() 446 queued_chunks = 0 447 state = "IDLE" 448 label_state.set_text(str(state)) 449 label_message.set_text(str("Recorder failed")) 450 record_button.set_btn_text(str("RECORD")) 451 else: 452 state = "IDLE" 453 label_state.set_text(str(state)) 454 label_message.set_text(str("Microphone failed")) 455 record_button.set_btn_text(str("RECORD")) 456 if state == "RECORDING" or state == "STOPPING": 457 if (Mic.isRecording()) < queued_chunks: 458 if next_is_a: 459 record_buffer.extend(buffer_a) 460 else: 461 record_buffer.extend(buffer_b) 462 recorded_bytes = recorded_bytes + 4000 463 queued_chunks = queued_chunks - 1 464 record_start = time.ticks_ms() 465 if not stop_requested and recorded_bytes + queued_chunks * 4000 < 480000: 466 if next_is_a: 467 Mic.record(buffer_a, 8000, False) 468 else: 469 Mic.record(buffer_b, 8000, False) 470 queued_chunks = queued_chunks + 1 471 next_is_a = not next_is_a 472 label_duration.set_text(str((str((recorded_bytes / 16000)) + str(" / 30 s")))) 473 if queued_chunks == 0: 474 Mic.end() 475 state = "READY" 476 label_state.set_text(str(state)) 477 if recorded_bytes >= 480000: 478 label_message.set_text(str("30 s limit reached")) 479 else: 480 label_message.set_text(str("Recording ready")) 481 record_button.set_btn_text(str("RECORD")) 482 play_button.set_btn_text(str("PLAY")) 483 if (state == "RECORDING" or state == "STOPPING") and ( 484 time.ticks_diff((time.ticks_ms()), record_start) 485 ) > 2000: 486 Mic.end() 487 if recorded_bytes > 0: 488 state = "READY" 489 else: 490 state = "IDLE" 491 label_state.set_text(str(state)) 492 queued_chunks = 0 493 label_message.set_text(str("Recording timed out")) 494 record_button.set_btn_text(str("RECORD")) 495 if play_pending: 496 play_pending = False 497 if state == "PLAYING": 498 Speaker.stop() 499 Speaker.end() 500 state = "READY" 501 label_state.set_text(str(state)) 502 play_button.set_btn_text(str("PLAY")) 503 else: 504 if state == "READY": 505 Mic.end() 506 speaker_ready = Speaker.begin() 507 if speaker_ready: 508 Speaker.setVolume(int((volume * 255 + 50) / 100)) 509 Speaker.setPA(True) 510 play_started = Speaker.playRaw(record_buffer, 8000) 511 if play_started: 512 state = "PLAYING" 513 label_state.set_text(str(state)) 514 label_message.set_text(str("")) 515 play_button.set_btn_text(str("STOP PLAY")) 516 else: 517 label_message.set_text(str("Playback failed")) 518 else: 519 label_message.set_text(str("Speaker failed")) 520 if state == "PLAYING" and (Speaker.isPlaying()) == 0: 521 Speaker.stop() 522 Speaker.end() 523 state = "READY" 524 label_state.set_text(str(state)) 525 play_button.set_btn_text(str("PLAY")) 526 if volume_pending: 527 volume_pending = False 528 if state == "PLAYING": 529 Speaker.setVolume(int((volume * 255 + 50) / 100)) 530 time.sleep_ms(10) 531 532 533if __name__ == "__main__": 534 try: 535 setup() 536 while True: 537 loop() 538 except (Exception, KeyboardInterrupt) as e: 539 try: 540 m5ui.deinit() 541 from utility import print_error_msg 542 543 print_error_msg(e) 544 except ImportError: 545 print("please update to latest firmware")
Example output:
None
Infrared Transmission and Reception
Use the built-in infrared receiver on G13 and transmitter on G49. Tap the send button to transmit an NEC frame with address 0x08 and an incrementing data byte. The screen shows transmitted data, received address and data, and the receive count. Use an NEC-compatible infrared remote control to test reception.
MicroPython Code Block:
1# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD 2# 3# SPDX-License-Identifier: MIT 4 5import time 6 7import lvgl as lv 8import M5 9from M5 import * 10import m5ui 11from unit import IRUnit 12 13 14BACKGROUND = 0x080808 15PANEL = 0x222224 16TEXT = 0xF4F4F5 17MUTED = 0x9A9A9F 18GOOD = 0x8EDA91 19 20BUTTON_X = 24 21BUTTON_Y = 388 22BUTTON_W = 432 23BUTTON_H = 64 24TX_TONE_HZ = 1800 25RX_TONE_HZ = 900 26TONE_DURATION_MS = 55 27TONE_GAP_MS = 25 28 29ir = None 30page = None 31label_tx = None 32label_rx = None 33label_count = None 34tx_data = 0 35rx_count = 0 36rx_pending = False 37rx_data = 0 38rx_addr = 0 39tx_pending = False 40speaker_ready = False 41tone_queue = [] 42tone_ready_ms = 0 43 44 45def make_label(parent, text, x, y, width, font, color=TEXT, align=lv.TEXT_ALIGN.LEFT): 46 label = m5ui.M5Label(text, x, y, color, BACKGROUND, 0, font, parent) 47 label.set_width(width) 48 label.set_style_text_align(align, lv.PART.MAIN) 49 label.remove_flag(lv.obj.FLAG.CLICKABLE) 50 return label 51 52 53def make_page(title): 54 screen = m5ui.M5Page(bg_c=BACKGROUND) 55 screen.set_style_pad_all(0, lv.PART.MAIN) 56 screen.set_style_border_width(0, lv.PART.MAIN) 57 screen.set_style_shadow_width(0, lv.PART.MAIN) 58 screen.remove_flag(lv.obj.FLAG.SCROLLABLE) 59 make_label(screen, title, 24, 24, 432, lv.font_montserrat_24) 60 return screen 61 62 63def make_panel(parent, x, y, width, height, color=PANEL): 64 panel = lv.obj(parent) 65 panel.remove_style_all() 66 panel.set_pos(x, y) 67 panel.set_size(width, height) 68 panel.set_style_radius(24, lv.PART.MAIN) 69 panel.set_style_pad_all(0, lv.PART.MAIN) 70 panel.set_style_bg_color(lv.color_hex(color), lv.PART.MAIN) 71 panel.set_style_bg_opa(255, lv.PART.MAIN) 72 panel.remove_flag(lv.obj.FLAG.SCROLLABLE) 73 panel.remove_flag(lv.obj.FLAG.CLICKABLE) 74 return panel 75 76 77def make_button(parent, text, x, y, width, height, color=0x303034): 78 button = m5ui.M5Button(text, x, y, width, height, color, TEXT, lv.font_montserrat_18, parent) 79 button.set_style_radius(18, lv.PART.MAIN) 80 button.set_style_pad_all(0, lv.PART.MAIN) 81 button.set_style_shadow_width(0, lv.PART.MAIN) 82 button.set_style_shadow_width(0, lv.PART.MAIN | lv.STATE.PRESSED) 83 button.label.set_width(width - 16) 84 button.label.set_style_text_align(lv.TEXT_ALIGN.CENTER, lv.PART.MAIN) 85 button.label.center() 86 return button 87 88 89def ir_rx_event(data, addr, ctrl): 90 global rx_count, rx_pending, rx_data, rx_addr 91 92 rx_count += 1 93 rx_data = data 94 rx_addr = addr 95 rx_pending = True 96 97 98def queue_tone(frequency): 99 if speaker_ready and len(tone_queue) < 4: 100 tone_queue.append(frequency) 101 102 103def update_tone(): 104 global tone_ready_ms 105 106 if not speaker_ready or not tone_queue: 107 return 108 now = time.ticks_ms() 109 if time.ticks_diff(now, tone_ready_ms) >= 0: 110 Speaker.tone(tone_queue.pop(0), TONE_DURATION_MS) 111 tone_ready_ms = time.ticks_add(now, TONE_DURATION_MS + TONE_GAP_MS) 112 113 114def send_button_event(event_struct): 115 global tx_pending 116 117 if event_struct.code == lv.EVENT.CLICKED: 118 tx_pending = True 119 120 121def setup(): 122 global ir, page, label_tx, label_rx, label_count 123 global speaker_ready, tone_ready_ms 124 125 M5.begin() 126 m5ui.init() 127 page = make_page("Infrared") 128 panel = make_panel(page, 24, 84, 432, 260) 129 make_label( 130 panel, "Addr / Data", 140, 20, 272, lv.font_montserrat_18, MUTED, lv.TEXT_ALIGN.RIGHT 131 ) 132 values = [] 133 for index, name in enumerate(("TX", "RX", "Received")): 134 y = 64 + index * 68 135 make_label(panel, name, 20, y + 4, 112, lv.font_montserrat_18, MUTED) 136 values.append( 137 make_label(panel, "--", 140, y, 272, lv.font_montserrat_24, TEXT, lv.TEXT_ALIGN.RIGHT) 138 ) 139 label_tx, label_rx, label_count = values 140 label_tx.set_text("Ready") 141 label_rx.set_text("Waiting") 142 label_count.set_text("0") 143 send_button = make_button(page, "SEND NEC", BUTTON_X, BUTTON_Y, BUTTON_W, BUTTON_H) 144 send_button.add_event_cb(send_button_event, lv.EVENT.ALL, None) 145 page.screen_load() 146 # Use the same explicit board IR pins as the graphical IR Unit example. 147 ir = IRUnit((13, 49)) 148 ir.rx_cb(ir_rx_event) 149 speaker_ready = Speaker.begin() 150 if speaker_ready: 151 Speaker.setVolume(128) 152 tone_ready_ms = time.ticks_ms() 153 154 155def loop(): 156 global tx_data, rx_pending, tx_pending 157 158 M5.update() 159 if tx_pending: 160 tx_pending = False 161 tx_data = (tx_data + 1) & 0xFF 162 ir.tx(0x08, tx_data) 163 queue_tone(TX_TONE_HZ) 164 label_tx.set_text("08 / %02X" % tx_data) 165 if rx_pending: 166 rx_pending = False 167 label_rx.set_text("%02X / %02X" % (rx_addr, rx_data)) 168 label_count.set_text("%d" % rx_count) 169 queue_tone(RX_TONE_HZ) 170 update_tone() 171 time.sleep_ms(10) 172 173 174if __name__ == "__main__": 175 try: 176 setup() 177 while True: 178 loop() 179 except (Exception, KeyboardInterrupt): 180 Speaker.stop() 181 Speaker.end() 182 m5ui.deinit() 183 raise
Example output:
None






