1 puntos por GN⁺ 2023-11-01 | 1 comentarios | Compartir por WhatsApp
  • El repositorio de documentación de Asahi Linux funciona como fuente del sitio de documentación, incluida la página sobre fallas de arranque de macOS Sonoma, y el material relacionado se gestiona en GitHub
  • La documentación está dividida en categorías como alt, fw, hw, platform, project y sw, lo que permite navegar por temas
  • La sección hw trata el hardware de las Mac con Apple Silicon y se divide en cpu, devices, peripherals y soc para diferenciar el hardware en detalle
  • El sitio de documentación se genera con Zensical y las pruebas locales pueden ejecutarse con zensical serve después de instalar el paquete de Python
  • El sitio se vuelve a compilar mediante CI en cada commit y se publica a través de GitHub Pages

Función del repositorio de documentación de Asahi Linux

  • Este repositorio administra la documentación del sitio Asahi Linux documentation
  • La documentación está organizada por categorías según el tema

Estructura de categorías de la documentación

  • alt: documentación sobre sistemas operativos alternativos y compatibilidad con distribuciones Linux
  • fw: documentación sobre firmware controlado por el proveedor y las interfaces de firmware
  • hw: documentación de hardware relacionada con Apple Silicon Mac
    • cpu: documentación del procesador de aplicaciones
    • devices: documentación relacionada con modelos específicos de Mac
    • peripherals: documentación de hardware interno de Apple Silicon Mac que no forma parte del SoC en sí
    • soc: documentación de bloques de hardware integrados en el SoC de Apple Silicon
  • platform: documentación aplicable a toda la plataforma Apple Silicon
  • project: documentación de gestión del proyecto y elementos no relacionados con hardware o software
  • sw: documentación de software que no es firmware

Compilación local y método de despliegue

  • El sitio se genera con Zensical
  • Zensical se instala como paquete de Python
    • Si la distribución no ofrece el paquete, se puede instalar con pip
  • La compilación local de la documentación para pruebas se ejecuta con el siguiente comando después de instalar Zensical
$ zensical serve
  • El sitio web se recompila mediante CI en cada commit
  • El sitio compilado se sirve a través de GitHub Pages

