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

BSD