mick/hw657-hello-world
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
3 commits 1 branch 0 tags 61 KiB
  • C 97.6%
  • C++ 2%
  • Python 0.4%
Find a file
Exact
Mick e7909b76b6 Add Union Flag bitmap sketch and display documentation. 
Ports union_jack_src.png to RGB565 for pushImage on HW-657 ST7789. Documents bitmap regeneration, TFT_BGR profile, and verified colour settings.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-06 01:30:35 +01:00
hw657_backlight_test Document verified HW-657 ST7789 display configuration. 2026-06-06 01:03:25 +01:00
hw657_display_probe Initial HW-657 Arduino sketches and TFT_eSPI setup profiles. 2026-06-06 00:34:51 +01:00
hw657_hello_world Document verified HW-657 ST7789 display configuration. 2026-06-06 01:03:25 +01:00
hw657_hello_world_cyd Initial HW-657 Arduino sketches and TFT_eSPI setup profiles. 2026-06-06 00:34:51 +01:00
hw657_i2c_scan Initial HW-657 Arduino sketches and TFT_eSPI setup profiles. 2026-06-06 00:34:51 +01:00
hw657_tft_probe Initial HW-657 Arduino sketches and TFT_eSPI setup profiles. 2026-06-06 00:34:51 +01:00
hw657_union_flag Add Union Flag bitmap sketch and display documentation. 2026-06-06 01:30:35 +01:00
tft_espi_setups Add Union Flag bitmap sketch and display documentation. 2026-06-06 01:30:35 +01:00
tools Add Union Flag bitmap sketch and display documentation. 2026-06-06 01:30:35 +01:00
README.md Add Union Flag bitmap sketch and display documentation. 2026-06-06 01:30:35 +01:00
REQUIREMENTS.md Add Union Flag bitmap sketch and display documentation. 2026-06-06 01:30:35 +01:00

README.md

HW-657 V0.0.1 Hello World (Arduino IDE)

Shows Hello World on the built-in ST7789 color TFT of the HW-657 V0.0.1 ESP32 board.

Full requirements, pinout, and bring-up notes: REQUIREMENTS.md

Quick start

  1. Install TFT_eSPI (Library Manager).
  2. Copy tft_espi_setups/Setup_HW657_ST7789.h into
    Documents\Arduino\libraries\TFT_eSPI\User_Setups\.
  3. In User_Setup_Select.h, comment out User_Setup.h and enable: 
    #include <User_Setups/Setup_HW657_ST7789.h>
  4. Open hw657_hello_world/hw657_hello_world.ino.
  5. Board: ESP32 Dev Module → select COM port → Upload.
  6. Serial Monitor 115200 (optional — prints Done. when ready).

Expected: centred white Hello / World! on a black screen.

Verified pinout (silkscreen)

Silkscreen GPIO Role
SDA 23 MOSI
SCL 18 SCLK
RS 2 DC
RST 4 Reset
CS 15 Chip select
LEDK 32 Backlight (HIGH = on)

Driver: ST7789 240×320 · Rotation 1 · invertDisplay(true)

Union Flag sketch

Step Action
1 Same TFT_eSPI setup as Hello World (Setup_HW657_ST7789.h)
2 Open hw657_union_flag/hw657_union_flag.ino → Upload

Displays a 320×160 Union Jack bitmap centred on screen (2:1 ratio).

Regenerate bitmap (after replacing the source PNG):

python tools/png_to_union_flag.py

Source image: tools/union_jack_src.png → output: hw657_union_flag/union_flag_bitmap.h

If red and blue are swapped on the display, toggle tft.setSwapBytes(true) in the sketch.

Other sketches

Sketch Description
hw657_union_flag/ Union Flag (PNG bitmap, verified on hardware)

Diagnostics (if something breaks)

Sketch Use
hw657_backlight_test/ Toggle GPIO 32 — confirm backlight polarity
hw657_tft_probe/ Cycle colours/rotations

Arduino IDE settings

Setting Value
Board ESP32 Dev Module
Port Your COM port