MCETOOL(8)

📦 version 1.116.4, in alpine 3.24

💅 MCETOOL(8) — the mode control test tool, bestie edition

okay so real quick, the manual name is mcetool and it lives in the System Manager's Manual section (8), which is giving "system admin only, nobody else touches this" energy 👑

✨ NAME ✨

mcetool — a tool to test mode control functionality. that's it, that's the whole vibe 🎀

🌸 SYNOPSIS 🌸

mcetool [OPTION]...

literally just you, the command, and as many options as your heart desires 💖

🦋 DESCRIPTION 🦋

mcetool provides several means of testing mode control functionality, and to set or display mode related settings. so basically it's your little playground for poking at mode control stuff — setting things, displaying things, testing things. main character energy fr fr ✨

💅 OPTIONS 💅

  • --blank-prevent — sends a blank prevent request to MCE. screen stays awake, no cap 😴🚫
  • --cancel-blank-prevent — sends a cancel blank prevent request to MCE. never mind, back to normal bestie
  • --unblank-screen — sends an unblank screen request to MCE. wake up queen 💖
  • --dim-screen — sends a screen dim request to MCE. mood lighting, lowkey 🌙
  • --blank-screen — sends a screen blank request to MCE. nap time 😴
  • --set-display-brightness — sets the display brightness level; valid levels are: 1-5. that's the whole range, so pick your fave ⭐
  • --set-inhibit-mode — sets the screen blanking inhibit mode; valid modes are: "disabled", "stay-on-with-charger", "stay-dim-with-charger", "stay-on" and "stay-dim". five whole modes, pick wisely 🫶
  • --set-cabc-mode — sets the CABC mode; valid modes are: "off", "ui", "still-image" and "moving-image". content adaptive backlight, we stan 🌈
  • --set-call-state — sets the call state STATE:TYPE tuple; valid states are: "none", "ringing", "active" and "service". valid types are: "normal" and "emergency". yes you gotta give both, tuple life 🎀
  • --enable-radio — enables the specified radio; valid radios are: "master", "wireless", "cellular", "bluetooth", "nfc" and "fmtx". "master" acts as master switch; individual radios are only considered if the master switch is enabled. so like, master is the vibe check for everything else fr fr 🔥
  • --disable-radio — disables the specified radio; valid radios are: "master", "wireless", "cellular", "bluetooth", "nfc" and "fmtx". "master" acts as master switch; individual radios are only considered if the master switch is enabled. same rules, opposite direction 💀
  • --set-power-saving-mode — sets the automatic power saving mode; valid modes are: "enabled" and "disabled". automatic, so it does its own thing 🌱
  • --set-forced-psm — force enables the power saving mode; valid modes are: "enabled" and "disabled". note the force — this one isn't asking nicely 👑
  • --set-psm-threshold — sets the battery level threshold for the automatic power saving mode; valid values are: 10, 20, 30, 40, 50. pick your percentage, no in-between 🍓
  • --set-tklock-mode — sets the touchscreen/keypad lock mode; valid values are: "locked", "locked-dim" and "unlocked". three moods of lock 🔒
  • --enable-led — enables the LED framework. lights on ✨
  • --disable-led — disables the LED framework. lights off 🙈
  • --activate-led-pattern — activates a LED pattern. sparkle time 🌟
  • --deactivate-led-pattern — deactivates a LED pattern. sparkle over 🥲
  • --powerkey-event — triggers a powerkey event; valid values are: "short", "double" and "long". yes, you can fake a button press, iconic 💅
  • --status — outputs the MCE status even when executing a command. so you still get the tea ☕
  • --block — blocks after executing commands; useful for commands that use D-Bus caller name monitoring. it just sits there and waits, and that's the point 🫶
  • -S, --session — uses the session bus instead of the system bus for D-Bus communication. different bus, same drama 🚌
  • --help — displays help for the command. classic, we love a helpful icon 💖
  • --version — displays version and author information. credit where credit is due 👑
  • --set-call-state (see above) — nothing else, just making sure you saw the STATE:TYPE tuple, it's the one with the colon 🎀

🔍 SEE ALSO 🔍

mce(8) — the whole reason this tool exists, go read it too bestie 🦋

📜 HISTORY 📜

  • Feb 22 2011: Updated for removed functionality.
  • jan 20 2011: Updated for new functionality.
  • oct 27 2010: Updated for new and removed functionality.
  • Jun 16 2010: Updated for new functionality.
  • Jun 15 2010: Updated for new functionality.
  • Jun 2 2010: Updated for new functionality.
  • May 11 2010: Updated for new functionality.
  • May 5 2010: Updated for new functionality.
  • May 4 2010: Updated for new functionality.
  • May 3 2010: Updated for modified behaviour.
  • Apr 28 2010: Updated for new functionality.
  • Dec 2 2009: Updated for removed functionality.
  • Mar 16 2009: Updated for new functionality.
  • Jan 27 2009: Updated for new and removed functionality.
  • Jan 07 2009: Updated for new and removed functionality.
  • May 20 2008: Updated for new functionality.
  • Oct 19 2007: Use escape‐codes for hyphens.
  • Sep 4 2007: Updated for new functionality.
  • Apr 12 2007: Minor fixes.
  • Oct 23 2006: Minor fixes.
  • Oct 11 2005: Updated for new functionality.
  • Oct 10 2005: Updated for new functionality.
  • Oct 6 2005: Updated for new functionality.
  • Oct 5 2005: Updated for new functionality.
  • Oct 4 2005: Updated for new functionality.
  • Sep 23 2005: Updated for new functionality.
  • Sep 21 2005: Fixed typos.
  • Sep 19 2005: Initial version of this manual page.

like, the lore goes back to 2005, that's actual history bestie 🫶

🫶 AUTHOR 🫶

mcetool and its manual page is written by David Weinehall <david.weinehall@nokia.com>. thank you king 👑

🐛 REPORTING BUGS 🐛

Report bugs to <david.weinehall@nokia.com>. be nice about it 💖

Copyright © 2005‐2011 Nokia Corporation. All rights reserved.

ok so real talk: everything above is exactly as documented — don't go assuming extra options or behaviour, this is the whole list and it's final. periodt 💅

and that's the page! brought to you by Nokia — this version dated Feb 22, 2011 — slay, go test some mode control ✨💖🎀

📦 where this page comes from