Skip to content

Commit

Permalink
---
Browse files Browse the repository at this point in the history 
yaml
---
r: 58141
b: refs/heads/master
c: 7dcf528
h: refs/heads/master
i:
  58139: 7b3b342
v: v3
  • Loading branch information
Dan Williams authored and John W. Linville committed Jun 28, 2007
1 parent 04a70a2 commit 64abf55
Show file tree
Hide file tree
Showing 7 changed files with 7 additions and 1,552 deletions.
2 changes: 1 addition & 1 deletion [refs]
View file
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
---
refs/heads/master: 18c96c3497aa871608d57ca5e08de3558159a6c9
refs/heads/master: 7dcf5284d12d7b59359a503d35797295f085f327
2 changes: 1 addition & 1 deletion trunk/drivers/net/wireless/libertas/Makefile
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ libertas-objs := main.o fw.o wext.o \
rx.o tx.o cmd.o \
cmdresp.o scan.o \
join.o 11d.o \
ioctl.o debugfs.o \
debugfs.o \
ethtool.o assoc.o

usb8xxx-objs += if_bootcmd.o
Expand Down
275 changes: 0 additions & 275 deletions trunk/drivers/net/wireless/libertas/README
View file
Original file line number Diff line number Diff line change
Expand Up @@ -28,281 +28,6 @@ DRIVER LOADING

insmod usb8388.ko [fw_name=usb8388.bin]

=====================
IWPRIV COMMAND
=====================

NAME
This manual describes the usage of private commands used in Marvell WLAN
Linux Driver. All the commands available in Wlanconfig will not be available
in the iwpriv.

SYNOPSIS
iwpriv <ethX> <command> [sub-command] ...

iwpriv ethX setregioncode <n>
iwpriv ethX getregioncode

Version 5 Command:
iwpriv ethX ledgpio <n>

BT Commands:
The blinding table (BT) contains a list of mac addresses that will be,
by default, ignored by the firmware. It is also possible to invert this
behavior so that we will ignore all traffic except for the portion
coming from mac addresess in the list. It is primarily used for
debugging and testing networks. It can be edited and inspected with
the following commands:

iwpriv ethX bt_reset
iwpriv ethX bt_add <mac_address>
iwpriv ethX bt_del <mac_address>
iwpriv ethX bt_list <id>
iwpriv ethX bt_get_invert <n>
iwpriv ethX bt_set_invert <n>

FWT Commands:
The forwarding table (FWT) is a feature used to manage mesh network
routing in the firmware. The FWT is essentially a routing table that
associates a destination mac address (da) with a next hop receiver
address (ra). The FWT can be inspected and edited with the following
iwpriv commands, which are described in greater detail below.
Eventually, the table will be automatically maintained by a custom
routing protocol.

NOTE: FWT commands replace the previous DFT commands. What were the DFT
commands?, you might ask. They were an earlier API to the firmware that
implemented a simple MAC-layer forwarding mechanism. In the unlikely
event that you were using these commands, you must migrate to the new
FWT commands which can be used to achieve the same functionality.

iwpriv ethX fwt_add [parameters]
iwpriv ethX fwt_del [parameters]
iwpriv ethX fwt_lookup [parameters]
iwpriv ethX fwt_list [parameters]
iwpriv ethX fwt_list_route [parameters]
iwpriv ethX fwt_list_neigh [parameters]
iwpriv ethX fwt_reset [parameters]
iwpriv ethX fwt_cleanup
iwpriv ethX fwt_time

MESH Commands:

The MESH commands are used to configure various features of the mesh
routing protocol. The following commands are supported:

iwpriv ethX mesh_get_ttl
iwpriv ethX mesh_set_ttl ttl

DESCRIPTION
Those commands are used to send additional commands to the Marvell WLAN
card via the Linux device driver.

The ethX parameter specifies the network device that is to be used to
perform this command on. it could be eth0, eth1 etc.

setregioncode
This command is used to set the region code in the station.
where value is 'region code' for various regions like
USA FCC, Canada IC, Spain, France, Europe ETSI, Japan ...

Usage:
iwpriv ethX setregioncode 0x10: set region code to USA (0x10).

getregioncode
This command is used to get the region code information set in the
station.

ledgpio
This command is used to set/get LEDs.

iwpriv ethX ledgpio <LEDs>
will set the corresponding LED for the GPIO Line.

iwpriv ethX ledgpio
will give u which LEDs are Enabled.

Usage:
iwpriv eth1 ledgpio 1 0 2 1 3 4
will enable
LED 1 -> GPIO 0
LED 2 -> GPIO 1
LED 3 -> GPIO 4

iwpriv eth1 ledgpio
shows LED information in the format as mentioned above.

Note: LED0 is invalid
Note: Maximum Number of LEDs are 16.

fwt_add
This command is used to insert an entry into the FWT table. The list of
parameters must follow the following structure:

iwpriv ethX fwt_add da ra [metric dir rate ssn dsn hopcount ttl expiration sleepmode snr]

The parameters between brackets are optional, but they must appear in
the order specified. For example, if you want to specify the metric,
you must also specify the dir, ssn, and dsn but you need not specify the
hopcount, expiration, sleepmode, or snr. Any unspecified parameters
will be assigned the defaults specified below.

