drivers/net/wireless/ath/ath9k/dfs_pri_detector.h

   1 /*
   2  * Copyright (c) 2012 Neratec Solutions AG
   3  *
   4  * Permission to use, copy, modify, and/or distribute this software for any
   5  * purpose with or without fee is hereby granted, provided that the above
   6  * copyright notice and this permission notice appear in all copies.
   7  *
   8  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
   9  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  10  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  11  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  13  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  14  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15  */
  16
  17 #ifndef DFS_PRI_DETECTOR_H
  18 #define DFS_PRI_DETECTOR_H
  19
  20 #include <linux/list.h>
  21
  22 /**
  23  * struct pri_sequence - sequence of pulses matching one PRI
  24  * @head: list_head
  25  * @pri: pulse repetition interval (PRI) in usecs
  26  * @dur: duration of sequence in usecs
  27  * @count: number of pulses in this sequence
  28  * @count_falses: number of not matching pulses in this sequence
  29  * @first_ts: time stamp of first pulse in usecs
  30  * @last_ts: time stamp of last pulse in usecs
  31  * @deadline_ts: deadline when this sequence becomes invalid (first_ts + dur)
  32  */
  33 struct pri_sequence {
  34         struct list_head head;
  35         u32 pri;
  36         u32 dur;
  37         u32 count;
  38         u32 count_falses;
  39         u64 first_ts;
  40         u64 last_ts;
  41         u64 deadline_ts;
  42 };
  43
  44 /**
  45  * struct pri_detector - PRI detector element for a dedicated radar type
  46  * @exit(): destructor
  47  * @add_pulse(): add pulse event, returns pri_sequence if pattern was detected
  48  * @reset(): clear states and reset to given time stamp
  49  * @rs: detector specs for this detector element
  50  * @last_ts: last pulse time stamp considered for this element in usecs
  51  * @sequences: list_head holding potential pulse sequences
  52  * @pulses: list connecting pulse_elem objects
  53  * @count: number of pulses in queue
  54  * @max_count: maximum number of pulses to be queued
  55  * @window_size: window size back from newest pulse time stamp in usecs
  56  */
  57 struct pri_detector {
  58         void (*exit)     (struct pri_detector *de);
  59         struct pri_sequence *
  60              (*add_pulse)(struct pri_detector *de, struct pulse_event *e);
  61         void (*reset)    (struct pri_detector *de, u64 ts);
  62
  63 /* private: internal use only */
  64         const struct radar_detector_specs *rs;
  65         u64 last_ts;
  66         struct list_head sequences;
  67         struct list_head pulses;
  68         u32 count;
  69         u32 max_count;
  70         u32 window_size;
  71 };
  72
  73 struct pri_detector *pri_detector_init(const struct radar_detector_specs *rs);
  74
  75 #endif /* DFS_PRI_DETECTOR_H */