From nobody Mon Sep 21 16:51:40 2026 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4hpTld0VFvz6srvY for ; Mon, 21 Sep 2026 16:51:41 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR2" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hpTlc41Yhz4s4w for ; Mon, 21 Sep 2026 16:51:40 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1790009500; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=0XsnDIgtz0JbVXZiqMfoFlw+Zt5ClnV5rWtPTtPM5vU=; b=W4/olFDz3I3RdupwYsTLHCHPEOI4zowM09DnZdCDS9mGlNEXmep0zy7B7i3pxPXz9EBENk cuAjrxr3jvREtH7GtPA7BgXUyvkHyFS9Q6j1AXadO4o9HIgEYhr3IPjCTUtQPYPDkJOdg9 E7tRaNz8gu4Uf1HMRc6ogIc/Hnhx+a0zwHUnbMENKHrEE2pke1nbHDDPZiKSJOPmUwwYfh 1MqPXcS+8Btw0DzvplJtyX9MOY0dgI68slvykiJu8ZM/HYZzav4PrfBAfFKblUv4SVrvbd XjoLhqU7ZlKe7WQwdCw6/qq7HZ30Y03+1LXgxcAzf59EXD+emovnUUfs8e3rUw== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1790009500; b=qtvhgY1pnY1Eidy66HyerRtm603GUMRPr5a7jjSICfl0mz9MzASxXVL9GI7f0830pQHuB8 iU57i/em+io0vwdM6Osq/Wxy9GAl7VzKBLmti8WcGkf7Qt5JP+daoPEtVacDY/a1LcDLuV VGBTM2onEWm253k5xnfDluGJYXnm5i8WiUZ7mMhl5tvuuwxo/LMGLbsyarqD8IwT0UYdVM 6W5AqdxtUYgSjSrBSBLMegZ6UG4Pzo4qH1M/n6HENV7XixRK0zNaDohBzV2CRZ4JeDw5H4 sh9lFZFn2OtlzClnjc5w13pnRSC52Nee0Kz3hNwru3ecKVXxSIIt4zMK3ViJYg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1790009500; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=0XsnDIgtz0JbVXZiqMfoFlw+Zt5ClnV5rWtPTtPM5vU=; b=fMsxnat0uqhX7L2pxShH1VBeCt4Fm9gW2wpAZFFCCO4t+cWHZ1TCJSzB5mIq305qN71HIF vw6OP6h7eU1o5TWSAZ4wG5dcXbjCgkV2kcYgGYipgi6BVC1nm7PPdVRZDg6fr6j+e7EAZ0 dvWY1hMllBKuD5T7eG5kppkpoqyR1mzjxhrswZSTCZCGsKAccYqHQRI/heJ9L2fsCIlaiZ budC42RZq7A8uSt90Vu17z9kSQs350EVxxvtGITjRoh2lVsU9OhBnd4BoPrPz/z2jzNwPr kk0OcREy6wQrx8jzFUvfppB+tXByeh/mT11FCqmhcz6Mv0sKpJlaASa7hA1ltw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hpTlc0WRGzSSC for ; Mon, 21 Sep 2026 16:51:40 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 39579 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Mon, 21 Sep 2026 16:51:40 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Alexander Ziaee Subject: git: 2407b84c6835 - main - uhso.4: describe better, SYNOPSIS, HARDWARE, SPDX List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2407b84c683582ad2fb8840df5a13637d0a8f405 Auto-Submitted: auto-generated Date: Mon, 21 Sep 2026 16:51:40 +0000 Message-Id: <6ab1609c.39579.126c2a23@gitrepo.freebsd.org> The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=2407b84c683582ad2fb8840df5a13637d0a8f405 commit 2407b84c683582ad2fb8840df5a13637d0a8f405 Author: Alexander Ziaee AuthorDate: 2026-09-21 16:43:06 +0000 Commit: Alexander Ziaee CommitDate: 2026-09-21 16:49:05 +0000 uhso.4: describe better, SYNOPSIS, HARDWARE, SPDX + Update SYNOPSIS to the new standard format + Give this a clearer description in apropos + Give this a clearer description in hardware note + Spinoff SYSCTL VARIABLES from HARDWARE + Pet linter for long lines and trailing punctuation + Tag SPDX MFC after: 3 days --- share/man/man4/uhso.4 | 55 ++++++++++++++++++++++++++++++--------------------- 1 file changed, 33 insertions(+), 22 deletions(-) diff --git a/share/man/man4/uhso.4 b/share/man/man4/uhso.4 index d88c925212eb..f91a7837085e 100644 --- a/share/man/man4/uhso.4 +++ b/share/man/man4/uhso.4 @@ -1,3 +1,6 @@ +.\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" .\" Copyright (c) 2009 Fredrik Lindberg .\" All rights reserved. .\" @@ -21,23 +24,30 @@ .\" (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 July 20, 2010 +.Dd September 21, 2026 .Dt UHSO 4 .Os .Sh NAME .Nm uhso -.Nd support for several HSxPA devices from Option N.V. +.Nd USB support for Option N.V. HSxPA 3G cellular modems .Sh SYNOPSIS -The module can be loaded at boot time by placing the following line in +.Cd device usb +.Cd device uhso +.Pp +In .Xr loader.conf 5 : -.Bd -literal -offset indent -uhso_load="YES" -.Ed +.Cd uhso_load="YES" +.Pp +In +.Xr loader.conf 5 +or +.Xr sysctl.conf 5 : +.Cd hw.usb.uhso.auto_switch .Sh DESCRIPTION The .Nm -driver provides support for several HSxPA devices from Option N.V. that are -based on their packet interface. +driver provides support for several HSxPA devices from Option N.V. +that are based on their packet interface. Each device has a set of serial ports and a raw IP packet interface. The serial ports of the device are accessed through the .Xr ucom 4 @@ -46,32 +56,33 @@ driver which makes them behave like devices. The packet interface is exposed as a network interface. .Pp -Establishing a connection on the packet interface is achieved by using the -proprietary AT commands +Establishing a connection on the packet interface is achieved by using +the proprietary AT commands .Dq Li AT_OWANCALL and .Dq Li AT_OWANDATA on any of the available serial ports. .Pp -The network interface must be configured manually using the data obtain from -these calls. +The network interface must be configured manually +using the data obtained from these calls. .Pp -Each device usually have at least two or more serial ports, their individual purpose -can be identified through +Each device usually have at least two or more serial ports, +their individual purpose can be identified through .Xr sysctl 8 . Ports identified as .Dq Modem features a normal modem interface that can be used with PPP. Ports identified as .Dq Diagnostic -uses a proprietary binary interface used for firmware upgrades, this port does not +uses a proprietary binary interface used for firmware upgrades, +this port does not have a AT command interface and can not be used to control the device. -Other ports features an AT command interface that can be used for normal device control. +Other ports features an AT command interface that can be used for normal +device control. .Sh HARDWARE The .Nm -driver should work with most devices from Option. -The following devices have been verified to work +driver supports the following Option N.V. HSxPA 3G cellular modems: .Pp .Bl -bullet -compact .It @@ -85,7 +96,7 @@ Option iCON 452 .It Option iCON 505 .El -.Pp +.Sh SYSCTL VARIABLES The device features a mass storage device referred to as .Dq Zero-CD which contains drivers for Microsoft Windows; this is the default @@ -101,11 +112,11 @@ to 0 using .Xr sysctl 8 . .Sh FILES .Bl -tag -width "XXXXXX" -.It Pa /dev/cuaU?.? +.It Pa /dev/cuaU?.?\& .El .Sh EXAMPLES -Establishing a packet interface connection using the AT command interface available -at one of the serial ports +Establish a packet interface connection using the AT command interface +available at one of the serial ports .Bd -literal -offset indent AT+CGDCONT=1,,"apn.provider" AT_OWANCALL=1,1,1