[wiki:Documentation]
| [wiki:Documentation/NodeHandler NodeHandler]
| [wiki:Documentation/NodeHandler/Commands Commands]
| antenna

= antenna: Configure Noise Insertation and Spectrum Measurements =

This command allows the experimenter to inject noise into the grid through the available antennas. While currently not supported, the same command will also provide access to spectrum analyzers.


== Syntax ==

'''antenna(''selector'').signal.''resource'' = ''value'''''[[BR]]
'''antenna(''selector'').signal {}'''

  * '''selector''': Expression to select the antenna set.
  * '''signal''': Path to noise generator.
  * '''resource:''' Name of resource.
  * '''value:''' Value to assign to resource.

The supported syntax for the ''selector'' can be found in [wiki:Documentation/NodeHandler/Commands/defNodes defNodes].

The current resources for the signal generator are:

  * '''bandwidth''': Bandwidth of signal
  * '''channel''': 802.11 channel
  * '''power''': Output power in dbM ???
  * '''on''': On when set to true, off when set to false

The locations of the antennas within the grid can be found '''missing'''.

== Usage ==

{{{
antenna(4,4).signal {|s|
  s.bandwidth = 20
  s.channel = 36
  s.power = prop.noisePower
}
}}}




== See Also ==

[wiki:Documentation/NodeHandler/Commands/prop prop]

== Channel Mapping ==

===  Channels for IEEE 802.11a ===

||'''Channel Identifier''' ||'''Frequency in MHz'''||
|| 34 || 5170 ||
|| 36 || 5180 ||
|| 38 || 5190 ||
|| 40 || 5200 ||
|| 42 || 5210 ||
|| 44 || 5220 ||
|| 46 || 5230 ||
|| 48 || 5240 ||
|| 52 || 5260 ||
|| 56 || 5280 ||
|| 60 || 5300 ||
|| 64 || 5320 ||
|| 149 || 5745 ||
|| 153 || 5765 ||
|| 157 || 5785 ||
|| 161 || 5805 ||

=== Channels for IEEE 802.11b ===

||'''Channel Identifier''' || '''Frequency in MHz''' ||
|| 1 || 2412 ||
|| 2 || 2417 ||
|| 3 || 2422 ||
|| 4 || 2427 ||
|| 5 || 2432 ||
|| 6 || 2437 ||
|| 7 || 2442 ||
|| 8 || 2447 ||
|| 9 || 2452 ||
|| 10 || 2457 ||
|| 11 || 2462 ||
|| 12 || 2467 ||
|| 13 || 2472 ||
|| 14 || 2484  ||


== Maximum Power Levels and Antenna Gains ==
=== IEEE 802.11a ===



An improper combination of power level and antenna gain can result in Effective Isotropic Radiated Power (EIRP) above the amount allowed per regulatory domain. The following table indicates the maximum power levels and antenna gains allowed for each IEEE 802.11a regulatory domain.


|| '''Regulatory Domain''' || '''Maximum Power Level (mW) with 6-dBi Antenna Gain''' ||
|| Americas (-A)(160 mW EIRP maximum on channels 36-48, 800 mW EIRP maximum on channels 52-64) || 40 ||
|| Japan (-J) (10 mW/MHz EIRP maximum) || 40 ||
|| Singapore (-S) (100 mW EIRP maximum) || 20 ||
|| Taiwan (-T) (800 mW EIRP maximum) || 40 ||

=== IEEE 802.11b ===

An improper combination of power level and antenna gain can result in EIRP above the amount allowed per regulatory domain. The following table indicates the antenna gains and the maximum power levels in mW allowed for each IEEE 802.11b regulatory domain.

 * Americas (-A) (4 W EIRP maximum)
 * EMEA (-E) (100 mW EIRP maximum)
 * Israel (-I) (100 mW EIRP maximum)
 * China (-C) (10 mW EIRP maximum)
 * Japan (-J) (10 mW/MHz EIRP maximum)

||'''Antenna Gain (dBi)''' ||'''-A'''||'''-E'''||'''-I'''||'''-C'''||'''-J'''||
|| 0 || 100||100||100||5||50||
||2.2||100||50||50||5||30||
||5.2||100||30||30||n/a||30||
||6||100||30||30||n/a||30||
||8.5||100||5||5||n/a||n/a||
||12||100||5||5||n/a||n/a||
||13.5||100||5||5||n/a||5||
||21||20||1||1||n/a||n/a||