directory move

picocalc/libraries/TFT_eSPI/docs/ESP-IDF/Using ESP-IDF.txt

@@ -0,0 +1,70 @@
+The TFT_eSPI library has been updated by a user (dracir9) in pull request #1770 to enable
+use with the ESP-IDF.
+
+https://github.com/Bodmer/TFT_eSPI/pull/1770
+
+The library author (Bodmer) does not use the ESP-IDF so will not be able to provide support!
+
+There are two ways to configure the library either:
+
+    manually enter the setup in menuconfig
+    OR
+    delete the KConfig file, select your LCD/board in the User_Setup_Select.h file, and run "idf.py reconfigure"
+
+The following menuconfig instructions were posted by dracir9 as part of the pull request #1770:
+
+https://github.com/Bodmer/TFT_eSPI/pull/1770#issuecomment-1096478997
+
+In the above link the instructions include useful hyperlinks. The bare text of the
+instructions is included below.
+
+Steps to use:
+
+  1.  Install ESP-IDF toolchain. The easiest way is to use VS Code and the ESP-IDF extension
+      which handles most of the work automatically. Make sure to install version V4.4. From
+      now on I'll assume that VS Code is being used.
+ 
+  2.  Once ESP-IDF is installed open VS Code and press F1. Type ESP-IDF: New Project. Hit enter.
+  
+  3.  Enter your project name, directory and board (if not sure choose ESP32 chip (via ESP-PROG)).
+      If your board is connected choose serial port. Leave ESP-IDF component directory blank and
+      press Choose Template.
+      
+  4.  In the dropdown choose Extension and select Arduino-as-component. (This is not mandatory.
+      You can try other templates if you want). This will create a blank project with a simple
+      main source file in the "main" folder.
+      
+  5.  Now we have to add Arduino to your project. You can find the complete documentation here:
+      https://github.com/espressif/arduino-esp32
+      
+      and here:
+      https://docs.espressif.com/projects/arduino-esp32/en/latest/esp-idf_component.html
+      
+      I'll list two methods that I use most of the time:
+
+      5.1. Press F1 and type ESP-IDF: Add Arduino ESP32 as ESP-IDF Component. This will
+      automatically download and install the latest code from the arduino esp-32 repository.
+      This is the easiest method but as it uses the latest code it may introduce compilation errors.
+
+      5.2. Go to the Arduino esp-32 repository release page. Choose a version and find its "Assets"
+      section. Download the source code file into "project directory/components". Extract the
+      compressed file. This will create a folder called arduino-esp32-2.x.x. Rename it to arduino.
+      This method is slightly more complex but ensures you choose a stable version.
+      
+  6.  Download the TFT_eSPI library into the components folder
+  
+  7.  Now open VS Code and load your project folder. Press F1 and type ESP-IDF: SDK Configuration
+      editor (menuconfig). Alternatively press Ctrl+E, G or press the gear button in the bottom left
+      corner.
+      
+  8.  This will open the project configuration menu. Navigate to the TFT_eSPI section and configure
+      the library (TFT driver, pins, fonts, etc.).
+      
+  9.  Press F1 and type ESP-IDF: Build your project. Alternatively press Ctrl+E, B or click the
+      build button in the bottom left corner.
+      
+ 10.  Choose your port by typing ESP-IDF: Select port to use or with the button in the bottom left.
+ 
+ 11.  Upload your code with the lightning button in the bottom toolbar.
+ 
+ 12.  Enjoy!

picocalc/libraries/TFT_eSPI/docs/PlatformIO/Configuring options.txt

