share/man/man4/ufoma.4

   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$
  29 .\"
  30 .Dd January 10, 2006
  31 .Dt UFOMA 4
  32 .Os
  33 .Sh NAME
  34 .Nm ufoma
  35 .Nd USB mobile phone support
  36 .Sh SYNOPSIS
  37 .Cd "device ufoma"
  38 .Cd "device ucom"
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 driver provides support for USB mobile phone terminal in the subset of
  43 Mobile Computing Promotion Consortium USB Implementation Guideline,
  44 which is adopted by FOMA, the NTT DoCoMo 3G system, terminal.
  45 These are partly like CDC ACM model based modem, which is supported
  46 by
  47 .Xr umodem 4 .
  48 But this recognizes specific usb descriptor that describes its role and
  49 interface structure, and it will negotiate its role when the device is open.
  50
  51 They support a regular AT command set.
  52 The commands can either be multiplexed with the data stream
  53 or handled through separate pipes.
  54 In the latter case the AT
  55 commands have to be given on a device separate from the data device.
  56 .Pp
  57 The device is accessed through the
  58 .Xr ucom 4
  59 driver which makes it behave like a
  60 .Xr tty 4 .
  61
  62 .Sh SYSCTLS
  63 This device often have a few interface sets and these interfaces
  64 have its role, sometimes multiplexed.
  65 These roles are identified with following sysctl MIB.
  66 .Bl -tag -width indent
  67 .It Va dev.ucom.%d.supportmode
  68 The modes which is supprted by the interface.
  69 .It Va dev.ucom.%d.currentmode
  70 Current mode of the interface.
  71 .It Va dev.ucom.%d.openmode
  72 Mode to transit when the device is open next.
  73 .El
  74 The mode is as follows.
  75 .Bl -tag -width indent
  76 .It modem
  77 Accepts AT commands and go and pass packet communication data.
  78 .It handsfree
  79 Accepts AT commands but it does not pass data.
  80 .It obex
  81 Accepts OBEX frame which is used to exchange telephone book, etc.
  82 .It vendor1
  83 .It vendor2
  84 Vendor specific data may passed.
  85 .It deactivated
  86 When a interface is recognized to the system and not used, the interface
  87 will set to this mode.
  88 .It unlinked
  89 When a interface is not yet negotiated, the interface is in this mode.
  90 .El
  91 .Sh HARDWARE
  92 Devices supported by the
  93 .Nm
  94 driver include:
  95 .Pp
  96 .Bl -bullet -compact
  97 .It
  98 SHARP FOMA SH902i
  99 .It
 100 KYOCERA PHS AH-K3001V (a.k.a Kyopon)
 101 .El
 102 .Sh SEE ALSO
 103 specification can be found at:
 104 .Pp
 105 http://www.nttdocomo.co.jp/corporate/technology/document/foma/index.html
 106 http://www.mcpc-jp.org/doclist.htm
 107 .Pp
 108
 109 .Xr tty 4 ,
 110 .Xr ucom 4 ,
 111 .Xr umodem 4 ,
 112 .Xr usb 4
 113 .Sh HISTORY
 114 The
 115 .Nm
 116 driver
 117 appeared in
 118 .Fx 7-CURRENT, partly from
 119 .Xr umodem 4
 120 code.
 121 .Sh BUGS
 122 Interfaces with multiplexed commands and data and interfaces with
 123 commands only are supported.