1 comentarios

 
GN⁺ 2023-11-01
Comentarios en Hacker News
  • Vale la pena revisar también su Twitter para ver una especulación sobre cómo un simple cambio de tasa de refresco puede causar corrupción en el arranque: https://social.treehouse.systems/@marcan/111329614147717090
    Porque Apple parece odiar el parpadeo al cambiar de modo de pantalla, y activar/desactivar ProMotion provoca justamente ese parpadeo de cambio de modo
    Así que la especulación es que guardaron esa configuración en algún lugar del NVRAM y la hacen aplicar cuando la pantalla se enciende durante el arranque inicial, para evitar que vuelva a parpadear al iniciar macOS
    El problema es que no lo probaron con cargadores de arranque de OS antiguos, así que la transferencia/inicialización de pantalla falla catastróficamente cuando ese modo está activado

    • Siempre me molestó que en PC la resolución cambiara de forma horrible durante el arranque
      En la época del BIOS se entendía, pero después de la llegada de UEFI, parecería que incluso pantallas de configuración EFI deberían poder mostrarse en la resolución nativa del monitor, o al menos en su relación de aspecto por defecto; en la práctica, solo he visto cosas como 1024x768 estirado en un monitor 16:9 y se ve espantoso
    • Qué bueno que al menos a alguien más le molesta el parpadeo al cambiar modos de pantalla
      Con la potencia de cómputo actual, no deberíamos tener que ver parpadeos en ningún momento de la vida, y me molesta que tanta gente acepte el ruido visual que aparece al conectar un monitor como si “ya con eso bastara”
    • Me resulta curiosamente entrañable que una empresa de billones haga algo parecido a cuando yo trasteaba con rEFInd, imágenes de splash del BIOS, plymouth-git, plymouth-sddm y quiet splash para crear una experiencia de arranque fluida, alargando unos segundos el arranque y recuperando el sistema varias veces con un USB booteable
      Ahora ya acepté los parpadeos y los mensajes de systemd
      Hoy en día el arranque solo tarda unos segundos, y ya ni me resulta fácil explicar por qué estaba tan obsesionado con eso
    • Es interesante, pero me pregunto quién desactiva ProMotion si 120Hz mejora mucho la capacidad de respuesta
      Solo he visto una app que no funciona bien con tasa de refresco variable, Genshin en Windows, y aun así, en un monitor moderno probablemente no sea problema porque maneja VRR hasta 60Hz, así que no hay ese parpadeo de duplicación de cuadros al ir entre 60Hz y 120Hz
  • Me pasó exactamente lo mismo al actualizar una MacBook Pro M1 del trabajo a Ventura 13.6, y pensé que era un caso totalmente aislado
    Ni siquiera era dual boot; solo tenía instalado macOS
    Estaba conectada a un Thunderbolt Display durante la actualización y, como dice el artículo enlazado, parece que eso produjo un efecto parecido a cambiar a una tasa de refresco que no era ProMotion
    Tuve que hacer una restauración DFU desde otra Mac y luego ejecutar el instalador de macOS Sonoma por USB; por suerte detectó la instalación existente y hizo una actualización en el lugar, así que se conservaron los datos
    También perdí mucho tiempo porque la restauración DFU no funcionaba, hasta que me di cuenta de que el cable Thunderbolt no sirve y hay que usar un cable USB-C normal para que Apple Configurator detecte la otra Mac

    • Yo habría supuesto justo lo contrario, que si hacía falta uno de los dos, tendría que ser un cable Thunderbolt
      Normalmente esos cables de mayor ancho de banda y más capacidades suelen funcionar también del lado menos exigente, así que me parece bastante inesperado
      Quiero acordarme de esto si alguna vez tengo que revivir una Mac brickeada
    • Tampoco entiendo por qué entrar en modo DFU es un procedimiento casi mágico de presionar ciertos botones en momentos exactos durante cierta cantidad de segundos
      Se sentía como si hubiera que cantarle al dios virtual de Mac OS y esperar que se alinearan las estrellas para que la laptop apareciera en la segunda Mac
      Además, también importa en qué puerto conectas el cable USB-C, y tiene que ser el primero de la izquierda; no tengo idea de por qué
      Aun así, al final logré revivirla siguiendo un video de Mr. Macintosh
    • Mi MacBook Air M1 necesita entrar en modo DFU y usar Configurator para hacer un “revive” en cada actualización
      Si no, solo aparece “Failed to personalize the software update”
      La llevé al Apple Store, restauraron el equipo de inmediato y borraron todos los datos, y cuando salió la siguiente actualización volvió a pasar exactamente lo mismo
      Así también se vuelve difícil demostrar que su arreglo no lo corrigió de forma permanente
    • En una MacBook con M1 Pro también se echó a perder un monitor LG USB-C durante una actualización
      Solo mostraba pantalla negra, y pasaba lo mismo incluso al conectarlo a otra laptop por USB-C
      Cambiar el cable, desconectarlo de la corriente o hacer un reset de fábrica no sirvió de nada, aunque otras entradas como HDMI y DisplayPort seguían funcionando
      No creo que haya sido coincidencia que se dañara durante la actualización, y recomiendo mucho no tener conectado nada a la MacBook durante una actualización salvo el cargador
    • En una M2 Pro me pasó exactamente lo mismo y lo arreglé con el mismo procedimiento
      Por suerte, después del DFU revive los datos siguieron intactos, pero al principio pensé que era un caso aislado de corrupción porque la batería se había agotado antes de que terminara la actualización
      Pero es muy probable que la causa haya sido el monitor secundario
  • Intenté reinstalar mi MacBook, pero la recuperación web integrada no funcionó y hoy tuve que hacer una restauración DFU
    El sistema base era 13.2, y después de descargar por completo los archivos de 13.6, la barra de progreso llegó al 100% y luego arrojó un error
    Parece ser una incompatibilidad entre el sistema base 13.2 y la instalación de 13.6; la calidad de Apple últimamente es terrible
    Pensé que al menos habrían probado el escenario más básico antes de lanzar software x.6, pero no fue así
    Lo peor es que, sin otra Mac, es difícil encontrar una forma oficial o incluso no oficial de crear un instalador USB de arranque, o de hacer una restauración DFU
    No sé si creen que vivo comprando en la Apple Store
    No tenía otra Mac y al final pude hacer la restauración DFU con libimobiledevice, así que gracias a quien lo hizo posible
    Pero esto no debería pasar, y Windows o Linux son mucho más transparentes que macOS

    • El bootloader y el proceso de recuperación de Apple dan mucho miedo
      Cosas como exigir acceso a la red, el firmware en el SSD y los bloqueos de hardware se sienten como trampas ocultas listas para causarte problemas justo en el peor momento
      En cambio, en Windows basta con arrancar desde una memoria USB que tengas en un cajón
    • A mí me pasa algo parecido
      Hace como un año instalé Avahi Linux y luego lo quité, pero ahora ya no actualiza más allá de 12.6
      Creo que voy a tener que conseguir una unidad externa, respaldar todo y luego hacer una restauración DFU a mi M1 Max MBP para poder subir a Sonoma
  • Con eso de “No me hagan pagar. Este es un problema que Apple creó y es un problema puramente de software. Si un técnico afirma que es daño de hardware, está equivocado”, supongo que solo queda esperar que así sea

    • La Apple Store normalmente maneja bien este tipo de cosas
      Si es un problema documentado que afecta a un modelo de hardware y una versión de software específicos, es muy poco probable que te cobren
    • No fue tan difícil
      Cuando hubo una falla de hardware del SSD en un MacBook Air de 2011, les mostré a algunos compañeros la página de defectos de hardware, y en vez de gastar 800 dólares lo repararon gratis
  • No sé qué le está pasando a Apple estos días
    Apple casi murió una vez, y luego construyó una de las mejores marcas del mundo al enfocarse con brutalidad y una dedicación obsesiva en ofrecer una experiencia premium integral que justificara sus precios premium y sus grandes márgenes
    Si te gustaba su manera de hacer las cosas, desde el momento de la compra “simplemente funcionaba”, o al menos así fue hasta hace poco
    Hoy tuve una experiencia kafkiana que se sintió casi como una mala broma, y como Apple casi nunca la arruinaba así de feo, ni siquiera tenía un plan de respaldo para un momento realmente importante
    Si alguien sabe cómo hablar por teléfono con personas que realmente hagan lo necesario para arreglarle los problemas a un cliente fiel, agradecería el consejo, pero no tengo muchas esperanzas porque la atención telefónica de primer nivel hoy se siente como un carrusel infinito de espera

    • El Apple de hoy es muy distinto al Apple de hace 20 años
      La marca es la misma, pero la mayoría de las personas ya cambiaron
      Es algo que también se ve siempre en la industria de los videojuegos, en lugares como Blizzard, Bungie o 343 Industries
      Tal vez los nuevos programadores e ingenieros estén lidiando con una base de código muy compleja, y quizá no haya nadie que la entienda por completo hasta que algo se rompa
  • Solo afecta a dispositivos con chip Apple Silicon y pantalla ProMotion; no afecta a Intel
    Es una cláusula de escape rápida para quienes usan dispositivos más viejos

    • De los dos errores listados, solo uno requiere una pantalla ProMotion
      El otro puede ocurrir en cualquier dispositivo Apple Silicon
  • Como una semana después de actualizar a Sonoma, mi MacBook Air M1 de 2020 quedó brickeada, aunque no estoy seguro de si está relacionado
    Sospeché que tenía que ver con la actualización
    Por suerte, gracias a las leyes de garantía de aquí, me reemplazaron la placa lógica gratis, pero al día siguiente ya se me quitaron las ganas de cambiarme a iPhone

    • Que una actualización brickee el hardware parece ser un patrón de falla común en macOS
      Por ejemplo, Big Sur brickeó varias MBP de 2013 y 2014: https://www.macrumors.com/2020/11/15/macos-big-sur-update-br...
      A mí también me afectó y, como a muchos usuarios, el problema se arregló después de reemplazar la tarjeta I/O
      En mi caso la garantía ya había vencido hace mucho, así que compré la pieza por 10 dólares en Ebay y la cambié yo mismo
    • Como referencia, llevo más de 10 años usando iPhone y nunca he tenido una actualización fallida ni problemas
      En cambio, mi Google Pixel se brickeó solo como dos veces durante los 2 años que lo tuve
    • A mi Air M1 de 2020 también se le dañó la placa lógica
      Un día abrí la tapa y ya no encendía, y sin AppleCare habría sido una reparación de 500 dólares
      Hace unas dos semanas lo dejé sobre la cama en una habitación de hotel con la tapa abierta y acerqué la pantalla sujetándola; la pantalla se rompió solo con la ligera presión de mis dedos
      En internet hay montones de casos de estos dos problemas en el Air
      Al principio me gustaba muchísimo el M1 Air, pero ahora resultó ser un equipo demasiado poco confiable para mí
    • Suena como un criterio bastante raro
      Cualquier fabricante va a tener cierto nivel de problemas de software y hardware
  • Leyendo los comentarios aquí, me hace preguntarme si mucha gente de Hacker News realmente ha conocido a usuarios comunes en su día a día
    No otros nerds o usuarios avanzados, sino la gente normal del cubículo de al lado que solo sabe de computadoras lo necesario para hacer su trabajo
    Me cuesta creer que de verdad piensen que los usuarios quieren elegir el modo gráfico al arrancar
    ¿Qué porcentaje de usuarios de Mac usará un bootloader alternativo o siquiera sabrá qué es?
    Si pasas algo de tiempo dando soporte a flotas de dispositivos en una gran empresa, te das cuenta de si a los usuarios realmente les importan las cosas que nosotros creemos importantes

    • Según la publicación, después de que el firmware del sistema se actualiza a una versión de macOS Sonoma, si la pantalla está configurada con una frecuencia de actualización distinta de ProMotion, ese sistema ya no puede arrancar correctamente instalaciones antiguas de macOS ni Asahi Linux
      Esto también incluye el modo de recuperación cuando esos sistemas están configurados como el SO de arranque predeterminado, y hasta la siguiente actualización del SO también afecta a System Recovery
      Aunque el usuario no “se preocupe” por eso o no “sepa qué significa”, esto perfectamente puede afectar también a usuarios comunes
    • Si conoces a usuarios tecnológicos cotidianos, te das cuenta de que están totalmente acostumbrados a recordar solo qué hacer clic en una pantalla críptica que nadie entiende y para la que nadie tiene tiempo de investigar
      Basta con pensar en cuántas alertas y advertencias de seguridad aparecen mientras uno intenta trabajar
      Al final es memoria muscular
      Ignorar una advertencia de seguridad puede comprometer el sistema, pero en este caso incluso podría salvar el sistema y el trabajo de alguien algún día, así que no diría que carece de valor
      Este problema puede afectarle a cualquiera que por la razón que sea quiera usar dos versiones de macOS, y entre profesionales creativos eso tampoco es algo tan raro
  • En resumen, las versiones recientes de macOS Sonoma y 13.6 Ventura tienen un bug de actualización que puede dejar algunos Mac inservibles y provocar una pantalla negra que inutiliza recoveryOS y requiere un DFU revive
    El problema en Sonoma parece presentarse con más frecuencia en Mac con arranque dual: https://support.apple.com/en-us/HT208891
    La actualización de Ventura también puede causar problemas por razones poco claras si la frecuencia de actualización de la pantalla está configurada en un valor distinto de ProMotion
    La documentación está en la wiki de Asahi Linux porque fueron los desarrolladores de Asahi Linux quienes descubrieron este problema, pero no es un problema limitado a Asahi
    De hecho, si ejecutas el instalador de Asahi Linux, puede detectar si ese Mac se verá afectado por este problema aunque al final no instales Asahi Linux
    Para más detalles, basta con leer la publicación

    • Me pasó este problema dos veces en mi Mac al actualizar
      Tenía dos particiones OSX arrancables y me ocurrió en ambas actualizaciones
      No estoy tan familiarizado con Mac, así que me costó muchísimo resolverlo y hasta tuve que aprender que DFU existe y para qué sirve
      Tuve suerte de que mi hija tenía una Mac, así que pude usar DFU sin tener que llevarla a una Apple Store
  • Hasta cierto punto, da tranquilidad que haya terceros buscando activamente este tipo de problemas en macOS