/esp8266_ili9341

ESP8266 ILI9341 multiple window + printf sources, wireframe viewer, cusom fonts, WEB, SD CARD , RTC

Primary LanguageHTMLOtherNOASSERTION

\mainpage index page \section README

@par Documentation

@par Copyright

  • See COPYRIGHT.md for a full copyright notice for the project

@par Description

  • ESP8266 ILI9341 with multiple window support WEB server and other networking demos
    • The specific display is an TM022HDH26 display I got from ebay.
  • I wrote the following support functions from scratch
    • Font compiler and display code
    • ILI9341 display driver with multiple custom sized window support
    • (I rewrote most of Adafruit code ili9341 graphics library)
    • readPixel() and custom sized window scrolling
    • Not limited by ILI9341 hardware scroll restrictions.
    • CORDIC C table generator and 3D transformation code support functions
    • Wire frame viewer and C generator for Earth coastline data
      • I created two wireframe demos
        • Cube wireframe dataset
        • Earth coastline dataset - wireframe view still needs hidden line removal option
    • Small Printf with full floating point support along with ftoa/atof and integer conversions
    • BDF fonts and a BDF font to C conversion code and optimized display code
    • WEB server using SD CARD with CGI processing - files and CGI results can be ANY SIZE!
    • Network server client example for display updates
    • Uart network server client for serial uart to network bridge.
    • Generic queue handling code
    • Uart driver.
    • POSIX wrappers for FatFS support by ChaN
    • POSIX time functions and RTC set with NTP
    • Timers used by rtc and time functions
    • HSPI code that can handle multiple chip select and clock frequencies
  • Includes FatFS SD card support by ChaN

@par Credits

