Version 1.0.0

Author: michalin

Doxyfile

@@ -0,0 +1,10 @@
+#ifndef EXAMPLES_H
+#define EXAMPLES_H
+
+void textmode();
+void g1text();
+void g2text();
+void sprites();
+void g2image();
+
+#endif

examples/examples.h

@@ -0,0 +1,16 @@
+
+#include "examples.h"
+
+//Uncomment the example you want to run
+void setup()
+{
+    textmode();
+    //g1text();
+    //g2text();
+    //sprites();
+    //g2image();
+}
+
+void loop()
+{
+}

examples/examples.ino

@@ -0,0 +1,25 @@
+#include <tms9918.h>
+
+
+void g1text()
+{
+    vdp_init_textmode(VDP_BLACK, VDP_WHITE);
+    //vdp_init_textmode();
+
+    //vdp_textcolor(VDP_DARK_BLUE, VDP_WHITE);
+    vdp_print("Character set in graphic mode 1:\r\n\r\n");
+    vdp_print(" !\"#$%&'()*+,-./\r\r");
+    vdp_print("0123456789:;<=>?@\r\n");
+    vdp_print("ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_'\r\n");
+    vdp_print("abcdefghijklmnopqrstuvwxyz{>}+~\r\n");
+return;
+    while (1)
+    {
+        for (uint8_t i = 1; i <= 15; i++)
+            for (uint8_t j = 1; j <= 15; j++)
+            {
+                vdp_textcolor(j, i);
+                delay(1000);
+            }
+    }
+}

examples/g1text.cpp

@@ -0,0 +1,66 @@
+#include <tms9918.h>
+
+bool loaded = false;
+
+void serialEvent()
+{
+    uint16_t y = 0, n_cols, n_lines;
+    uint8_t line[256];
+    delay(10);
+    n_cols = Serial.read();
+    n_lines = Serial.read();
+    n_cols == 0 ? n_cols = 256 : n_cols;
+    if (n_cols == 256) //Hi-res
+    {
+        vdp_init_g2();
+        vdp_set_bdcolor(VDP_BLACK);
+        while (y < 192)
+        {
+            Serial.readBytes(line, 256);
+            uint8_t color1 = 0, color2 = 0;
+            for (int x = 0; x < n_cols; x++)
+            {
+                if(x%8 == 0)
+                    color1 = color2 = line[x];
+                else if(line[x] != color1)
+                    color2 = line[x];
+
+                if(line[x] == color1)    
+                    vdp_plot_hires(x, y, color1+1);
+                else
+                    vdp_plot_hires(x, y, NULL, color2+1);
+            }
+            y++;
+            Serial.write('@');
+        }
+        //sprites();
+    } 
+    else if(n_cols == 64)
+    {
+        vdp_init_multicolor();
+        while (y < 64)
+        {
+            Serial.readBytes(line, 64);
+            for (int x = 0; x < 64; x++)
+            {
+                vdp_plot_color(x, y, 1+line[x]);
+            }
+            y++;
+            Serial.write('@');
+        }
+    }
+    else 
+    {
+        vdp_print("Unknown format");
+
+    }
+}
+
+void g2image()
+{
+    Serial.begin(115200);
+    vdp_init_textmode();
+    vdp_print("Start the imgserial tool on PC to \r\nsend a picture");
+    //Serial.write('@');
+
+}

examples/g2image.cpp

@@ -0,0 +1,54 @@
+#include <tms9918.h>
+
+void g2text()
+{
+    if (vdp_init_g2())
+        Serial.println("VDP Error");
+
+    vdp_textcolor(VDP_GRAY, VDP_BLACK);
+    vdp_print("BLACK (1)                       ");
+    vdp_textcolor(VDP_BLACK, VDP_GRAY);
+    vdp_print("GRAY (14)                       ");
+    vdp_textcolor(VDP_BLACK, VDP_WHITE);
+    vdp_print("WHITE (15)                      ");
+    vdp_textcolor(VDP_GRAY, VDP_MAGENTA);
+    vdp_print("MAGENTA (13)                    ");
+    vdp_textcolor(VDP_GRAY, VDP_DARK_BLUE);
+    vdp_print("DARK BLUE (4)                   ");
+    vdp_textcolor(VDP_GRAY, VDP_LIGHT_BLUE);
+    vdp_print("LIGHT BLUE (5)                  ");
+    vdp_textcolor(VDP_BLACK, VDP_CYAN);
+    vdp_print("CYAN (7)                        ");
+    vdp_textcolor(VDP_GRAY, VDP_DARK_GREEN);
+    vdp_print("DARK GREEN (12)                 ");
+    vdp_textcolor(VDP_GRAY, VDP_MED_GREEN);
+    vdp_print("MEDIUM GREEN (2)                ");
+    vdp_textcolor(VDP_BLACK, VDP_LIGHT_GREEN);
+    vdp_print("LIGHT GREEN (3)                 ");
+    vdp_textcolor(VDP_BLACK, VDP_DARK_YELLOW);
+    vdp_print("DARK YELLOW (10)                ");
+    vdp_textcolor(VDP_BLACK, VDP_LIGHT_YELLOW);
+    vdp_print("LIGHT YELLOW (11)               ");
+    vdp_textcolor(VDP_GRAY, VDP_DARK_RED);
+    vdp_print("DARK RED (6)                    ");
+    vdp_textcolor(VDP_GRAY, VDP_MED_RED);
+    vdp_print("MEDIUM RED (8)                  ");
+    vdp_textcolor(VDP_BLACK, VDP_LIGHT_RED);
+    vdp_print("LIGHT RED (9)                   ");
+    vdp_print("\033[0;1m ------------------------------ ");
+    vdp_print("!\033[1;0m                              \033[0;1m!");
+    vdp_print("!\033[1;0m                              \033[0;1m!");
+    vdp_print("!\033[1;0m                              \033[0;1m!");
+    vdp_print("!\033[1m         TRANSPARENT (0)      \033[0;1m!");
+    vdp_print("!\033[1;0m                              \033[0;1m!");
+    vdp_print("!\033[1;0m                              \033[0;1m!");
+    vdp_print("!\033[1;0m                              \033[0;1m!");
+    vdp_print(" ------------------------------ ");
+
+    uint8_t j;
+    while(1)
+    {
+        vdp_set_bdcolor(j++);
+        delay(2000);
+    }
+}

