Library for Mini-DK board

Dependencies:   SPI_TFT_ILI9320

Dependents:   LPC1768_Mini-DK_EasyWeb_DM9161 LPC1768_Mini-DK LPC1768_Mini-DK

Fork of Mini-DK by Frank Vannieuwkerke

Mini-DK board overview (Micro SD connector is at the bottom side)

One serial interface , uses CP2102 (USB to RS232 interface, support ISP download )

RJ45-10/100M Ethernet network interface (Ethernet PHY: DM9161)

2.8 inch TFT color LCD interface (SPI interface or 16Bit parallel interface)

Touch panel controller XPT2046 (ADS7843 compatible)

USB 2.0 interface, USB host and USB Device interface.

TF SD / MMC card (SPI) interface.

Two user buttons, One Reset button and ISP button , One INT0 button, two user-programmable LED lights

Serial ISP download, Standard 20-pin JTAG download simulation debugging interface.

Selection between external 5V power supply or USB 5V supply.

Board size: 95mm * 78mm

All IO available on extension connectors

/media/uploads/frankvnk/mini-dk_top.jpg

04/01/13

Erik Olieman (http://mbed.org/users/Sissors/) joined the code development for the Mini-DK board.

Thanks to his input, we were able to obtain a tremendous speed gain, remove warnings, ...

An overview of all modifications is stored in modifs.h

The old page (http://mbed.org/users/frankvnk/code/LPC1768_Mini-DK/) contains the demo code.

IMPORTANT : Due to a change in the mbed libraries (Stream()), we cannot use the printf instruction - we need to use <SPI_TFT>.printf (example - see main.cpp in http://mbed.org/users/frankvnk/code/LPC1768_Mini-DK/)

WARNING: filetoflash (SD to CPU flash)

The SPI_TFT library contains an option to copy an image from the SD card to the CPU flash memory. This allows you to use an image as background without speed loss when writing other text and graphics.

By default, this option is enabled.

It can be disabled by uncommenting the #define mentioned below in Mini_DK.h:

#define NO_FLASH_BUFFER

Since the flash memory has limited write endurance, DO NOT use this feature when you intend to read multiple images from the SD card (eg: when used as a photo frame).

14/01/13

A newer version of the Mini-DK has been released by the manufacturer: Mini-DK2. They replaced the DM9161 PHY with a LAN8720A PHY and better buttons are fitted on the board. All other hardware remains the same. Code for this PHY is available from the NXP MCU SW application team. This allows us to use the mbed 'EthernetInterface' library with little modifications. Further info - see http://mbed.org/forum/mbed/topic/3684/?page=1#comment-18473.

Notes:

The code in 'lpc_phy_lan8720.c' uses 'msDelay' - needs to be replaced with 'osDelay'.

A custom MAC address can be defined using following code:

extern "C" void mbed_mac_address(char * mac) {
 
// define your own MAC Address
  mac[0] = 0x00;  
  mac[1] = 0x01;  
  mac[2] = 0x02;  
  mac[3] = 0x03;  
  mac[4] = 0x04;  
  mac[5] = 0x05;           
  
};
Revision:
17:66c4e84d8571
Parent:
6:b547fb6c1095
--- a/modifs.h	Tue Jan 08 17:39:50 2013 +0000
+++ b/modifs.h	Wed Jan 09 20:54:35 2013 +0000
@@ -1,84 +1,116 @@
 /*
-Date    : 31.12.12
 Authors : Erik Olieman/Frank Vannieuwkerke
------------------------------------------
-      Code readability and speed
-        1. created separate structure for mini-DK (base for library)
-        2. Removed wr_dat_only routine (uses 8 bit transfer = slow) in SPI_TFT
-           Replaced each wr_dat_only with
-             _spi.format(16,3);
-             .....
-             _spi.write(...);
-             .....
-             _spi.format(8,3);
-        3. Creation of Mini-DK.h with all declarations specific to the mini-DK board.
+------------------------------------------
+
+    11/12/2012  Initial code (ported from Peter Drescher's code - http://mbed.org/cookbook/SPI-driven-QVGA-TFT
+                Replaced DMA code with SPI code - modified several functions to fit ILI9320.
+
+    12/12/2012  (SPI_TFT) Replaced circle and fillcircle with draw_ellipse and fill_ellipse
+                          Modified rect and fillrect: use width and height parameters instead of x1,y1
+
+    31/12/2012  lpc1768 SPI port: problem when using SD and TFT simultaneously - solution provided by Erik Olieman
+                see note http://mbed.org/comments/cr/83/2654/#c4768
 
-
-      Removed reset pin from SPI_TFT (not needed - pin is connected to main reset).
+                Code readability and speed
+                  1. created separate structure for mini-DK (base for library)
+                  2. Removed wr_dat_only routine (uses 8 bit transfer = slow) in SPI_TFT
+                     Replaced each wr_dat_only with
+                       _spi.format(16,3);
+                       .....
+                       _spi.write(...);
+                       .....
+                       _spi.format(8,3);
+                  3. Creation of Mini-DK.h with all declarations specific to the mini-DK board.
 
-      Separated SPI_TFT from TouchADS7843
-      
-      In main.cpp
-      ----------- 
+                Removed reset pin from SPI_TFT (not needed - pin is connected to main reset).
 
-      TouchScreenADS7843 initialisation: pointer to SPI_TFT needed for calibration, drawcross and drawpoint routines.
+                Separated SPI_TFT from TouchADS7843
       
-      Moved following global touch var declarations from main.cpp back to touch.cpp/.h
-        Matrix      matrix;
-        Coordinate  display;
-        Coordinate  screen;
-        NOTE : i did not create a class with var readback, just used plain C notation.
-               These vars can be accessed from other code through <classname>.<varname>
-               example : TP.display.x
-               Only drawback : Each element of these vars needs to be initialised separately.
-                               (initialisation of these vars is not possible with array notation).
+                In main.cpp
+                ----------- 
+                TouchScreenADS7843 initialisation: pointer to SPI_TFT needed for calibration, drawcross and drawpoint routines.
+      
+                Moved following global touch var declarations from main.cpp back to touch.cpp/.h
+                  Matrix      matrix;
+                  Coordinate  display;
+                  Coordinate  screen;
+                  NOTE : i did not create a class with var readback, just used plain C notation.
+                         These vars can be accessed from other code through <classname>.<varname>
+                         example : TP.display.x
+                         Only drawback : Each element of these vars needs to be initialised separately.
+                                         (initialisation of these vars is not possible with array notation).
 
-      In Touch.cpp/.h
-      ---------------
-      TouchScreenADS7843 constructor: added pointer to SPI_TFT - needed for calibration, drawcross and drawpoint routines.
-                                      If LCD calls are not needed, initialise TouchScreenADS7843 with NULL pointer for LCD.
+                In Touch.cpp/.h
+                ---------------
+                TouchScreenADS7843 constructor: added pointer to SPI_TFT - needed for calibration, drawcross and drawpoint routines.
+                                                If LCD calls are not needed, initialise TouchScreenADS7843 with NULL pointer for LCD.
 
-      Removed TP_Init - moved TP_init code to constructor.
+                Removed TP_Init - moved TP_init code to constructor.
 
-      Variables in call to TouchPanel_Calibrate, Read_Ads7846, getDisplayPoint are no longer needed.
-      Modified these routines accordingly in touch.cpp/.h (pointers no longer needed)
-      *** TouchPanel_Calibrate and getDisplayPoint already modified.
+                Variables in call to TouchPanel_Calibrate, Read_Ads7846, getDisplayPoint are no longer needed.
+                Modified these routines accordingly in touch.cpp/.h (pointers no longer needed)
 
-      Read_Ads7846: is also called in TouchPanel_Calibrate (Touch.cpp) with other var.
-                    Modified Read_Ads7846 to allow call with/without (parameter).
-                    If called without  (parameter) - screen variable is used, otherwise (parameter) is used.
-                    in Touch.h - unsigned char Read_Ads7846(Coordinate * screenPtr); replaced with
-                                 unsigned char Read_Ads7846(Coordinate * screenPtr = NULL);
-                    in Touch.cpp - if (screenPtr == NULL) screenPtr = &screen; added.
+                Read_Ads7846: is also called in TouchPanel_Calibrate (Touch.cpp) with other var.
+                              Modified Read_Ads7846 to allow call with/without (parameter).
+                              When called without (parameter) - screen variable is used, otherwise (parameter) is used.
+                              in Touch.h - unsigned char Read_Ads7846(Coordinate * screenPtr); replaced with
+                                           unsigned char Read_Ads7846(Coordinate * screenPtr = NULL);
+                              in Touch.cpp - if (screenPtr == NULL) screenPtr = &screen; added.
+
       
       
       
-      General cleaning:
-      SPI_TFT::window function changed to use ints instead of unsigned ints, and made virtual to remove warnings.
-      In SPI_TFT.cpp GraphicsDiplay initialization moved to front to remove warnings
-      In Touch.cpp TFT pointer initialization moved to front to remove warnings
-      
-      In Mini_DK.h
-      ------------
-      Added SD card pins
-      Added two macros to enable/disable the LCD MISO pin, allowing use of both SD card and LCD
-      
+                In SPI_TFT
+                ----------
+                Changed the SPI object to a BurstSPI object
+                All cases where large numbers of bytes are written (filled rect, cls, etc) have been replaced by fastWrite functions for higher speed
+                mbed library updated to this century
+                Colorwheel stepsize reduced to 1 in main.cpp
       
-      In SPI_TFT
-      ----------
-      Changed the SPI object to a BurstSPI object
-      All cases where large numbers of bytes were writting (filled rect, cls, etc) have been replaced by fastWrite functions for higher speed
-      mbed library updated to this century
-      Removed stream name from TextDisplay (not used in current mbed version)
-      Colorwheel stepsize reduced to 1 in main.cpp
-      
-      Known issue: claim function for stdout does not work
-      
+                Known issues: claim function for stdout does not work
+                              Removed stream name from TextDisplay (not used in current mbed version)
 
 
-General notes
--------------
-lpc1768 SPI port - problem when using SD and TFT simultaneously - solution provided by Erik Olieman
-see note http://mbed.org/comments/cr/83/2654/#c4768
-Even faster SPI write : http://mbed.org/users/Sissors/code/BurstSPI/docs/600eecd89a78/BurstSPI_8cpp_source.html
+    03/01/2013  General cleaning:
+                    SPI_TFT::window function changed to use ints instead of unsigned ints, and made virtual to remove warnings.
+                    In SPI_TFT.cpp GraphicsDiplay initialization moved to front to remove warnings
+                    In Touch.cpp TFT pointer initialization moved to front to remove warnings
+                    In Mini_DK.h    Added SD card pins
+                                    Added two macros to enable/disable the LCD MISO pin, allowing use of both SD card and LCD
+                                    Usage (in your main function): 
+                                        ENABLE_LCD_MISO when you want to read from LCD
+                                        DISABLE_LCD_MISO when you want to read from SD
+                Faster SPI write: BurstSPI libary added.
+                                  _spi.write replaced with _spi.fastWrite
+                                  (http://mbed.org/users/Sissors/code/BurstSPI/docs/600eecd89a78/BurstSPI_8cpp_source.html)
+                Code cleanup & comments added.
+                Separate Mini_DK library created.
+                
+    04/01/2013  Added ability to use bitmaps from any filesystem.
+                Added conversion to be able to use 24 bit bitmaps.
+                NOTE : Don't forget to load the official mbed SDFileSystem library!! 
+                
+    06/01/2013  Bug fix in Bitmap function: orientation.
+                Added IAP (In-Application programming): internal Flash memory access library.
+                Added option to use a background image: #define USE_FLASH_BUFFER introduced in SPI_TFT.h
+                                                        When omitted, the bitmap is NOT copied to flash memory.
+                Bitmap function: comments about return codes updated.
+                Background image remains static when orientation is changed.
+                Constructor modified in SPI_TFT: backgroundOrientation = 0;
+                                                 changed to
+                                                 #ifdef USE_FLASH_BUFFER
+                                                 backgroundOrientation = 0;
+                                                 #endif
+                                                 
+    08/01/2013  Stream & claim issues resolved: mbed library has been updated by the mbed team to allow
+                                                stream name => claim function can be used again.
+                                                Changed 'TextDisplay::TextDisplay(const char *name) : Stream()' back to 
+                                                TextDisplay::TextDisplay(const char *name) : Stream(name) in TextDisplay.cpp
+                #define USE_FLASH_BUFFER (SPI_TFT.h) replaced with #define NO_FLASH_BUFFER (Mini_DK.h). When copy to flash
+                is not needed, enable this option.
+                
+    09/01/2013  Code cleanup: modifs.h streamlined.
+                              SPI_TFT.cpp and SPI_TFT.h comments.
+                              Touch.cpp commnets.
+
 */
\ No newline at end of file