Page MenuHomeFreeBSD
Files F170962257

D59470.id186081.diff
No OneTemporary
Actions

D59470.id186081.diff
View Options

diff --git a/share/man/man4/asmc.4 b/share/man/man4/asmc.4
--- a/share/man/man4/asmc.4
+++ b/share/man/man4/asmc.4
@@ -1,70 +1,26 @@
.\"
.\" Copyright (c) 2007, 2008, 2009 Rui Paulo <rpaulo@FreeBSD.org>
-.\" All rights reserved.
+.\" Copyright (c) 2026 Enji Cooper <ngie@FreeBSD.org>
.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
+.\" SPDX-License-Identifier: BSD-2-Clause
.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
-.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
-.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
-.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd March 29, 2026
+.Dd September 6, 2026
.Dt ASMC 4
.Os
.Sh NAME
.Nm asmc
-.Nd device driver for the Apple System Management Controller (SMC)
+.Nd Apple System Management Controller (SMC) driver
.Sh SYNOPSIS
To compile this driver into the kernel, place the following line in your
kernel configuration file:
.Bd -ragged -offset indent
-.Cd "device asmc"
-.Ed
-.Pp
-Alternatively, to load the driver as a
-module at boot time, place the following line in
-.Xr loader.conf 5 :
-.Bd -literal -offset indent
-asmc_load="YES"
-.Ed
+.Cd device asmc
.Sh DESCRIPTION
The
.Nm
driver controls the Apple System Management Controller (SMC for short)
found on Intel Apple systems.
.Pp
-The SMC is known to be found on the following systems:
-.Pp
-.Bl -bullet -offset indent -compact
-.It
-MacBook
-.It
-MacBook Pro
-.It
-Intel MacMini
-.It
-Mac Pro
-.It
-MacBook Air
-.It
-Intel iMac
-.El
-.Pp
With this driver, you can configure your keyboard backlight
brightness, check temperatures of several sensors, check the speed of
the internal fans and check the status of the Sudden Motion Sensor.
@@ -74,10 +30,8 @@
under the device tree
.Va dev.asmc .
.Sh KEYBOARD BACKLIGHT
-On
-.Tn MacBook Pro
-systems, you can control the keyboard brightness by writing a value to
-the
+The keyboard brightness on all laptop models, e.g., MacBook Pro, can be
+controlled by writing a value to the
.Va dev.asmc.%d.light.control
sysctl MIB or with
.Xr backlight 8
@@ -157,30 +111,44 @@
.Pp
The most interesting usage of this device is to park the disk heads
when the laptop is moved harshly.
-First, you need to install
-.Xr ataidle 8 Pq Pa ports/sysutils/ataidle
-and then configure
+Configure
.Xr devd 8
-the following way:
+the following way to automatically part your hard drives using
+.Xr camcontrol 8 :
.Bd -literal -offset indent
notify 0 {
match "system" "ACPI";
match "subsystem" "asmc";
- action "/usr/local/sbin/ataidle -s X Y";
+ action "/sbin/camcontrol idle X";
};
.Ed
.Pp
-Do not forget to change the
+Do not forget to change
.Ar X
-and
-.Ar Y
-values in the command above.
+in the command example to match the target hard drive, e.g.,
+.Da ada0 .
.Pp
Also, please note that parking the disk heads too many times can
dramatically reduce your hard drive's life span.
-Do not rely solely on
-the SMS to protect your hard drive: good care and common sense can
-increase your hard drive's life.
+Do not rely solely on the SMS to protect your hard drive: good care and
+common sense can increase your hard drive's life.
+.Sh HARDWARE
+The Apple SMC is known to be found on the following systems:
+.Pp
+.Bl -bullet -offset indent -compact
+.It
+iMac
+.It
+MacBook
+.It
+MacBook Air
+.It
+MacBook Pro
+.It
+Mac Mini
+.It
+Mac Pro
+.El
.Sh FILES
.Bl -tag -width ".Pa /dev/backlight/asmc0" -compact
.It Pa /dev/backlight/asmc0
@@ -188,8 +156,9 @@
.Xr backlight 8
device node.
.Sh SEE ALSO
-.Xr ataidle 8 Pq Pa ports/sysutils/ataidle ,
+.Xr apple_bce 4 ,
.Xr backlight 8 ,
+.Xr camcontrol 8 ,
.Xr devd 8 ,
.Xr sysctl 8
.Sh HISTORY
@@ -197,9 +166,14 @@
.Nm
driver first appeared in
.Fx 8.0 .
+The driver was heavily modified in
+.Fx 15.1
+to support additional Apple SMC functionality and platforms.
.Sh AUTHORS
.An Rui Paulo Aq Mt rpaulo@FreeBSD.org
-(Google Summer of Code project)
+wrote
+.Nm
+as a 2007 Google Summer of Code project.
.Sh BUGS
-Support for the latest models was never tested and is most likely not
-fully working.
+This driver also supports ARM64 Mac models (in theory), but this has not
+been widely tested yet.

File Metadata

Mime Type
text/plain
Expires
Tue, Sep 8, 9:31 PM (9 h, 11 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
38490265
Default Alt Text
D59470.id186081.diff (5 KB)

Event Timeline