Ver el código de «ST7920»

= Características =
== Address Counter (AC) ==
La AC es una dirección que sirve para poder acceder a la DDRAM, CGRAM y GDRAM. Cuando yo quiero acceder a una posicion de la DDRAM, CGRAM o GDRAM lo hago a traves de una dirección. Mediante el siguiente dibujo explico la relación entre la AC y la DDRAM. La relación con la CGRAM no la explicaré porque no la encuentro necesaria y no me he parado a "jugar" con ella, y la relación con la GDRAM la explico en el apartado de [[ST7920#Relación AC con GDRAM|Relación AC con GDRAM]].

== CGROM ==
Esta CGROM tiene la particularidad que tiene caracteres chinos de 16x16 puntos. Según el manual tiene 8192 caracteres. 
== HCGROM ==
La HCGROM contiene 128 caracteres alfanumericos de 8x16 puntos. Lo que quiere decir que son los caracteres que representan nuestro abecedario. Cada caracter de estos ocupa la mitad que los de la CGROM y necesitas escribir dos caracteres de la HCGROM para completar una dirección AC.<br/>


Explicación gráfica:
[[File:HCGROM.jpg]]


*Como se puede ver en el dibujo, en este lcd se pueden mostrar 8 caracteres de la CGROM y 16 de la HCGROM. La CGROM son kanjis chinos y la HCGROM son caracteres alfanumericos (nuestro abecedario mas los signos de puntuación, etc)
*Cada caracter HCGROM consta de 8bits, y un caracter de CGROM necesita 16bits para ser representado
*La AC tiene solo 8 posiciones, lo que significa que tengo que escribir los caracteres alfanuméricos de dos en dos porque dos caracteres de la HCGROM equivalen a 1 AC


=== Peculiaridad al escribir un caracter de la HCGROM ===
Aqui intento explicar el punto anterior de la AC.


*Enviamos la instrucción 0x40 que es enviar la AC 0x00 con la instrucción Set CGRAM (0x40)


[[File:HCGROM01.jpg]]


*En la imagen se ve la AC 0x00 subrayada de azul, ahora estamos en esa AC
*Ahora vamos a poner RS a 1 para poder enviar el caracter ''A'' (que en hexa es 0x41). Lo que hacemos es escribir la letra ''A'' en la primera posición


[[File:HCGROM02.jpg]]


*Como vemos en la imagen de arriba la AC 0x00 se ha dividido en dos y la letra ''A'' se ha escrito en la primera ''subcasilla''. Esta ''subcasilla'' es el espacio que ocupa un caracter de la HCGROM (como hemos visto más arriba)
*Ahora queremos dejar dos espacios en blanco y escribir ''B'', por lo tanto queremos escribirla en la ''subcasilla'' 4. No se puede acceder a esta ''subcasilla'' porque la AC 0x01 empieza con la ''subcasilla'' 3 y no hay manera de acceder la ''subcasilla'' 4 directamente
*Para poder escribir en la ''subcasilla'' 4 tendré que enviar el comando Set CGRAM con la dirección de AC 0x01 y luego enviar el comando Write Ram con el hexadecimal del ''espacio'' y otra vez el comando Write Ram con el hexadecimal de ''B''

== DDRAM ==
Hay 64x2bytes de espacios para la DDRAM. Son 4 lienas para 16 caracteres de 16x16 puntos o 32 caracteres de 8x16 puntos.<br/>
La explicación de que es la DDRAM ya se puede leer en el apartado [[HD44780U#DDRAM|DDRAM del HD44780U]]

== CGRAM ==
Esta es la RAM que nos permite crear caracteres personalizados, pero debido a que este lcd es un GLCD lo encuentro poco útil. En la sección de [[ST7920#Modo_Gr.C3.A1fico_.28GLCD.29|Modo Gráfico (GLCD)]] hay funciones mucho más interesantes.


= Descripción Pines =
*XRESET: Es el pin de reset. Para resetear el lcd desde el hardware se hace con este pin. Tiene que pasar de LOW a HIGH para hacer el reset. Yo no lo utilizo.
*PSB: Es un pin para seleccionar si usamos la comunicación serie o paralela. LOW es serie y HIGH paralela
*Vo: Es para el contraste (creo)
*VSS: GND
*VDD: +5V

== SPI ==
En el modo serie no se puede leer de la pantalla. Solo se pueden hacer operaciones de escritura.
*RS: es el pin SS del protocolo SPI
*RW: es el pin MOSI del protocolo SPI
*E: es el pin clock del protocolo SPI

== Paralelo 8 bits ==
*RS: Es el pin Register Select. LOW es para seleccionar las instrucciones de registro (IR) y HIGH es para seleccionar los registros de datos (DR).
*RW: Es el pin de lectura/escritura. LOW es para indicar escritura y HIGH para indicar lectura.
*E: Es el pin utilizado para indicar el paso de datos del microcontrolador al st7920. Se ve mejor su utilidad en la sección [[ST7920#Como funciona la comunicación paralela 8bits|Como funciona la comunicación paralela 8bits]]
*D0-D7: Son los pines de datos.

= Funciones Básicas =
[[File:Funciones Basicas.jpg|722px]]


*Todas las instrucciones básicas excepto Function Set son muy parecidas o iguales a las de [[HD44780U#Instrucciones referentes a IR|HD44780U]]


== Function Set ==
*El bit DL indica si estamos en comunicación paralela de 8 bits(HIGH) o comunicación paralela de 4 bits (LOW)
*El bit RE es para indicar si estamos en modo extendido(HIGH) o en modo normal(LOW). El modo extendido es en modo GLCD


= Funciones Extendidas =
[[File:Funciones Extendidas.jpg|722px]]


De todas las funciones extendidas, de momento, yo solo he "trasteado" con Extended Function Set y Set Graphic Display Ram Address

== Extended Function Set ==
*DL indica lo mismo que en el apartado anterior, HIGH para comunicacion paralelo 8 bits y LOW para 4 bits.
*RE indica modo extendido (HIGH) o normal (LOW)
*G indica lcd encendido (HIGH) o apagado (LOW). Este es el bit importante, porque cada vez que pasemos de modo normal a modo GLCD tenemos que asegurarnos de enviar esta instrucción con este bit en HIGH, sino no se verá nada. Esto lo explico en el apartado de [[ST7920#Proceso al dibujar uno o varios pixeles|pasos a seguir al dibujar un pixel]]

== Set Graphic Display Ram Address ==
Esta instrucción es la que se usa para pasar una dirección de memoria a la AC (que recordemos que es la dirección que necesitamos para saber donde dibujar un pixel, es decir las cordenadas X e Y).<br/>
En la imagen se ven dos filas porque se tiene que enviar dos veces esta instrucción, una para el eje X y la otra para el eje Y. La primera instrucción se envia para determinar la X y la segunda para determinar la Y.<br/>
En el apartado [[ST7920#Relación AC con GDRAM|Relación AC con GDRAM]] hay una imagen explicativa de la relación entre la AC y la GDRAM


= Como funciona la comunicación Serial (SPI) =


= Como funciona la comunicación paralela 8bits =
[[File:Comunicacion_8_bits.jpg]]

*El bit RS controla si enviamos operaciones DR o IR ([[ST7920#Paralelo 8 bits|Paralelo 8 bits]]). El bit lo tenemos que colocar a 1 o 0 antes de activar Enable
*El bit RW controla si son operaciones de lectura o escritura ([[ST7920#Paralelo 8 bits|Paralelo 8 bits]]). Igual que con RS se tiene que establecer en 0 o 1 antes de acrtivar Enable
*Los bits DB0-DB7 son los que llevan los datos. Se tienen que establecer antes de activar Enable
*El bit E (Enable) es el que utilizamos para transmitir las instrucciones al lcd


Ejemplo:
<pre>
/*RS, RW, DB0-DB7 y E son pines digitales de Arduino*/

  digitalWrite(RS, LOW);
  digitalWrite(RW, LOW);
  digitalWrite(DB7, LOW);
  digitalWrite(DB6, LOW);
  digitalWrite(DB5, LOW);
  digitalWrite(DB4, LOW);
  digitalWrite(DB3, LOW);
  digitalWrite(DB2, LOW);
  digitalWrite(DB1, LOW);
  digitalWrite(DB0, HIGH);

  digitalWrite(E, HIGH);
  delayMicroseconds(1);
  digitalWrite(E, LOW);
</pre>
*En este ejemplo vamos a enviar el comando Display Clear 0x01
*Como se puede comprobar en la tabla de [[ST7920#Funciones Básicas|Funciones Básicas]] estamos transmitiendo la instrucción IR Display Clear
*Esta es una forma muy básica de hacerlo, pero es para que quede claro
*Cuando establecemos todos los pines con su bit correspondiente (0 o 1) pasamos a enviar la instrucción al lcd
**En el flanco de bajada de Enable es cuando se transmite la instrucción al lcd

= Inicialización por software =

== Modo paralelo 8 bits ==
Aqui voy a poner el esquema de la inicialización con interfaz de 8 bits. La de 4 bits no la pondré porque trabajar este LCD con 4 bits da errores que no se de donde vienen exactamente pero que con la interfaz de 8 bits o la de serie no pasa.<br/>
<br/>
Al hacer las pruebas he visto como siguiendo este esquema se hace una buena inicialización y el lcd funciona correctamente, pero también he visto en códigos encontrados por internet que no siguen todo el esquema y también se le inicializa correctamente el lcd.<br/>
<br/>
Supongo que de la segunda manera ahorras tiempo en inicializar, pero no se si hay más ventajas o no, ni puedo decir con certeza cual es mejor utilizar.


[[File:Inicializacion 8 bits.jpg|255px]]

== Modo serie (SPI) ==


= Modo Gráfico (GLCD) =
El modo gráfico es en el que tenemos control total sobre todos los pixeles del lcd. con esto podemos dibujar todo tipos de formas, dibujos o incluso tener fuentes de diferentes tamaños y estilos.
== Relación AC con GDRAM ==
Antes he explicado una peculiaridad de la AC en el apartado [[ST7920#Peculiaridad al escribir un caracter de la HCGROM|Peculiaridad al escribir un caracter de la HCGROM]]. En el modo gráfico también se tiene que tener en cuenta porque cuando se quiere dibujar un pixel se tiene que seleccionar una AC. Esto se verá en más profundidad en el siguiente apartado, [[ST7920#Proceso al dibujar uno o varios pixeles|Proceso al dibujar uno o varios pixeles]]<br/>
<br/>
A parte de esta peculiaridad también nos encontramos con otra. Esta tiene que ver con las filas y columnas.<br/>
<br/>
Para poder explicarla primero se ha de explicar como se dibide en coordenadas la pantalla:<br/>


[[File:Coordenadas.jpg]]




== Proceso al dibujar uno o varios pixeles ==
Aqui voy a poner el proceso a seguir, tanto con código y con dibujos, para dibujar pixeles en este lcd.

= Fuentes personalizadas =


= [[Código D Crocker (DC42)]] =


= Documentación =
[http://www.crystalfontz.com/controllers/ST7920.pdf Datasheet ST7920 Cytronix]
= Notas =
*Hacer una representación gráfica de la disposicion de las filas y columnas, lo del 0x80 y 0x88
**Explicar como lo soluciona dc42
*Explicar como soluciona dc42 el problema de que cada AC son 2 bytes y que cada byte representa 8 pixeles (cada pixel corresponde a un bit)
*Explicar uint8_t *ptr = image + ((16 * r) + (2 * startColNum)); y también la parte (2*startColNum)
*Explicar sendLcdData(*ptr++);
*Creo que cada vez que si se hace esto:
 setPixel(1,1);
 flush();
 setPixel(2,1);
 flush();

Esta dibujando la pantalla entera para cada flush(), pero no lo entiendo porque la función flush() esta preparada para renderizar un AC de una fila concreto