1 Punkte von GN⁺ 2023-11-01 | 1 Kommentare | Auf WhatsApp teilen
  • Das Asahi-Linux-Dokumentations-Repository dient als Quelle der Dokumentationswebsite, einschließlich der Seite zu Startfehlern von macOS Sonoma; die zugehörigen Materialien werden auf GitHub verwaltet
  • Die Dokumentation ist in Kategorien wie alt, fw, hw, platform, project und sw unterteilt, sodass eine thematische Navigation möglich ist
  • Der Bereich hw behandelt die Hardware von Apple-Silicon-Macs und ist in cpu, devices, peripherals und soc unterteilt, um die Hardware weiter zu differenzieren
  • Die Dokumentationswebsite wird mit Zensical erzeugt; lokale Tests können nach Installation des Python-Pakets mit zensical serve ausgeführt werden
  • Die Website wird bei jedem Commit per CI neu gebaut und über GitHub Pages bereitgestellt

Rolle des Asahi-Linux-Dokumentations-Repositorys

  • Dieses Repository verwaltet die Dokumentation der Website Asahi Linux documentation
  • Die Dokumentation ist nach Themen in Kategorien gegliedert

Aufbau der Dokumentationskategorien

  • alt: Dokumentation zur Unterstützung alternativer Betriebssysteme und Linux-Distributionen
  • fw: Dokumentation zu vom Anbieter kontrollierter Firmware und Firmware-Schnittstellen
  • hw: Hardware-Dokumentation zu Apple-Silicon-Macs
    • cpu: Dokumentation zu Applikationsprozessoren
    • devices: Dokumentation zu bestimmten Mac-Modellen
    • peripherals: Dokumentation zu interner Hardware von Apple-Silicon-Macs, die nicht Teil des SoC selbst ist
    • soc: Dokumentation zu Hardwareblöcken, die in Apple-Silicon-SoCs integriert sind
  • platform: Dokumentation, die für die Apple-Silicon-Plattform insgesamt gilt
  • project: Dokumentation zum Projektmanagement sowie Punkte ohne Bezug zu Hardware oder Software
  • sw: Dokumentation zu Software, die keine Firmware ist

Lokaler Build und Bereitstellung

  • Die Website wird mit Zensical erzeugt
  • Zensical wird als Python-Paket installiert
    • Wenn die Distribution kein Paket bereitstellt, kann es mit pip installiert werden
  • Der Dokumentations-Build für lokale Tests wird nach der Installation von Zensical mit folgendem Befehl gestartet
$ zensical serve
  • Die Website wird bei jedem Commit durch CI neu gebaut
  • Die gebaute Website wird über GitHub Pages bereitgestellt

