LIBREELEC HADES  -  DIAGNÓSTICO
===============================
(English version: README.txt)

Mientras el archivo DIAG-ON.TXT esté en la raíz de esta unidad (la partición de arranque de LibreELEC
Hades), LibreELEC Hades deja en esta carpeta lo necesario para averiguar por qué algo no funciona en un PC.
No cambia ningún ajuste ni apaga nada. Para que deje de hacerlo, vuelve a poner OFF en el nombre de ese
archivo (DIAG-OFF.TXT), o bórralo. (Cualquier nombre que empiece por DIAG-ON cuenta como encendido.)

Solo lee lo que está haciendo el sistema, con tres excepciones, las tres un minuto después de cada arranque
y las tres para una tele que está enchufada y no se ve:
  - vuelve a preguntar a las tomas HDMI y DisplayPort que no tienen nada conectado, como hace el centro
    multimedia al arrancar. No lo hace si ya se abrió un vídeo;
  - lista los dispositivos del PC, lo que despierta a una gráfica que estuviera dormida;
  - donde no se ve ninguna tele ni monitor en ninguna toma, el kernel anota más sobre las pantallas durante
    unos tres minutos, o hasta que se abre un vídeo. Donde sí se ve una tele o un monitor, no se hace.

QUÉ SE ESCRIBE AQUÍ

  Cada arranque del PC tiene su propia carpeta: start-1, start-2, y así. El número sigue desde el arranque
  anterior, también después de actualizar el sistema o de borrar las carpetas, así que un nombre nunca se da
  a dos arranques. Se conservan las ocho últimas, de modo que una unidad que se lleva de un PC a otro guarda
  lo que cada uno tenía que contar. En cada una:

  start.txt
      De qué arranque es la carpeta: su número, la build de LibreELEC Hades y cuándo arrancó el PC. Lo que
      hay en una carpeta es siempre de ese único arranque: una carpeta del mismo nombre que sea de otro
      arranque (por ejemplo, de una versión anterior) se vacía antes de que este escriba en ella, y
      start.txt dice entonces qué era.

  1-minute, 4-minutes
      Hacia 1 y 4 minutos después de iniciarse el centro multimedia: las gráficas y lo que tiene conectado
      cada una (con el EDID de cada pantalla, sin su número de serie), el registro del kernel, lo último
      del registro del centro multimedia (kodi.log), los avisos del sistema, el sonido, los dispositivos
      USB, la red, los servicios, el reloj y el Bluetooth (bluetooth.txt: las controladoras y su firmware,
      los ajustes y, de cada dispositivo emparejado, qué es, su estado y la conexión que pidió; nunca una
      clave, y su nombre solo como marca, más abajo). La primera tiene además:
        - redetect.txt: lo que dijo el kernel al volver a preguntar a las tomas HDMI y DisplayPort sin
          nada conectado, y si alguna gráfica estaba dormida. Una gráfica AMD contesta con lo último que
          vio: mira una toma al arrancar, al despertar y cuando se enchufa o se desenchufa algo;
        - lspci.txt: los dispositivos del PC;
        - acpi-tables.tar.gz: la descripción del PC que da su firmware (cómo están cableadas y cómo se
          conmutan sus tomas). Es casi igual en todos los PC de ese modelo.
      En algunos PC hay también gpio.txt: el estado de las líneas que el firmware usa para sus tomas y
      botones.

  during-dv-1 a during-dv-6
      Unos 15 segundos después de empezar cada reproducción en Dolby Vision: lo que se envía de verdad a la
      tele. Con una gráfica NVIDIA, también nvidia-smi.txt: sus relojes, lo que los frena, su consumo y su
      temperatura en ese momento (state.txt dice cuándo; lo demás se toma 12 segundos después).

  after-dv-1 a after-dv-6
      5 y 30 segundos después de terminar cada reproducción en Dolby Vision. Se escribe al momento, así que
      está ahí aunque haya que apagar el PC a la fuerza (por ejemplo, si la tele se queda sin imagen).

  shutdown
      Al apagar o reiniciar desde el menú de la pantalla: los registros de esa sesión, lo que había
      conectado a cada toma en ese momento, y cómo iban la unidad y la gráfica segundo a segundo. Apaga
      siempre desde ese menú, no con el botón del PC.

  Cada una de esas carpetas tiene además build.txt: la build de LibreELEC Hades que la escribió.
  De las dos clases de Dolby Vision se guardan las seis primeras reproducciones de cada arranque.
  No se escribe nada si a esta unidad le quedan menos de 128 MB libres: lo dice entonces una nota en esta
  carpeta, NO-ROOM.txt.
  Las carpetas 1-minute, shutdown-1 y parecidas que haya junto a estas son de una versión anterior.
  Las carpetas que una versión anterior a esta escribió sin el filtro de abajo, o pasó por él antes de
  que quitara los nombres de los dispositivos Bluetooth, pasan por él una vez, al arrancar esta versión;
  cada carpeta que ya pasó por él tiene un archivo llamado .filtered, en el que esta versión escribe 2.

