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, desactiva "Guardar el diagnóstico en cada
arranque" en los ajustes de LibreELEC Hades (Sistema), 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.) "Crear un informe
de diagnóstico", en el mismo sitio, hace un archivo con lo que hay en esta carpeta y lo que está haciendo el
sistema en ese momento.

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.

  previous-boot
      Se escribe nada más arrancar: el registro del sistema (journal) del arranque anterior a este
      (journal.txt.gz, y sus líneas del kernel en journal-kernel.txt.gz), hasta su última línea. Cuenta
      cómo terminó un arranque que se colgó o se quedó sin corriente antes de poder guardar nada. Mientras
      el interruptor está encendido, el registro de cada arranque se guarda para esto en el almacenamiento
      del PC (16 MiB como mucho); al apagarlo, ese registro se borra.

  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 y
      las controladoras USB (también USB4 y Thunderbolt), 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;
        - boot-time.txt: cuánto tardó el arranque y qué esperó (systemd-analyze). Si el arranque no había
          terminado todavía, la segunda lo tiene también.
      Con una gráfica AMD, las dos dicen también cuánta memoria usa: su memoria de vídeo (en una gráfica
      integrada, la parte de la memoria del PC que el firmware le reserva) y la memoria del PC que ha
      tomado para sí (GTT).
      En algunos PC hay también gpio.txt: el estado de las líneas que el firmware usa para sus tomas y
      botones. Lo que contestan las gráficas (drm-state.txt, nvidia-smi.txt, vainfo.txt,
      modetest-connectors.txt, redetect.txt) se copia en cuanto llega cada respuesta, así que está ahí
      aunque el PC se apague en el medio minuto siguiente.

  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, su
      temperatura y su memoria de vídeo (y la que ocupa cada programa) en ese momento (state.txt dice
      cuándo; lo demás se toma 12 segundos después). Con una gráfica AMD, también gpu-amd.txt: cinco
      lecturas, una por segundo, de su carga, sus relojes, su temperatura, su consumo y su memoria.

      Con amdgpu.dvbridge_dce=1 en la línea del kernel (tarjetas Radeon RX 400, RX 500 y Vega), también
      crc.txt: la comprobación (CRC) que hace la propia tarjeta gráfica de lo que sale de ella, durante 12
      fotogramas. Encender esa comprobación medio segundo no cambia la imagen.

  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.

  output-check
      El informe de cada comprobación de la salida que se pidió en los ajustes (Sistema > Enviar registro,
      "Comprobar la salida Dolby Vision"): si la tarjeta gráfica envía los bytes de Dolby Vision sin
      cambiarlos, según los midió su propio CRC de lo que sale de ella, y los detalles de la medida. El último
      informe está también en el archivo results.txt de 1-minute y 4-minutes.

  installer
      En un arranque de la entrada "Installer" de esta unidad: lo que dijo el sistema, desde su primera
      línea (journal.txt), y el registro del instalador (install.txt). Se escribe cada dos segundos, sobre
      la marcha, así que está ahí también si el PC se cuelga o hay que apagarlo a la fuerza: lo que tenía
      que contar un arranque del instalador que no muestra nada o que se para. Como mucho 8 MB del registro
      del sistema y el último 1 MB del registro del instalador. Su start.txt dice que fue un arranque del
      instalador. El sistema que el instalador pone en otro disco arranca con el diagnóstico apagado.

  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 una versión
  anterior de él, 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 4. Cada carpeta que escribe, salvo shutdown,
  tiene además filter.txt, que dice cuántas veces queda en sus archivos el nombre de este PC (más abajo).

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.
    - El nombre de este PC se quita donde una línea lo nombra como tal y, salvo que sea una palabra que
      usan los propios registros (como "media" o "kodi") o uno muy corto, dondequiera que aparezca como
      palabra suelta, en mayúsculas o no. filter.txt dice cuántas veces queda como palabra suelta (lo
      esperado es ninguna) y dentro de otras palabras.
    - 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 el nombre de una unidad o de una película donde una línea lo escribe
      fuera de una ruta (en una ruta, y como etiqueta de una unidad, es una marca);
    - 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.
