ng_bt3c(4)

NAME

ng_bt3c - Netgraph node type that is also a 3Com Bluetooth
PC card driver

SYNOPSIS

#include <sys/types.h>
#include <netgraph/bluetooth/include/ng_bt3c.h>

DESCRIPTION

The btccc node type is both a persistent Netgraph node type
and a driver
for the 3Com Bluetooth PC card (3CRWB6096-HP). It imple
ments a Bluetooth
HCI UART transport layer as per chapter H4 of the Bluetooth
Specification
Book v1.1. A new node is created when the card is plugged.
In order to use the card one MUST download the firmware
first. Due to
copyright issues the firmware cannot be provided with this
driver. The
firmware can be obtained from the Windows driver package
that can be
downloaded from the 3Com web site at no charge. The
firmware name is
BT3CPCC.BIN. To load the firmware into the card, use
bt3cfw(8). I am
using the original firmware that came with the card on CD
ROM.

MD5 (BT3CPCC.BIN) = 36170fda56ea9fdbf1702c966f8a97f1
For OLDCARD systems the entry in pccard.conf(5) might look
like this:

# 3Com 3CRWB60-A Bluetooth PC Card
card "3COM" "3CRWB60-A" "Bluetooth PC Card"
config auto "btccc" ?
insert /usr/sbin/bt3cfw -n $device -f
/etc/BT3CPCC.bin
Do not forget to load the module and SIGHUP pccardd(8).
The node has a single hook called hook. Incoming bytes re
ceived on the
device are re-assembled into HCI frames (according to the
length). Full
HCI frames are sent out on the hook. HCI frames received on
hook are
transmitted out. No modification to the data is performed
in either
direction.

HARDWARE

The ng_bt3c driver provides support for the 3Com/HP 3CR
WB6096-A PCCARD
bluetooth adapter.

HOOKS

This node type supports the following hooks:

hook single HCI frame contained in single mbuf structure.

CONTROL MESSAGES

This node type supports the generic control messages, plus
the following:
NGM_BT3C_NODE_GET_STATE
Returns the current receiving state for the node.
NGM_BT3C_NODE_GET_DEBUG
Returns an integer containing the current debug lev
el for the
node.
NGM_BT3C_NODE_SET_DEBUG
This command takes an integer argument and sets the
current debug
level for the node.
NGM_BT3C_NODE_GET_QLEN
This command takes a parameter that specifies queue
number and
returns the current length of the queue for the
node.
NGM_BT3C_NODE_SET_QLEN
This command takes two parameters that specify the
queue number
and the maximum length of the queue and sets the
maximum length
of the queue for the node.
NGM_BT3C_NODE_GET_STAT
Returns various statistic information for the node,
such as: number of bytes (frames) sent, number of bytes (frames)
received and
number of input (output) errors.
NGM_BT3C_NODE_RESET_STAT
Reset all statistic counters to zero.
NGM_BT3C_NODE_DOWNLOAD_FIRMWARE
Download card firmware.

SHUTDOWN

This node shuts down when the corresponding card is un
plugged.

SEE ALSO

cardbus(4), netgraph(4), pccbb(4), pcic(4), pccard.conf(5),
bt3cfw(8),
ngctl(8), pccardc(8), pccardd(8)

HISTORY

The btccc node type was implemented in FreeBSD 5.0.

AUTHORS

Maksim Yevmenkin <m_evmenkin@yahoo.com>

BUGS

The driver is based on information obtained from Jose Orlan
do Pereira
<jop@di.uminho.pt> and disassembled the W2K driver.
BSD December 17, 2004
Copyright © 2010-2024 Platon Technologies, s.r.o.           Home | Man pages | tLDP | Documents | Utilities | About
Design by styleshout