Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
add-ons:mtdshield:reference-manual [2021/05/14 16:04] – ↷ Page moved from reference:add-ons:mtdshield:reference-manual to add-ons:mtdshield:reference-manual Arthur Brownadd-ons:mtdshield:reference-manual [2022/10/04 04:38] (current) – external edit 127.0.0.1
Line 8: Line 8:
 The Multi-Touch Display Shield is a gorgeous 2.8" touchscreen display with a powerful on-board microcontroller that performs graphics processing tasks. The display is a capacitive touchscreen with QVGA resolution (320x240) and 2 finger multi-touch support.  The Multi-Touch Display Shield is a gorgeous 2.8" touchscreen display with a powerful on-board microcontroller that performs graphics processing tasks. The display is a capacitive touchscreen with QVGA resolution (320x240) and 2 finger multi-touch support. 
  
-The most compelling aspect of the Multi-Touch Display Shield is the programming experience provided by its [[reference:software:mtds:start|Multi-Touch Display System (MTDS) Firmware]] and the associated libraries. These allow you to design sleek, stylish user interfaces very quickly and with very little code. The timing dependent tasks are handled by the firmware, so integrating the display into existing projects is also a snap. Some of the key functionality provided by the libraries include the ability to draw basic shapes and text, draw images stored on microSD with binary transparency, draw buttons and easily check if they have been pressed, and check the status and location of the user's two fingers. The libraries are supported in Arduino IDE and Xilinx SDK, and have been tested with Ardiuno, chipKIT and Arty host boards.+The most compelling aspect of the Multi-Touch Display Shield is the programming experience provided by its [[software:mtds:start|Multi-Touch Display System (MTDS) Firmware]] and the associated libraries. These allow you to design sleek, stylish user interfaces very quickly and with very little code. The timing dependent tasks are handled by the firmware, so integrating the display into existing projects is also a snap. Some of the key functionality provided by the libraries include the ability to draw basic shapes and text, draw images stored on microSD with binary transparency, draw buttons and easily check if they have been pressed, and check the status and location of the user's two fingers. The libraries are supported in Arduino IDE and Xilinx SDK, and have been tested with Ardiuno, chipKIT and Arty host boards.
  
 {{Digilent Image Gallery  {{Digilent Image Gallery 
Line 30: Line 30:
   * 2 Finger Capacitive touch panel   * 2 Finger Capacitive touch panel
   * Powerful PIC32MZ Microcontroller   * Powerful PIC32MZ Microcontroller
-  * [[reference:software:mtds:start|Multi-Touch Display System (MTDS) Firmware]]+  * [[software:mtds:start|Multi-Touch Display System (MTDS) Firmware]]
   * Design a beautiful UI with only a few lines of code using libraries for Arduino IDE and Xilinx SDK    * Design a beautiful UI with only a few lines of code using libraries for Arduino IDE and Xilinx SDK 
   * Easily draw images with binary transparency from files stored on microSD   * Easily draw images with binary transparency from files stored on microSD
Line 41: Line 41:
 =====Functional Description ===== =====Functional Description =====
  
-The Multi-Touch Display Shield has an on-board PIC32MZ microncontroller that is running the MTDS firmware. To communicate with the device, you must use the MTDS and MyDisp libraries available and documented on the [[reference:software:mtds:start|MTDS resource center]]. This library requires that the host SPI controller pinout matches Figure 1 below (this is not required for Zynq or FPGA based host boards). Arduino and chipKIT host boards should use the Arduino IDE libraries, and Xilinx FPGA or Zynq based host boards should use the PmodMTDS IP core and the libraries included with it. For information on downloading and using the PmodMTDS IP core see the [[reference:software:mtds:start|MTDS resource center]]. +The Multi-Touch Display Shield has an on-board PIC32MZ microncontroller that is running the MTDS firmware. To communicate with the device, you must use the MTDS and MyDisp libraries available and documented on the [[software:mtds:start|MTDS resource center]]. This library requires that the host SPI controller pinout matches Figure 1 below (this is not required for Zynq or FPGA based host boards). Arduino and chipKIT host boards should use the Arduino IDE libraries, and Xilinx FPGA or Zynq based host boards should use the PmodMTDS IP core and the libraries included with it. For information on downloading and using the PmodMTDS IP core see the [[software:mtds:start|MTDS resource center]]. 
  
 {{ :reference:add-ons:mtdshield:mtdshield.png?direct&600 |}} {{ :reference:add-ons:mtdshield:mtdshield.png?direct&600 |}}
Line 63: Line 63:
 JP1 is used to select which shield pin to use for chip select. When it is in the "Host" position, the normal chip select pin is used (digital pin 10). When it is in the "Alt" position, the alternative chip select pin is used (digital pin 8).  JP1 is used to select which shield pin to use for chip select. When it is in the "Host" position, the normal chip select pin is used (digital pin 10). When it is in the "Alt" position, the alternative chip select pin is used (digital pin 8). 
  
-The microSD connector allows the MTDS firmware to draw and save images to an attached microSD card. In order to work properly, the microSD card must be formatted as FAT32. Image files should be saved as Windows Bitmap files (.bmp). For more information see the MTDS documentation available on the [[reference:software:mtds:start|MTDS resource center]]. +The microSD connector allows the MTDS firmware to draw and save images to an attached microSD card. In order to work properly, the microSD card must be formatted as FAT32. Image files should be saved as Windows Bitmap files (.bmp). For more information see the MTDS documentation available on the [[software:mtds:start|MTDS resource center]]. 
  
 The Multi-Touch Display Shield is designed to work with hosts that use 3.3V or 5.0V I/O signaling. The Multi-Touch Display Shield is designed to work with hosts that use 3.3V or 5.0V I/O signaling.
Line 71: Line 71:
 The schematics of the Multi-Touch Display Shield are available {{:reference:add-ons:mtdshield:multi-touch_display_shield_sch.pdf|here}}.  The schematics of the Multi-Touch Display Shield are available {{:reference:add-ons:mtdshield:multi-touch_display_shield_sch.pdf|here}}. 
  
-The Multi-Touch Display System requires the use of the MTDS and/or the MyDisp libraries, which are available and documented at the [[reference:software:mtds:start|MTDS resource center]].+The Multi-Touch Display System requires the use of the MTDS and/or the MyDisp libraries, which are available and documented at the [[software:mtds:start|MTDS resource center]].
  
 If you have any questions or comments about the Multi-Touch Display Shield, feel free to post them under the appropriate section ("Add-on Boards") of the [[https://forum.digilentinc.com/|Digilent Forum]]. If you have any questions or comments about the Multi-Touch Display Shield, feel free to post them under the appropriate section ("Add-on Boards") of the [[https://forum.digilentinc.com/|Digilent Forum]].