ABOUT:
--------------------------------------------
Simple Project Template for Raspberry Pi Pico C SDK.
	-For use with v.2.3.0
	-SDK files should be in /opt/pico-sdk, or edit the CMakeLists.txt
	-picotool must be installed correctly (i.e. version matched and on the system path)
   Michael J. Wolverton, Aug. 2026

INSTRUCTIONS:
--------------------------------------------
1. RENAME PROJECT   
   - Open CMakeLists.txt and change the name of the program to match your project.
     use only valid filenames. Avoid spaces, punctuation or slashes ( / or \ ). underscore ( _ ) and hyphen ( - ) are okay.
   
   - Rename the template directory (folder) to the project name.
   
2. BUILD 
   -Open a bash terminal in the project directory, or navigate to it with 'ls' and 'cd'
   
   -Run the following commands from the project directory to create the build scripts and temporary files
	cd build
	cmake ..
	make

3. LOAD PROGRAM TO PI PICO BOARD:
   -Hold the BOOTSEL button while inserting the USB cable. The Pico should show up as a USB drive.
   -Copy the <program_name>.uf2 file from the build directory onto the Pico. 
   	It should automatically reset and begin running the code after the transfer completes. 

4. CODE UPDATES
   -If edits are made to the existing source code files, just rerun make. cmake is not needed.
   	Remember to load the program onto the pico board again.
   
   -If source ( .c or .h ) files are renamed, added or removed from the project, you must do the following steps in order:
   	i.   Delete all files in the build directory
	ii.  Edit the the CMakeLists.txt and update all src/<file-name>.c files by name (no * wildcards can be used)
	iii. Rerun the 'cmake ..' command from the build directory.
	iv.  Rerun 'make' from build

6. POWER
   -The board can be powered by USB cable (5v) or through the Vsys pin at 1.8V (min) to 5.5V (max).
