1.\" Copyright (c) 2006 Takanori Watanabe. 2.\" All rights reserved. 3.\" 4.\" This code is derived from software contributed to The NetBSD Foundation 5.\" by Lennart Augustsson. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 17.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 18.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 19.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 20.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 21.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 22.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 23.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 24.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 25.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 26.\" POSSIBILITY OF SUCH DAMAGE. 27.\"
| 1.\" Copyright (c) 2006 Takanori Watanabe. 2.\" All rights reserved. 3.\" 4.\" This code is derived from software contributed to The NetBSD Foundation 5.\" by Lennart Augustsson. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 17.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 18.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 19.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 20.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 21.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 22.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 23.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 24.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 25.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 26.\" POSSIBILITY OF SUCH DAMAGE. 27.\"
|
28.\" $FreeBSD: head/share/man/man4/ufoma.4 162871 2006-09-30 15:14:49Z ru $
| 28.\" $FreeBSD: head/share/man/man4/ufoma.4 164524 2006-11-22 21:30:02Z brueffer $
|
29.\"
| 29.\"
|
30.Dd January 10, 2006
| 30.Dd November 22, 2006
|
31.Dt UFOMA 4 32.Os 33.Sh NAME 34.Nm ufoma 35.Nd USB mobile phone support 36.Sh SYNOPSIS
| 31.Dt UFOMA 4 32.Os 33.Sh NAME 34.Nm ufoma 35.Nd USB mobile phone support 36.Sh SYNOPSIS
|
| 37To compile this driver into the kernel, 38place the following lines in your 39kernel configuration file: 40.Bd -ragged -offset indent
|
37.Cd "device ufoma" 38.Cd "device ucom"
| 41.Cd "device ufoma" 42.Cd "device ucom"
|
| 43.Ed 44.Pp 45Alternatively, to load the driver as a 46module at boot time, place the following line in 47.Xr loader.conf 5 : 48.Bd -literal -offset indent 49ufoma_load="YES" 50.Ed
|
39.Sh DESCRIPTION 40The 41.Nm 42driver provides support for USB mobile phone terminals in the subset of 43the Mobile Computing Promotion Consortium USB Implementation Guideline, 44which is adopted by FOMA, the NTT DoCoMo 3G system, terminal. 45These are partly like CDC ACM model based modems, which are supported 46by 47.Xr umodem 4 , 48but the 49.Nm 50driver recognizes a specific USB descriptor that describes its role and 51interface structure, and it will negotiate its role when the device is open. 52They support a regular AT command set and 53the commands can either be multiplexed with the data stream 54or handled through separate pipes. 55In the latter case the AT 56commands have to be given on a device separate from the data device. 57.Pp 58The device is accessed through the 59.Xr ucom 4 60driver which makes it behave like a 61.Xr tty 4 . 62.Sh SYSCTLS 63These devices often have a few interface sets and these interfaces 64have their role, sometimes multiplexed. 65These roles are identified with the following sysctl MIBs: 66.Bl -tag -width indent 67.It Va dev.ucom.%d.supportmode 68The modes which are supported by the interface. 69.It Va dev.ucom.%d.currentmode 70Current mode of the interface. 71.It Va dev.ucom.%d.openmode 72Mode to transit when the device is open next. 73.El 74The modes are as follows: 75.Bl -tag -width indent 76.It Li modem 77Accepts AT commands and go and pass packet communication data. 78.It Li handsfree 79Accepts AT commands but it does not pass data. 80.It Li obex 81Accepts OBEX frame which is used to exchange telephone book, etc. 82.It Li vendor1 , vendor2 83Vendor specific data may be passed. 84.It Li deactivated 85When an interface is recognized by the system but not used, the interface 86will be set to this mode. 87.It Li unlinked 88When an interface is not yet negotiated, the interface is in this mode. 89.El 90.Sh HARDWARE 91Devices supported by the 92.Nm 93driver include: 94.Pp 95.Bl -bullet -compact 96.It 97SHARP FOMA SH902i 98.It 99KYOCERA PHS AH-K3001V (a.k.a Kyopon) 100.It 101SANYO Vodafone3G V801SA 102.El 103.Sh SEE ALSO 104Specification can be found at: 105.Pp 106.Bl -item -compact 107.It 108.Pa http://www.nttdocomo.co.jp/corporate/technology/document/foma/index.html 109.It 110.Pa http://www.mcpc-jp.org/doclist.htm 111.El 112.Pp 113.Xr tty 4 , 114.Xr ucom 4 , 115.Xr umodem 4 , 116.Xr usb 4 117.Sh HISTORY 118The 119.Nm 120driver 121appeared in 122.Fx 7.0 , 123partly derived from the 124.Xr umodem 4 125code. 126.Sh BUGS 127Interfaces with multiplexed commands and data and interfaces with 128commands only are supported.
| 51.Sh DESCRIPTION 52The 53.Nm 54driver provides support for USB mobile phone terminals in the subset of 55the Mobile Computing Promotion Consortium USB Implementation Guideline, 56which is adopted by FOMA, the NTT DoCoMo 3G system, terminal. 57These are partly like CDC ACM model based modems, which are supported 58by 59.Xr umodem 4 , 60but the 61.Nm 62driver recognizes a specific USB descriptor that describes its role and 63interface structure, and it will negotiate its role when the device is open. 64They support a regular AT command set and 65the commands can either be multiplexed with the data stream 66or handled through separate pipes. 67In the latter case the AT 68commands have to be given on a device separate from the data device. 69.Pp 70The device is accessed through the 71.Xr ucom 4 72driver which makes it behave like a 73.Xr tty 4 . 74.Sh SYSCTLS 75These devices often have a few interface sets and these interfaces 76have their role, sometimes multiplexed. 77These roles are identified with the following sysctl MIBs: 78.Bl -tag -width indent 79.It Va dev.ucom.%d.supportmode 80The modes which are supported by the interface. 81.It Va dev.ucom.%d.currentmode 82Current mode of the interface. 83.It Va dev.ucom.%d.openmode 84Mode to transit when the device is open next. 85.El 86The modes are as follows: 87.Bl -tag -width indent 88.It Li modem 89Accepts AT commands and go and pass packet communication data. 90.It Li handsfree 91Accepts AT commands but it does not pass data. 92.It Li obex 93Accepts OBEX frame which is used to exchange telephone book, etc. 94.It Li vendor1 , vendor2 95Vendor specific data may be passed. 96.It Li deactivated 97When an interface is recognized by the system but not used, the interface 98will be set to this mode. 99.It Li unlinked 100When an interface is not yet negotiated, the interface is in this mode. 101.El 102.Sh HARDWARE 103Devices supported by the 104.Nm 105driver include: 106.Pp 107.Bl -bullet -compact 108.It 109SHARP FOMA SH902i 110.It 111KYOCERA PHS AH-K3001V (a.k.a Kyopon) 112.It 113SANYO Vodafone3G V801SA 114.El 115.Sh SEE ALSO 116Specification can be found at: 117.Pp 118.Bl -item -compact 119.It 120.Pa http://www.nttdocomo.co.jp/corporate/technology/document/foma/index.html 121.It 122.Pa http://www.mcpc-jp.org/doclist.htm 123.El 124.Pp 125.Xr tty 4 , 126.Xr ucom 4 , 127.Xr umodem 4 , 128.Xr usb 4 129.Sh HISTORY 130The 131.Nm 132driver 133appeared in 134.Fx 7.0 , 135partly derived from the 136.Xr umodem 4 137code. 138.Sh BUGS 139Interfaces with multiplexed commands and data and interfaces with 140commands only are supported.
|