diff --git a/Code/picocalc_lvgl_graphics_demo/README.md b/Code/picocalc_lvgl_graphics_demo/README.md new file mode 100644 index 0000000..c8a1b03 --- /dev/null +++ b/Code/picocalc_lvgl_graphics_demo/README.md @@ -0,0 +1,89 @@ +# PicoCalc LVGL Graphics Demo + +This is a template demo app using LVGL graphic engine on PicoCalc. + +### TODOs +#### Done +- [x] Project support for both Pico1/2 Builds +- [x] Initial LVGL Project support +- [x] I2C Keyboard Porting for LVGL +- [x] SPI Display Porting for LVGL +- [x] Bitmap Driver flushing +#### TODO +- [ ] Improve Keyboard event processing + +## Building +``` shell +# onetime, cloning latest lvgl submodule +git submodule update --init --recursive + + +cd {to_this_demo_path} + +mkdir build +cd build +export PICO_SDK_PATH=/where/pico-sdk/is +cmake .. +make +``` + + +## Build for Pico 1(RP2040) or Pico 2(RP2350) +if you are using other pico board, you could select a board type from the `CMakeLists.txt` + +```cmake +# Setup board for Pico 1 +set(PICO_BOARD pico) + +# Setup board for Pico 2W +# set(PICO_BOARD pico2) +``` + +## How to Upload UF2 + +Uploading a UF2 file to the Raspberry Pi Pico on a Linux system is straightforward. Here’s how you can do it: + +### Step 1: Prepare Your Raspberry Pi Pico +Enter Bootloader Mode: + +- Hold down the BOOTSEL button on your Pico. +- While holding the button, connect the Pico to your Linux PC via USB. +- Release the BOOTSEL button. +- Check If the Pico Is Recognized: + +Your Pico should appear as a mass storage device named RPI-RP2. + +Verify using the following command: + +```bash +lsblk +``` + +You should see a new device (e.g., /media/$USER/RPI-RP2 or /run/media/$USER/RPI-RP2). + +### Step 2: Copy the UF2 File to the Pico +``` +cp your_firmware.uf2 /media/$USER/RPI-RP2/ +``` + +### Step 3: Run it +On PicoCalc, the default serial port of the Pico is the USB Type-C port, not its built-in Micro USB port. +So here is the standard running procedures: + +- Unplug the pico from Micro-USB cable +- Plug the pico via USB Type-C +- Press Power On on Top of the PicoCalc + + +If your firmware includes serial output, you can monitor it using **minicom** or **screen**: +```bash +screen /dev/ttyACM0 115200 +``` + +(Replace /dev/ttyACM0 with the correct serial port for your Pico.) + +The serial monitor of **Arduino IDE** is another great choice for PicoCalc serial output on both Linux and Windows. + + +#### Special thanks +[Hsuan Han Lai](https://github.com/adwuard) for initial porting and demo project for the PicoCalc