# Open Software On An Open Convertible Laptop

{%hackmd @coscup/announcement-2025 %}

> 請從這裡開始

###### tags: `COSCUP2025`, `en`, `intermediate`

Slides: https://docs.google.com/presentation/d/1rwHa_Dz13ADSR8pSg-swqJyXLDCtxx2Fa50ehwggfws/edit?usp=sharing

## Who am I?

## What is Framework

* 產品都在台灣組裝

## Last Year

* Framework 13
* Framework 16

## This year

* Framework 12
* Framework Desktop

## What's a convertible?

* 螢幕可 180度翻轉
* 但是這個時候鍵盤會被禁用

## What's does a convertible do

* Tablet mode
* 螢幕旋轉會被啟用
* 手寫筆有很多協定所以很難作

## How does it do that?

* 加速度計跟 Hall sensor
* hall sensor 用來偵測螢幕不完全翻轉的 case (0/360度，fully-open/closed)
* 機制都做在 EC
* 觸控螢幕使用標準 I2C HID 協議

## First power on

* 是在 FreeBSD（因為工程師的 Linux 都在磁碟加密上面
* 螢幕跟觸控螢幕都可以鄭作

## Tablet mode - Linux

* 有很多種作法、Daemon 跟程式語言實作，很混亂
* 不同的桌面環境要怎麼支援？
* ACPI？
* Standard? PNP0C60
* Intel: INT33D6, INT33D5, INTC1078
* Google (for chromebooks)
* AMD
* Lenovo
* 使用標準的 ACPI 發現可以動

## Tablet mode - Windows

* 有 GPIO Laptop and Slate indicator driver 可以用

## G-Sensor - Linux

* 使用跟 ChromeOS 同一套 EC，只需要加上硬體識別碼就好

## G-sensor - Windows

* 因為沒 Chromebook 驅動只好自己寫
* 修改 coolstar 的 EC 通訊實作實現

## Windows driver development

1. 使用 VS 建構（也可以用命令列界面）
2. 使用特殊的 USB-A 傳輸線與 WinDBG kernel debugger 來除錯
3. 跑 HLK (Windows Hardware Lab Kit) 測試
* Windows 驗證驅動規定因為 Crowdstrike 事件變嚴格
4. 要用 EV 憑證 HLK 測試結果（RSA 憑證問題所以又多花了幾百美元）
5. 上傳到 WHQL

## Full stack sumamry

1. EC 讀取 hall sensor 跟加速度計算出螢幕角度
1. EC 設定 GPIO
1. CPU 透過 ACPI(soc_button_array) OS 中斷
1. OS 透過 SW_TABLET_MODE keycode 通知桌面環境 -> 切換到 tablet mode
1. OS 加速度計驅動讀取 EC 螢幕 sensor
1. 螢幕旋轉驅動/軟體作剩下的事

## Stylus protocols

* MPP(Microsoft) vs. USI(Google)
* 對作業系統來說都是 HID 標準，所以 Linux 跟 Windows 都可動
* USI 才支援報告手寫筆電量
* USI 標準文件要成為會員才能拿到

## Keyboard and touchpad should be disabled

* Chrome EC 會自動禁用鍵盤
* Linux 上 libinput 可以自動處理
* Windows 上微軟叫你自己想辦法
* 最後要多給 touchpad 一個 GPIO 來自 EC 禁用

## iio-sensor-proxy

* 可以獲取原生 g-sensor 資料
* 但是產品釋出之前有一個 regression
* 將修正發布到作業系統散步版要花很多時間
* 昨天(COSCUP第一天)晚上終於釋出了包含修正的新版本

## Summary

* 可以到 GitHub 看 EC 韌體的原始碼
* BIOS 中的 ACPI code 可以從作業系統讀到所以形同開源(?)

## Q&A

### When does it (Framework 12) ship?

Already shipping, current batches sold out, can pre-order and new orders ship in a few weeks.