@par Directories

  • .

    • Makefile from CHERTS modified for the project
    • README.md - Project readme file
    • COPYRIGHT.md - Project Copyright file
    • Doxyfile - Doxygen configuration file
    • get_esp-open-sdk - shell script to download an install ESP OPEN SDK on Ubuntu 14.04LTS
    • term115200 - shell script to launch terminal to 115200 baud

  • bridge

    • bridge.c
    • bridge.h
      • Serial bridge code - send and receive serial data via network
      • Opens a port on port 23 so you can use telnet to test
        • Note: at the moment no telnet command processing is done.

  • cordic

    • cordic.c
      • My 3D transformation functions based on CORDIC and gradians/100
      • 1 = 90degrees so the integer part reflects the quadrant
    • cordic2c_inc.h
      • CORDIC lookup tables generated with my program cordic2c
      • 1 = 90degrees so the integer part reflects the quadrant
    • make_cordic
      • cordic2c.c
        • My customized CORDIC code, CORDIC table generating tools
        • Creates fixed point tables where 1 = 90degrees
          • The integer part reflects the quadrant
        • Based on work by P. Knoppers, 13-Apr-1992.
      • Makefile
        • Make and test CORDIC tables

  • display

    • font.c
    • font.h
      • My Fixed and proportional font display code
    • fonts.h
      • Fonts data structures converted BDF fonts
    • ili9341.c
    • ili9341.h
      • My mostly rewritten ili9341 display driver code handles multiple windows
        • Optimized line drawing function is from CHERTS
        • Non optimized version is also supplied that I wrote in 1984
        • multiple window support
        • readPixel() works on most all 4 wire displays now
        • scrolling window support

  • docs

    • ili9431 and esp8266 related documents

  • driver - third party code

    • cal_dex.c
      • Debug exception support by cal (20150421, cal)
    • ili9341_adafruit.c
    • ili9341_adafruit.h
      • Adafruit display - just those functions that I have not rewritten

  • earth

    • Earth coast line data and display code
    • Still need to add hidden vector removal
      • 00README.txt
        • Article on coordinate transforms from stackoverflow by Daphna Shezaf
      • make_wireframe
        • earth2wireframe.c
          • Create C structure wire-frame coastline data
          • This code could be easily adapted for any kind of wire-frame
        • Makefile
          • earth_data.h from Coastline LAt/LONG pairs
        • data
          • world.dat
          • world_10m.txt
          • world_110m.txt
          • world_50m.txt
            • Coastline data at various resolutions

  • fatfs

    • SD CARD support with FatFS and POSIX wrappers modified to use hardware abstraction
    • Files originally from FatFs (C)ChaN, 2013
      • disk.c
      • disk.h
      • diskio.h
      • ff.c
      • ffconf.h
      • ff.h
      • integer.h
      • mmc.c
      • mmc.h
      • option
      • syscall.c
      • unicode.c
    • My interface and POSIX wrappers
      • fatfs_utils.c
      • fatfs_utils.h
      • mmc_hal.c
      • mmc_hal.h
      • posix.c
      • posix.h

  • fonts

    • BDF Font conversion code
      • bdffont2c.c
        • Convert BDF fonts to C structures main program
      • bdffontutil.c
      • bdffontutil.h
        • BDF fonts to C support code
      • bdfview.c
        • ASCII previewer to test BDF display code
      • font.h
        • Font data structure definitions
      • fonts.h
        • Converted fonts as C structures
      • Makefile
        • Make file to build selected fonts into a C structure
      • docs
        • BDF font specs
      • fixed
        • ucs-fonts.tar.gz
        • Unicode versions of the X11 "misc-fixed-*" fonts
        • Markus Kuhn, etc
      • fonts
        • Rockbox Font Collection - www.rockbox.org
        • Reorganized into three directories
          • C - constant size fonts
          • P - Proportional size fonts
          • O - Other

  • include

    • misc esp8266 include files

  • lib

    • time, rtc and timer functions
    • time.h
    • time.c - POSIX time functions
    • timer.h
    • timer.c - simple timers (only intended for quick functions)
    • timer_hal.h
    • timer_hal.c - timer hardware abstraction layer

  • network

    • Simple network server - displays message sent by send.c
    • network.c

  • printf

    • My small printf with floating support, misc I/O functions
      • Makefile
        • Build and test printf
      • pr.c
        • Printf interface to display library tft_printf()
      • printf.c
      • printf.h
        • My printf code

  • send.c

    • Send message to network server
    • Example: ./send -i 192.168.200.116 -m '\fscrolling\ntext\n1\n2\n3\n4'
      • These escape characters are processed on the display: \n, \t, \f

  • user

    • Main user demo task
    • user_main.c
      • Intializes ESP8266 and sets up demo with 4 active windows with independent attributes

  • utils * hspi.c
    * hspi.h

    • My rewritten HPSI code that avoids unaligned read and writes
    • Origonal Code from CHERTS and Sem * queue.c * queue.h
    • Generic ring buffer support code * uart.c * uart.h * uart_register.h
    • Interrup driven receive and transmit code * util.c * util.h
    • Flash read
    • Bittest functions
    • For system requiring specific memory alignment access methods
    • POSIX malloc,calloc and free wrappers

  • web

    • web.c
    • web.h
      • Web server with FAT filesystem SD CARD support
      • Served files can be ANY SIZE!
      • CGI files can have an extension of: html,htm,text,txt,cgi
        • Only tokens of the form @_ token _@ are replaced by the rewrite function
          • @see rewrite_cgi_token() in web.c
      • CGI results can be ANY SIZE
      • Uses yield function to continue background tasks while serving requests

  • wire

    • wire.c
    • wire.h
      • Wireframe viewer code - uses CORDIC
    • cube_data.h
      • Wireframe CUBE data
    • earth_data.h
      • Wireframe EARTH data

  • yield

    • README.txt
    • cont.S
    • cont.h
    • cont_util.c
      • Context switch code
    • ets_sys.h
    • user_task.c
    • user_task.h
      • Main user_init and task replacement with yield support

@par Demo Images

  • Running demo and sending a message to the network window
  • "./send -i 192.168.200.116 -m 'testing\nTest3\nscrolling\ntext\n1\n2'"
    • Diagnostics from send ip:192.168.200.116, port:31415, message: testing Test3 scrolling text 1 2 Host name: 192.168.200.116
    • Result: