Совместимость: на каких моделях работает XiControl? / Which laptops are supported?

[Oksion]

English below.

На каких моделях работает XiControl?

Утилита разрабатывается и проверяется на Xiaomi Book Pro 14 (TM2424) — это единственная модель, доступная автору физически. Но она не привязана к ней жёстко: всё управление идёт через штатный WMI-интерфейс прошивки MiCommonInterface (протокол MIFS, ODM Bitland), который есть у большинства современных ноутбуков Xiaomi и Redmi.

Набор поддерживаемых функций зависит от модели. Утилита определяет их в рантайме: если прошивка отвечает «не поддерживается» (0xE0), соответствующая функция просто молча исчезает из меню — приложение не падает и ничего не ломает.

Эта тема — карта совместимости. Если у вас другая модель, расскажите, что получилось: так список будет расти.

Как проверить свою модель за минуту

1. Установите: winget install Oksion.XiControl
2. Выполните в PowerShell:

Get-CimClass -Namespace root/wmi -ClassName MiCommonInterface

Класс нашёлся — интерфейс есть, утилита будет работать (в каком объёме — покажет пункт 3). Не нашёлся — эта модель, к сожалению, не поддерживается.

3. Запустите приложение и посмотрите, что доступно: защита заряда, режимы производительности, реакция на клавиши, OSD.

Что написать в ответе

• Модель — точное название и код (например, «Xiaomi Book Pro 14 2024, TM2424»)
• Нашёлся ли класс MiCommonInterface
• Что работает: порог заряда (какие проценты предлагаются), режимы производительности (сколько их), Mi-кнопка и спец-клавиши, OSD
• Что не работает или ведёт себя странно
• Лог, если что-то пошло не так: %APPDATA%\XiControl\log.txt (включите логирование в Настройки → Общие)

Проверенные модели

Модель	Класс MIFS	Порог заряда	Режимы	Клавиши	Примечания
Xiaomi Book Pro 14 (TM2424)	✅	✅ 40/50/60/70/80/100%	✅ 5 режимов (вкл. скрытый Eco)	✅ Mi, AI, «Настройки», «Проекция», микрофон, подсветка, Fn-Lock	Эталонная модель, всё проверено вживую

Список пополняется по вашим отчётам.

---

Which laptops does XiControl support?

The app is developed and tested on the Xiaomi Book Pro 14 (TM2424) — the only model the author physically owns. It is not hard-wired to it, though: everything goes through the stock firmware WMI interface MiCommonInterface (the MIFS protocol, ODM Bitland), which most recent Xiaomi and Redmi laptops expose.

The set of supported features depends on the model. They are detected at runtime: if the firmware answers "not supported" (0xE0), that feature simply disappears from the menu — the app never crashes and never forces anything.

This thread is a compatibility map. If you have a different model, please share what you got.

Check your model in a minute

1. Install: winget install Oksion.XiControl
2. Run in PowerShell:

Get-CimClass -Namespace root/wmi -ClassName MiCommonInterface

If the class is found, the interface is there and the app will work (item 3 shows how much of it). If it isn't, this model is unfortunately not supported.

3. Launch the app and see what's available: charge protection, performance modes, key handling, OSD.

What to include in your reply

• Model — exact name and code (e.g. "Xiaomi Book Pro 14 2024, TM2424")
• Whether the MiCommonInterface class was found
• What works: charge threshold (which percentages are offered), performance modes (how many), Mi button and special keys, OSD
• What doesn't work or behaves oddly
• The log, if something went wrong: %APPDATA%\XiControl\log.txt (enable logging in Settings → General)

Verified models

See the table above — it's shared between both languages and grows with your reports.

---

XiControl is driver-free by design: no kernel drivers, no WinRing0, no direct EC access. If a feature can't be done that way, it isn't done — and the reason is written down in docs/05-open-questions.md.