€•X‡Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ:/translations/zh_CN/admin-guide/laptops/samsung-galaxybook”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ:/translations/zh_TW/admin-guide/laptops/samsung-galaxybook”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ:/translations/it_IT/admin-guide/laptops/samsung-galaxybook”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ:/translations/ja_JP/admin-guide/laptops/samsung-galaxybook”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ:/translations/ko_KR/admin-guide/laptops/samsung-galaxybook”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ:/translations/pt_BR/admin-guide/laptops/samsung-galaxybook”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ:/translations/sp_SP/admin-guide/laptops/samsung-galaxybook”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ)SPDX-License-Identifier: GPL-2.0-or-later”h]”hŒ)SPDX-License-Identifier: GPL-2.0-or-later”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1hµhhh²hh³ŒT/var/lib/git/docbuild/linux/Documentation/admin-guide/laptops/samsung-galaxybook.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒSamsung Galaxy Book Driver”h]”hŒSamsung Galaxy Book Driver”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ paragraph”“”)”}”(hŒ'Joshua Grisham ”h]”(hŒJoshua Grisham <”…””}”(hhßh²hh³Nh´NubhŒ reference”“”)”}”(hŒjosh@joshuagrisham.com”h]”hŒjosh@joshuagrisham.com”…””}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:josh@joshuagrisham.com”uh1hçhhßubhŒ>”…””}”(hhßh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÞ)”}”(hŒÇThis is a Linux x86 platform driver for Samsung Galaxy Book series notebook devices which utilizes Samsung's ``SCAI`` ACPI device in order to control extra features and receive various notifications.”h]”(hŒoThis is a Linux x86 platform driver for Samsung Galaxy Book series notebook devices which utilizes Samsung’s ”…””}”(hjh²hh³Nh´NubhŒliteral”“”)”}”(hŒ``SCAI``”h]”hŒSCAI”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒR ACPI device in order to control extra features and receive various notifications.”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒSupported devices”h]”hŒSupported devices”…””}”(hj(h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj%h²hh³hÇh´KubhÞ)”}”(hŒóAny device with one of the supported ACPI device IDs should be supported. This covers most of the "Samsung Galaxy Book" series notebooks that are currently available as of this writing, and could include other Samsung notebook devices as well.”h]”hŒ÷Any device with one of the supported ACPI device IDs should be supported. This covers most of the “Samsung Galaxy Book†series notebooks that are currently available as of this writing, and could include other Samsung notebook devices as well.”…””}”(hj6h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj%h²hubeh}”(h]”Œsupported-devices”ah ]”h"]”Œsupported devices”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒStatus”h]”hŒStatus”…””}”(hjOh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjLh²hh³hÇh´KubhÞ)”}”(hŒ/The following features are currently supported:”h]”hŒ/The following features are currently supported:”…””}”(hj]h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjLh²hubhŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ6:ref:`Keyboard backlight ` control”h]”hÞ)”}”(hjth]”(h)”}”(hŒ.:ref:`Keyboard backlight `”h]”hŒinline”“”)”}”(hj{h]”hŒKeyboard backlight”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j}hjyubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ&admin-guide/laptops/samsung-galaxybook”Œ refdomain”jŠŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆŒ reftarget”Œkeyboard-backlight”uh1hh³hÇh´KhjvubhŒ control”…””}”(hjvh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjrubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjmh²hh³hÇh´Nubjq)”}”(hŒc:ref:`Performance mode ` control implemented using the platform profile interface”h]”hÞ)”}”(hŒc:ref:`Performance mode ` control implemented using the platform profile interface”h]”(h)”}”(hŒ*:ref:`Performance mode `”h]”j~)”}”(hj¸h]”hŒPerformance mode”…””}”(hjºh²hh³Nh´Nubah}”(h]”h ]”(j‰Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j}hj¶ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j–Œ refdomain”jÄŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjœŒperformance-mode”uh1hh³hÇh´Khj²ubhŒ9 control implemented using the platform profile interface”…””}”(hj²h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj®ubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjmh²hh³hÇh´Nubjq)”}”(hŒ¢:ref:`Battery charge control end threshold ` (stop charging battery at given percentage value) implemented as a battery hook”h]”hÞ)”}”(hŒ¢:ref:`Battery charge control end threshold ` (stop charging battery at given percentage value) implemented as a battery hook”h]”(h)”}”(hŒR:ref:`Battery charge control end threshold `”h]”j~)”}”(hjðh]”hŒ$Battery charge control end threshold”…””}”(hjòh²hh³Nh´Nubah}”(h]”h ]”(j‰Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j}hjîubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j–Œ refdomain”jüŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjœŒ$battery-charge-control-end-threshold”uh1hh³hÇh´KhjêubhŒP (stop charging battery at given percentage value) implemented as a battery hook”…””}”(hjêh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjæubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjmh²hh³hÇh´Nubjq)”}”(hŒ\:ref:`Firmware Attributes ` to allow control of various device settings”h]”hÞ)”}”(hŒ\:ref:`Firmware Attributes ` to allow control of various device settings”h]”(h)”}”(hŒ0:ref:`Firmware Attributes `”h]”j~)”}”(hj(h]”hŒFirmware Attributes”…””}”(hj*h²hh³Nh´Nubah}”(h]”h ]”(j‰Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j}hj&ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j–Œ refdomain”j4Œreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjœŒfirmware-attributes”uh1hh³hÇh´K hj"ubhŒ, to allow control of various device settings”…””}”(hj"h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjmh²hh³hÇh´Nubjq)”}”(hŒK:ref:`Handling of Fn hotkeys ` for various actions”h]”hÞ)”}”(hjXh]”(h)”}”(hŒ7:ref:`Handling of Fn hotkeys `”h]”j~)”}”(hj_h]”hŒHandling of Fn hotkeys”…””}”(hjah²hh³Nh´Nubah}”(h]”h ]”(j‰Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j}hj]ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j–Œ refdomain”jkŒreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjœŒkeyboard-hotkey-actions”uh1hh³hÇh´K"hjZubhŒ for various actions”…””}”(hjZh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K"hjVubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjmh²hh³hÇh´Nubjq)”}”(hŒZ:ref:`Handling of ACPI notifications and hotkeys ` ”h]”hÞ)”}”(hŒY:ref:`Handling of ACPI notifications and hotkeys `”h]”h)”}”(hj“h]”j~)”}”(hj“h]”hŒ*Handling of ACPI notifications and hotkeys”…””}”(hj˜h²hh³Nh´Nubah}”(h]”h ]”(j‰Œstd”Œstd-ref”eh"]”h$]”h&]”uh1j}hj•ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j–Œ refdomain”j¢Œreftype”Œref”Œ refexplicit”ˆŒrefwarn”ˆjœŒ%acpi-notifications-and-hotkey-actions”uh1hh³hÇh´K#hj‘ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K#hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjmh²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jkh³hÇh´KhjLh²hubhÞ)”}”(hX…Because different models of these devices can vary in their features, there is logic built within the driver which attempts to test each implemented feature for a valid response before enabling its support (registering additional devices or extensions, adding sysfs attributes, etc). Therefore, it can be important to note that not all features may be supported for your particular device.”h]”hX…Because different models of these devices can vary in their features, there is logic built within the driver which attempts to test each implemented feature for a valid response before enabling its support (registering additional devices or extensions, adding sysfs attributes, etc). Therefore, it can be important to note that not all features may be supported for your particular device.”…””}”(hjÈh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K&hjLh²hubhÞ)”}”(hŒThe following features might be possible to implement but will require additional investigation and are therefore not supported at this time:”h]”hŒThe following features might be possible to implement but will require additional investigation and are therefore not supported at this time:”…””}”(hjÖh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K,hjLh²hubjl)”}”(hhh]”(jq)”}”(hŒ#"Dolby Atmos" mode for the speakers”h]”hÞ)”}”(hjéh]”hŒ'“Dolby Atmos†mode for the speakers”…””}”(hjëh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K/hjçubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjäh²hh³hÇh´Nubjq)”}”(hŒJ"Outdoor Mode" for increasing screen brightness on models with ``SAM0427``”h]”hÞ)”}”(hjh]”(hŒC“Outdoor Mode†for increasing screen brightness on models with ”…””}”(hjh²hh³Nh´Nubj )”}”(hŒ ``SAM0427``”h]”hŒSAM0427”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K0hjþubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjäh²hh³hÇh´Nubjq)”}”(hŒ)"Silent Mode" on models with ``SAM0427`` ”h]”hÞ)”}”(hŒ("Silent Mode" on models with ``SAM0427``”h]”(hŒ!“Silent Mode†on models with ”…””}”(hj'h²hh³Nh´Nubj )”}”(hŒ ``SAM0427``”h]”hŒSAM0427”…””}”(hj/h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj'ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K1hj#ubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjäh²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”jÆjÇuh1jkh³hÇh´K/hjLh²hubhŒtarget”“”)”}”(hŒ.. _keyboard-backlight:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œkeyboard-backlight”uh1jOh´K3hjLh²hh³hÇubeh}”(h]”Œstatus”ah ]”h"]”Œstatus”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒKeyboard backlight”h]”hŒKeyboard backlight”…””}”(hjhh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjeh²hh³hÇh´K6ubhÞ)”}”(hX\A new LED class named ``samsung-galaxybook::kbd_backlight`` is created which will then expose the device using the standard sysfs-based LED interface at ``/sys/class/leds/samsung-galaxybook::kbd_backlight``. Brightness can be controlled by writing the desired value to the ``brightness`` sysfs attribute or with any other desired userspace utility.”h]”(hŒA new LED class named ”…””}”(hjvh²hh³Nh´Nubj )”}”(hŒ%``samsung-galaxybook::kbd_backlight``”h]”hŒ!samsung-galaxybook::kbd_backlight”…””}”(hj~h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjvubhŒ^ is created which will then expose the device using the standard sysfs-based LED interface at ”…””}”(hjvh²hh³Nh´Nubj )”}”(hŒ5``/sys/class/leds/samsung-galaxybook::kbd_backlight``”h]”hŒ1/sys/class/leds/samsung-galaxybook::kbd_backlight”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjvubhŒC. Brightness can be controlled by writing the desired value to the ”…””}”(hjvh²hh³Nh´Nubj )”}”(hŒ``brightness``”h]”hŒ brightness”…””}”(hj¢h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjvubhŒ= sysfs attribute or with any other desired userspace utility.”…””}”(hjvh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K8hjeh²hubhŒnote”“”)”}”(hŒ×Most of these devices have an ambient light sensor which also turns off the keyboard backlight under well-lit conditions. This behavior does not seem possible to control at this time, but can be good to be aware of.”h]”hÞ)”}”(hŒ×Most of these devices have an ambient light sensor which also turns off the keyboard backlight under well-lit conditions. This behavior does not seem possible to control at this time, but can be good to be aware of.”h]”hŒ×Most of these devices have an ambient light sensor which also turns off the keyboard backlight under well-lit conditions. This behavior does not seem possible to control at this time, but can be good to be aware of.”…””}”(hjÀh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K?hj¼ubah}”(h]”h ]”h"]”h$]”h&]”uh1jºhjeh²hh³hÇh´NubjP)”}”(hŒ.. _performance-mode:”h]”h}”(h]”h ]”h"]”h$]”h&]”j[Œperformance-mode”uh1jOh´KChjeh²hh³hÇubeh}”(h]”(j\Œid1”eh ]”h"]”(Œkeyboard backlight”Œkeyboard-backlight”eh$]”h&]”uh1hÈhhÊh²hh³hÇh´K6Œexpect_referenced_by_name”}”jåjQsŒexpect_referenced_by_id”}”j\jQsubhÉ)”}”(hhh]”(hÎ)”}”(hŒPerformance mode”h]”hŒPerformance mode”…””}”(hjïh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjìh²hh³hÇh´KFubhÞ)”}”(hŒ¨This driver implements the Documentation/userspace-api/sysfs-platform_profile.rst interface for working with the "performance mode" function of the Samsung ACPI device.”h]”hŒ¬This driver implements the Documentation/userspace-api/sysfs-platform_profile.rst interface for working with the “performance mode†function of the Samsung ACPI device.”…””}”(hjýh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KHhjìh²hubhÞ)”}”(hŒðMapping of each Samsung "performance mode" to its respective platform profile is performed dynamically by the driver, as not all models support all of the same performance modes. Your device might have one or more of the following mappings:”h]”hŒôMapping of each Samsung “performance mode†to its respective platform profile is performed dynamically by the driver, as not all models support all of the same performance modes. Your device might have one or more of the following mappings:”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KLhjìh²hubjl)”}”(hhh]”(jq)”}”(hŒ"Silent" maps to ``low-power``”h]”hÞ)”}”(hjh]”(hŒ“Silent†maps to ”…””}”(hj h²hh³Nh´Nubj )”}”(hŒ ``low-power``”h]”hŒ low-power”…””}”(hj'h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KPhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjh²hh³hÇh´Nubjq)”}”(hŒ"Quiet" maps to ``quiet``”h]”hÞ)”}”(hjCh]”(hŒ“Quiet†maps to ”…””}”(hjEh²hh³Nh´Nubj )”}”(hŒ ``quiet``”h]”hŒquiet”…””}”(hjLh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjEubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KQhjAubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjh²hh³hÇh´Nubjq)”}”(hŒ "Optimized" maps to ``balanced``”h]”hÞ)”}”(hjhh]”(hŒ“Optimized†maps to ”…””}”(hjjh²hh³Nh´Nubj )”}”(hŒ ``balanced``”h]”hŒbalanced”…””}”(hjqh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjjubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KRhjfubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjh²hh³hÇh´Nubjq)”}”(hŒ+"High performance" maps to ``performance`` ”h]”hÞ)”}”(hŒ*"High performance" maps to ``performance``”h]”(hŒ“High performance†maps to ”…””}”(hjh²hh³Nh´Nubj )”}”(hŒ``performance``”h]”hŒ performance”…””}”(hj—h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KShj‹ubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjh²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”jÆjÇuh1jkh³hÇh´KPhjìh²hubhÞ)”}”(hXThe result of the mapping can be printed in the kernel log when the module is loaded. Supported profiles can also be retrieved from ``/sys/firmware/acpi/platform_profile_choices``, while ``/sys/firmware/acpi/platform_profile`` can be used to read or write the currently selected profile.”h]”(hŒ„The result of the mapping can be printed in the kernel log when the module is loaded. Supported profiles can also be retrieved from ”…””}”(hj·h²hh³Nh´Nubj )”}”(hŒ/``/sys/firmware/acpi/platform_profile_choices``”h]”hŒ+/sys/firmware/acpi/platform_profile_choices”…””}”(hj¿h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj·ubhŒ, while ”…””}”(hj·h²hh³Nh´Nubj )”}”(hŒ'``/sys/firmware/acpi/platform_profile``”h]”hŒ#/sys/firmware/acpi/platform_profile”…””}”(hjÑh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj·ubhŒ= can be used to read or write the currently selected profile.”…””}”(hj·h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KUhjìh²hubhÞ)”}”(hŒgThe ``balanced`` platform profile will be set during module load if no profile has been previously set.”h]”(hŒThe ”…””}”(hjéh²hh³Nh´Nubj )”}”(hŒ ``balanced``”h]”hŒbalanced”…””}”(hjñh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjéubhŒW platform profile will be set during module load if no profile has been previously set.”…””}”(hjéh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K[hjìh²hubjP)”}”(hŒ).. _battery-charge-control-end-threshold:”h]”h}”(h]”h ]”h"]”h$]”h&]”j[Œ$battery-charge-control-end-threshold”uh1jOh´K^hjìh²hh³hÇubeh}”(h]”(jÞŒid2”eh ]”h"]”(Œperformance mode”Œperformance-mode”eh$]”h&]”uh1hÈhhÊh²hh³hÇh´KFjè}”jjÔsjê}”jÞjÔsubhÉ)”}”(hhh]”(hÎ)”}”(hŒ$Battery charge control end threshold”h]”hŒ$Battery charge control end threshold”…””}”(hj"h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjh²hh³hÇh´KaubhÞ)”}”(hŒ”This platform driver will add the ability to set the battery's charge control end threshold, but does not have the ability to set a start threshold.”h]”hŒ–This platform driver will add the ability to set the battery’s charge control end threshold, but does not have the ability to set a start threshold.”…””}”(hj0h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kchjh²hubhÞ)”}”(hXThis feature is typically called "Battery Saver" by the various Samsung applications in Windows, but in Linux we have implemented the standardized "charge control threshold" sysfs interface on the battery device to allow for controlling this functionality from the userspace.”h]”hXThis feature is typically called “Battery Saver†by the various Samsung applications in Windows, but in Linux we have implemented the standardized “charge control threshold†sysfs interface on the battery device to allow for controlling this functionality from the userspace.”…””}”(hj>h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kfhjh²hubhÞ)”}”(hŒŽThe sysfs attribute ``/sys/class/power_supply/BAT1/charge_control_end_threshold`` can be used to read or set the desired charge end threshold.”h]”(hŒThe sysfs attribute ”…””}”(hjLh²hh³Nh´Nubj )”}”(hŒ=``/sys/class/power_supply/BAT1/charge_control_end_threshold``”h]”hŒ9/sys/class/power_supply/BAT1/charge_control_end_threshold”…””}”(hjTh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjLubhŒ= can be used to read or set the desired charge end threshold.”…””}”(hjLh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kkhjh²hubhÞ)”}”(hXgIf you wish to maintain interoperability with the Samsung Settings application in Windows, then you should set the value to 100 to represent "off", or enable the feature using only one of the following values: 50, 60, 70, 80, or 90. Otherwise, the driver will accept any value between 1 and 100 as the percentage that you wish the battery to stop charging at.”h]”hXkIf you wish to maintain interoperability with the Samsung Settings application in Windows, then you should set the value to 100 to represent “offâ€, or enable the feature using only one of the following values: 50, 60, 70, 80, or 90. Otherwise, the driver will accept any value between 1 and 100 as the percentage that you wish the battery to stop charging at.”…””}”(hjlh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kohjh²hubj»)”}”(hŒ‹Some devices have been observed as automatically "turning off" the charge control end threshold if an input value of less than 30 is given.”h]”hÞ)”}”(hŒ‹Some devices have been observed as automatically "turning off" the charge control end threshold if an input value of less than 30 is given.”h]”hŒSome devices have been observed as automatically “turning off†the charge control end threshold if an input value of less than 30 is given.”…””}”(hj~h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kvhjzubah}”(h]”h ]”h"]”h$]”h&]”uh1jºhjh²hh³hÇh´NubjP)”}”(hŒ.. _firmware-attributes:”h]”h}”(h]”h ]”h"]”h$]”h&]”j[Œfirmware-attributes”uh1jOh´Kyhjh²hh³hÇubeh}”(h]”(jŒid3”eh ]”h"]”(Œ$battery charge control end threshold”Œ$battery-charge-control-end-threshold”eh$]”h&]”uh1hÈhhÊh²hh³hÇh´Kajè}”j£j sjê}”jj subhÉ)”}”(hhh]”(hÎ)”}”(hŒFirmware Attributes”h]”hŒFirmware Attributes”…””}”(hj«h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj¨h²hh³hÇh´K|ubhÞ)”}”(hŒÌThe following enumeration-typed firmware attributes are set up by this driver and should be accessible under ``/sys/class/firmware-attributes/samsung-galaxybook/attributes/`` if your device supports them:”h]”(hŒmThe following enumeration-typed firmware attributes are set up by this driver and should be accessible under ”…””}”(hj¹h²hh³Nh´Nubj )”}”(hŒA``/sys/class/firmware-attributes/samsung-galaxybook/attributes/``”h]”hŒ=/sys/class/firmware-attributes/samsung-galaxybook/attributes/”…””}”(hjÁh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj¹ubhŒ if your device supports them:”…””}”(hj¹h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K~hj¨h²hubjl)”}”(hhh]”(jq)”}”(hŒE``power_on_lid_open`` (device should power on when the lid is opened)”h]”hÞ)”}”(hjÞh]”(j )”}”(hŒ``power_on_lid_open``”h]”hŒpower_on_lid_open”…””}”(hjãh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjàubhŒ0 (device should power on when the lid is opened)”…””}”(hjàh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KƒhjÜubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjÙh²hh³hÇh´Nubjq)”}”(hŒ€``usb_charging`` (USB ports can deliver power to connected devices even when the device is powered off or in a low sleep state)”h]”hÞ)”}”(hŒ€``usb_charging`` (USB ports can deliver power to connected devices even when the device is powered off or in a low sleep state)”h]”(j )”}”(hŒ``usb_charging``”h]”hŒ usb_charging”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjubhŒp (USB ports can deliver power to connected devices even when the device is powered off or in a low sleep state)”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K„hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjÙh²hh³hÇh´Nubjq)”}”(hŒ=``block_recording`` (blocks access to camera and microphone) ”h]”hÞ)”}”(hŒ<``block_recording`` (blocks access to camera and microphone)”h]”(j )”}”(hŒ``block_recording``”h]”hŒblock_recording”…””}”(hj/h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj+ubhŒ) (blocks access to camera and microphone)”…””}”(hj+h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K†hj'ubah}”(h]”h ]”h"]”h$]”h&]”uh1jphjÙh²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”jÆjÇuh1jkh³hÇh´Kƒhj¨h²hubhÞ)”}”(hŒÊAll of these attributes are simple boolean-like enumeration values which use 0 to represent "off" and 1 to represent "on". Use the ``current_value`` attribute to get or change the setting on the device.”h]”(hŒ‹All of these attributes are simple boolean-like enumeration values which use 0 to represent “off†and 1 to represent “onâ€. Use the ”…””}”(hjSh²hh³Nh´Nubj )”}”(hŒ``current_value``”h]”hŒ current_value”…””}”(hj[h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjSubhŒ6 attribute to get or change the setting on the device.”…””}”(hjSh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kˆhj¨h²hubhÞ)”}”(hŒ·Note that when ``block_recording`` is updated, the input device "Samsung Galaxy Book Lens Cover" will receive a ``SW_CAMERA_LENS_COVER`` switch event which reflects the current state.”h]”(hŒNote that when ”…””}”(hjsh²hh³Nh´Nubj )”}”(hŒ``block_recording``”h]”hŒblock_recording”…””}”(hj{h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjsubhŒR is updated, the input device “Samsung Galaxy Book Lens Cover†will receive a ”…””}”(hjsh²hh³Nh´Nubj )”}”(hŒ``SW_CAMERA_LENS_COVER``”h]”hŒSW_CAMERA_LENS_COVER”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjsubhŒ/ switch event which reflects the current state.”…””}”(hjsh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KŒhj¨h²hubjP)”}”(hŒ.. _keyboard-hotkey-actions:”h]”h}”(h]”h ]”h"]”h$]”h&]”j[Œkeyboard-hotkey-actions”uh1jOh´Khj¨h²hh³hÇubeh}”(h]”(jœŒid4”eh ]”h"]”(Œfirmware attributes”Œfirmware-attributes”eh$]”h&]”uh1hÈhhÊh²hh³hÇh´K|jè}”j¶j’sjê}”jœj’subhÉ)”}”(hhh]”(hÎ)”}”(hŒ&Keyboard hotkey actions (i8042 filter)”h]”hŒ&Keyboard hotkey actions (i8042 filter)”…””}”(hj¾h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj»h²hh³hÇh´K“ubhÞ)”}”(hŒÖThe i8042 filter will swallow the keyboard events for the Fn+F9 hotkey (Multi- level keyboard backlight toggle) and Fn+F10 hotkey (Block recording toggle) and instead execute their actions within the driver itself.”h]”hŒÖThe i8042 filter will swallow the keyboard events for the Fn+F9 hotkey (Multi- level keyboard backlight toggle) and Fn+F10 hotkey (Block recording toggle) and instead execute their actions within the driver itself.”…””}”(hjÌh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K•hj»h²hubhÞ)”}”(hXoFn+F9 will cycle through the brightness levels of the keyboard backlight. A notification will be sent using ``led_classdev_notify_brightness_hw_changed`` so that the userspace can be aware of the change. This mimics the behavior of other existing devices where the brightness level is cycled internally by the embedded controller and then reported via a notification.”h]”(hŒlFn+F9 will cycle through the brightness levels of the keyboard backlight. A notification will be sent using ”…””}”(hjÚh²hh³Nh´Nubj )”}”(hŒ-``led_classdev_notify_brightness_hw_changed``”h]”hŒ)led_classdev_notify_brightness_hw_changed”…””}”(hjâh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hjÚubhŒÖ so that the userspace can be aware of the change. This mimics the behavior of other existing devices where the brightness level is cycled internally by the embedded controller and then reported via a notification.”…””}”(hjÚh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K™hj»h²hubhÞ)”}”(hŒÃFn+F10 will toggle the value of the "block recording" setting, which blocks or allows usage of the built-in camera and microphone (and generates the same Lens Cover switch event mentioned above).”h]”hŒÇFn+F10 will toggle the value of the “block recording†setting, which blocks or allows usage of the built-in camera and microphone (and generates the same Lens Cover switch event mentioned above).”…””}”(hjúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KŸhj»h²hubjP)”}”(hŒ*.. _acpi-notifications-and-hotkey-actions:”h]”h}”(h]”h ]”h"]”h$]”h&]”j[Œ%acpi-notifications-and-hotkey-actions”uh1jOh´K£hj»h²hh³hÇubeh}”(h]”(Œ$keyboard-hotkey-actions-i8042-filter”j¯eh ]”h"]”(Œ&keyboard hotkey actions (i8042 filter)”Œkeyboard-hotkey-actions”eh$]”h&]”uh1hÈhhÊh²hh³hÇh´K“jè}”jj¥sjê}”j¯j¥subhÉ)”}”(hhh]”(hÎ)”}”(hŒ%ACPI notifications and hotkey actions”h]”hŒ%ACPI notifications and hotkey actions”…””}”(hj!h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjh²hh³hÇh´K¦ubhÞ)”}”(hŒÿACPI notifications will generate ACPI netlink events under the device class ``samsung-galaxybook`` and bus ID matching the Samsung ACPI device ID found on your device. The events can be received using userspace tools such as ``acpi_listen`` and ``acpid``.”h]”(hŒLACPI notifications will generate ACPI netlink events under the device class ”…””}”(hj/h²hh³Nh´Nubj )”}”(hŒ``samsung-galaxybook``”h]”hŒsamsung-galaxybook”…””}”(hj7h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj/ubhŒ and bus ID matching the Samsung ACPI device ID found on your device. The events can be received using userspace tools such as ”…””}”(hj/h²hh³Nh´Nubj )”}”(hŒ``acpi_listen``”h]”hŒ acpi_listen”…””}”(hjIh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj/ubhŒ and ”…””}”(hj/h²hh³Nh´Nubj )”}”(hŒ ``acpid``”h]”hŒacpid”…””}”(hj[h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j hj/ubhŒ.”…””}”(hj/h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K¨hjh²hubhÞ)”}”(hŒ‚The Fn+F11 Performance mode hotkey will be handled by the driver; each keypress will cycle to the next available platform profile.”h]”hŒ‚The Fn+F11 Performance mode hotkey will be handled by the driver; each keypress will cycle to the next available platform profile.”…””}”(hjsh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K­hjh²hubeh}”(h]”(jŒid5”eh ]”h"]”(Œ%acpi notifications and hotkey actions”Œ%acpi-notifications-and-hotkey-actions”eh$]”h&]”uh1hÈhhÊh²hh³hÇh´K¦jè}”j‡jsjê}”jjsubeh}”(h]”Œsamsung-galaxy-book-driver”ah ]”h"]”Œsamsung galaxy book driver”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÍNŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j·Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”(j\]”jQajÞ]”jÔaj]”j ajœ]”j’aj¯]”j¥aj]”jauŒnameids”}”(j‘jŽjIjFjbj_jåj\jäjájjÞjjj£jj¢jŸj¶jœjµj²jj¯jjj‡jj†jƒuŒ nametypes”}”(j‘‰jI‰jb‰jåˆjä‰jˆj‰j£ˆj¢‰j¶ˆjµ‰jˆj‰j‡ˆj†‰uh}”(jŽhÊjFj%j_jLj\jejájejÞjìjjìjjjŸjjœj¨j²j¨j¯j»jj»jjjƒjuŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”jÅKs…”R”Œparse_messages”]”Œtransform_messages”]”(hŒsystem_message”“”)”}”(hhh]”hÞ)”}”(hhh]”hŒ8Hyperlink target "keyboard-backlight" is not referenced.”…””}”hj&sbah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhj#ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hÇŒline”K3uh1j!ubj")”}”(hhh]”hÞ)”}”(hhh]”hŒ6Hyperlink target "performance-mode" is not referenced.”…””}”hjAsbah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhj>ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”j;Œsource”hÇŒline”KCuh1j!ubj")”}”(hhh]”hÞ)”}”(hhh]”hŒJHyperlink target "battery-charge-control-end-threshold" is not referenced.”…””}”hj[sbah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhjXubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”j;Œsource”hÇŒline”K^uh1j!ubj")”}”(hhh]”hÞ)”}”(hhh]”hŒ9Hyperlink target "firmware-attributes" is not referenced.”…””}”hjusbah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhjrubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”j;Œsource”hÇŒline”Kyuh1j!ubj")”}”(hhh]”hÞ)”}”(hhh]”hŒ=Hyperlink target "keyboard-hotkey-actions" is not referenced.”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhjŒubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”j;Œsource”hÇŒline”Kuh1j!ubj")”}”(hhh]”hÞ)”}”(hhh]”hŒKHyperlink target "acpi-notifications-and-hotkey-actions" is not referenced.”…””}”hj©sbah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhj¦ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”j;Œsource”hÇŒline”K£uh1j!ubeŒ transformer”NŒ include_log”]”Œ decoration”Nh²hub.