examples/g2text.cpp

@@ -0,0 +1,20 @@
+GIMP Palette
+Name: TMS9918
+Columns: 16
+#
+  0   0   0	Untitled
+ 33 200  66	Untitled
+ 94 220 120	Untitled
+ 84  85 237	Untitled
+125 118 252	Untitled
+212  82  77	Untitled
+ 66 235 245	Untitled
+252  85  84	Untitled
+255 121 120	Untitled
+212 193  84	Untitled
+230 206 128	Untitled
+ 33 176  59	Untitled
+201  91 186	Untitled
+204 204 204	Untitled (occurs 4769)
+255 255 255	Untitled (occurs 855)
+  0   0   0	Untitled

examples/imgserial/cygwin1.dll

@@ -0,0 +1,131 @@
+/* Tool to send for Gimp raw data files an Arduino running the g2image example
+    Copyright (C) 2022  Doctor Volt
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+*/
+#include <stdio.h>
+#include <stdint.h>
+#include <cstring>
+#include <string>
+#include <fcntl.h>
+#include <termios.h>
+#include <unistd.h>
+#include <sys/stat.h>
+
+using namespace std;
+
+int main(int argc, const char *argv[])
+{
+    termios tty;
+    tty.c_iflag = 0;
+    tty.c_oflag = 0;
+    tty.c_cflag = CS8 | CREAD | CLOCAL; // 8 Bit, No parity, one stop bit, no flow control, disable signal lines, Read enabled
+    tty.c_lflag = 0;
+    tty.c_cc[VMIN] = 5; // Block until at least one byte received
+    tty.c_cc[VTIME] = 0;
+    cfsetspeed(&tty, B115200);
+
+    if (argc != 3)
+    {
+        printf("This program sends GIMP raw data files to an Arduino running the \"g2image\" example over serial(USB) interface\r\n");
+        printf("\r\nUsage: imgserial filename.data port \r\n");
+#ifdef __CYGWIN__
+        printf("Example: imgserial parrot.data /dev/ttyS0 where /dev/ttyS0 is COM1, /dev/ttyS1 COM2 etc. \r\n");
+#else
+        printf("Example: imgserial parrot.data /dev/ttyUSB0 \r\n");
+#endif
+        return -1;
+    }
+#ifdef __CYGWIN__
+        printf("IMPORTANT: Put a 10µF cap between the RST pin of your Arduino and Ground to prevent a reboot.\r\n");
+#endif
+
+
+    string fname_in = argv[1];
+    if (fname_in.rfind(".data", string::npos) == -1)
+    {
+        printf("Invalid filename. Must be a *.data file\r\n");
+        return -1;
+    }
+
+    // FILE *infile = fopen(fname_in.c_str(), "r");
+    int infile = open(fname_in.c_str(), O_RDONLY);
+    if (errno)
+    {
+        printf("Error opening file: %s\r\n", strerror(errno));
+        return -1;
+    }
+
+    // Opening serial port
+    // int port = open("/dev/ttyUSB0", O_RDWR);
+    int port = open(argv[2], O_RDWR);
+    if (errno)
+    {
+        printf("Error opening serial Port: %s\n", strerror(errno));
+        return -1;
+    }
+
+    // Setting port attributes
+    if (tcsetattr(port, TCSANOW, &tty) != 0)
+    {
+        printf("Error setting serial port: %s\n", strerror(errno));
+        return -1;
+    }
+
+    // Determine filesize
+    struct stat buf;
+    fstat(infile, &buf);
+    size_t filesize = buf.st_size;
+
+    uint16_t n_cols, n_lines;
+    switch (filesize)
+    {
+    case 64 * 48:
+        printf("\r\n64x48 Multicolor Mode\r\n");
+        n_cols = 64;
+        n_lines = 48;
+        break;
+    case 256 * 192:
+        printf("\r\n256x192 Graphic Mode 2 high resolution\r\n");
+        n_cols = 256;
+        n_lines = 192;
+        break;
+    default:
+        printf("\r\nInvalid file format. Size: %d \r\n", (int)filesize);
+        return -1;
+    }
+    uint8_t ack;
+    // read(port, &ack, 1); //Block until Arduino is ready
+    printf("Transfer started: %s to %s...\r\n", argv[1], argv[2]);
+    write(port, (uint8_t *)&n_cols, 1); // Send resolution
+    write(port, (uint8_t *)&n_lines, 1);
+    uint8_t *inbuf = (uint8_t *)calloc(1, filesize);
+    if (read(infile, inbuf, filesize) < 1)
+    {
+        printf("Error reading file: %s\r\n", strerror(errno));
+        return -1;
+    }
+
+    for (int i = 0; i < n_lines; i++)
+    {
+        write(port, (const void *)(inbuf + n_cols * i), n_cols);
+        read(port, &ack, 1); // Block until Arduino acknowledged that he processed the packet
+    }
+
+    close(port);
+    close(infile);
+    printf("\r\nFile sent\r\n");
+
+    return 0;
+}