Library to control a Graphics TFT connected to 4-wire SPI - revised for the Raio RA8875 Display Controller.
Dependents: FRDM_RA8875_mPaint RA8875_Demo RA8875_KeyPadDemo SignalGenerator ... more
Fork of SPI_TFT by
See Components - RA8875 Based Display
Enhanced touch-screen support - where it previous supported both the Resistive Touch and Capacitive Touch based on the FT5206 Touch Controller, now it also has support for the GSL1680 Touch Controller.
Offline Help Manual (Windows chm)
/media/uploads/WiredHome/ra8875.zip.bin (download, rename to .zip and unzip)
RA8875.cpp
- Committer:
- WiredHome
- Date:
- 2014-01-25
- Revision:
- 38:38d503b4fad6
- Parent:
- 37:f19b7e7449dc
- Child:
- 39:805cee56872d
File content as of revision 38:38d503b4fad6:
/// RA8875 Display Controller Library. /// /// This is being created for a specific display from buydisplay.com, /// which is 480 x xxx. It has other attributes (like display controller /// managed backlight brightness. So, there are expectations and some /// defined constants based on that specific display. /// #include "RA8875.h" DigitalOut zz1(LED1); DigitalOut zz2(LED2); DigitalOut zz3(LED3); DigitalOut zz4(LED4); #define DEBUG "RAIO" // ... // INFO("Stuff to show %d", var); // new-line is automatically appended // #if (defined(DEBUG) && !defined(TARGET_LPC11U24)) #define INFO(x, ...) std::printf("[INF %s %3d] "x"\r\n", DEBUG, __LINE__, ##__VA_ARGS__); #define WARN(x, ...) std::printf("[WRN %s %3d] "x"\r\n", DEBUG, __LINE__, ##__VA_ARGS__); #define ERR(x, ...) std::printf("[ERR %s %3d] "x"\r\n", DEBUG, __LINE__, ##__VA_ARGS__); #else #define INFO(x, ...) #define WARN(x, ...) #define ERR(x, ...) #endif #define RA8875_DISPLAY_WIDTH 480 #define RA8875_DISPLAY_HEIGHT 272 #ifdef PERF_METRICS #define PERFORMANCE_RESET performance.reset() #define REGISTERPERFORMANCE(a) RegisterPerformance(a) static const char *metricsName[] = { "Point", "Line", "Rectangle", "Rounded Rectangle", "Triangle", "Circle", "Ellipse" }; #else #define PERFORMANCE_RESET #define REGISTERPERFORMANCE(a) #endif // When it is going to poll a register for completion, how many // uSec should it wait between each polling activity. #define POLLWAITuSec 10 RA8875::RA8875(PinName mosi, PinName miso, PinName sclk, PinName csel, PinName reset, const char *name) : spi(mosi, miso, sclk) , cs(csel) , res(reset) , GraphicsDisplay(name) { font = NULL; // no external font, use internal. select(false); // deselect the display frequency(RA8875_DEFAULT_SPI_FREQ); // data rate Reset(); Power(true); Backlight_u8(255); #ifdef PERF_METRICS performance.start(); ClearPerformance(); #endif } //RA8875::~RA8875() //{ //} #ifdef PERF_METRICS void RA8875::ClearPerformance() { for (int i=0; i<METRICCOUNT; i++) metrics[i] = 0; } void RA8875::RegisterPerformance(method_e method) { unsigned long elapsed = performance.read_us(); if (method < METRICCOUNT && elapsed > metrics[method]) metrics[method] = elapsed; } void RA8875::ReportPerformance() { for (int i=0; i<METRICCOUNT; i++) { printf("%10d uS %s\r\n", metrics[i], metricsName[i]); } } #endif RetCode_t RA8875::WriteCommandW(uint8_t command, uint16_t data) { #if 1 WriteCommand(command, data & 0xFF); WriteCommand(command+1, data >> 8); #else INFO("WriteCommandW(%02X, %04X)", command, data); select(true); spiwrite(0x80); spiwrite(command); // spiwrite(0x00); spiwrite(data & 0xFF); spiwrite(data >> 8); select(false); #endif return noerror; } RetCode_t RA8875::WriteCommand(unsigned char command, unsigned int data) { select(true); spiwrite(0x80); spiwrite(command); if (data <= 0xFF) { // only if in the valid range spiwrite(0x00); spiwrite(data); } select(false); return noerror; } RetCode_t RA8875::WriteDataW(uint16_t data) { select(true); spiwrite(0x00); spiwrite(data & 0xFF); spiwrite(data >> 8); select(false); return noerror; } RetCode_t RA8875::WriteData(unsigned char data) { select(true); spiwrite(0x00); spiwrite(data); select(false); return noerror; } unsigned char RA8875::ReadCommand(unsigned char command) { WriteCommand(command); return ReadData(); } unsigned char RA8875::ReadData(void) { unsigned char data; select(true); spiwrite(0x40); data = spiread(); select(false); return data; } unsigned char RA8875::ReadStatus(void) { unsigned char data; select(true); spiwrite(0xC0); data = spiread(); select(false); return data; } dim_t RA8875::fontwidth(void) { if (font == NULL) return (((ReadCommand(0x22) >> 2) & 0x3) + 1) * 16; else return font[1]; } dim_t RA8875::fontheight(void) { if (font == NULL) return (((ReadCommand(0x22) >> 0) & 0x3) + 1) * 16; else return font[2]; } RetCode_t RA8875::locate(textloc_t column, textloc_t row) { return SetTextCursor(column * fontwidth(), row * fontheight()); } int RA8875::columns(void) { return width() / fontwidth(); } int RA8875::rows(void) { return height() / fontheight(); } dim_t RA8875::width(void) { return (ReadCommand(0x14) + 1) * 8; } dim_t RA8875::height(void) { return (ReadCommand(0x19) | (ReadCommand(0x1A) << 8)) + 1; } RetCode_t RA8875::SetTextCursor(loc_t x, loc_t y) { cursor_x = x; cursor_y = y; // for non-internal fonts WriteCommandW(0x2A, x); WriteCommandW(0x2C, y); return noerror; } loc_t RA8875::GetTextCursor_Y(void) { if (font == NULL) return ReadCommand(0x2C) | (ReadCommand(0x2D) << 8); else return cursor_y; } loc_t RA8875::GetTextCursor_X(void) { if (font == NULL) return ReadCommand(0x2A) | (ReadCommand(0x2B) << 8); else return cursor_x; } RetCode_t RA8875::SetTextCursorControl(cursor_t cursor, bool blink) { unsigned char mwcr0 = ReadCommand(0x40) & 0x0F; // retain direction, auto-increase unsigned char horz = 0; unsigned char vert = 0; mwcr0 |= 0x80; // text mode if (cursor != NOCURSOR) mwcr0 |= 0x40; // visible if (blink) mwcr0 |= 0x20; // blink WriteCommand(0x40, mwcr0); // configure the cursor WriteCommand(0x41, 0x00); // close the graphics cursor WriteCommand(0x44, 0x1f); // The cursor flashing cycle switch (cursor) { case IBEAM: horz = 0x01; vert = 0x1F; break; case UNDER: horz = 0x07; vert = 0x01; break; case BLOCK: horz = 0x07; vert = 0x1F; break; case NOCURSOR: default: break; } WriteCommand(0x4e, horz); // The cursor size horz WriteCommand(0x4f, vert); // The cursor size vert return noerror; } RetCode_t RA8875::SetTextFont(RA8875::font_t font) { if (/*font >= RA8875::ISO8859_1 && */ font <= RA8875::ISO8859_4) { WriteCommand(0x21, (unsigned int)(font)); return noerror; } else { return bad_parameter; } } RetCode_t RA8875::SetTextFontControl(fill_t fillit, RA8875::font_angle_t angle, RA8875::HorizontalScale hScale, RA8875::VerticalScale vScale, RA8875::alignment_t alignment) { if (hScale >= 1 && hScale <= 4 && vScale >= 1 && vScale <= 4) { unsigned char x = 0; if (alignment == align_full) x |= 0x80; if (fillit == NOFILL) x |= 0x40; if (angle == rotated) x |= 0x10; x |= ((hScale - 1) << 2); x |= ((vScale - 1) << 0); WriteCommand(0x22, x); return noerror; } else { return bad_parameter; } } RetCode_t RA8875::SetTextFontSize(RA8875::HorizontalScale hScale, RA8875::VerticalScale vScale) { unsigned char reg = ReadCommand(0x22); if (hScale >= 1 && hScale <= 4 && vScale >= 1 && vScale <= 4) { reg &= 0xF0; // keep the high nibble as is. reg |= ((hScale - 1) << 2); reg |= ((vScale - 1) << 0); WriteCommand(0x22, reg); return noerror; } else { return bad_parameter; } } int RA8875::_putc(int c) { if (font == NULL) { return _internal_putc(c); } else { return _external_putc(c); } } int RA8875::_external_putc(int c) { if (c) { if (c == '\r') { cursor_x = 0; } else if (c == '\n') { cursor_y += font[2]; } else { int advance = character(cursor_x, cursor_y, c); // advance tells us how many pixels we advanced //INFO("x,y,advance %d,%d,%d", cursor_x, cursor_y, advance); if (advance) { cursor_x += advance; if (cursor_x >= width()) { cursor_x = 0; cursor_y += font[2]; if (cursor_y >= height()) { cursor_y = 0; // @todo Should it scroll? } } } } } return c; } int RA8875::_internal_putc(int c) { if (c) { unsigned char mwcr0; mwcr0 = ReadCommand(0x40); if ((mwcr0 & 0x80) == 0x00) { WriteCommand(0x40, 0x80 | mwcr0); // Put in Text mode if not already } if (c == '\r') { loc_t x; x = ReadCommand(0x30) | (ReadCommand(0x31) << 8); // Left edge of active window WriteCommandW(0x2A, x); } else if (c == '\n') { loc_t y; y = ReadCommand(0x2C) | (ReadCommand(0x2D) << 8); // current y location y += fontheight(); if (y > height()) // @TODO after bottom of active window, then scroll window? y = 0; WriteCommandW(0x2C, y); } else { WriteCommand(0x02); // RA8875 Internal Fonts select(true); WriteData(c); while (ReadStatus() & 0x80) wait_us(POLLWAITuSec); // Chk_Busy(); select(false); } } return c; } RetCode_t RA8875::_StartGraphicsStream(void) { WriteCommand(0x40,0x00); // Graphics write mode WriteCommand(0x02); // Prepare for streaming data return noerror; } RetCode_t RA8875::_EndGraphicsStream(void) { return noerror; } RetCode_t RA8875::putp(color_t pixel) { WriteDataW((pixel>>8) | (pixel<<8)); return noerror; } void RA8875::puts(loc_t x, loc_t y, const char * string) { SetTextCursor(x,y); puts(string); } void RA8875::puts(const char * string) { unsigned char mwcr0 = ReadCommand(0x40); if (font == NULL) { if ((mwcr0 & 0x80) == 0x00) WriteCommand(0x40,0x80); // Put in Text mode if not already } else { _StartGraphicsStream(); } if (*string != '\0') { #if 1 while (*string) { // @TODO calling individual _putc is slower... optimizations? _putc(*string++); } #else WriteCommand(0x02); select(true); while (*string != '\0') { WriteData(*string); ++string; while (ReadStatus() & 0x80) wait_us(POLLWAITuSec); // Chk_Busy(); } select(false); #endif } if (font) _EndGraphicsStream(); } RetCode_t RA8875::SetGraphicsCursor(loc_t x, loc_t y) { WriteCommandW(0x46, x); WriteCommandW(0x48, y); return noerror; } RetCode_t RA8875::window(loc_t x, loc_t y, dim_t width, dim_t height) { GraphicsDisplay::window(x,y, width,height); WriteCommandW(0x30, x); WriteCommandW(0x32, y); WriteCommandW(0x34, (x+width-1)); WriteCommandW(0x36, (y+height-1)); SetGraphicsCursor(x,y); return noerror; } RetCode_t RA8875::cls(void) { PERFORMANCE_RESET; clsw(FULLWINDOW); SetTextCursor(0,0); REGISTERPERFORMANCE(PRF_CLS); return noerror; } RetCode_t RA8875::clsw(RA8875::Region_t region) { PERFORMANCE_RESET; WriteCommand(0x8E, (region == ACTIVEWINDOW) ? 0xC0 : 0x80); while (ReadCommand(0x8E) & 0x80) wait_us(POLLWAITuSec); REGISTERPERFORMANCE(PRF_CLS); return noerror; } RetCode_t RA8875::pixel(loc_t x, loc_t y, color_t color) { INFO("pixel(%d,%d, %04X)", x,y, color); foreground(color); return pixel(x,y); } RetCode_t RA8875::pixel(loc_t x, loc_t y) { RetCode_t ret; PERFORMANCE_RESET; color_t color = GetForeColor(); WriteCommand(0x40,0x00); // Graphics write mode SetGraphicsCursor(x, y); WriteCommand(0x02); WriteDataW(color); ret = noerror; REGISTERPERFORMANCE(PRF_DRAWPOINT); return ret; } RetCode_t RA8875::line(loc_t x1, loc_t y1, loc_t x2, loc_t y2, color_t color) { foreground(color); return line(x1,y1,x2,y2); } RetCode_t RA8875::line(loc_t x1, loc_t y1, loc_t x2, loc_t y2) { PERFORMANCE_RESET; WriteCommandW(0x91, x1); WriteCommandW(0x93, y1); WriteCommandW(0x95, x2); WriteCommandW(0x97, y2); unsigned char drawCmd = 0x00; // Line WriteCommand(0x90, drawCmd); WriteCommand(0x90, 0x80 + drawCmd); // Start drawing. while (ReadCommand(0x90) & 0x80) // await completion. wait_us(POLLWAITuSec); REGISTERPERFORMANCE(PRF_DRAWLINE); return noerror; } RetCode_t RA8875::fillrect(loc_t x1, loc_t y1, loc_t x2, loc_t y2, color_t color, fill_t fillit) { return rect(x1,y1,x2,y2,color,fillit); } RetCode_t RA8875::rect(loc_t x1, loc_t y1, loc_t x2, loc_t y2, color_t color, fill_t fillit) { foreground(color); return rect(x1,y1,x2,y2,fillit); } RetCode_t RA8875::rect(loc_t x1, loc_t y1, loc_t x2, loc_t y2, fill_t fillit) { PERFORMANCE_RESET; if (x1 == x2 && y1 == y2) { pixel(x1, y1); } else if (x1 == x2) { line(x1, y1, x2, y2); } else if (y1 == y2) { line(x1, y1, x2, y2); } else { WriteCommandW(0x91, x1); WriteCommandW(0x93, y1); WriteCommandW(0x95, x2); WriteCommandW(0x97, y2); unsigned char drawCmd = 0x10; // Rectangle if (fillit == FILL) drawCmd |= 0x20; WriteCommand(0x90, drawCmd); WriteCommand(0x90, 0x80 + drawCmd); // Start drawing. while (ReadCommand(0x90) & 0x80) // await completion. wait_us(POLLWAITuSec); } REGISTERPERFORMANCE(PRF_DRAWRECTANGLE); return noerror; } RetCode_t RA8875::fillroundrect(loc_t x1, loc_t y1, loc_t x2, loc_t y2, dim_t radius1, dim_t radius2, color_t color, fill_t fillit) { foreground(color); return roundrect(x1,y1,x2,y2,radius1,radius2,fillit); } RetCode_t RA8875::roundrect(loc_t x1, loc_t y1, loc_t x2, loc_t y2, dim_t radius1, dim_t radius2, color_t color, fill_t fillit) { foreground(color); return roundrect(x1,y1,x2,y2,radius1,radius2,fillit); } RetCode_t RA8875::roundrect(loc_t x1, loc_t y1, loc_t x2, loc_t y2, dim_t radius1, dim_t radius2, fill_t fillit) { RetCode_t ret = noerror; PERFORMANCE_RESET; if (x1 > x2 || y1 > y2 || (radius1 > (x2-x1)/2) || (radius2 > (y2-y1)/2) ) { ret = bad_parameter; } else if (x1 == x2 && y1 == y2) { pixel(x1, y1); } else if (x1 == x2) { line(x1, y1, x2, y2); } else if (y1 == y2) { line(x1, y1, x2, y2); } else { WriteCommandW(0x91, x1); WriteCommandW(0x93, y1); WriteCommandW(0x95, x2); WriteCommandW(0x97, y2); WriteCommandW(0xA1, radius1); WriteCommandW(0xA3, radius2); // Should not need this... WriteCommandW(0xA5, 0); WriteCommandW(0xA7, 0); unsigned char drawCmd = 0x20; // Rounded Rectangle if (fillit == FILL) drawCmd |= 0x40; WriteCommand(0xA0, drawCmd); WriteCommand(0xA0, 0x80 + drawCmd); // Start drawing. while (ReadCommand(0xA0) & 0x80) { // await completion. wait_us(POLLWAITuSec); } } REGISTERPERFORMANCE(PRF_DRAWROUNDEDRECTANGLE); return ret; } RetCode_t RA8875::triangle(loc_t x1, loc_t y1, loc_t x2, loc_t y2, loc_t x3, loc_t y3, color_t color, fill_t fillit) { RetCode_t ret; foreground(color); ret = triangle(x1,y1,x2,y2,x3,y3,fillit); return ret; } RetCode_t RA8875::filltriangle(loc_t x1, loc_t y1, loc_t x2, loc_t y2, loc_t x3, loc_t y3, color_t color, fill_t fillit) { RetCode_t ret; foreground(color); ret = triangle(x1,y1,x2,y2,x3,y3,fillit); return ret; } RetCode_t RA8875::triangle(loc_t x1, loc_t y1 ,loc_t x2, loc_t y2, loc_t x3, loc_t y3, fill_t fillit) { RetCode_t ret = noerror; PERFORMANCE_RESET; if (x1 == x2 && y1 == y2 && x1 == x3 && y1 == y3) { pixel(x1, y1); } else { WriteCommandW(0x91, x1); WriteCommandW(0x93, y1); WriteCommandW(0x95, x2); WriteCommandW(0x97, y2); WriteCommandW(0xA9, x3); WriteCommandW(0xAB, y3); unsigned char drawCmd = 0x01; // Triangle if (fillit == FILL) drawCmd |= 0x20; WriteCommand(0x90, drawCmd); WriteCommand(0x90, 0x80 + drawCmd); // Start drawing. while (ReadCommand(0x90) & 0x80) // await completion. wait_us(POLLWAITuSec); } REGISTERPERFORMANCE(PRF_DRAWTRIANGLE); return ret; } RetCode_t RA8875::circle(loc_t x, loc_t y, dim_t radius, color_t color, fill_t fillit) { foreground(color); return circle(x,y,radius,fillit); } RetCode_t RA8875::fillcircle(loc_t x, loc_t y, dim_t radius, color_t color, fill_t fillit) { foreground(color); return circle(x,y,radius,fillit); } RetCode_t RA8875::circle(loc_t x, loc_t y, dim_t radius, fill_t fillit) { RetCode_t ret = noerror; PERFORMANCE_RESET; if (radius <= 0) { ret = bad_parameter; } else if (radius == 1) { pixel(x,y); } else { WriteCommandW(0x99, x); WriteCommandW(0x9B, y); WriteCommand(0x9d, radius & 0xFF); unsigned char drawCmd = 0x00; // Circle if (fillit == FILL) drawCmd |= 0x20; WriteCommand(0x90, drawCmd); WriteCommand(0x90, 0x40 + drawCmd); // Start drawing. while (ReadCommand(0x90) & 0x40) // await completion. wait_us(POLLWAITuSec); } REGISTERPERFORMANCE(PRF_DRAWCIRCLE); return ret; } RetCode_t RA8875::ellipse(loc_t x, loc_t y, dim_t radius1, dim_t radius2, color_t color, fill_t fillit) { foreground(color); return ellipse(x,y,radius1,radius2,fillit); } RetCode_t RA8875::fillellipse(loc_t x, loc_t y, dim_t radius1, dim_t radius2, color_t color, fill_t fillit) { foreground(color); return ellipse(x,y,radius1,radius2,fillit); } RetCode_t RA8875::ellipse(loc_t x, loc_t y, dim_t radius1, dim_t radius2, fill_t fillit) { RetCode_t ret = noerror; PERFORMANCE_RESET; if (radius1 <= 0 || radius2 <= 0) { ; // do nothing } else if (radius1 == 1 && radius2 == 1) { pixel(x, y); } else { WriteCommandW(0xA5, x); WriteCommandW(0xA7, y); WriteCommandW(0xA1, radius1); WriteCommandW(0xA3, radius2); unsigned char drawCmd = 0x00; // Ellipse if (fillit == FILL) drawCmd |= 0x40; WriteCommand(0xA0, drawCmd); WriteCommand(0xA0, 0x80 + drawCmd); // Start drawing. while (ReadCommand(0xA0) & 0x80) // await completion. wait_us(POLLWAITuSec); } REGISTERPERFORMANCE(PRF_DRAWELLIPSE); return ret; } RetCode_t RA8875::frequency(unsigned long Hz) { spi.frequency(Hz); // __ ___ // Clock ___A Rising edge latched // ___ ____ // Data ___X____ spi.format(8, 3); // 8 bits and clock to data phase 0 init(); return noerror; } RetCode_t RA8875::Power(bool on) { WriteCommand(0x01, (on) ? 0x80 : 0x00); return noerror; } RetCode_t RA8875::Reset(void) { WriteCommand(0x01, 0x01); // Apply Display Off, Reset wait_ms(2); // no idea if I need to wait, or how long WriteCommand(0x01, 0x00); // Display off, Remove reset wait_ms(2); // no idea if I need to wait, or how long init(); return noerror; } RetCode_t RA8875::Backlight_u8(unsigned char brightness) { static bool is_enabled = false; if (brightness == 0) { WriteCommand(0x8a); // Disable the PWM WriteData(0x00); is_enabled = false; } else if (!is_enabled) { WriteCommand(0x8a); // Enable the PWM WriteData(0x80); WriteCommand(0x8a); // Not sure why this is needed, but following the pattern WriteData(0x81); // open PWM (SYS_CLK / 2 as best I can tell) is_enabled = true; } WriteCommand(0x8b, brightness); // Brightness parameter 0xff-0x00 return noerror; } RetCode_t RA8875::Backlight(float brightness) { unsigned char b; if (brightness >= 1.0) b = 255; else if (brightness <= 0.0) b = 0; else b = (unsigned char)(brightness * 255); return Backlight_u8(b); } RetCode_t RA8875::set_font(const unsigned char * _font) { if (font && ! _font) { SetTextCursor(cursor_x, cursor_y); // soft-font cursor -> hw cursor } font = _font; GraphicsDisplay::set_font(_font); return noerror; // trusting them, but it might be good to put some checks in here... } RetCode_t RA8875::background(color_t color) { GraphicsDisplay::background(color); WriteCommand(0x60, (color>>11)); // BGCR0 WriteCommand(0x61, (unsigned char)(color>>5)); // BGCR0 WriteCommand(0x62, (unsigned char)(color)); // BGCR0 return noerror; } RetCode_t RA8875::background(unsigned char r, unsigned char g, unsigned char b) { background(RGB(r,g,b)); // WriteCommand(0x60, r); // WriteCommand(0x61, g); // WriteCommand(0x62, b); return noerror; } RetCode_t RA8875::foreground(color_t color) { GraphicsDisplay::foreground(color); WriteCommand(0x63, (unsigned char)(color>>11)); WriteCommand(0x64, (unsigned char)(color>>5)); WriteCommand(0x65, (unsigned char)(color)); return noerror; } RetCode_t RA8875::foreground(unsigned char r, unsigned char g, unsigned char b) { foreground(RGB(r,g,b)); // WriteCommand(0x63, r); // WriteCommand(0x64, g); // WriteCommand(0x65, b); return noerror; } color_t RA8875::GetForeColor(void) { color_t color; color = (ReadCommand(0x63) & 0x1F) << 11; color |= (ReadCommand(0x64) & 0x3F) << 5; color |= (ReadCommand(0x65) & 0x1F); return color; } color_t RA8875::DOSColor(int i) { const color_t colors[16] = { Black, Blue, Green, Cyan, Red, Magenta, Brown, Gray, Charcoal, BrightBlue, BrightGreen, BrightCyan, Orange, Pink, Yellow, White }; if (i < 16) return colors[i]; else return 0; } const char * RA8875::DOSColorNames(int i) { const char * names[16] = { "Black", "Blue", "Green", "Cyan", "Red", "Magenta", "Brown", "Gray", "Charcoal", "BrightBlue", "BrightGreen", "BrightCyan", "Orange", "Pink", "Yellow", "White" }; if (i < 16) return names[i]; else return NULL; } /////////////////////////////////////////////////////////////// // Private functions unsigned char RA8875::spiwrite(unsigned char data) { unsigned char retval; retval = spi.write(data); return retval; } unsigned char RA8875::spiread(void) { unsigned char retval; unsigned char data = 0; retval = spi.write(data); return retval; } RetCode_t RA8875::select(bool chipsel) { cs = (chipsel == true) ? 0 : 1; return noerror; } RetCode_t RA8875::init(void) { Backlight_u8(0); WriteCommand(0x88, 0x0a); // PLLC1 - Phase Lock Loop registers wait_ms(1); WriteCommand(0x89, 0x02); wait_ms(1); // System Config Register (SYSR) WriteCommand(0x10, 0x0C); // 16-bpp (65K colors) color depth, 8-bit interface // Pixel Clock Setting Register (PCSR) WriteCommand(0x04, 0x82); // PDAT on PCLK falling edge, PCLK = 4 x System Clock wait_ms(1); // Horizontal Settings WriteCommand(0x14, RA8875_DISPLAY_WIDTH/8 - 1); //HDWR//Horizontal Display Width Setting Bit[6:0] WriteCommand(0x15, 0x02); //HNDFCR//Horizontal Non-Display Period fine tune Bit[3:0] WriteCommand(0x16, 0x03); //HNDR//Horizontal Non-Display Period Bit[4:0] WriteCommand(0x17, 0x01); //HSTR//HSYNC Start Position[4:0] WriteCommand(0x18, 0x03); //HPWR//HSYNC Polarity ,The period width of HSYNC. // Vertical Settings WriteCommand(0x19, (RA8875_DISPLAY_HEIGHT-1)&0xFF); //VDHR0 //Vertical Display Height Bit [7:0] WriteCommand(0x1a, (RA8875_DISPLAY_HEIGHT-1)>>8); //VDHR1 //Vertical Display Height Bit [8] WriteCommand(0x1b, 0x0F); //VNDR0 //Vertical Non-Display Period Bit [7:0] WriteCommand(0x1c, 0x00); //VNDR1 //Vertical Non-Display Period Bit [8] WriteCommand(0x1d, 0x0e); //VSTR0 //VSYNC Start Position[7:0] WriteCommand(0x1e, 0x06); //VSTR1 //VSYNC Start Position[8] WriteCommand(0x1f, 0x01); //VPWR //VSYNC Polarity ,VSYNC Pulse Width[6:0] // Clear ram image window(0,0, width(), height()); // Initialize to full screen SetTextCursorControl(); foreground(Blue); background(Black); cls(); return noerror; } #ifdef TESTENABLE #include "Arial12x12.h" #include "Small_6.h" // ______________ ______________ ______________ _______________ // /_____ _____/ / ___________/ / ___________/ /_____ ______/ // / / / / / / / / // / / / /___ / /__________ / / // / / / ____/ /__________ / / / // / / / / / / / / // / / / /__________ ___________/ / / / // /__/ /_____________/ /_____________/ /__/ // // Everything from here down is test code. void TextCursorTest(RA8875 & display, Serial & pc) { const char * iCursor = "The I-Beam cursor should be visible for this text.\r\n"; const char * uCursor = "The Underscore cursor should be visible for this text.\r\n"; const char * bCursor = "The Block cursor should be visible for this text.\r\n"; const char * bbCursor = "The Blinking Block cursor should be visible for this text.\r\n"; const char * p; pc.printf("Text Cursor Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.Backlight_u8(255); display.puts(0,0, "Text Cursor Test."); // visible, non-blinking display.SetTextCursor(0,20); display.SetTextCursorControl(IBEAM, false); p = iCursor; while (*p) { display._putc(*p++); wait_ms(100); } display.SetTextCursorControl(UNDER, false); p = uCursor; while (*p) { display._putc(*p++); wait_ms(100); } display.SetTextCursorControl(BLOCK, false); p = bCursor; while (*p) { display._putc(*p++); wait_ms(100); } display.SetTextCursorControl(BLOCK, true); p = bbCursor; while (*p) { display._putc(*p++); wait_ms(100); } wait_ms(2000); display.SetTextCursorControl(NOCURSOR, false); } void BacklightTest(RA8875 & display, Serial & pc, float ramptime) { char buf[60]; pc.printf("Backlight Test - ramp over %f sec.\r\n", ramptime); display.Backlight_u8(0); display.background(White); display.foreground(Blue); display.cls(); wait_ms(200); display.puts(0,0, "RA8875 Backlight Test - Ramp up."); for (int i=0; i <= 255; i++) { unsigned int w = (ramptime * 1000)/ 256; sprintf(buf, "%3d, %4d", i, w); display.puts(100,100,buf); display.Backlight_u8(i); wait_ms(w); } } void BacklightTest2(RA8875 & display, Serial & pc) { pc.printf("Backlight Test 2\r\n"); // Dim it out at the end of the tests. display.foreground(Blue); display.puts(0,0, "Ramp Backlight down."); // Ramp it off for (int i=255; i != 0; i--) { display.Backlight_u8(i); wait_ms(20); } display.Backlight_u8(0); } void ExternalFontTest(RA8875 & display, Serial & pc) { pc.printf("External Font Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.Backlight(1); display.puts(0,0, "External Font Test."); display.set_font(Small_6); display.puts(0,30, "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz\r\n"); display.set_font(Arial12x12); display.puts("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz\r\n"); display.set_font(); // restore to internal display.puts("Normal font again."); //display.window(0,0, display.width(), display.height()); } void DOSColorTest(RA8875 & display, Serial & pc) { pc.printf("DOS Color Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.puts(0,0, "DOS Colors - Fore"); display.puts(280,0, "Back"); display.background(Gray); for (int i=0; i<16; i++) { display.foreground(display.DOSColor(i)); display.puts(160, i*16, display.DOSColorNames(i)); display.background(Black); } display.foreground(White); for (int i=0; i<16; i++) { display.background(display.DOSColor(i)); display.puts(360, i*16, display.DOSColorNames(i)); display.foreground(White); } } void WebColorTest(RA8875 & display, Serial & pc) { pc.printf("Web Color Test\r\n"); display.background(Black); display.foreground(Blue); display.window(0,0, display.width(), display.height()); display.cls(); display.puts(0,0, "Web Color Test\r\n"); display.SetTextFontSize(1,2); for (int i=0; i<sizeof(WebColors)/sizeof(WebColors[0]); i++) { display.background(WebColors[i]); display.puts(" "); if (i % 36 == 35) display.puts("\r\n"); } display.SetTextFontSize(1,1); } void PixelTest(RA8875 & display, Serial & pc) { int i, c, x, y; pc.printf("Pixel Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.puts(0,0, "Pixel Test"); for (i=0; i<1000; i++) { x = rand() % 480; y = 16 + rand() % (272-16); c = rand() % 16; //pc.printf(" (%d,%d) - %d\r\n", x,y,r1); display.pixel(x,y, display.DOSColor(c)); } } void LineTest(RA8875 & display, Serial & pc) { int i, x, y, x2, y2; pc.printf("Line Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.puts(0,0, "Line Test"); for (i=0; i<16; i++) { // Lines x = rand() % 480; y = rand() % 272; x2 = rand() % 480; y2 = rand() % 272; display.line(x,y, x2,y2, display.DOSColor(i)); } } void RectangleTest(RA8875 & display, Serial & pc) { int i, x1,y1, x2,y2; pc.printf("Rectangle Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.puts(0,0, "Rectangle Test"); for (i=0; i<16; i++) { x1 = rand() % 240; y1 = 50 + rand() % 200; x2 = rand() % 240; y2 = 50 + rand() % 200; display.rect(x1,y1, x2,y2, display.DOSColor(i)); x1 = 240 + rand() % 240; y1 = 50 + rand() % 200; x2 = 240 + rand() % 240; y2 = 50 + rand() % 200; display.rect(x1,y1, x2,y2, FILL); } } void RoundRectTest(RA8875 & display, Serial & pc) { loc_t i, x1,y1, x2,y2, r1,r2; pc.printf("Round Rectangle Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.puts(0,0, "Rounded Rectangle Test"); for (i=0; i<16; i++) { x1 = rand() % 240; y1 = 50 + rand() % 200; x2 = x1 + rand() % 100; y2 = y1 + rand() % 100; r1 = rand() % (x2 - x1)/2; r2 = rand() % (y2 - y1)/2; display.roundrect(x1,y1, x2,y2, 5,8, display.DOSColor(i)); x1 = 240 + rand() % 240; y1 = 50 + rand() % 200; x2 = x1 + rand() % 100; y2 = y1 + rand() % 100; r1 = rand() % (x2 - x1)/2; r2 = rand() % (y2 - y1)/2; display.roundrect(x1,y1, x2,y2, r1,r2, FILL); } } void TriangleTest(RA8875 & display, Serial & pc) { int i, x1, y1, x2, y2, x3, y3; pc.printf("Triangle Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.puts(0,0, "Triangle Test"); x1 = 150; y1 = 2; x2 = 190; y2 = 7; x3 = 170; y3 = 16; display.triangle(x1,y1, x2,y2, x3,y3); x1 = 200; y1 = 2; x2 = 240; y2 = 7; x3 = 220; y3 = 16; display.filltriangle(x1,y1, x2,y2, x3,y3, BrightRed); x1 = 300; y1 = 2; x2 = 340; y2 = 7; x3 = 320; y3 = 16; display.triangle(x1,y1, x2,y2, x3,y3, NOFILL); x1 = 400; y1 = 2; x2 = 440; y2 = 7; x3 = 420; y3 = 16; display.triangle(x1,y1, x2,y2, x3,y3, Blue); for (i=0; i<16; i++) { x1 = rand() % 240; y1 = 50 + rand() % 200; x2 = rand() % 240; y2 = 50 + rand() % 200; x3 = rand() % 240; y3 = 50 + rand() % 200; display.triangle(x1,y1, x2,y2, x3,y3, display.DOSColor(i)); x1 = 240 + rand() % 240; y1 = 50 + rand() % 200; x2 = 240 + rand() % 240; y2 = 50 + rand() % 200; x3 = 240 + rand() % 240; y3 = 50 + rand() % 200; display.triangle(x1,y1, x2,y2, x3,y3, FILL); } } void CircleTest(RA8875 & display, Serial & pc) { int i, x, y, r1; pc.printf("Circle Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.puts(0,0, "Circle Test"); for (i=0; i<16; i++) { x = 100 + rand() % 100; y = 70 + rand() % 200; r1 = rand() % min(y - 20, 100); //pc.printf(" (%d,%d) - %d\r\n", x,y,r1); display.circle(x,y,r1, display.DOSColor(i)); x = 300 + rand() % 100; y = 70 + rand() % 200; r1 = rand() % min(y - 20, 100); //pc.printf(" (%d,%d) - %d FILL\r\n", x,y,r1); display.circle(x,y,r1, display.DOSColor(i), FILL); } } void EllipseTest(RA8875 & display, Serial & pc) { int i,x,y,r1,r2; pc.printf("Ellipse Test\r\n"); display.background(Black); display.foreground(Blue); display.cls(); display.puts(0,0, "Ellipse Test"); for (i=0; i<16; i++) { x = 100 + rand() % 100; y = 70 + rand() % 200; r1 = rand() % min(y - 20, 100); r2 = rand() % min(y - 20, 100); display.ellipse(x,y,r1,r2, display.DOSColor(i)); x = 300 + rand() % 100; y = 70 + rand() % 200; r1 = rand() % min(y - 20, 100); r2 = rand() % min(y - 20, 100); display.ellipse(x,y,r1,r2, FILL); } } void TestGraphicsBitmap(RA8875 & display, Serial & pc) { LocalFileSystem local("local"); display.background(Black); display.foreground(Blue); display.cls(); display.puts(0,0, "Graphics Test, loading /local/TestPat.bmp"); wait(3); int r = display.RenderBitmapFile(0,0, "/local/TestPat.bmp"); } void RunTestSet(RA8875 & lcd, Serial & pc) { int q = 0; int automode = 0; const unsigned char modelist[] = "BDWtGLFROTPCEb"; // auto-test in this order. while(1) { pc.printf("\r\n" "B - Backlight up b - backlight dim\r\n" "D - DOS Colors W - Web Colors\r\n" "t - text cursor G - Graphics Bitmap\r\n" "L - Lines F - external Font\r\n" "R - Rectangles O - rOund rectangles\r\n" "T - Triangles P - Pixels \r\n" "C - Circles E - Ellipses\r\n" "A - Auto Test mode r - reset \r\n" "> "); if (automode == -1 || pc.readable()) { automode = -1; q = pc.getc(); while (pc.readable()) pc.getc(); } else if (automode >= 0) { q = modelist[automode]; } switch(q) { case 'A': automode = 0; break; case 'B': BacklightTest(lcd, pc, 4); break; case 'b': BacklightTest2(lcd, pc); break; case 'D': DOSColorTest(lcd, pc); break; case 'W': WebColorTest(lcd, pc); break; case 't': TextCursorTest(lcd, pc); break; case 'F': ExternalFontTest(lcd, pc); break; case 'L': LineTest(lcd, pc); break; case 'R': RectangleTest(lcd, pc); break; case 'O': RoundRectTest(lcd, pc); break; case 'T': TriangleTest(lcd, pc); break; case 'P': PixelTest(lcd, pc); break; case 'G': TestGraphicsBitmap(lcd, pc); break; case 'C': CircleTest(lcd, pc); break; case 'E': EllipseTest(lcd, pc); break; case 'r': pc.printf("Resetting ...\r\n"); wait_ms(20); mbed_reset(); break; default: printf("huh?\n"); break; } if (automode >= 0) { automode++; if (automode >= sizeof(modelist)) automode = 0; wait_ms(2000); } wait_ms(200); } } #endif // TESTENABLE