@@ -0,0 +1,52 @@
+;PlatformIO User notes:
+
+;It is possible to load settings from the calling program rather than modifying
+;the library for each project by modifying the "platformio.ini" file.
+
+;The User_Setup_Select.h file will not load the user setting header files if
+;USER_SETUP_LOADED is defined.
+
+;Instead of using #define, use the -D prefix, for example:
+
+; PlatformIO Project Configuration File
+;
+;   Build options: build flags, source filter
+;   Upload options: custom upload port, speed and extra flags
+;   Library options: dependencies, extra library storages
+;   Advanced options: extra scripting
+;
+; Please visit documentation for the other options and examples
+; https://docs.platformio.org/page/projectconf.html
+
+[env:esp32dev]
+platform = https://github.com/platformio/platform-espressif32.git#feature/arduino-upstream
+board = esp32dev
+framework = arduino
+lib_deps = bodmer/TFT_eSPI@^2.4.31
+
+build_flags =
+  -Os
+  -DCORE_DEBUG_LEVEL=ARDUHAL_LOG_LEVEL_DEBUG
+  -DUSER_SETUP_LOADED=1
+  
+  ; Define the TFT driver, pins etc here:
+  -DST7789_DRIVER=1
+  -DTFT_WIDTH=128
+  -DTFT_HEIGHT=160
+  -DTFT_MISO=19
+  -DTFT_MOSI=23
+  -DTFT_SCLK=18
+  -DTFT_CS=5
+  -DTFT_DC=19
+  -DTFT_RST=4
+  ;-DTFT_BL=21
+  ;-DTOUCH_CS=22
+  -DLOAD_GLCD=1
+  -DLOAD_FONT2=1
+  -DLOAD_FONT4=1
+  -DLOAD_FONT6=1
+  -DLOAD_FONT7=1
+  -DLOAD_FONT8=1
+  -DLOAD_GFXFF=1
+  -DSMOOTH_FONT=1
+  -DSPI_FREQUENCY=27000000

picocalc/libraries/TFT_eSPI/docs/PlatformIO/rp2040.txt

@@ -0,0 +1,63 @@
+;PlatformIO User notes:
+
+;It is possible to load settings from the calling program rather than modifying
+;the library for each project by modifying the "platformio.ini" file.
+
+;The User_Setup_Select.h file will not load the user setting header files if
+;USER_SETUP_LOADED is defined.
+
+;Instead of using #define, use the -D prefix, for example:
+
+; PlatformIO Project Configuration File
+;
+;   Build options: build flags, source filter, extra scripting
+;   Upload options: custom port, speed and extra flags
+;   Library options: dependencies, extra library storages
+;
+; Please visit documentation for the other options and examples
+; http://docs.platformio.org/page/projectconf.html
+
+[env:pico]
+platform = https://github.com/maxgerhardt/platform-raspberrypi.git
+board = pico
+framework = arduino
+board_build.core = earlephilhower
+board_build.filesystem_size = 0.5m
+lib_deps = bodmer/TFT_eSPI@^2.5.21
+; change microcontroller
+board_build.mcu = rp2040
+
+; change MCU frequency
+board_build.f_cpu = 133000000L
+
+build_flags =
+  -Os
+  -DUSER_SETUP_LOADED=1
+  ; Define the TFT driver, pins etc here:
+  -DTFT_PARALLEL_8_BIT=1
+  -DRM68120_DRIVER=1
+  -DRP2040_PIO_CLK_DIV=1
+  -DTFT_DC=28
+  -DTFT_WR=22
+  -DTFT_RST=2
+
+  -DTFT_D0=6
+  -DTFT_D1=7
+  -DTFT_D2=8
+  -DTFT_D3=9
+  -DTFT_D4=10
+  -DTFT_D5=11
+  -DTFT_D6=12
+  -DTFT_D7=13
+
+  -DTFT_BL=16
+  -DTFT_BACKLIGHT_ON=HIGH
+
+  -DLOAD_GLCD=1
+  -DLOAD_FONT2=1
+  -DLOAD_FONT4=1
+  -DLOAD_FONT6=1
+  -DLOAD_FONT7=1
+  -DLOAD_FONT8=1
+  -DLOAD_GFXFF=1
+  -DSMOOTH_FONT=1