1 poin oleh GN⁺ 2023-11-01 | 1 komentar | Bagikan ke WhatsApp
  • Repositori dokumentasi Asahi Linux berfungsi sebagai sumber situs dokumentasi, termasuk halaman kegagalan boot macOS Sonoma, dan materi terkait dikelola di GitHub
  • Dokumentasi dibagi ke dalam kategori seperti alt, fw, hw, platform, project, dan sw, sehingga dapat ditelusuri berdasarkan topik
  • Area hw membahas perangkat keras Apple Silicon Mac, dan dibagi lagi menjadi cpu, devices, peripherals, dan soc untuk membedakan detail perangkat keras
  • Situs dokumentasi dibuat dengan Zensical, dan pengujian lokal dapat dijalankan dengan zensical serve setelah memasang paket Python
  • Situs dibangun ulang oleh CI pada setiap commit dan disajikan melalui GitHub Pages

Peran repositori dokumentasi Asahi Linux

  • Repositori ini mengelola dokumen untuk situs Asahi Linux documentation
  • Dokumentasi disusun dengan membaginya ke dalam kategori berdasarkan topik

Struktur kategori dokumentasi

  • alt: dokumentasi dukungan sistem operasi alternatif dan distribusi Linux
  • fw: dokumentasi firmware yang dikendalikan vendor dan antarmuka firmware
  • hw: dokumentasi perangkat keras terkait Apple Silicon Mac
    • cpu: dokumentasi prosesor aplikasi
    • devices: dokumentasi terkait model Mac tertentu
    • peripherals: dokumentasi perangkat keras internal Apple Silicon Mac yang bukan bagian dari SoC itu sendiri
    • soc: dokumentasi blok perangkat keras yang terintegrasi ke dalam Apple Silicon SoC
  • platform: dokumentasi yang berlaku untuk platform Apple Silicon secara keseluruhan
  • project: dokumentasi manajemen proyek dan item yang tidak terkait perangkat keras maupun perangkat lunak
  • sw: dokumentasi perangkat lunak selain firmware

Build lokal dan metode deployment

  • Situs dibuat dengan Zensical
  • Zensical dipasang sebagai paket Python
    • Jika distribusi tidak menyediakan paketnya, pemasangan dapat dilakukan dengan pip
  • Build dokumentasi untuk pengujian lokal dijalankan dengan perintah berikut setelah Zensical terpasang
$ zensical serve
  • Situs web dibangun ulang oleh CI pada setiap commit
  • Situs hasil build disajikan melalui GitHub Pages

