git: 58e1d0102241 - main - cdce: add to cdce.4 information about NCM network mode

From: Warner Losh <imp_at_FreeBSD.org>
Date: Fri, 10 Feb 2023 23:36:40 UTC
The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/src/commit/?id=58e1d01022415e29d3e08c4d3936b6631c27406c

commit 58e1d01022415e29d3e08c4d3936b6631c27406c
Author:     Michael Paepcke <git@paepcke.de>
AuthorDate: 2023-02-10 19:43:09 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2023-02-10 23:28:34 +0000

    cdce: add to cdce.4 information about NCM network mode
    
    add a new section how to use NCM network mode and specify the required
    kernel modules
    
    Reviewed by: imp
    Pull Request: https://github.com/freebsd/freebsd-src/pull/646
---
 share/man/man4/cdce.4 | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/share/man/man4/cdce.4 b/share/man/man4/cdce.4
index b27d89bc1639..99d04bd12d07 100644
--- a/share/man/man4/cdce.4
+++ b/share/man/man4/cdce.4
@@ -28,7 +28,7 @@
 .\" $NetBSD: cdce.4,v 1.4 2004/12/08 18:35:56 peter Exp $
 .\" $FreeBSD$
 .\"
-.Dd July 10, 2019
+.Dd February 10, 2023
 .Dt CDCE 4
 .Os
 .Sh NAME
@@ -47,6 +47,13 @@ kernel configuration file:
 .Cd "device cdce"
 .Ed
 .Pp
+Mobile Devices (eg. Huawei E3372, E5573 and others)
+may need additionally the u3g command port:
+.Bd -ragged -offset indent
+.Cd "device ucom"
+.Cd "device u3g"
+.Ed
+.Pp
 Alternatively, to load the driver as a
 module at boot time, place the following line in
 .Xr loader.conf 5 :
@@ -77,6 +84,13 @@ received and transmitted over separate USB bulk transfer endpoints.
 The
 .Nm
 driver does not support different media types or options.
+.Pp
+Mobile
+.Nm
+Network Devices may need a connect command sequence via u3g
+serial command port before they activate the NCM/ECM/ACM network
+interface. Example: echo 'AT^NDISUP=1,1,"internet"' > /dev/cuaU[0].0,
+where "internet" is your providers apn name.
 .Sh HARDWARE
 The following devices are supported by the
 .Nm
@@ -93,6 +107,8 @@ Terayon TJ-715 DOCSIS Cable Modem
 Realtek RTL8156 USB GBE/2.5G Ethernet Family Controller
 .It
 Planex USB-LAN2500R
+.It
+Huawei 3G/4G LTE (eg. E3372, E5573) and other mobile network devices
 .El
 .Sh DIAGNOSTICS
 .Bl -diag
@@ -127,6 +143,8 @@ is running low on mbufs.
 .Xr netintro 4 ,
 .Xr urndis 4 ,
 .Xr usb 4 ,
+.Xr ucom 4 ,
+.Xr u3g 4 ,
 .Xr ifconfig 8
 .Rs
 .%T "Universal Serial Bus Class Definitions for Communication Devices"