Home
Contents

Site Survey Tool - TamoGraph

Prev Page Next Page
 
Introduction
Overview
System Requirements
Differences between the Windows and macOS Versions
Driver Installation - Microsoft Windows
Wi-Fi Capture Engine Installation - macOS
Licensing and Trial Version Limitations
Interface Overview
Access Point List
Floor Plan / Site Map
Plans and Surveys, Properties, and Options Panel
Main Menu
Dashboard
Spectrum and Networks Panel
Performing a Site Survey
New Project Wizard
Calibration
Configuration
Adapter Signal Level Correction
Data Collection
Understanding Survey Types: Passive, Active, and Predictive
Active Survey Configuration
Best Practices, Tips, and Tricks
Survey Job Splitting
RF Predictive Modeling
Drawing Walls and Other Obstructions
Drawing Attenuation Zones
Copying, Pasting, and Deleting Multiple Objects
Undo and Redo
Virtual APs Placement Methods
Manual Placing and Configuring Virtual APs
Antenna Selection
Adjusting Horizontal Antenna Orientation
Creating Vendor-Specific AP Presets
Automatic Placing and Configuring Virtual APs
Reconfiguring Virtual APs
Applying Visualizations
Working with Multi-floor Sites
Mixing Real and Virtual Data
Best Practices, Tips, and Tricks
Analyzing Data – Passive Surveys and Predictive Models
Selecting Data for Analysis
Adjusting AP Locations After Passive Surveys
Splitting an AP into Multiple Unique APs
Working with Multi-SSID APs
AP Rank and Secondary Coverage
Visualization Types
Signal Level
Signal-to-Noise Ratio
AP Coverage Areas
Signal-to-Interference Ratio
Number of APs
Expected PHY Rate
Frame Format
Channel Bandwidth
Channel Map
Requirements
Analyzing Data – Active Surveys
Selecting Data for Analysis
Visualization Types
Actual PHY Rate
TCP Upstream and Downstream Rate
UDP Upstream and Downstream Rate
UDP Upstream and Downstream Loss
Round-trip Time
Associated AP
Requirements
Spectrum Analysis
Hardware Requirements
Spectrum Data Graphs
Performing Spectrum Analysis Surveys
Viewing Collected Spectrum Data
Exporting Spectrum Data
Reporting and Printing
Customizing Reports
Google Earth Integration
Configuring TamoGraph
Plans and Surveys
Properties
Plan / Map
Environment
Client Capabilities
Requirements
Scanner
Options
Colors and Value Ranges
AP Detection and Placement
Visualization Settings
Tips Panel
Computations
Miscellaneous
Configuring GPS Receiver
Using GPS Configuration Dialog
Finding the GPS Receiver Port Number
Taking Photographs
Voice Control
Using TamoGraph in a Virtual Machine
Command-Line Options and Configuration Settings
Frequently Asked Questions
Sales and Support

Command-Line Options and Configuration Settings

A few command-line options are available for customizing the application’s behavior.

/nodriver – No attempt to use the compatible Wi-Fi adapter in TamoGraph will be made. In other words, if you launch TamoGraph with this switch, TamoGraph will not take control of your Wi-Fi adapter.

/scanneroff – TamoGraph will start up with the scanner turned off. This switch also prevents the driver installation guide dialog from appearing.

The rest of this chapter is intended for advanced users; please do not modify the registry or edit configuration files unless you know exactly what you are doing or unless you have been asked to do that by our technical support team.

/debug – turns on writing debug information to a log file and writing captured packets to a capture file. Our technical support team may request these files for troubleshooting complex problems. On Windows, the output file names are debug.log and dump.ncf; the files are located in the application folder. On macOS, the output file names are TamoGraph.log and dump.ncf; the files are located on the desktop.

/debug-gps – turns on writing GPS-related debug information to a log file. Used together with the /debug option.

/gpu_force_bench – forces TamoGraph to re-evaluate OpenCL compatibility of the connected GPU devices and to re-run benchmark tests for them in order to check their performance.

Certain advanced TamoGraph configuration settings cannot be accessed via the user interface; such settings can be edited in the registry (on Windows) or in the settings.xml file (on macOS).4

IMPORTANT: Close TamoGraph before editing these settings!

On Windows, the parameters listed below are located under the following registry branch: HKEY_CURRENT_USER\SOFTWARE\TamoGraph. On macOS, the parameters listed below are contained in the settings.xml file that is located in the following folder: /Users/[UserName]/Library/Application Support/TamoGraph.

APLabelTemplate – defines the format of information displayed on AP Labels. An AP label is a line of text that can include one or several of the following variables:

%n – AP ordinal number according to the AP list on the left application panel.

%m – AP name

%s - SSID

%b - Band

%M - MAC

%v - Vendor

%e - Encryption

%c – Channel(s)

%r – Maximum PHY rate

 

If the parameter is empty, the labels will show only AP names. Note that this parameter affects only the AP labels; it does not affect the AP names saved as part of the project.

MinZoomPercent / MaxZoomPercent – defines the minimum and maximum zoom factor in percent for the floor plans displayed by TamoGraph.

SaveVisAPIconFactor – this parameter controls the magnification in percent of AP icons when you use the Save Visualization As… function. If you want to make AP icons larger, specify a value > 100. To make them smaller, specify a value below 100.

RFPlanner\FloorNeighborhoodDepth – defines how many floors above and below the specific floor are taken into consideration when computing signals in predictive models. By default, this value equals 1, which means that signals from APs located one floor above and one floor below are computed. Note that increasing the value of this parameter slows down calculations.

Some user settings and presets are stored as separate files. These files can be manually edited, for example, if you need to add a long list of APs to the ignore list. All the files that are listed below use UTF-16 encoding.

On Windows, these files are located in C:\ProgramData\TamoSoft\TamoGraph Site Survey. On macOS, these files are located in /Users/[Username]/Library/Application Support/TamoGraph

ApAlias.txt – the list of custom AP names. If you renamed any APs manually, the file is modified after you exit TamoGraph. If needed, instead of renaming individual APs, you can manually populate this list with MAC addresses and corresponding custom AP names before a survey or before generating a report.

ApBlackList.txt – this list contains the MAC addresses of APs that should be fully ignored during passive surveys. For example, if internet sharing is enabled in your smartphone, you may want to fully ignore it.

ApLinked.txt – this list contains MAC addresses that belong to the same physical APs. Each line represents a physical AP; its MAC addresses (BSSIDs) are separated by spaces. This list is populated when you use the Link/Unlink MultiSSID AP function in TamoGraph, but you can also edit it manually. This linking affects SIR calculations: If several radios on the same channel are linked into a Multi-SSID/Multi-MAC AP, they will not be considered as a source of interference for each other. This list is applicable to passive surveys. Please note that all manual changes to this file will be applied to future surveys only; these changes are not retroactive. If you plan to survey a large WLAN with multi-SSID APs, we recommend that you obtain the lists of MAC addresses (BSSIDs) that belong to the same AP, added them to this file, save the file, and then perform a site survey.

Applications.user – custom applications defined for client types in coverage areas (applicable to predictive RF Modeling).

areas.user – custom attenuation area presets (applicable to predictive RF Modeling).

clients.user – custom client device presets (applicable to predictive RF Modeling).

floor_ceiling.user – custom floor/ceiling material presets (applicable to predictive RF Modeling).

obstructions.user – custom walls and doors presets.

stations.user – custom AP presets (they include antenna information + AP-specific values of band, rate, power, etc.)