initial entry, move code over from test library

Author: DIBJT

LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, SparkFun Electronics
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -0,0 +1,3 @@
+# SparkFun PicoDVI Arduino Library
+
+SparkFun Wrapper for the AdaFruit PicoDVI Library

examples/16bit_hello/16bit_hello.ino

@@ -0,0 +1,73 @@
+// Note - this example is from the AdaFruit Pico DVI library, but
+// modified to work with the SparkFun RedBoard IoT - RP2350. All
+// that is changed is the hardware configuration.
+
+// Double-buffered 1-bit Adafruit_GFX-compatible framebuffer for PicoDVI.
+// Animates without redraw flicker. Requires Adafruit_GFX >= 1.11.5
+
+#include <SparkFun_PicoDVI.h>
+
+// Here's how a 640x480 1-bit (black, white) framebuffer is declared.
+// Second argument ('true' here) enables double-buffering for flicker-free
+// animation. Third argument is a hardware configuration -- examples are
+// written for Adafruit Feather RP2040 DVI, but that's easily switched out
+// for boards like the Pimoroni Pico DV (use 'pimoroni_demo_hdmi_cfg') or
+// the SparkFun RedBoard IoT - RP2350 - which this example is using.
+
+DVIGFX1 display(DVI_RES_640x480p60, true, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+// An 800x480 mode is possible but pushes overclocking even higher than
+// 640x480 mode. SOME BOARDS MIGHT SIMPLY NOT BE COMPATIBLE WITH THIS.
+// May require selecting QSPI div4 clock (Tools menu) to slow down flash
+// accesses, may require further over-volting the CPU to 1.25 or 1.3 V.
+// DVIGFX1 display(DVI_RES_800x480p60, true, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+#define N_BALLS 100 // Number of bouncy balls to draw
+struct
+{
+    int16_t pos[2]; // Ball position (X,Y)
+    int8_t vel[2];  // Ball velocity (X,Y)
+} ball[N_BALLS];
+
+void setup()
+{ // Runs once on startup
+    if (!display.begin())
+    { // Blink LED if insufficient RAM
+        pinMode(LED_BUILTIN, OUTPUT);
+        for (;;)
+            digitalWrite(LED_BUILTIN, (millis() / 500) & 1);
+    }
+
+    // Randomize initial ball positions and velocities
+    for (int i = 0; i < N_BALLS; i++)
+    {
+        ball[i].pos[0] = 10 + random(display.width() - 20);
+        ball[i].pos[1] = 10 + random(display.height() - 20);
+        do
+        {
+            ball[i].vel[0] = 4 - random(9);
+            ball[i].vel[1] = 4 - random(9);
+        } while ((ball[i].vel[0] == 0) && (ball[i].vel[1] == 0));
+    }
+}
+
+void loop()
+{
+    display.fillScreen(0); // Clear back framebuffer...
+    // And draw bouncy balls (circles) there
+    for (int i = 0; i < N_BALLS; i++)
+    {
+        display.drawCircle(ball[i].pos[0], ball[i].pos[1], 40, 1);
+        // After drawing each one, update positions, bounce off edges.
+        ball[i].pos[0] += ball[i].vel[0];
+        if ((ball[i].pos[0] <= 0) || (ball[i].pos[0] >= display.width()))
+            ball[i].vel[0] *= -1;
+        ball[i].pos[1] += ball[i].vel[1];
+        if ((ball[i].pos[1] <= 0) || (ball[i].pos[1] >= display.height()))
+            ball[i].vel[1] *= -1;
+    }
+
+    // Swap front/back buffers, do not duplicate current screen state to next frame,
+    // we'll draw it new from scratch each time.
+    display.swap();
+}

examples/1bit_double_buffer/1bit_double_buffer.ino

@@ -0,0 +1,40 @@
+// Note - this example is from the AdaFruit Pico DVI library, but
+// modified to work with the SparkFun RedBoard IoT - RP2350. All
+// that is changed is the hardware configuration.
+
+// Simple 1-bit Adafruit_GFX-compatible framebuffer for PicoDVI.
+
+#include <SparkFun_PicoDVI.h>
+
+// Here's how a 640x480 1-bit (black, white) framebuffer is declared.
+// Second argument ('false' here) means NO double-buffering; all drawing
+// operations are shown as they occur. Third argument is a hardware
+// configuration -- examples are written for Adafruit Feather RP2040 DVI,
+// but that's easily switched out for boards like the Pimoroni Pico DV
+// (use 'pimoroni_demo_hdmi_cfg') or the SparkFun RedBoard IoT - RP2350 - which this example is using.
+
+DVIGFX1 display(DVI_RES_640x480p60, false, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+// An 800x480 mode is possible but pushes overclocking even higher than
+// 640x480 mode. SOME BOARDS MIGHT SIMPLY NOT BE COMPATIBLE WITH THIS.
+// May require selecting QSPI div4 clock (Tools menu) to slow down flash
+// accesses, may require further over-volting the CPU to 1.25 or 1.3 V.
+// DVIGFX1 display(DVI_RES_800x480p60, false, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+void setup()
+{ // Runs once on startup
+    if (!display.begin())
+    { // Blink LED if insufficient RAM
+        pinMode(LED_BUILTIN, OUTPUT);
+        for (;;)
+            digitalWrite(LED_BUILTIN, (millis() / 500) & 1);
+    }
+}
+
+void loop()
+{
+    // Draw random lines
+    display.drawLine(random(display.width()), random(display.height()), // Start X,Y
+                     random(display.width()), random(display.height()), // End X,Y
+                     random(2));                                        // Color (0 or 1)
+}

examples/1bit_single_buffer/1bit_single_buffer.ino

@@ -0,0 +1,45 @@
+// Note - this example is from the AdaFruit Pico DVI library, but
+// modified to work with the SparkFun RedBoard IoT - RP2350. All
+// that is changed is the hardware configuration.
+
+// 1-bit (black, white) text mode for PicoDVI.
+
+#include <SparkFun_PicoDVI.h>
+
+// Here's how an 80x30 character display is declared. First argument,
+// resolution, is full display pixel count...character cells are 8x8 pixels,
+// yielding the 80x30 result. 640x240 uses "tall" pixels, the result of all
+// this is very reminiscent of IBM VGA mode. Second argument is a hardware
+// configuration -- examples are written for Adafruit Feather RP2040 DVI,
+// but that's easily switched out for boards like the Pimoroni Pico DV
+// (use 'pimoroni_demo_hdmi_cfg') or the SparkFun RedBoard IoT - RP2350 -
+// which this example is using.
+
+DVItext1 display(DVI_RES_640x240p60, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+// Wider and taller modes are possible. Wider pushes overclocking even
+// higher than 640x480 mode. SOME BOARDS MIGHT SIMPLY NOT BE COMPATIBLE
+// WITH THIS. May require selecting QSPI div4 clock (Tools menu) to slow
+// down flash accesses, may require over-volting the CPU to 1.25 or 1.3 V.
+// Here's how a 100x60 char display might be declared:
+// DVItext1 display(DVI_RES_800x480p60, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+// A reduced refresh rate display doesn't as aggressive an over-clock
+// This timing is verified to work on https://www.adafruit.com/product/2232
+// DVItext1 display(DVI_RES_800x240p30, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+void setup()
+{ // Runs once on startup
+    if (!display.begin())
+    { // Blink LED if insufficient RAM
+        pinMode(LED_BUILTIN, OUTPUT);
+        for (;;)
+            digitalWrite(LED_BUILTIN, (millis() / 500) & 1);
+    }
+}
+
+void loop()
+{
+    display.print("Hello World!  ");
+    delay(50);
+}

examples/1bit_text/1bit_text.ino

@@ -0,0 +1,75 @@
+// Note - this example is from the AdaFruit Pico DVI library, but
+// modified to work with the SparkFun RedBoard IoT - RP2350. All
+// that is changed is the hardware configuration.
+
+// Double-buffered 8-bit Adafruit_GFX-compatible framebuffer for PicoDVI.
+// Animates without redraw flicker. Requires Adafruit_GFX >= 1.11.4
+
+#include <SparkFun_PicoDVI.h>
+
+// Here's how a 320x240 8-bit (color-paletted) framebuffer is declared.
+// Second argument ('true' here) enables double-buffering for flicker-free
+// animation. Third argument is a hardware configuration -- examples are
+// written for Adafruit Feather RP2040 DVI, but that's easily switched out
+// for boards like the Pimoroni Pico DV (use 'pimoroni_demo_hdmi_cfg') or
+// the SparkFun RedBoard IoT - RP2350 - which this example is using.
+
+DVIGFX8 display(DVI_RES_320x240p60, true, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+// A 400x240 mode is possible but pushes overclocking even higher than
+// 320x240 mode. SOME BOARDS MIGHT SIMPLY NOT BE COMPATIBLE WITH THIS.
+// May require selecting QSPI div4 clock (Tools menu) to slow down flash
+// accesses, may require further over-volting the CPU to 1.25 or 1.3 V.
+// DVIGFX8 display(DVI_RES_400x240p60, true, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+#define N_BALLS 100 // Number of bouncy balls to draw, 1-254 (not 255)
+struct
+{
+    int16_t pos[2]; // Ball position (X,Y)
+    int8_t vel[2];  // Ball velocity (X,Y)
+} ball[N_BALLS];
+
+void setup()
+{ // Runs once on startup
+    if (!display.begin())
+    { // Blink LED if insufficient RAM
+        pinMode(LED_BUILTIN, OUTPUT);
+        for (;;)
+            digitalWrite(LED_BUILTIN, (millis() / 500) & 1);
+    }
+
+    // Randomize initial ball positions, velocities and colors
+    for (int i = 0; i < N_BALLS; i++)
+    {
+        display.setColor(i + 1, 64 + random(192), 64 + random(192), 64 + random(192));
+        ball[i].pos[0] = 10 + random(display.width() - 20);
+        ball[i].pos[1] = 10 + random(display.height() - 20);
+        do
+        {
+            ball[i].vel[0] = 2 - random(5);
+            ball[i].vel[1] = 2 - random(5);
+        } while ((ball[i].vel[0] == 0) && (ball[i].vel[1] == 0));
+    }
+    display.setColor(255, 0xFFFF); // Last palette entry = white
+    display.swap(false, true);     // Duplicate same palette into front & back buffers
+}
+
+void loop()
+{
+    // Clear back framebuffer and draw balls (circles) there.
+    display.fillScreen(0);
+    for (int i = 0; i < N_BALLS; i++)
+    {
+        display.fillCircle(ball[i].pos[0], ball[i].pos[1], 20, i + 1);
+        // After drawing each one, update positions, bounce off edges.
+        ball[i].pos[0] += ball[i].vel[0];
+        if ((ball[i].pos[0] <= 0) || (ball[i].pos[0] >= display.width()))
+            ball[i].vel[0] *= -1;
+        ball[i].pos[1] += ball[i].vel[1];
+        if ((ball[i].pos[1] <= 0) || (ball[i].pos[1] >= display.height()))
+            ball[i].vel[1] *= -1;
+    }
+    // Swap front/back buffers, do not duplicate current screen state to next frame,
+    // we'll draw it new from scratch each time.
+    display.swap();
+}

examples/8bit_double_buffer/8bit_double_buffer.ino

@@ -0,0 +1,45 @@
+// Note - this example is from the AdaFruit Pico DVI library, but
+// modified to work with the SparkFun RedBoard IoT - RP2350. All
+// that is changed is the hardware configuration.
+
+// 8-bit Adafruit_GFX-compatible framebuffer for PicoDVI.
+
+#include <SparkFun_PicoDVI.h>
+
+// Here's how a 320x240 8-bit (color-paletted) framebuffer is declared.
+// Second argument ('false' here) means NO double-buffering; all drawing
+// operations are shown as they occur. Third argument is a hardware
+// configuration -- examples are written for Adafruit Feather RP2040 DVI,
+// but that's easily switched out for boards like the Pimoroni Pico DV
+// (use 'pimoroni_demo_hdmi_cfg') or the SparkFun RedBoard IoT - RP2350 -
+// which this example is using.
+
+DVIGFX8 display(DVI_RES_320x240p60, false, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+// A 400x240 mode is possible but pushes overclocking even higher than
+// 320x240 mode. SOME BOARDS MIGHT SIMPLY NOT BE COMPATIBLE WITH THIS.
+// May require selecting QSPI div4 clock (Tools menu) to slow down flash
+// accesses, may require further over-volting the CPU to 1.25 or 1.3 V.
+// DVIGFX8 display(DVI_RES_400x240p60, false, sparkfun_iot_redboard_rp2350_dvi_cfg);
+
+void setup()
+{ // Runs once on startup
+    if (!display.begin())
+    { // Blink LED if insufficient RAM
+        pinMode(LED_BUILTIN, OUTPUT);
+        for (;;)
+            digitalWrite(LED_BUILTIN, (millis() / 500) & 1);
+    }
+
+    // Randomize color palette. First entry is left black, last is set white.
+    for (int i = 1; i < 255; i++)
+        display.setColor(i, random(65536));
+    display.setColor(255, 0xFFFF);
+}
+
+void loop()
+{
+    // Draw random lines
+    display.drawLine(random(display.width()), random(display.height()), random(display.width()),
+                     random(display.height()), random(256));
+}

examples/8bit_single_buffer/8bit_single_buffer.ino

@@ -0,0 +1,8 @@
+# Arduino Examples for PicoDVI Library
+
+This directory does not exist in the original PicoDVI repository.
+It contains examples compatible with the Arduino IDE.
+
+## Note
+
+The examples in this directory are ported over from the Adafruit fork of the Pico DVI library. The only changes made were to use the SparkFun IoT RedBoard - RP2350 configuration structure in setup.