PRIVACIDAD

  Todo lo que se escribe aquí pasa antes por un filtro. Sin ese filtro no se copia nada.
    - Las direcciones de tu red y de internet (IPv4 e IPv6), las direcciones MAC y Bluetooth, los nombres
      de las redes wifi, el nombre de este PC en la red y el de los equipos de tu red en las direcciones,
      los números de serie de pantallas, gráficas y dispositivos USB (también dentro del EDID de una
      pantalla), los UUID de discos y particiones, las claves SSH y sus huellas, y los nombres de los
      dispositivos Bluetooth que conoce este PC (los emparejados y los que vio al buscar dispositivos: un
      teclado o un teléfono suele llevar el nombre de su dueño, como en "Magic Keyboard de Juan") se
      cambian por marcas como [lan-ip-1a2b.3c4d], [mac-5e6f70] o [bt-name-7a8b9c]. Una marca es la misma
      para el mismo valor en este PC, así que los archivos siguen diciendo qué líneas hablan del mismo
      dispositivo o de la misma red, pero no se puede volver de ella al valor: se hace con un secreto que
      no sale de este PC.
    - De los registros del centro multimedia y del sistema se quitan la ruta de cada dirección (queda
      solo el nombre del servidor), los nombres de películas, canciones y búsquedas (queda solo la
      extensión, como en [redacted].mkv), los correos y lo que parezca un token, una clave o una
      contraseña.
  Ningún filtro es perfecto: mira los archivos antes de dárselos a nadie.

  Lo que sí queda, porque es lo que distingue un PC de otro:
    - los nombres de tus addons, y los de tus unidades tal como las nombraste;
    - la marca y el modelo de tus pantallas, dispositivos de sonido, discos, dispositivos USB, gráfica y
      PC;
    - los nombres de los servidores públicos (por ejemplo, de los servicios que usan tus addons), y qué
      servicios de este PC estaban a la escucha;
    - tu zona horaria.
  Y un nombre de dispositivo Bluetooth corto o de una sola palabra corriente, como "TV", "K" o
  "Keyboard", se queda donde aparece como una palabra más: se cambia por su marca solo donde una línea
  nombra con él un dispositivo de entrada.

  Nada se envía a ningún sitio: los archivos se quedan en esta unidad.

CONVIENE SABER

  Con algunos controladores gráficos los archivos drm-state salen casi vacíos. Es lo esperado.

  Si una tele o un monitor enchufado no muestra nada:
    1. Enciende el PC con él enchufado y encendido, y espera dos minutos.
    2. Saca su cable del PC, espera diez segundos y vuelve a enchufarlo.
    3. Espera tres minutos más y apaga el PC desde el menú (en la pantalla que sí funcione).
  La carpeta de ese arranque cuenta entonces qué vio cada toma: al arrancar (1-minute), al volver a
  enchufar el cable (4-minutes) y al final (shutdown). Volver a preguntar a una toma puede hacer que
  aparezca una pantalla que se había pasado por alto: redetect.txt la muestra entonces como conectada.