1 Kommentare

 
GN⁺ 2023-11-01
Hacker-News-Kommentare
  • Spekulationen darüber, wie allein eine Änderung der Bildwiederholrate den Bootvorgang beschädigen kann, finden sich auch auf seinem Twitter: https://social.treehouse.systems/@marcan/111329614147717090
    Vermutet wird: Apple mag das Flackern beim Wechsel des Display-Modus nicht, und das Umschalten von ProMotion an/aus erzeugt genau so ein Flackern.
    Daher speichere man diese Einstellung irgendwo im NVRAM und wende sie beim Einschalten des Bildschirms früh im Bootvorgang an, damit es beim Booten von macOS nicht erneut flackert.
    Das Problem ist, dass offenbar nicht mit älteren OS-Bootloadern getestet wurde, sodass bei aktiviertem Modus die Display-Übergabe/-Initialisierung katastrophal fehlschlägt.

    • Mich hat es auf PCs immer gestört, dass sich beim Booten die Auflösung völlig chaotisch ändert.
      Zu BIOS-Zeiten war das verständlich, aber seit UEFI sollte doch selbst ein EFI-Einstellungsbildschirm in der nativen Monitorauflösung, mindestens aber im nativen Seitenverhältnis, angezeigt werden können. In der Praxis habe ich jedoch nur hässliche Fälle gesehen, in denen etwa 1024x768 auf einen 16:9-Monitor gestreckt wurde.
    • Schön zu hören, dass zumindest jemand das Flackern beim Wechsel des Display-Modus nicht mag.
      Bei der heutigen Rechenleistung sollte man im Alltag nirgends mehr Flackern sehen müssen; ich mag es nicht, dass viele Leute das visuelle Rauschen beim Anschließen eines Monitors als „gut genug“ hinnehmen.
    • Es wirkt irgendwie sympathisch, dass auch ein Unternehmen mit Billionenbewertung Ähnliches tut wie ich, als ich an rEFInd, BIOS-Splash-Images, plymouth-git, plymouth-sddm und quiet splash herumgebastelt habe, um ein weiches Boot-Erlebnis zu schaffen, dabei den Bootvorgang um ein paar Sekunden verlängerte und mehrfach per Boot-USB reparieren musste.
      Inzwischen habe ich mich mit Flackern und systemd-Meldungen abgefunden.
      Heutige Bootvorgänge dauern nur noch ein paar Sekunden, und ich kann mittlerweile kaum noch erklären, warum ich davon überhaupt so besessen war.
    • Interessant, aber ich frage mich, wer ProMotion abschaltet, wo 120 Hz die Reaktionsfähigkeit doch deutlich verbessern.
      Die einzige App, die ich gesehen habe, die mit variabler Bildwiederholrate nicht richtig funktioniert, ist Genshin unter Windows. Und selbst das ist mit aktuellen Monitoren wahrscheinlich kein Problem, weil sie VRR bis 60 Hz beherrschen und es dadurch kein Flackern durch Frame-Verdopplung beim Wechsel zwischen 60 Hz und 120 Hz gibt.
  • Ich hatte exakt dasselbe Problem, als ich mein berufliches MacBook Pro M1 auf Ventura 13.6 aktualisierte, und hielt es für einen völlig isolierten Vorfall.
    Es war kein Dual-Boot-System, sondern nur macOS installiert.
    Während des Updates war es an ein Thunderbolt Display angeschlossen, was offenbar denselben Effekt hatte wie der im verlinkten Beitrag beschriebene Wechsel auf eine Nicht-ProMotion-Bildwiederholrate.
    Nach einer DFU-Wiederherstellung von einem anderen Mac aus musste ich den macOS-Sonoma-Installer per USB ausführen; glücklicherweise erkannte er die bestehende Installation und führte ein In-Place-Upgrade durch, sodass die Daten erhalten blieben.
    Außerdem habe ich viel Zeit verloren, weil die DFU-Wiederherstellung nicht funktionierte; erst spät fand ich heraus, dass kein Thunderbolt-Kabel, sondern ein normales USB-C-Kabel nötig ist, damit Apple Configurator den anderen Mac erkennt.

    • Ich hätte eher erwartet, dass man, wenn überhaupt, ein Thunderbolt-Kabel braucht.
      Normalerweise funktionieren Kabel mit mehr Funktionen und höherer Bandbreite oft auch auf der weniger unterstützten Seite, daher ist das ziemlich überraschend.
      Falls ich später einmal einen gebrickten Mac wiederbeleben muss, möchte ich mir das merken.
    • Ich verstehe auch nicht, warum der Einstieg in den DFU-Modus so ein magischer Ablauf ist, bei dem man bestimmte Tasten zu einem bestimmten Zeitpunkt exakt einige Sekunden lang drücken muss.
      Es fühlte sich an, als müsse man einem imaginären Mac-OS-Gott ein Lied vorsingen und hoffen, dass die Sterne richtig stehen, damit der Laptop auf dem zweiten Mac erscheint.
      Außerdem ist sogar der USB-C-Port wichtig, in den man das Kabel steckt; es muss der erste links sein – warum auch immer.
      Trotzdem konnte ich ihn schließlich mithilfe eines Videos von Mr. Macintosh wiederbeleben.
    • Mein M1 MacBook Air muss bei jedem Update in den DFU-Modus versetzt und mit Configurator „revived“ werden.
      Andernfalls erscheint nur „Failed to personalize the software update“.
      Im Apple Store wurde das Gerät sofort wiederhergestellt und dabei wurden alle Daten gelöscht; als das nächste Update erschien, trat genau dasselbe Problem erneut auf.
      In so einer Situation ist es auch schwer zu zeigen, dass ihre Reparatur das Problem nicht dauerhaft behoben hat.
    • Bei meinem M1 Pro MacBook wurde während des Upgrades auch ein LG-USB-C-Monitor zerstört.
      Er zeigte nur noch einen schwarzen Bildschirm, und das Gleiche passierte auch beim Anschluss an andere USB-C-Laptops.
      Kabelwechsel, Trennen des Monitors vom Strom und Zurücksetzen auf Werkseinstellungen halfen nicht, während andere Eingänge wie HDMI und DisplayPort weiterhin funktionierten.
      Ich halte es nicht für Zufall, dass er während des Upgrades kaputtging, und empfehle dringend, während eines Upgrades außer dem Ladegerät nichts an das MacBook anzuschließen.
    • Bei einem M2 Pro ist mir exakt dasselbe passiert, und ich habe es mit demselben Verfahren behoben.
      Zum Glück waren die Daten nach dem DFU-Revive noch da, aber zunächst dachte ich, der Akku sei vor Abschluss des Updates leer geworden und es handle sich um einen isolierten Schaden.
      Inzwischen ist es aber sehr wahrscheinlich, dass der zusätzliche Monitor die Ursache war.
  • Ich wollte mein MacBook neu installieren, aber die integrierte Web-Wiederherstellung funktionierte nicht, also musste ich heute eine DFU-Wiederherstellung machen
    Das Basissystem war 13.2, und nachdem alle 13.6-Dateien heruntergeladen waren und der Fortschrittsbalken 100 % erreicht hatte, spuckte es einen Fehler aus
    Es scheint eine Inkompatibilität zwischen dem 13.2-Basissystem und der 13.6-Installation zu sein; die Qualität bei Apple ist heutzutage furchtbar
    Ich dachte, sie hätten wenigstens die grundlegendsten Szenarien getestet, bevor sie x.6-Software veröffentlichen, aber offenbar nicht
    Noch schlimmer ist, dass es schwer ist, eine offizielle oder inoffizielle Methode zu finden, um ohne einen anderen Mac einen bootfähigen USB-Installer zu erstellen oder ohne einen anderen Mac eine DFU-Wiederherstellung durchzuführen
    Keine Ahnung, ob die glauben, ich wohne in einem Apple Store
    Ich hatte keinen anderen Mac und konnte die DFU-Wiederherstellung am Ende mit libimobiledevice durchführen; danke an die Person, die das gebaut hat
    Aber so etwas darf nicht passieren, und Windows oder Linux sind viel transparenter als macOS

    • Apples Bootloader- und Wiederherstellungsprozess ist wirklich beängstigend
      Dinge wie erforderlicher Netzwerkzugriff, Firmware auf der SSD und Hardware-Sperren wirken, als würden sie nur darauf lauern, im ungünstigsten Moment Probleme zu machen
      Bei Windows dagegen bootet man einfach von einem USB-Stick aus der Schublade
    • Bei mir ähnlich
      Ich hatte vor etwa einem Jahr Avahi Linux installiert und wieder entfernt, aber jetzt lässt sich das System seit 12.6 nicht mehr aktualisieren
      Ich muss mir wohl ein externes Laufwerk besorgen, alles sichern und dann mein M1 Max MBP per DFU-Wiederherstellung zurücksetzen, um auf Sonoma zu kommen
  • „Lasst euch nicht zur Kasse bitten. Das ist ein von Apple verursachtes Problem und ein reines Softwareproblem. Wenn ein Techniker behauptet, es sei ein Hardwareschaden, liegt er falsch“, heißt es — man kann nur hoffen, dass es so läuft

    • Apple Stores sind bei so etwas normalerweise ziemlich gut
      Wenn es ein dokumentiertes Problem ist, das ein bestimmtes Hardwaremodell und eine bestimmte Softwareversion betrifft, ist es sehr unwahrscheinlich, dass sie Geld verlangen
    • War nicht besonders schwierig
      Als es beim 2011er MacBook Air einen SSD-Hardwarefehler gab, habe ich einigen Kommilitonen die Seite zum Hardwaredefekt gezeigt, und sie bekamen statt einer 800-Dollar-Reparatur eine kostenlose Instandsetzung
  • Ich weiß nicht, was in letzter Zeit bei Apple los ist
    Nachdem Apple fast gestorben wäre, haben sie eine der besten Marken der Welt aufgebaut, indem sie sich rücksichtslos und geradezu fanatisch darauf konzentriert haben, durchweg ein Premium-Erlebnis zu liefern, um Premiumpreise und hohe Margen zu rechtfertigen
    Wenn einem ihre Art gefiel, funktionierte es vom Moment des Kaufs an „einfach“ — bis vor Kurzem
    Heute hatte ich eine so kafkaeske Erfahrung, dass es sich fast wie ein bösartiger Streich anfühlte, und weil Apple so selten so massiv versagt hat, hatte ich auch keinen Notfallplan für wirklich wichtige Momente
    Wenn jemand weiß, wie man telefonisch zu Leuten durchkommt, die für treue Kunden das Nötige tun und das Problem beheben, höre ich mir den Rat gern an; aber der heutige First-Level-Support am Telefon fühlt sich wie ein endloses Warteschleifen-Karussell an, also erwarte ich nicht viel

    • Das heutige Apple ist ganz anders als Apple vor 20 Jahren
      Die Marke ist dieselbe, aber die Menschen sind größtenteils andere
      So etwas sieht man ständig auch in der Videospielbranche, etwa bei Blizzard, Bungie oder 343 Industries
      Vielleicht arbeiten die neuen Programmierer und Ingenieure an einer sehr komplexen Codebasis, und niemand versteht das Ganze vollständig, bis etwas kaputtgeht
  • Betroffen sind nur Geräte mit Apple-Silicon-Chips und ProMotion-Display; Intel ist nicht betroffen
    Das ist eine schnelle Entwarnungsklausel für Leute mit älteren Geräten

    • Nur einer der beiden aufgeführten Bugs erfordert ein ProMotion-Display
      Der andere kann auf allen Apple-Silicon-Geräten auftreten
  • Mein 2020er M1 MacBook Air wurde etwa eine Woche nach dem Upgrade auf Sonoma zu einem Brick, aber ich bin mir nicht sicher, ob das zusammenhängt
    Ich hatte den Verdacht, dass es mit dem Update zu tun hatte
    Zum Glück wurde dank der hiesigen Gewährleistungsregeln das Logic Board kostenlos ersetzt, aber mein Vorhaben, gleich am nächsten Tag aufs iPhone umzusteigen, war damit erst einmal abgekühlt

    • Dass ein Upgrade Hardware brickt, scheint bei macOS ein typisches Fehlermuster zu sein
      Big Sur hat zum Beispiel mehrere MBP von 2013 und 2014 gebrickt: https://www.macrumors.com/2020/11/15/macos-big-sur-update-br...
      Ich war ebenfalls betroffen, und wie bei vielen Nutzern wurde das Problem nach dem Austausch des I/O-Boards behoben
      In meinem Fall war die Garantie längst abgelaufen, also habe ich ein 10-Dollar-Teil bei Ebay gekauft und es selbst ersetzt
    • Zur Einordnung: Ich nutze seit über 10 Jahren iPhones, und noch nie ist ein Update fehlgeschlagen oder hat Probleme gemacht
      Mein Google Pixel dagegen hat sich in den zwei Jahren, in denen ich es hatte, etwa zweimal selbst gebrickt
    • Auch bei meinem 2020er M1 Air ist das Logic Board ausgefallen
      Eines Tages klappte ich es auf, und es ließ sich nicht mehr einschalten; ohne AppleCare wäre das eine 500-Dollar-Reparatur gewesen
      Vor etwa zwei Wochen lag es im Hotelzimmer aufgeklappt auf dem Bett, ich zog es am Display etwas näher zu mir heran, und schon der leichte Druck meiner Finger ließ das Display brechen
      Fälle mit genau diesen beiden Problemen beim Air findet man im Internet zuhauf
      Anfangs mochte ich das M1 Air wirklich, aber inzwischen hat es sich für mich als viel zu unzuverlässiges Gerät erwiesen
    • Wirkt wie ein merkwürdiges Entscheidungskriterium
      Bei jedem Hersteller gibt es bis zu einem gewissen Grad Software- und Hardwareprobleme
  • Wenn ich hier die Kommentare lese, frage ich mich, ob viele Leute auf Hacker News jemals echte Alltagsnutzer getroffen haben.
    Nicht andere Geeks oder erfahrene Nutzer, sondern ganz normale Leute im Büro nebenan, die nur so viel über Computer wissen, wie sie für ihre Arbeit brauchen.
    Ich frage mich wirklich, ob man glaubt, dass Nutzer beim Booten eine Auswahl im Grafikmodus wollen.
    Wie groß ist wohl der Anteil der Mac-Nutzer, die einen alternativen Bootloader verwenden oder überhaupt wissen, was das ist?
    Wenn man etwas Zeit vor Ort in großen Unternehmen verbringt, die ganze Geräteflotten betreuen, merkt man, ob Nutzer sich wirklich für die Dinge interessieren, die wir für wichtig halten.

    • Dem eingereichten Beitrag zufolge kann ein System, nachdem die System-Firmware auf die macOS-Sonoma-Version aktualisiert wurde, nicht mehr korrekt in ältere macOS-Installationen oder Asahi Linux booten, wenn das Display auf eine Bildwiederholrate eingestellt ist, die nicht ProMotion entspricht.
      Das schließt auch den Recovery-Modus ein, wenn diese Systeme als Standard-Boot-OS festgelegt sind, und bis zum nächsten OS-Upgrade ist auch System Recovery betroffen.
      Auch wenn Nutzer sich darum „nicht kümmern“ oder „nicht wissen, was das bedeutet“, kann das ganz normale Nutzer durchaus betreffen.
    • Wenn man alltägliche Techniknutzer trifft, merkt man, dass sie völlig daran gewöhnt sind, sich einfach zu merken, worauf sie auf undurchsichtigen Bildschirmen klicken müssen, die niemand versteht und für die niemand Zeit hat, sie nachzuschlagen.
      Man muss nur daran denken, wie viele sicherheitsbezogene Hinweise und Warnungen es gibt, während man eigentlich arbeiten muss.
      Am Ende ist es Muskelgedächtnis.
      Ignoriert man Sicherheitswarnungen, kann das System kompromittiert werden; in diesem Fall könnte man damit aber irgendwann sein System und seine Arbeit retten, daher ist es schwer zu sagen, dass es wertlos wäre.
      Dieses Problem kann jeden Nutzer treffen, der aus irgendeinem Grund zwei macOS-Versionen verwenden möchte, und gerade unter Kreativprofis ist das gar nicht so ungewöhnlich.
  • Kurz gesagt: In den aktuellen Versionen macOS Sonoma und 13.6 Ventura gibt es einen Upgrade-Bug, der einige Macs unbrauchbar machen und recoveryOS außer Funktion setzen kann, was zu einem schwarzen Bildschirm führt und einen DFU Revive erforderlich macht.
    Das Sonoma-Problem scheint am häufigsten bei Dual-Boot-Macs aufzutreten: https://support.apple.com/en-us/HT208891
    Auch das Ventura-Upgrade kann aus unklaren Gründen problematisch sein, wenn die Bildwiederholrate des Displays auf einen Wert eingestellt ist, der nicht ProMotion entspricht.
    Die Dokumentation steht im Asahi-Linux-Wiki, weil die Asahi-Linux-Entwickler dieses Problem entdeckt haben, aber es ist nicht auf Asahi beschränkt.
    Tatsächlich kann der Asahi-Linux-Installer erkennen, ob ein Mac von diesem Problem betroffen sein wird, selbst wenn man am Ende Asahi Linux gar nicht installiert.
    Details stehen im Beitrag.

    • Ich hatte dieses Problem beim Upgrade auf meinem Mac gleich zweimal.
      Ich hatte zwei bootfähige OSX-Partitionen, und beide Upgrades haben mich erwischt.
      Da ich mit Macs nicht besonders vertraut bin, habe ich mich bei der Lösung wirklich schwergetan und musste sogar lernen, dass es DFU gibt und wozu es dient.
      Ich hatte Glück, dass meine Tochter einen Mac hat und ich deshalb DFU nutzen konnte, ohne in den Apple Store gehen zu müssen.
  • Es ist bis zu einem gewissen Grad beruhigend, dass es Dritte gibt, die aktiv nach macOS-Problemen suchen.