├── LICENSE ├── README.md └── ST7789_terminal.ino /LICENSE: -------------------------------------------------------------------------------- 1 | GNU LESSER GENERAL PUBLIC LICENSE 2 | Version 3, 29 June 2007 3 | 4 | Copyright (C) 2007 Free Software Foundation, Inc. 5 | Everyone is permitted to copy and distribute verbatim copies 6 | of this license document, but changing it is not allowed. 7 | 8 | 9 | This version of the GNU Lesser General Public License incorporates 10 | the terms and conditions of version 3 of the GNU General Public 11 | License, supplemented by the additional permissions listed below. 12 | 13 | 0. Additional Definitions. 14 | 15 | As used herein, "this License" refers to version 3 of the GNU Lesser 16 | General Public License, and the "GNU GPL" refers to version 3 of the GNU 17 | General Public License. 18 | 19 | "The Library" refers to a covered work governed by this License, 20 | other than an Application or a Combined Work as defined below. 21 | 22 | An "Application" is any work that makes use of an interface provided 23 | by the Library, but which is not otherwise based on the Library. 24 | Defining a subclass of a class defined by the Library is deemed a mode 25 | of using an interface provided by the Library. 26 | 27 | A "Combined Work" is a work produced by combining or linking an 28 | Application with the Library. The particular version of the Library 29 | with which the Combined Work was made is also called the "Linked 30 | Version". 31 | 32 | The "Minimal Corresponding Source" for a Combined Work means the 33 | Corresponding Source for the Combined Work, excluding any source code 34 | for portions of the Combined Work that, considered in isolation, are 35 | based on the Application, and not on the Linked Version. 36 | 37 | The "Corresponding Application Code" for a Combined Work means the 38 | object code and/or source code for the Application, including any data 39 | and utility programs needed for reproducing the Combined Work from the 40 | Application, but excluding the System Libraries of the Combined Work. 41 | 42 | 1. Exception to Section 3 of the GNU GPL. 43 | 44 | You may convey a covered work under sections 3 and 4 of this License 45 | without being bound by section 3 of the GNU GPL. 46 | 47 | 2. Conveying Modified Versions. 48 | 49 | If you modify a copy of the Library, and, in your modifications, a 50 | facility refers to a function or data to be supplied by an Application 51 | that uses the facility (other than as an argument passed when the 52 | facility is invoked), then you may convey a copy of the modified 53 | version: 54 | 55 | a) under this License, provided that you make a good faith effort to 56 | ensure that, in the event an Application does not supply the 57 | function or data, the facility still operates, and performs 58 | whatever part of its purpose remains meaningful, or 59 | 60 | b) under the GNU GPL, with none of the additional permissions of 61 | this License applicable to that copy. 62 | 63 | 3. Object Code Incorporating Material from Library Header Files. 64 | 65 | The object code form of an Application may incorporate material from 66 | a header file that is part of the Library. You may convey such object 67 | code under terms of your choice, provided that, if the incorporated 68 | material is not limited to numerical parameters, data structure 69 | layouts and accessors, or small macros, inline functions and templates 70 | (ten or fewer lines in length), you do both of the following: 71 | 72 | a) Give prominent notice with each copy of the object code that the 73 | Library is used in it and that the Library and its use are 74 | covered by this License. 75 | 76 | b) Accompany the object code with a copy of the GNU GPL and this license 77 | document. 78 | 79 | 4. Combined Works. 80 | 81 | You may convey a Combined Work under terms of your choice that, 82 | taken together, effectively do not restrict modification of the 83 | portions of the Library contained in the Combined Work and reverse 84 | engineering for debugging such modifications, if you also do each of 85 | the following: 86 | 87 | a) Give prominent notice with each copy of the Combined Work that 88 | the Library is used in it and that the Library and its use are 89 | covered by this License. 90 | 91 | b) Accompany the Combined Work with a copy of the GNU GPL and this license 92 | document. 93 | 94 | c) For a Combined Work that displays copyright notices during 95 | execution, include the copyright notice for the Library among 96 | these notices, as well as a reference directing the user to the 97 | copies of the GNU GPL and this license document. 98 | 99 | d) Do one of the following: 100 | 101 | 0) Convey the Minimal Corresponding Source under the terms of this 102 | License, and the Corresponding Application Code in a form 103 | suitable for, and under terms that permit, the user to 104 | recombine or relink the Application with a modified version of 105 | the Linked Version to produce a modified Combined Work, in the 106 | manner specified by section 6 of the GNU GPL for conveying 107 | Corresponding Source. 108 | 109 | 1) Use a suitable shared library mechanism for linking with the 110 | Library. A suitable mechanism is one that (a) uses at run time 111 | a copy of the Library already present on the user's computer 112 | system, and (b) will operate properly with a modified version 113 | of the Library that is interface-compatible with the Linked 114 | Version. 115 | 116 | e) Provide Installation Information, but only if you would otherwise 117 | be required to provide such information under section 6 of the 118 | GNU GPL, and only to the extent that such information is 119 | necessary to install and execute a modified version of the 120 | Combined Work produced by recombining or relinking the 121 | Application with a modified version of the Linked Version. (If 122 | you use option 4d0, the Installation Information must accompany 123 | the Minimal Corresponding Source and Corresponding Application 124 | Code. If you use option 4d1, you must provide the Installation 125 | Information in the manner specified by section 6 of the GNU GPL 126 | for conveying Corresponding Source.) 127 | 128 | 5. Combined Libraries. 129 | 130 | You may place library facilities that are a work based on the 131 | Library side by side in a single library together with other library 132 | facilities that are not Applications and are not covered by this 133 | License, and convey such a combined library under terms of your 134 | choice, if you do both of the following: 135 | 136 | a) Accompany the combined library with a copy of the same work based 137 | on the Library, uncombined with any other library facilities, 138 | conveyed under the terms of this License. 139 | 140 | b) Give prominent notice with the combined library that part of it 141 | is a work based on the Library, and explaining where to find the 142 | accompanying uncombined form of the same work. 143 | 144 | 6. Revised Versions of the GNU Lesser General Public License. 145 | 146 | The Free Software Foundation may publish revised and/or new versions 147 | of the GNU Lesser General Public License from time to time. Such new 148 | versions will be similar in spirit to the present version, but may 149 | differ in detail to address new problems or concerns. 150 | 151 | Each version is given a distinguishing version number. If the 152 | Library as you received it specifies that a certain numbered version 153 | of the GNU Lesser General Public License "or any later version" 154 | applies to it, you have the option of following the terms and 155 | conditions either of that published version or of any later version 156 | published by the Free Software Foundation. If the Library as you 157 | received it does not specify a version number of the GNU Lesser 158 | General Public License, you may choose any version of the GNU Lesser 159 | General Public License ever published by the Free Software Foundation. 160 | 161 | If the Library as you received it specifies that a proxy can decide 162 | whether future versions of the GNU Lesser General Public License shall 163 | apply, that proxy's public statement of acceptance of any version is 164 | permanent authorization for you to choose that version for the 165 | Library. 166 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # ST7789_terminal 2 | Serial Terminal Display emulator 3 | 4 | Requires: 5 | - Arduino 6 | - ST7789 240x240 display and my library 7 | - RREFont library 8 | 9 | YouTube video: 10 | https://youtu.be/Z4PMT5wUhMw 11 | 12 | Practical use case: 13 | https://youtu.be/a1vxOkcO5Fw 14 | 15 | Features: 16 | - most typical ANSI color and style codes supported 17 | - works perfectly in 9600 and 19200 bps modes 18 | - in 28800 Arduino seems to be sometimes little too slow but still usable 19 | - used fast ST7789 and RRE fonts libraries 20 | - ST7789 hardware scrolling 21 | - 30x15 character display with 8x16 pixel font 22 | 23 | If you find it useful and want to buy me a coffee or a beer: 24 | 25 | https://www.paypal.me/cbm80amiga 26 | -------------------------------------------------------------------------------- /ST7789_terminal.ino: -------------------------------------------------------------------------------- 1 | // Serial terminal display (VT100) 2 | // 30x15 screen with 8x16 font 3 | // ST7789 & RRE library example 4 | // (c) 2019 Pawel A. Hernik 5 | 6 | #define TFT_DC 7 7 | #define TFT_RST 8 8 | #define SCR_WD 240 9 | #define SCR_HT 320 // 320 - to allow access to full 240x320 frame buffer 10 | #include 11 | #include 12 | #include 13 | Arduino_ST7789 lcd = Arduino_ST7789(TFT_DC, TFT_RST); 14 | 15 | #include "RREFont.h" 16 | #include "rre_fjg_8x16.h" 17 | 18 | RREFont font; 19 | 20 | // needed for RREFont library initialization, define your fillRect 21 | void customRect(int x, int y, int w, int h, int c) { return lcd.fillRect(x, y, w, h, c); } 22 | 23 | int maxy = 320; // internal ST7789 fb is 240x320 24 | int xp = 0, yp = 240; 25 | int ys = 0; 26 | uint16_t bg = BLACK, fg = WHITE; 27 | int screenWd = 240, screenHt = 240; 28 | int charWd, charHt; 29 | int wrap = 0; // 1 - for wrapping long lines (>30 characters) 30 | int sx = 1, sy = 1; 31 | 32 | int escMode = 0; 33 | int nVals = 0; 34 | int vals[10]={0}; 35 | 36 | uint16_t c0 = RGBto565(20,20,20); 37 | uint16_t c1 = RGBto565(40,40,40); 38 | 39 | void scrollScreen() 40 | { 41 | xp = 0; 42 | ys += charHt*sy; 43 | if(ys>=maxy) ys-=maxy; 44 | yp = ys+screenHt; 45 | if(yp>=maxy) yp-=maxy; 46 | lcd.fillRect(0, yp, screenWd, charHt*sy, ((yp/charHt)&1) ? c1 : c0); 47 | lcd.setScroll(ys); 48 | } 49 | 50 | void printString(char *str) 51 | { 52 | while(*str) printTermChar(*str++); 53 | } 54 | 55 | void printTermChar(char c) 56 | { 57 | static const uint16_t colors[] = { 58 | 0x0000, // 0-black 59 | 0xf800, // 1-red 60 | 0x07e0, // 2-green 61 | 0xffe0, // 3-yellow 62 | 0x001f, // 4-blue 63 | 0xf81f, // 5-magenta 64 | 0x07ff, // 6-cyan 65 | 0xffff // 7-white 66 | }; 67 | 68 | if(c==0x1b) { escMode=1; return; } 69 | if(escMode==1) { 70 | if(c=='[') { escMode=2; nVals=0; } else escMode=0; 71 | return; 72 | } 73 | if(escMode==2) { 74 | if(isdigit(c)) 75 | vals[nVals] = vals[nVals]*10+(c-'0'); 76 | else if(c==';') 77 | nVals++; 78 | else if(c=='m') { 79 | escMode=0; 80 | nVals++; 81 | for(int i=0;i=30 && v<38){ // fg colors 95 | fg = colors[v-30]; 96 | if(bg==BLACK) font.setColor(fg); else font.setColor(fg, bg); 97 | } else if(v>=40 && v<48){ 98 | bg = colors[v-40]; 99 | if(bg==BLACK) font.setColor(fg); else font.setColor(fg, bg); 100 | } else if(v>=90 && v<98){ // fg colors 101 | fg = colors[v-90]; 102 | if(bg==BLACK) font.setColor(fg); else font.setColor(fg, bg); 103 | } else if(v>=100 && v<108){ 104 | bg = colors[v-100]; 105 | if(bg==BLACK) font.setColor(fg); else font.setColor(fg, bg); 106 | } 107 | } 108 | vals[0]=vals[1]=vals[2]=vals[3]=0; 109 | nVals=0; 110 | } else { 111 | escMode=0; 112 | vals[0]=vals[1]=vals[2]=vals[3]=0; 113 | nVals=0; 114 | } 115 | return; 116 | } 117 | if(c==10) { scrollScreen(); return; } // LF 118 | if(c==13) { xp=0; return; } // CR 119 | if(c==8) { // BS 120 | if(xp>0) xp-=charWd*sx; 121 | lcd.fillRect(xp, yp, charWd*sx, charHt*sy, BLACK); 122 | return; 123 | } 124 | if(xp=screenWd && wrap) scrollScreen(); // 8900us 127 | } 128 | 129 | void testVT100() 130 | { 131 | printString("\e[0;32;40mGreen on black\n"); 132 | printString("\e[0;37;45mWhite on magenta\n"); 133 | printString("\e[0;30;46mBlack on cyan\n"); 134 | printString("\e[0;33;44mYellow on blue\n"); 135 | printString("\e[0;31;47mRed on white\n"); 136 | printString("\e[0mRegular\n"); 137 | printString("\e[1mText in bold\e[0m\n"); 138 | printString("\e[7mInverse\e[0m\n"); 139 | printString("ABCDEFGHIJKLMNOPQRSTUVWXYZ[]{}\n"); 140 | printString("abcdefghijklmnopqrstuvwxyz:;()\n"); 141 | printString("01234567890,.'!|?/*_=+-#%$^&\n"); 142 | if(charHt*sy<24) { 143 | printString("\e[1m"); 144 | printString("ABCDEFGHIJKLMNOPQRSTUVWXYZ[]{}\n"); 145 | printString("abcdefghijklmnopqrstuvwxyz:;()\n"); 146 | printString("01234567890,.'!|?/*_=+-#%$^&\n"); 147 | printString("\e[0m"); 148 | } 149 | //delay(2000); 150 | } 151 | 152 | void setup() 153 | { 154 | Serial.begin(9600); // perfect 155 | //Serial.begin(19200); // perfect 156 | //Serial.begin(28800); // almost ok 157 | lcd.init(SCR_WD, SCR_HT); 158 | lcd.fillScreen(BLACK); 159 | font.init(customRect, SCR_WD, SCR_HT); // custom fillRect function and screen width and height values 160 | font.setFont(&rre_fjg_8x16); 161 | charWd = font.getWidth(); 162 | charHt = font.getHeight(); 163 | font.setColor(WHITE); 164 | font.setCharMinWd(8); 165 | lcd.setScrollArea(0,0); 166 | //testVT100(); 167 | printString("\e[0;44m *** Terminal Init *** \e[0m\n"); 168 | } 169 | 170 | void loop() 171 | { 172 | while(Serial.available()) 173 | printTermChar(Serial.read()); 174 | } 175 | 176 | --------------------------------------------------------------------------------