13
0
Fork 1
dedected/kismet-dect
dragorn 1ba9f43abd Update to kismet release default dir (to match kismet release plugins)
Default to /dev/coa if no device specified


git-svn-id: https://dedected.org/svn/trunk@89 8d8ab74c-27aa-4a3d-9bde-523a2bc1f624
2009-06-03 18:20:02 +00:00
..
client_module Update makefile and client plugin API to Kismet-2009-05-RC2 and newer API 2009-06-03 18:18:26 +00:00
server_module Update to kismet release default dir (to match kismet release plugins) 2009-06-03 18:20:02 +00:00
LICENSE Added GPL LICENSE file 2008-12-30 23:28:47 +00:00
README README++ 2009-02-09 21:15:41 +00:00

README

                            KISMET DECT MODULES
                            ===================

PREREQUISITES:
=============

In order to use the Kismet DECT plugins, you need the latest kismet-newcore 
from the Kismet subversion repository. The code here is NOT usable with the 
current Kismet stable release, since Kismet supports modules only in newcore.

Get kismet-newcore like so:

 svn co http://svn.kismetwireless.net/code/branch/kismet-newcore kismet-newcore

Build & Install:

 cd kismet-newcore
 ./configure 
 make
 make install

KISMET-DECT PLUGINS:
===================

You can find the Kismet DECT client and server modules subversion repository at
the following url:

    https://dedected.org/svn/trunk/kismet-dect

Use subversion to check out the trunk like so:

    svn co https://dedected.org/svn/trunk/kismet-dect

You then should see these directories:

    client_module/ -- Contains the Kismet client module code
    server_module/ -- Contains the Kismet server module code

NOTE: Make sure the environment variables KIS_DEST_DIR and KIS_SRC_DIR point to
something useful. These variables are used in the Makefile and default to the 
following directories:
    
    KIS_DEST_DIR=/usr/local
    KIS_SRC_DIR=/usr/src/kismet-newcore

Change them according to your environment. For example, if your kismet-newcore
source is at /home/user/src/kismet-newcore and your Kismet installation is at
/home/user/tools/kismet-build, adapt your environment like so:

    export KIS_SRC_DIR=/home/user/src/kismet-newcore
    export KIS_DEST_DIR=/home/user/tools/kismet-build

Then, you're ready to build:

    make -C client_module && make -C server_module

Install:

    make -C client_module install && make -C server_module install

You are then able to start kismet_server and kismet_client and should be able
to choose the Kismet DECT plugin from the menu.

CONFIG:
======

Make sure to add the following source to your kismet.conf: 

Device:

    ncsource=dect:device=/dev/coa

Logtype:

    logtypes=dectpcap

FEATURES:
========

Functionality that works as of now:

 * FP scan
 * Sorting FP scan results by RFPI, RSSI, seen count, and channel
 * Locking channels for FP scan
 * PP (call) scan
 * Dumping pcap in for call (PP scan) or station (FP scan) (alpha, please test)

Stuff being worked on:

 * GPS support
 * Dump .wav files

HOTKEYS:
=======

Currently, after loading the DECT plugin into the client, you need to use 
certain hotkeys to tell it what to do. Here is a list of keys and what they do:

   ---------+---------------------------------------------
    KEY     | ACTION
   ---------+---------------------------------------------
    h       | Display this help
    L       | Lock channel hopping to current channel
    U       | Unlock channel hopping
    F       | Do async FP scan (default)
    A       | Do async PP scan
    M       | Show current mode
    i       | Sort by RFPI (ascending)
    I       | Sort by RFPI (descending)
    r       | Sort by RSSI (ascending)
    R       | Sort by RSSI (descending)
    c       | Sort by Channel (ascending)
    C       | Sort by Channel (descending)
    s       | Sort by view count (ascending)
    S       | Sort by view count (descending)
    Q       | Quit
    <enter> | Sync with selected station and dump calls
   -------------------------------------------------------

Q&A:
===

Q: I don't seem to be able to use the hotkeys or scroll through the station
   list. What's wrong?
A: Maybe you choose the wrong window? Try <tab>ing you way to the DECT plugin
   and then try again.

BUGS/FEATURE REQUESTS:
=====================

The code is currently quite rough and may contain bugs. If you find a serious bug or
if you would like to request some feature, please use our ticket system at:

    https://dedected.org/trac/newticket

Or send an email to kismet-dect@detected.org or dedected@lists.gnumonks.org. Thanks.

AUTHORS:
=======

Mike Kershaw <dragorn (at) kismetwireless (dot) net
Jake Appelbaum <jacob (at) appelbaum (dot) net
Christian Fromme <kaner (at) strace (dot) org