1 komentar

 
GN⁺ 2023-11-01
Pendapat Hacker News
  • Spekulasi tentang bagaimana sekadar mengubah refresh rate bisa menyebabkan kerusakan boot juga layak dilihat di Twitter-nya: https://social.treehouse.systems/@marcan/111329614147717090
    Menurutnya, ini karena Apple tidak menyukai kedipan saat pergantian mode tampilan, dan mengaktifkan/menonaktifkan ProMotion menimbulkan kedipan pergantian mode
    Jadi spekulasinya, Apple menyimpan pengaturan ini di suatu tempat di NVRAM dan menerapkannya ketika layar menyala pada tahap awal boot, agar tidak berkedip lagi saat macOS melakukan boot
    Masalahnya, karena tidak diuji dengan bootloader OS lama, ketika mode ini aktif handoff/inisialisasi display gagal secara katastrofik

    • Di PC, saya selalu terganggu melihat resolusi berubah kacau saat boot
      Pada era BIOS itu masih bisa dipahami, tetapi setelah UEFI hadir, rasanya layar pengaturan EFI semestinya bisa ditampilkan pada resolusi native monitor, atau setidaknya rasio aspek native; kenyataannya yang sering saya lihat justru layar seperti 1024x768 diregangkan ke monitor 16:9 dan tampak buruk
    • Syukurlah ternyata ada juga yang tidak suka kedipan saat pergantian mode tampilan
      Dengan daya komputasi sekarang, seharusnya kita tidak perlu melihat kedipan di mana pun dalam hidup, dan saya tidak suka banyak orang menerima noise visual yang muncul saat menyambungkan monitor sebagai “sudah cukup baik”
    • Agak menghangatkan hati melihat perusahaan bernilai triliunan dolar pun melakukan hal mirip dengan saya saat mengutak-atik rEFInd, gambar splash BIOS, plymouth-git, plymouth-sddm, quiet splash, dan semacamnya demi membuat pengalaman boot yang mulus, lalu menambah beberapa detik waktu boot dan berkali-kali memulihkan dengan USB boot
      Sekarang saya sudah menerima kedipan dan pesan systemd
      Boot sekarang hanya hitungan beberapa detik, dan bahkan sulit menjelaskan lagi kenapa dulu saya begitu terobsesi
    • Ini menarik, tapi saya penasaran siapa yang mematikan ProMotion, karena 120Hz sangat meningkatkan responsivitas
      Satu-satunya aplikasi yang pernah saya lihat tidak berjalan benar dengan variable refresh rate hanyalah Genshin di Windows, dan itu pun pada monitor modern kemungkinan bukan masalah karena VRR bisa menangani sampai 60Hz, sehingga tidak ada kedipan penggandaan frame saat bolak-balik antara 60Hz dan 120Hz
  • Saya mengalami persis masalah yang sama saat menaikkan MacBook Pro M1 kantor ke Ventura 13.6, dan mengira itu kejadian yang benar-benar terisolasi
    Tidak ada dual boot; hanya macOS yang terpasang
    Saat update, perangkat terhubung ke Thunderbolt Display, dan sepertinya itu menghasilkan efek yang sama seperti berpindah ke refresh rate non-ProMotion sebagaimana disebutkan di artikel tertaut
    Saya harus melakukan DFU restore dari Mac lain lalu menjalankan installer macOS Sonoma lewat USB; untungnya instalasi lama terdeteksi sehingga dilakukan upgrade di tempat dan data tetap tersimpan
    Saya juga menghabiskan banyak waktu karena DFU restore tidak berhasil, sampai akhirnya tahu bahwa kabel Thunderbolt tidak bisa dipakai dan harus memakai kabel USB-C biasa agar Apple Configurator mendeteksi Mac lain

    • Justru saya mengira jika salah satu dari keduanya diperlukan, yang dibutuhkan adalah kabel Thunderbolt
      Biasanya kabel bandwidth tinggi dengan lebih banyak fitur tetap bekerja pada sisi yang tidak mendukung fitur tersebut, jadi ini cukup mengejutkan
      Kalau suatu hari perlu menghidupkan kembali Mac yang brick, saya ingin mengingat hal ini
    • Saya juga tidak paham kenapa masuk ke mode DFU harus berupa prosedur magis: menekan tombol tertentu tepat pada saat tertentu selama beberapa detik tertentu
      Rasanya seperti harus bernyanyi untuk dewa Mac OS imajiner dan berharap bintang-bintang sejajar agar laptop muncul di Mac kedua
      Selain itu, port tempat kabel USB-C ditancapkan juga penting, harus yang pertama di sisi kiri; entah kenapa
      Meski begitu, dengan mengikuti video Mr. Macintosh akhirnya saya berhasil menghidupkannya lagi
    • M1 MacBook Air saya setiap kali update harus masuk mode DFU dan di-“revive” dengan Configurator
      Kalau tidak, yang muncul hanya “Failed to personalize the software update”
      Saya pergi ke Apple Store, mereka langsung memulihkan perangkat dan menghapus semua data, lalu saat update berikutnya keluar, masalah yang sama muncul lagi
      Dalam kondisi seperti ini, sulit juga menunjukkan bahwa perbaikan mereka tidak menyelesaikan masalah secara permanen
    • Pada M1 Pro MacBook, monitor LG USB-C juga rusak saat proses upgrade
      Layarnya hanya hitam, dan sama saja ketika dihubungkan ke laptop USB-C lain
      Mengganti kabel, mencabut daya monitor, dan factory reset tidak membantu, tetapi input lain seperti HDMI dan DisplayPort masih berfungsi
      Saya tidak menganggap kerusakan saat upgrade itu kebetulan, dan sangat menyarankan agar saat upgrade tidak ada apa pun yang tersambung ke MacBook selain charger
    • Hal yang persis sama terjadi pada M2 Pro dan diperbaiki dengan prosedur yang sama
      Untungnya data masih ada setelah DFU revive, tetapi awalnya saya mengira itu kejadian terisolasi karena baterai habis sebelum update selesai sehingga ada sesuatu yang rusak
      Namun besar kemungkinan penyebabnya adalah monitor cadangan
  • Saya sempat mencoba menginstal ulang MacBook, tetapi pemulihan web bawaan tidak berfungsi, jadi hari ini harus melakukan pemulihan DFU
    Sistem dasarnya 13.2, lalu setelah mengunduh semua berkas 13.6 dan progress bar mencapai 100%, muncul error
    Sepertinya ini ketidakcocokan antara sistem dasar 13.2 dan instalasi 13.6; kualitas Apple belakangan ini buruk sekali
    Saya kira setidaknya skenario paling dasar seperti ini sudah diuji sebelum merilis perangkat lunak x.6, ternyata tidak
    Yang lebih buruk, sulit menemukan cara resmi maupun tidak resmi untuk membuat installer boot USB tanpa Mac lain, atau melakukan pemulihan DFU tanpa Mac lain
    Entah mereka mengira saya tinggal di Apple Store
    Saya tidak punya Mac lain, dan akhirnya bisa melakukan pemulihan DFU dengan libimobiledevice; terima kasih kepada pembuatnya
    Tapi hal seperti ini seharusnya tidak terjadi, dan Windows atau Linux jauh lebih transparan daripada macOS

    • Bootloader dan prosedur pemulihan Apple benar-benar menakutkan
      Kebutuhan akses jaringan, firmware yang ada di SSD, penguncian hardware, dan hal-hal semacam itu terasa seperti bersembunyi untuk menimbulkan masalah di saat paling merepotkan
      Sebaliknya, di Windows cukup boot dari satu USB stick di laci
    • Saya juga mirip
      Sekitar setahun lalu saya memasang lalu menghapus Avahi Linux, dan sekarang tidak bisa upgrade lagi sejak 12.6
      Sepertinya saya harus mendapatkan drive eksternal, mencadangkan semuanya, lalu melakukan pemulihan DFU pada M1 Max MBP agar bisa naik ke Sonoma
  • Katanya, “Jangan sampai disuruh membayar. Ini masalah yang dibuat Apple dan murni masalah software. Kalau teknisi mengklaim ini kerusakan hardware, mereka salah,” jadi sepertinya harus berharap begitu

    • Apple Store biasanya cukup baik menangani hal seperti ini
      Kalau ini masalah terdokumentasi yang memengaruhi model hardware dan versi software tertentu, kecil sekali kemungkinannya mereka akan menagih biaya
    • Tidak terlalu sulit
      Saat MacBook Air 2011 mengalami kegagalan hardware SSD, saya memberi tahu beberapa teman sekelas tentang halaman cacat hardware, dan mereka mendapat perbaikan gratis alih-alih membayar 800 dolar
  • Entah apa yang sedang terjadi dengan Apple akhir-akhir ini
    Setelah nyaris mati, Apple membangun salah satu merek terbaik di dunia dengan fokus yang tanpa kompromi dan dedikasi fanatik untuk menghadirkan pengalaman premium secara menyeluruh demi membenarkan harga premium dan margin besar
    Jika Anda menyukai cara mereka, sejak saat membeli semuanya “langsung berfungsi”, setidaknya sampai belum lama ini
    Hari ini saya mengalami pengalaman ala Kafka yang sampai terasa seperti lelucon jahat, dan karena Apple hampir tidak pernah mengacau separah ini, saya juga tidak punya rencana cadangan untuk momen yang sangat penting
    Kalau ada cara untuk tersambung lewat telepon dengan orang-orang yang akan melakukan apa yang diperlukan bagi pelanggan setia dan memperbaiki masalah ini, saya ingin mendengar sarannya, tetapi dukungan telepon lini pertama saat ini terasa seperti komidi putar antrean tanpa akhir, jadi saya tidak terlalu berharap

    • Apple hari ini sangat berbeda dari Apple 20 tahun lalu
      Mereknya sama, tetapi orang-orangnya sebagian besar sudah berganti
      Hal yang sama selalu terlihat juga di industri gim video, di tempat seperti Blizzard, Bungie, dan 343 Industries
      Mungkin para programmer dan engineer baru sedang menangani codebase yang sangat kompleks, dan tidak ada orang yang benar-benar memahami keseluruhannya sampai ada sesuatu yang rusak
  • Dampaknya hanya pada perangkat dengan chip Apple Silicon dan layar ProMotion; Intel tidak terdampak
    Ini klausul keluar cepat bagi orang-orang yang memakai perangkat lama

    • Dari dua bug yang disebutkan, hanya satu yang membutuhkan layar ProMotion
      Yang lainnya bisa terjadi pada semua perangkat Apple Silicon
  • Sekitar seminggu setelah upgrade ke Sonoma, MacBook Air M1 2020 saya menjadi brick, tetapi saya tidak yakin apakah ada kaitannya
    Saya sempat curiga ini terkait update
    Untungnya, berkat aturan garansi di sini, logic board diganti gratis, tetapi keinginan saya untuk beralih ke iPhone keesokan harinya langsung mereda

    • Upgrade yang membuat hardware menjadi brick tampaknya seperti pola kegagalan yang umum di macOS
      Misalnya, Big Sur membuat beberapa MBP 2013 dan 2014 menjadi brick: https://www.macrumors.com/2020/11/15/macos-big-sur-update-br...
      Saya juga terdampak, dan seperti banyak pengguna lain, masalahnya teratasi setelah mengganti board I/O
      Dalam kasus saya, garansi sudah lama habis, jadi saya membeli komponen seharga 10 dolar di Ebay dan menggantinya sendiri
    • Sebagai catatan, saya sudah memakai iPhone lebih dari 10 tahun, tetapi belum pernah sekali pun update gagal atau menimbulkan masalah
      Sebaliknya, Google Pixel yang saya miliki selama 2 tahun sempat menjadi brick sendiri sekitar dua kali
    • M1 Air 2020 saya juga mengalami kerusakan logic board
      Suatu hari saya membuka penutupnya dan perangkat tidak mau menyala; kalau tidak ada AppleCare, biaya perbaikannya 500 dolar
      Sekitar 2 minggu lalu, di kamar hotel, saya meletakkannya di atas tempat tidur dengan penutup terbuka, lalu menariknya mendekat dengan memegang layar, dan layar retak hanya karena tekanan ringan dari jari
      Kasus kedua masalah ini pada Air bertebaran di internet
      Awalnya saya sangat menyukai M1 Air, tetapi sekarang terbukti sebagai perangkat yang terlalu tidak andal bagi saya
    • Itu terasa seperti tolok ukur yang aneh
      Masalah software dan hardware pasti terjadi sampai batas tertentu pada produsen mana pun
  • Setelah membaca komentar di sini, saya jadi bertanya-tanya apakah banyak orang di Hacker News pernah benar-benar bertemu pengguna sehari-hari
    Maksudnya bukan sesama geek atau pengguna berpengalaman, melainkan orang biasa di kubikel sebelah yang hanya tahu komputer sejauh yang diperlukan untuk bekerja
    Saya benar-benar ragu apakah pengguna menginginkan pemilihan mode grafis saat boot
    Berapa banyak pengguna Mac yang memakai bootloader alternatif, atau bahkan tahu apa itu
    Coba luangkan waktu di lapangan mendukung sekumpulan perangkat di perusahaan besar; dari situ kita bisa tahu apakah pengguna benar-benar peduli pada hal-hal yang kita anggap penting

    • Menurut kiriman tersebut, setelah firmware sistem diperbarui ke versi macOS Sonoma, jika layar disetel ke refresh rate non-ProMotion, sistem itu tidak lagi bisa boot dengan benar ke instalasi macOS lama atau Asahi Linux
      Ini juga mencakup recovery mode saat sistem-sistem tersebut ditetapkan sebagai OS boot default, dan System Recovery juga terdampak sampai sebelum upgrade OS berikutnya
      Sekalipun pengguna tidak “peduli” atau tidak “mengerti maksudnya”, ini tetap bisa cukup berdampak pada pengguna umum
    • Kalau bertemu pengguna teknologi sehari-hari, kita akan tahu bahwa mereka sudah sepenuhnya terbiasa hanya mengingat apa yang harus diklik di layar-layar rumit yang tidak dipahami siapa pun dan tidak sempat dicari tahu
      Coba pikirkan betapa banyak notifikasi dan peringatan keamanan yang muncul saat orang sedang harus bekerja
      Pada akhirnya itu adalah muscle memory
      Peringatan keamanan, jika diabaikan, bisa membuat sistem diretas; tetapi dalam kasus ini, suatu saat hal itu mungkin bisa menyelamatkan sistem dan pekerjaan, jadi sulit menyebutnya tidak bernilai
      Masalah ini bisa dialami pengguna yang, karena alasan apa pun, ingin memakai dua versi macOS, dan itu bukan hal yang sangat aneh terutama di kalangan profesional kreatif
  • Singkatnya, ada bug upgrade terbaru di macOS Sonoma dan 13.6 Ventura yang dapat membuat sebagian Mac menjadi brick dan memicu layar hitam yang membuat recoveryOS tidak bisa dipakai sehingga perlu DFU revive
    Masalah di Sonoma tampaknya paling sering muncul pada Mac dual-boot: https://support.apple.com/en-us/HT208891
    Upgrade Ventura juga bisa bermasalah karena alasan yang tidak jelas jika refresh rate layar disetel ke nilai non-ProMotion
    Dokumen ini ada di wiki Asahi Linux karena para pengembang Asahi Linux yang menemukan masalah ini, tetapi masalahnya tidak terbatas pada Asahi saja
    Bahkan, jika menjalankan installer Asahi Linux, ia bisa mendeteksi apakah Mac tersebut akan terdampak masalah ini, meskipun pada akhirnya Anda tidak memasang Asahi Linux
    Lihat tulisannya untuk detailnya

    • Saya mengalami masalah ini dua kali di Mac saya saat upgrade
      Saya punya dua partisi OSX yang bisa di-boot, dan terkena di kedua upgrade
      Karena saya tidak terlalu terbiasa dengan Mac, saya benar-benar banyak tersesat saat memperbaikinya, dan bahkan harus mempelajari bahwa DFU itu ada dan apa fungsinya
      Saya beruntung anak perempuan saya punya Mac, jadi saya bisa memakai DFU tanpa harus membawanya ke Apple Store
  • Dalam taraf tertentu, cukup melegakan bahwa ada pihak ketiga yang secara aktif menemukan masalah macOS