Skip to content

Command line interface

Arguments for the command line.

--frequency, -f

  • Possible values: 2412 - 7125 (frequency of the channel)
  • Default value: 2412
  • Description: TX/RX frequency in MHz.

--channel-width, -w

  • Possible values: 20, 40, HT40-, 80, 160
  • Default value: FeitCSI_{timestamp}.dat (save in folder where the program running)
  • Description: Channel width in MHz

--output-file, -o

  • Possible values: path/to/file
  • Default value: FeitCSI_{timestamp}.dat (save in folder where the program running)
  • Description: File where the raw CSI and FTM will be stored. For FTM the prefix "FTM_" will be added

--format, -r

  • Possible values: NOHT, HT, VHT, HESU
  • Default value: HT
  • Description: 802.11 frame format type for the measuring/injecting

--antenna, -a

  • Possible values: 1, 2, 12
  • Default value: 1
  • Description: Transmitting antenna

--mcs, -m

  • Possible values: 0 - 11
  • Default value: 0

  • Description: MCS index.

    • For NOHT: 0 (6 Mbps) - 7 (57Mbps)
    • For HT: 0 - 7
    • For VHT: 0 - 9
    • For HE: 0 - 11

--spatial-streams, -s

  • Possible values: 1, 2
  • Default value: 1
  • Description: Number of the spatial streams

--guard-interval, -g

  • Possible values: 400, 800
  • Default value: 400
  • Description: Guard interval in ns

--ltf, -l

  • Possible values: 2xLTF+0.8, 2xLTF+1.6, 4xLTF+3.2, 4xLTF+0.8
  • Default value: 2xLTF+0.8
  • Description: HE LTF

--coding, -c

  • Possible values: BCC, LDPC
  • Default value: LDPC
  • Description: Coding method

--tx-power, -t

  • Possible values: 1 - 22
  • Default value: 10
  • Description: TX power in dBm

--mode, -i

  • Possible values: measure, inject, measureinject, ftm, ftmres, injectftmres, measureftm
  • Default value: measure
  • Description: Mode of FeitCSI CSI, inject frames or both,
    • measure - measure CSI
    • inject - inject frames
    • measureinject - measure CSI and inject frames
    • ftm - FTM initiator
    • ftmres - FTM responder
    • injectftmres - inject frames and FTM responder
    • measureftm - measure CSI and FTM initiator

--inject-delay, -d

  • Possible values: positive number
  • Default value: 100000
  • Description: Delay between frame injections in us or between FTM initiator.

--inject-repeat, -d

  • Possible values: positive number
  • Default value: 0 (0 means infinity)
  • Description: How many times inject frames or FTM initiator repeat

--ftm-asap, -b

  • Description: FTM asap mode

--ftm-burst-exp, -q

  • Possible values: positive number
  • Default value: 0 (not specified)
  • Description: FTM burst exponent

--ftm-per-burst, -e

  • Possible values: positive number
  • Default value: 0 (not specified)
  • Description: FTM samples per burst

--ftm-burst-period, -h

  • Possible values: positive number
  • Default value: 0 (not specified)
  • Description: FTM burst period

--ftm-burst-duration, -k

  • Possible values: positive number
  • Default value: 0 (not specified)
  • Description: FTM burst duration

--ftm-mac, -n

  • Possible values: MAC addres in format xx:xx:xx:xx:xx:xx
  • Default value: 00:11:22:33:44:55
  • Description: MAC address of FTM responder for FTM initiator

--mode-delay, -y

  • Possible values: positive number
  • Default value: 3000
  • Description: Delay in ms between inject and ftm responder or measure and ftm initiator when modes are injectftmres|measureftm, t greater value is recommended

--strict, -z

  • Description: Filter out values that do not contain a specific MCS, because when fast switching between modes e.g. measure FTM there are unwanted frames in the buffer

--mac, -#

  • Possible values: MAC addres in format xx:xx:xx:xx:xx:xx
  • Default value: 00:11:22:33:44:55
  • Description: Default NICs MAC will be change to providing MAC

--plot, -p

  • Description: Live plotting of the CSI if argument is used

--gui, -x

  • Description: Run GUI application

Warning

Other arguments are ignored if you run with --gui

--udp-socket, -u

  • Description: Run as UDP socket. Listening on port 8008. Controlling via UDP socket is similiar to console, e.g. send string commands feitcsi --frequency 5180 --channel-width 160 --format HESU --output-file csi.dat. To stop extracting/injecting send string stop

--help

  • Description: Print help

--usage

  • Description: Print usage

Warning

Application are not fully sanitized against the bad combinations of the arguments (e.g. channel width 160 MHz and mode HT). So the program can behave unpredictably with the bad arguments. This will be fixed in the future releases.