The different parameters are:-
da -- DA MAC address in the form 00:11:22:33:44:55
ra -- RA MAC address in the form 00:11:22:33:44:55
metric -- route metric (cost: smaller-metric routes are
preferred, default is 0)
dir -- direction (1 for direct, 0 for reverse,
default is 1)
rate -- data rate used for transmission to the RA,
as specified for the rateadapt command,
default is 3 (11Mbps)
ssn -- Source Sequence Number (time at the RA for
reverse routes. Default is 0)
dsn -- Destination Sequence Number (time at the DA
for direct routes. Default is 0)
hopcount -- hop count (currently unused, default is 0)
ttl -- TTL (Only used in reverse entries)
expiration -- entry expiration (in ticks, where a tick is
1024us, or ~ 1ms. Use 0 for an indefinite
entry, default is 0)
sleepmode -- RA's sleep mode (currently unused, default is
0)
snr -- SNR in the link to RA (currently unused,
default is 0)

The command does not return anything.

fwt_del
This command is used to remove an entry to the FWT table. The list of
parameters must follow the following structure:

iwpriv ethX fwt_del da ra [dir]

where the different parameters are:-
da -- DA MAC address (in the form "00:11:22:33:44:55")
ra -- RA MAC address (in the form "00:11:22:33:44:55")
dir -- direction (1 for direct, 0 for reverse,
default is 1)

The command does not return anything.

fwt_lookup
This command is used to get the best route in the FWT table to a given
host. The only parameter is the MAC address of the host that is being
looked for.

iwpriv ethX fwt_lookup da

where:-
da -- DA MAC address (in the form "00:11:22:33:44:55")

The command returns an output string identical to the one returned by
fwt_list described below.


fwt_list
This command is used to list a route from the FWT table. The only
parameter is the index into the table. If you want to list all the
routes in a table, start with index=0, and keep listing until you get a
"(null)" string. Note that the indicies may change as the fwt is
updated. It is expected that most users will not use fwt_list directly,
but that a utility similar to the traditional route command will be used
to invoke fwt_list over and over.

iwpriv ethX fwt_list index

The output is a string of the following form:

da ra valid metric dir rate ssn dsn hopcount ttl expiration
sleepmode snr precursor

where the different fields are:-
da -- DA MAC address (in the form "00:11:22:33:44:55")
ra -- RA MAC address (in the form "00:11:22:33:44:55")
valid -- whether the route is valid (0 if not valid)
metric -- route metric (cost: smaller-metric routes are preferred)
dir -- direction (1 for direct, 0 for reverse)
rate -- data rate used for transmission to the RA,
as specified for the rateadapt command
ssn -- Source Sequence Number (time at the RA for reverse routes)
dsn -- Destination Sequence Number (time at the DA for direct routes)
hopcount -- hop count (currently unused)
ttl -- TTL (only used in reverse entries)
expiration -- entry expiration (in ticks, where a tick is 1024us, or ~ 1ms. Use 0 for an indefinite entry)
sleepmode -- RA's sleep mode (currently unused)
snr -- SNR in the link to RA (currently unused)
precursor -- predecessor in direct routes

fwt_list_route
This command is equivalent to fwt_list.

fwt_list_neigh
This command is used to list a neighbor from the FWT table. The only
parameter is the neighbor ID. If you want to list all the neighbors in a
table, start with nid=0, and keep incrementing nid until you get a
"(null)" string. Note that the nid from a fwt_list_route command can be
used as an input to this command. Also note that this command is meant
mostly for debugging. It is expected that users will use fwt_lookup.
One important reason for this is that the neighbor id may change as the
neighbor table is altered.

iwpriv ethX fwt_list_neigh nid

The output is a string of the following form:

ra sleepmode snr references

where the different fields are:-
ra -- RA MAC address (in the form "00:11:22:33:44:55")
sleepmode -- RA's sleep mode (currently unused)
snr -- SNR in the link to RA (currently unused)
references -- RA's reference counter

fwt_reset
This command is used to reset the FWT table, getting rid of all the
entries. There are no input parameters.

iwpriv ethX fwt_reset

The command does not return anything.

fwt_cleanup
This command is used to perform user-based garbage recollection. The
FWT table is checked, and all the entries that are expired or invalid
are cleaned. Note that this is exported to the driver for debugging
purposes, as garbage collection is also fired by the firmware when in
space problems. There are no input parameters.

iwpriv ethX fwt_cleanup

The command does returns the number of invalid/expired routes deleted.

fwt_time
This command returns a card's internal time representation. It is this
time that is used to represent the expiration times of FWT entries. The
number is not consistent from card to card; it is simply a timer count.
The fwt_time command is used to inspect the timer so that expiration
times reported by fwt_list can be properly interpreted.

iwpriv ethX fwt_time

mesh_get_ttl

The mesh ttl is the number of hops a mesh packet can traverse before it
is dropped. This parameter is used to prevent infinite loops in the
mesh network. The value returned by this function is the ttl assigned
to all mesh packets. Currently there is no way to control the ttl on a
per packet or per socket basis.

iwpriv ethX mesh_get_ttl

mesh_set_ttl ttl

Set the ttl. The argument must be between 0 and 255.

iwpriv ethX mesh_set_ttl <ttl>

=========================
ETHTOOL
=========================
Expand Down
Loading

0 comments on commit 64abf55

Please sign in to comment.