.. Librería Pantalla — Heltec Vision Master E213 documentation master file.
   Este archivo sirve como raíz del árbol de documentación y como
   página de inicio.

Librería Pantalla — Heltec Vision Master E213
==============================================

Driver en **MicroPython** para el panel e-paper **LCMEN2R13EFC1** de
2.13" montado en la placa **Heltec Vision Master E213** (ESP32-S3).

El proyecto incluye:

* Un driver de bajo nivel para el panel (:mod:`pantalla`).
* Dos fuentes de mapa de bits: 8×8 (:mod:`fuente_8x8`) y 12×16
  (:mod:`fuente_12x16`).
* Scripts de arranque (:mod:`boot`) y de ejemplo (:mod:`main`).

.. note::
   Esta documentación está pensada para consultarse junto al
   `datasheet HT-VME213 <https://resource.heltec.cn/download/VM_E213>`_
   del panel, que describe el protocolo SPI y las LUTs utilizadas.

Características
---------------

* **Orientación configurable** (``0`` = 128×250 retrato, ``90`` = 250×128
  apaisado).
* **Framebuffer en RAM** de 1 bit por píxel (4000 bytes).
* **API de dibujo simple**: píxeles, líneas horizontales/verticales,
  texto con dos tamaños de fuente.
* **Refresco bloqueante** basado en el pin ``BUSY`` del panel.
* **Modo *deep sleep*** para minimizar el consumo entre refrescos.

Ejemplo rápido
--------------

.. code-block:: python

   from pantalla import Pantalla, NEGRO, BLANCO

   pan = Pantalla(orientacion=90)
   pan.limpiar(BLANCO)
   pan.texto("Hola Mundo!", x=10, y=20, color=NEGRO, tamaño=16)
   pan.actualizar()

Para más detalles, ver :doc:`ejemplos/hola_mundo`.

.. toctree::
   :maxdepth: 2
   :caption: Guía de uso

   guia/instalacion
   guia/primeros_pasos
   ejemplos/hola_mundo

.. toctree::
   :maxdepth: 2
   :caption: Referencia de la API

   api/pantalla
   api/fuente_8x8
   api/fuente_12x16
   api/boot
   api/main

.. toctree::
   :maxdepth: 1
   :caption: Apéndices

   apendices/glosario
   apendices/hardware

Índices y búsqueda
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`