Command-Line Options and Configuration Settings for Advanced Users

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. Additionally, on macOS you can achieve the same effect if you press and hold the Fn key when launching TamoGraph.

/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).

Close TamoGraph before editing these settings!

Windows On Windows, the parameters listed below are located under the following registry branch:
Apple 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, add 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.)