EaKiu for OSX^TM Users Manual

	User Manual Quick Links Requirements Installation Launching Data Control Buttons Data Source Buttons Graph Type Buttons Output Buttons The Settings Area Density Histogram True Base Mode Custom Profiles The Airport Area Keyboard Help Help Support EaKiu

Requirements One or more MetaGeek Wi-Spy devices - EaKiu supports the entire line of MetaGeek products. This currently includes the Original Wi-Spy, Wi-Spy 2.4x, Wi-Spy 2.4i, Wi-Spy 900x, and Wi-Spy DBx. Apple Intel or PPC Computer running OSX 10.6.4 (Snow Leopard) or higher - EaKiu only runs on Apple computers. EaKiu is an universal binary and will run on both Apple Intel and PPC computers and laptops. Available Powered USB Port - The Wi-Spy devices require a powered USB port. If you are using an external USB hub it must be a powered hub.   Installation Visit our Downloads page and download the latest version of EaKiu. This will bring the file EaKiu_6.2.app.zip down to your computer. When the download is complete, double click the downloaded .zip file to extract the application. Once the application is extracted you should see the following icon: You can now delete the original downloaded .zip archive file. Leave the EaKiu application on your desktop or place it in your Applications folder.   Launching To launch EaKiu simply double click the application icon. You can have Wi-Spy devices already plugged in, or plug them in after the program runs. Devices can freely be removed and re-inserted while EaKiu is in operation. Once EaKiu is running a window should appear that looks like this: Use the Quit button near the upper left corner to stop EaKiu running. In the very lower right corner is the Resize bars. Click hold and drag this area to resize the EaKiu window.   Data Control Buttons In the upper left corner of the EaKiu window is a set of 6 buttons labeled Data Control: These buttons provide basic control over the EaKiu program and Wi-Spy device feeds. Use the QUIT button to stop EaKiu running. The program will automatically save most settings in the preferences file prior to stopping. You can also stop the program by typing the q key. If you wish to stop the program but not have settings saved to preferences, use the Q key. Clicking the RESET button will return most settings to their default values. You can also perform a reset by typing the R key. Clicking the ZERO ALL button will zero all data values and all data memory for the currently displayed device. This basically makes the system think it is gathering brand new data. You can also zero all values by typing the Z key. Clicking the ZERO MAX button will zero just the maximum data values for the currently displayed device. Since the maximum data values stick for a very long time this is an efficient way of resetting the programs sense of maximum. You can also zero the maximum values by typing the z key. Click the PAUSE button will place the currently display device in Pause mode. You can also pause the device by typing the p key. When paused, the PAUSE button light will flash yellow. Also when in pause mode all other paused threads will also flash their lights. You should expect to see the Source button flashing, and if you are using Record and / or Server, those lights should be flashing as well. When paused NO DATA is collected from the current device and no recording or serving of data information is performed on output. Note that each device can be paused independently. The built-in WAV (test waveforms) device defaults to being paused at the start of the program. If the program seems slugish, pause any devices that you don't need to currently monitor. Click the IMAGE button to take a screenshot of the EaKiu window. You can also take a screenshot by typing the i key. When EaKiu snaps the window it saves it in the current save directory (see B above) using the following filename format: YYYYMMDD-HHmmSS.tga Where 'YYYY' is the year, 'MM' is the month, 'DD' is the day and 'HH' is the hour, 'mm' is the minute and 'SS' is the second. The file is stored as a RGB TGA (.tga) file (Truevision file format). Most image programs can read this format.   Data Source Buttons Next to the Data Control Buttons in the EaKiu window is a set of three buttons labeled Data Source: These buttons select the source you are currently viewing. To switch sources select the desired source to use or type the s key to switch to the next available device. The USB button will only be clickable if the program has detected one or more MetaGeek Wi-Spy devices. Once the program identifies the MetaGeek USB device you will see the device name and current profile in the upper left corner of the EaKiu display: If one or more Wi-Spy are available, clicking the USB button will select any of the available Wi-Spy devices plugged into the USB ports. When selected, the button light indicates the USB status. A green light indicates that a USB device is the current data source. A dimmer yellow light means that you are not currently looking at the USB source but there are active USB sources. If the light blinks ALL USB sources are currently paused (if you are viewing a USB source and the USB light is blinking, that source is paused). EaKiu supports the entire family of MetaGeek Wi-Spy USB devices. If you are using multiple Wi-Spy devices you can switch between devices by repeatedly hitting the USB button or by click the w button on the keyboard. Clicking the CSV button enables CSV File Playback. A file dialog will appear to let you select a file for playback. Clicking Cancel in the file dialog will cancel the CSV source and will return you to the previous used source. Selecting a file and clicking OK will begin playback of that files data. While the file is playing back the CSV button will be lit green and the name of the file being played back will appear in the Status text area. CSV files play back at the same speed that they recorded at. The file will continue to play to the end. Once it reaches the end it will automatically pause. To play the file again simply click the PAUSE button. To stop playing the CSV file click the CSV button again. Clicking the TCP button will display a small dialog that asks for a remote server and a port. Clicking Cancel in the dialog will cancel the TCP source and will return you to the previous used source. Otherwise, enter a domain name or IP address and valid port (port 2400 is the default) and click OK to begin reading data from the remote server. Once you make a connection to the remote server the TCP button should light green and you should see the connected-to machine in the Source text area. To turn a TCP source off simply click the TCP button again. NOTE: EaKiu Version below 5.4 use an incompatible server stream to that used by EaKiu Version 5.4 and above. We recommend updating to the latest version for both your remote and local EaKiu software.   Graph Type Buttons Next to the Data Source Buttons in the EaKiu window is a set of 4 buttons labeled Graph Type: In the GRAPH button area are four buttons labeled 2d, 3d, Quad, and Wire. These buttons allow you to change the graph to be one of the following for styles: Linear Multi-Graph (2d) 3D Spectrum Chart (3d) 3D Interactive Quad Graph (Quad) 3D Interactive Wire Graph (Wire) To change the graph mode simply click on the desired graph button. The button light will become green indicating that the desired graph mode has been selected and you should also see the change in the graph window itself. You can also change the graph mode by typing the g key to move forward through each graph type or the G key to move backward through each graph type. Clicking the 2d button puts EaKiu into 2D LINEAR Graph mode. This mode combines all the different tracked data values on one graph. The following image shows 2D LINEAR Graph mode and what the various areas indicate: The above view is different for EaKiu version 6.0 (and above) than for earlier versions of EaKiu. Earlier versions of EaKiu had the following 2D display: With version 6.0, EaKiu supports both views. The newer view matches the EaKiuRemote 2D view. You can toggle between the two views by using the ^ (carat) key. EaKiu defaults at startup to the newer view. In the LINEAR Graph the horizontal axis shows the frequencies in MHz. This will either be the 2.4 GHz spectrum or the 5.0 GHz spectrum depending on your Wi-Spy device. The horizontal chart lines represent the actual channels within that range. Below the chart the channel numbers will appear in white below their specific frequencies. The vertical graph is divided into dBm (signal strength). The closer the signal is to 0, the more powerful it is. At the bottom of the chart will be the bright spectrum graph. This will be colored in the spectrums power color (or for the older style display, yellow bouncing gradient bars). These represent the Average signal at each frequency position. (See below to find out how to switch between AVERAGE and CURRENT for these bars). The dimmer colored spectrum graph which appears delayed behind the brighter graph (or, for the older style display, a solid red line) shows the current Peak value and decays in time. Once the bright spectrum bar goes high the dim spectrum bar will hold that position for 2 seconds before moving back towards the bright bar. This represents the Short-Term Peak of each frequency. The gradient bluish to red/white lines show the Maximum signal strength and also decays in time. After this line has peaked for a minute (60 seconds) it will begin to decay to the current short-term peak. This lets you see the Long Term Peak (or maximum) of the signals amplitude. The colors of this line correspond to the dBm colors and the signals strength. The little white dots stay at the True Maximum and never fall down. This shows the Overall Maximum that each frequency has reached. You can zero both the Long Term Peak and True Maximum lines by clicking the ZERO MAX button in the CONTROL area, or by typing the z key. You can zero ALL the data by clicking the ZERO ALL button in the CONTROL area, or by typing the Z key. While viewing the LINEAR Graph you can move your mouse cursor into the chart area to view the Frequency and Signal Strength of that point in the chart. Using the Viewing-Mode Buttons: On the left side of the Graph area are four buttons. These are the Viewing Mode Buttons, and are marked A, C, P, and M. Some of these buttons work differently for the 2D LINEAR mode than the other 3 modes (3D SPECTRUM, QUAD, and WIRE). When EaKiu first starts running, the A, P, and M buttons are lit and the C button is dim. These four buttons allow you to custom tailor what data is being shown in the 2D LINEAR MULTI-GRAPH. The A and C buttons toggle between each other. That is, if A is lit and you click on C, the A button will dim and the C button will light. The bottom two buttons toggle independently and each can be turned on and off individually. The A Button - This button shows the AVERAGE signal. The amount of the averaging is set in the SETTINGS area in the AVERAGE value. You can change this value by click the left button over the value and mousing left and right, or by typing the { and } keys. The AVERAGE signal is shown by the bouncing yellow bars. The C Button - This button shows the true current signal without any averaging. The CURRENT signal is shown by the bouncing yellow bars. The P Button - The red line shows the short-term peak as a decaying signal over 2 seconds of time. Turning the P button off will turn off this peak line. Turning the P button on will show the peak line. The M Button - The gradient vertical lines shows the long-term maximum as a decaying signal over 1 minute of time. Turning the M button off will turn off the maximum lines. Turning the M button on will turn on the maximum line. Combining The Buttons: You can combine the four buttons in most any combination with the exception being that only A or C can be lit at any one time. You can also turn all four buttons off. To turn the A or C button off, simply click the button that is on. When all four buttons are dim (off) the graph shows the white maximum dots as a gradient colored line (instead of the dots). This is a special mode for tracking just the maximum in a more friendly way than by using just the dots. Clicking the 3d button puts EaKiu into 3D SPECTRUM CHART Graph mode. This mode shows the spectrum over time as a moving chart. The following image shows 3D SPECTRUM CHART Graph mode: Once you switch to the 3D SPECTRUM CHART mode the graph will change and the right hand dBm numbers will shrink to a different position. The horizontal axis still represents channel numbers as it did in the 2D Linear Multi-Graph. The vertical axis no longer represents dBm, but now represents Time. The graph now shows information as colored rectangles. The darker towards blue the color is, the lower the dBm (as indicated by the right hand legend), the more towards red-white the color is, the higher the dBm (more signal strength). Using the Viewing-Mode Buttons: On the left side of the Graph area are four buttons known as the VIEWING MODE BUTTONS, and marked A, C, P, and M. These four buttons work differently for the 2D LINEAR mode than the other 3 modes (3D SPECTRUM, QUAD, and WIRE). For the 3D SPECTRUM mode these four buttons allow you to select which of the four possible views you want to see. All the buttons work as a toggle - selecting one button will turn all the others off, etc. The A Button shows the AVERAGE signal. The amount of the averaging is set in the SETTINGS area in the AVERAGE value. You can change this value by click the left button over the value and mousing left and right, or by typing the { and } keys. The C Button shows the true current signal without any averaging. The P Button shows the Peak chart. The M Button shows the Long-Term Maximum chart. Clicking the QUAD button puts EaKiu into 3D INTERACTIVE QUAD Graph mode. This mode shows the spectrum over time as a fully interactive 3D display: Once you switch to the QUAD mode the graph will change and the right hand dBm numbers will shrink to a different position. The horizontal axis still represents channel numbers as it did in the 2D Linear Multi-Graph. The vertical axis no longer represents dBm, but now represents Time. The graph now shows information as peaks and troughs. The darker towards blue the color is, the lower the dBm (as indicated by the right hand legend), the more towards red-white the color is, the higher the dBm (more signal strength). The QUAD view also has light sources to make the display more appealing. If the light source is causing you problems in viewing the data accurately you can turn the light-source off. To toggle the light source off and on, type the l key. You can rotate, scale, and pan the chart by using a combination of mouse buttons and keyboard keys as follows: Buttons/Keys ActionKeys Description Left Mouse ROTATE To rotate the graph in the horizontal, position the cursor inside the graph, push and hold the LEFT MOUSE BUTTON and move the mouse left and right. Left Mouse TILT To tilt the graph in the vertical, position the cursor inside the graph, push and hold the LEFT MOUSE BUTTON and move the mouse up and down. Right Mouse or CTRL-Left Mouse SCALE To scale the graph in the horizontal, position the cursor inside the graph, push and hold the RIGHT MOUSE BUTTON (or push and hold the CTRL key and LEFT MOUSE BUTTON) and move the mouse left and right. Moving the mouse left will make the chart larger, moving it right will make the chart smaller. Moving the mouse up and down in this mode will TILT the chart in the same direction. SHIFT-Left Mouse PAN To pan (reposition) the graph within the chart push and hold the SHIFT key and LEFT MOUSE BUTTON and move the mouse to the desired position. R Key RESET To reset the graph view to the default view click the RESET button in the CONTROL Area or use the R key. Note that the current rotation/tilt/pan/scale is always stored in the configuration file and reloaded at startup. Using the Viewing-Mode Buttons: On the left side of the Graph area are four buttons known as the VIEWING MODE BUTTONS, and marked A, C, P, and M. These four buttons work differently for the 2D LINEAR mode than the other 3 modes (3D SPECTRUM, QUAD, and WIRE). For the 3D SPECTRUM mode these four buttons allow you to select which of the four possible views you want to see. All the buttons work as a toggle - selecting one button will turn all the others off, etc. The A Button shows the AVERAGE signal. The amount of the averaging is set in the SETTINGS area in the AVERAGE value. You can change this value by click the left button over the value and mousing left and right, or by typing the { and } keys. The C Button shows the true current signal without any averaging. The P Button shows the Peak chart. The M Button shows the Long-Term Maximum chart. Clicking the WIRE button puts EaKiu into 3D INTERACTIVE WIRE Graph mode. This mode shows the spectrum over time as a fully interactive 3D display. This differs from the QUAD view in that the interior of each quad is not drawn, just the wireframe outline is drawn (allowing you to see through the quads): Once you switch to the WIRE mode the graph will change and the right hand dBm numbers will shrink to a different position. The horizontal axis still represents channel numbers as it did in the 2D Linear Multi-Graph. The vertical axis no longer represents dBm, but now represents Time. The graph now shows information as peaks and troughs. The darker towards blue the color is, the lower the dBm (as indicated by the right hand legend), the more towards red-white the color is, the higher the dBm (more signal strength). The WIRE view also has light sources to make the display more appealing. If the light source is causing you problems in viewing the data accurately you can turn the light-source off. To toggle the light source off and on, type the l key. You can rotate, scale, and pan the chart by using a combination of mouse buttons and keyboard keys as follows: Buttons/Keys ActionKeys Description Left Mouse ROTATE To rotate the graph in the horizontal, position the cursor inside the graph, push and hold the LEFT MOUSE BUTTON and move the mouse left and right. Left Mouse TILT To tilt the graph in the vertical, position the cursor inside the graph, push and hold the LEFT MOUSE BUTTON and move the mouse up and down. Right Mouse or CTRL-Left Mouse SCALE To scale the graph in the horizontal, position the cursor inside the graph, push and hold the RIGHT MOUSE BUTTON (or push and hold the CTRL key and LEFT MOUSE BUTTON) and move the mouse left and right. Moving the mouse left will make the chart larger, moving it right will make the chart smaller. Moving the mouse up and down in this mode will TILT the chart in the same direction. SHIFT-Left Mouse PAN To pan (reposition) the graph within the chart push and hold the SHIFT key and LEFT MOUSE BUTTON and move the mouse to the desired position. R Key RESET To reset the graph view to the default view click the RESET button in the CONTROL Area or use the R key. Note that the current rotation/tilt/pan/scale is always stored in the configuration file and reloaded at startup. Using the Viewing-Mode Buttons: On the left side of the Graph area are four buttons known as the VIEWING MODE BUTTONS, and marked A, C, P, and M. These four buttons work differently for the 2D LINEAR mode than the other 3 modes (3D SPECTRUM, QUAD, and WIRE). For the 3D SPECTRUM mode these four buttons allow you to select which of the four possible views you want to see. All the buttons work as a toggle - selecting one button will turn all the others off, etc. The A Button shows the AVERAGE signal. The amount of the averaging is set in the SETTINGS area in the AVERAGE value. You can change this value by click the left button over the value and mousing left and right, or by typing the { and } keys. The C Button shows the true current signal without any averaging. The P Button shows the Peak chart. The M Button shows the Long-Term Maximum chart.   Output Buttons Next to the Graph Type Buttons in the EaKiu window is a set of 2 buttons labeled Output: EaKiu can record and playback Wi-Fi data. Files are recorded by EaKiu in the CSV (Comma Separated Value) format. Each Wi-Spy device in the system can record a separate CSV file simultaneously if desired. Normally EaKiu is not in record mode and the OUTPUT and Recording Information show no light and read "Not Recording". To start EaKiu recording data for the currently viewed device click the RECORD button. You can also start recording by typing the r key. To stop a recording make sure the same device is displayed and simply click the RECORD button again, or type the r key again. If this is the very first time you have started a recording (and you have not snapped an Image yet) you will immediately get a Folder Dialog to allow you to select the desired Folder to store the recording. Select the desired folder from the Folder Dialog and then the Choose button to being recording to that folder. If you have already selected a Folder in a previous session, the last folder you selected will be automatically used to store the recording and you will not see the Folder Dialog. To change the Folder to another Folder, click the small File Icon in the upper center of the window. Once you are recording the RECORD button light will be green and the name of the file you are recording will be in green in the Recording Status area: File names are organized as follows: YYYYMMDD-HHMMSS-n.csv Where YYYY is the year, MM is the month, DD is the day and HH is the hour, mm is the minute and SS is the second. n is an incrementing number to avoid duplicate file names. The files are in CSV (Comma Separated Value) format. The first four records contain identification information that is required for EaKiu to be able to play back the files. The actual data starts with the fifth line in the file. To playback a CSV recording click the CSV button in the Data Source button area. How PAUSE affects recording: The PAUSE button in the CONTROL AREA will pause both Recording as well as Playback for the current device. While the system is in pause mode, no data for the current device will be recorded and no data for the current device will be played back (playback is actually paused). Recording and/or playback for the current device will resume once you take the system out of Pause.   EaKiu can act as both server and a client for remote sensing of wireless data. In fact, it is possible for EaKiu to be a client and server at the same time, if desired. Important Note: Versions of EaKiu prior to version 5.4 use a server format that is incompatible with EaKui 5.4 and up. We recommend upgrading all your EaKiu software to the latest version. If you intend to use EaKiu Remote for iPhone you MUST use EaKiu version 5.4 or later! EaKiu contains a multi-threaded server capable of talking to multiple connected clients simultaneously. By default EaKiu assigns each device a unique port starting with Port 2400. To change the default server port, click the Port: area near the upper right of the window. Once you click the Port: area a Dialog will appear asking you for a different port number: To change the default port, simply enter a new port value into the Dialog and click the OK button. Note that if you change the port while EaKiu is in Server mode you should disconnect and reconnect the server to get it to recognize the new port setting (we recommend setting the port before you enable server mode to avoid disconnecting any remote listeners). Once your port is correct (you do not have to set the port if you intend to use the default port assignments) you can turn Server mode on, for the current device, by simply clicking the SERVER button in the OUTPUT AREA. Once clicked the button should light a deep purple. As soon as users connect to your server you will see the SERVER button for the specific device change from deep purple to green and the Users: area will read the number of connected users (for all servers combined). To disconnect users and turn off the Server for the viewed device simply click the SERVER button again.   The Settings Area In the upper right corner of the EaKiu window is an area labeled Settings: In the SETTINGS area are a number of labeled fields that show information. These fields include: Average, Depth, GHz, CPU, S/F, and F/S. Of these five valued fields three of them are under your control. The fields are defined as follows: Average - This value indicates the number of consecutive samples per channel that are combined (averaged) to make the Average Signal. If AVERAGE is set in your Viewing Mode this will affect the graph display. The larger this number is (it can be as large as the value set by the Depth field) the more data is averaged together to make the final display, and thus the smoother and less noisy the result will be. The smaller this value is, the less values are used to average the signal. Setting this value to zero turns averaging off. You can change this value by using the mouse or the keyboard keys. To change the value with the mouse, position the mouse cursor over the actual number next to the Average label, click and hold the left button and move the mouse to the left to decrease the value and to the right to increase the value. To change the Average value with the keyboard, type the { key to decrease the value and the } key to increase the value. Depth - This value indicates the depth (size) of the sample buffer. EaKiu initially starts with a sample buffer of 400 samples. This means that for each of the frequencies slots there are 400 consecutive sample positions that are retained. The depth can be anywhere between 5 samples and 5000 samples. The more samples you have the more data-over-time you can view in the 3d, Quad, and Wire graphs. You can change this value by using the mouse or the keyboard keys. To change the value with the mouse, position the mouse cursor over the actual number next to the Depth label, click and hold the left button and move the mouse to the left to decrease the value and to the right to increase the value. To change the Depth value with the keyboard, type the < key to decrease the value and the > key to increase the value. GHz / MHz - This field shows the current frequency base that you are monitoring. For most Wi-Spy devices this will read GHz. If you are using a Wi-Spy 900x this will read MHz. CPU - This field shows you the current CPU load on your computer. You can only change this value indirectly by manipulating things like Average, Depth, Data, and F/S. The lower the CPU value is the less load is being placed on your computer. Higher values indicate that the computer is working harder and may be slowing up. Generally values under around 2.5 are considered fine. S/F - This field shows you the current Samples Per Frame. This is the number of Data samples that are being seen for each graphic frame being viewed. This number will most likely flicker rapidly as the number of sampled data is never exactly the same from sample to sample (unless you have a VERY fast computer). The closer to zero or one this number is, the less data you are missing from the input source (actually, a value of zero or one means you are missing NO data at all). Higher numbers indicate that data was received from the input device that was not displayed or incorporated into the data set. You can only change this value indirectly by manipulating things like Average, Depth, Data, and F/S. F/S - This value indicates the Frames Per Second of the graphic drawing layer. This field actually shows two values. The first value is a number and the second value is another number in parenthesis. The first value is the actual frames-per-second currently being displayed. The second value is what you would LIKE the frames-per-second to be. The second number can range between 10 and 121. At the value 121 the number will be replaced with the word OFF. The human eye sees continuous motion anytime a frame-rate is 10 FPS or higher. Frame rates above 30 FPS really don't add much visually, as it is faster than what the eye needs to see motion. The F/S control is the number one way to decrease CPU load. Placing this value at 30 FPS allows the system to limit the drawing speed (as long as it would draw faster than that). Thus, the value you set becomes an 'upper limit' that the system attempts to maintain. If you set the F/S to be OFF, than there are no upper limits and the system will attempt to draw frames as fast as possible (you might see frame rates in the hundreds of frames per second). You can change this value by using the mouse or the keyboard keys. To change the value with the mouse, position the mouse cursor over the actual number next to the F/S label, click and hold the left button and move the mouse to the left to decrease the value and to the right to increase the value. To change the F/S value with the keyboard, type the ( key to decrease the value and the ) key to increase the value.   Density Display Histogram Above the Viewing Mode buttons in the lower left corner is the d Density Histogram Button. This button toggles the Density Histogram Display. Regardless of what other viewing mode and graphing modes you are in, activiting the Density display will override those settings and will display the current density graph: Click the d button again will return the display to the previous settings. The Density Histogram is a useful tool in determining what channels and frequencies are open over an extended period of time. The Density Histogram continues to build up until cleared and reset. Color and position are used to show both the position of signals and the amount of time that position was filled with the signal. The color indicates the amount of time. Green is a relatively short period of time, while yellow is more and red is the most. When reading this chart, you would find areas that are empty of all color to be the most useful frequencies, and areas that have color to be the least useful frequencies. You can also control the Density Display by using the d keyboard key. To clear the Density Display and reset it to zero (allowing a new Density Display to build up over time) use the D keyboard key. Also note that a number of other mode changes (like invoking Locked Base mode, etc) will also automatically clear and reset the Density display.   True Base Mode In the lower right corner of the EaKiu window is an area labeled True Base. This area can have one of three messages in it:        The True Base Mode feature was introduced with EaKiu version 5.4. This mode is useful for some of the newer Wi-Spy devices such as the Wi-Spy 2.4x, the 2.4i, and the DBx. These devices have a much greater DBm sensitivity than the older Wi-Spy devices. True Base Mode addresses the problem of sensitivity outside the actually used spectrum. By default, the system is in True Base mode and what you see is the actual signal being received by the Wi-Spy. If you click the True Base area, or type the b key, you will toggle through three modes. The first click will put you into Active mode. In this mode, EaKiu will display the word Active followed by a 10 second countdown. While the countdown is happening, EaKiu is anaylizing the Wi-Spy signal and determining the noise threshold. After the 10 second countdown, EaKiu enters Locked Base mode. When in Locked Base mode, EaKiu forces the lowest DBm to be that which was sensed during the 10 second Active mode. You will see the results of this most readily in the 3D views, which will cease to have such a huge 'cliff' and offset. This is also very useful for EaKiu Remote displays. Clicking again (or typing the b key) will take it out of Locked Base and back to Active mode again, showing you the true signal. You can repeat this as many times as desired if the signal changes or your position changes.   Device Profiles and Custom Profiles Some MetaGeek Wi-Spy devices support multiple frequency ranges. These devices currently include the Wi-Spy 2.4i, the DBx, and the 900x. EaKiu comes with all the MetaGeek official supported profiles already included in the software. In addition, for any of these devices you can create your own custom profiles. The following chart shows the built-in profiles that come standard in the software: Device Profile Name Start Frequency Resolution Filter Bandwidth Points Per Sweep Wi-Spy DBx Full 5GHz Band 5,160,000 kHz 1,497,070 Hz 428,571 Hz 451 INT 2.4GHz Band 2,400,000 kHz 372,925 Hz 406,250 Hz 255 UNII-1 (Low) Band 5,150,000 kHz 374,268 Hz 428,571 Hz 267 UNII-2 (Mid) Band 5,250,000 kHz 374,268 Hz 428,571 Hz 267 UNII-1 & UNII-2 Bands 5,150,000 kHz 758,535 Hz 428,571 Hz 267 UNII-3 (INT) Band 5,470,000 kHz 1,122,070 Hz 428,571 Hz 227 UNII-4 (Upper) Band 5,725,000 kHz 374,268 Hz 428,571 Hz 267 Wi-Spy 900x US ISM Band 902,000 kHz 101,807 Hz 125,000 Hz 255 EU SRD Band 862,000 kHz 35,973 Hz 53,571 Hz 229 Wi-Spy 2.4i INT 2.4GHz Band 2,400,000 kHz 372,803 Hz 425,571 Hz 255 By default each device in the above table start displaying the first profile in the set. Use the x keyboard key to move to the next profile, or the X keyboard key to move to the previous profile. Creating your own custom profiles: For any of the profile oriented devices, you can create your own custom profiles for these devices. Custom profiles allow you to extend the range (in some cases) as well as narrow portions of the spectrum that you are interested in. When using a profile device, the following areas on the screen are sensitive to mouse clicks: If a non-profile device is the current device, the green "+" button will be grey and will not be clickable. If a profile-oriented device is plugged in and current, the "+" button will be green and clicking it will allow you to add a profile. If you are viewing a profile that you added yourself, clicking anywhere to the left of the green "+" button (e.g., in the device or profile name area) will allow you to edit or delete the current profile. NOTE that you can only modify or delete you own profiles. You can not delete or modify built-in profiles (though you can use a built-in profile to create your own custom profile). To create your own custom profile, click the green "+" button. You will see the following popup appear: Whatever profile you were currently viewing when you click the green "+" button will have the current values pre-loaded into the popup fields. This allows you to make copies and modify any built-in profile. Make changes to the various fields and provide a short name for the profile and then click the Add Profile button. To modify or delete any custom profile you have created, simply view the profile and then click the profile name in the upper left corner. Once you do this you will see the Edit Profile dialog: Make any desired changes in the fields and click the Modify button, or to delete the profile click the Delete button. Note that not all possible combination of values will work. The proper values depends on the actual range of the device and how the values work together. Experiment with various value to get an idea of how they work together. Note: For MetaGeek devices using Protocol 2, the Samples per point: field will instead be a dwell time field.   The Airport Area Just above the spectrum chart in the EaKiu window is the Airport area. This area displays any networks that are discovered (when in 2.4 GHz frequency range): You can toggle whether or not Airport is being used by typing the A key. Airport mode is on by default. When AIRPORT is on, any channels that are seen will appear as little triangles above the frequency chart itself. If there is an open channel it is shown in green. Secure channels are shown in red. To the left of the triangle is a number which indicates how many different devices were found on that channel. Just above the triangle is a small white number which is the channel number. You can type the a key to see an entire list of all seen access points. Channels with multiple access points will show all access points.   Keyboard Help In the very upper right corner of the EaKiu window is the HELP button. You can also access the help display by typing a h or ? key: The following chart outlines each keystroke available in EaKiu: A Toggle the use of AIRPORT. If AIRPORT is OFF, this turns it ON, if AIRPORT is ON, this turns it OFF. By default AIRPORT is ON the first time EaKiu is run. When ON EaKiu uses the Apple AIRPORT connection to sniff wireless access points. When access points are found they will appear as small green and red arrows above the chart in the corresponding channel locations (red arrows for SECURE and green arrows for OPEN networks). Use the 'a' key to see a list of all networks. a When using AIRPORT mode, the this key will show a list of all the channels and what networks are on them (if more than one network is on the same channel only one will be shown for that channel). If a channel is no longer a network it grays out but the information is still visible. To return to the main display hit any key. b Use this key to toggle through the three steps in True Base mode. The first time you hit this key, True Base will switch to a yellow Active Base and a 10 second countdown will begin. If you do nothing else, at the end of the 10 second countdown the mode will switch to Locked Base. If you hit this key while the countdown is commencing, the countdown will be stopped and Locked Base will immediatly be asserted. If you hit this key while in Locked Base mode, True Base will again be the new mode. d Use this key to toggle the Density Histogram Display. The first time you hit this key, any current display is replaced with the Density Histogram Display. Hitting the key a second time will revert the display back to the original information. D Use this key to clear and reset the Density Histogram Display. After you hit this key, a new Density Histogram will begin to be built. g Use this key to switch graphing modes. The first time EaKiu is run it comes up in the LINEAR multi-graph. Typing thas key once and EaKiu will show the 3D Spectrum Graph. Type it again and EaKiu will show the 3D Interactive Quad Graph. Typing it once more will show the 3D Interactive Wireframe Graph. Clicking it again brings you back to the original LINEAR Multi-Graph. G This key is identical to the g key with the only difference being that it moves in the opposite direction. h Shows a brief Help page of interactive and command line options. To return to the main display hit any key. i Captures the current EaKiu window as an image and saves it in a file in the current directory. The file is named: YYYYMMDD-HHmmSS.tga Where 'YYYY' is the year, 'MM' is the month, 'DD' is the day and 'HH' is the hour, 'mm' is the minute and 'SS' is the second. The file is stored as a RGB TGA (.tga) file (Truevision file format). Most image programs can read this format. l When in either the 3D Interactive Quad Graph or 3D Interactive Wireframe Graph this key will toggle 3D lighting ON and OFF. The lighting defaults to ON. Lighting can often enhance the readability of the QUAD and WIRE graphs. If you find that lighting interferes with viewing the graph turn it OFF. p Pauses the current device being viewed in EaKiu. While paused no data is recorded or displayed for the paused device. Hit any key to un-pause. q This key quits EaKiu and writes the current configuration file out to disk. This is the normal way to exit the program. See also the Q command below. Q This key quits EaKiu but does NOT write any configuration file to disk. r This key starts and stops RECORDING mode. When recording EaKiu writes the streaming the devices wi-fi data to a CSV file (comma separated value). Click r once to start RECORDING and click r again to STOP recording. Each recording will be stored in a file with the name: YYYYMMDD-HHmmSS-n.csv Where 'YYYY' is the year, 'MM' is the month, 'DD' is the day and 'HH' is the hour, 'mm' is the minute and 'SS' is the second. 'n' is an incrementing number to avoid duplicate files. R This key will reset all values that were overridden by the configuration file, thus returning a running program back to initial default conditions. s Each time you click this key EaKiu will switch between all your active data sources. w Each time you click this key EaKiu will switch between only your active USB (Wi-Spy) data sources. x When using a Wi-Spy device that supports multiple profiles, clicking this key will move to the next profile defined for that device. X When using a Wi-Spy device that supports multiple profiles, clicking this key will move to the previous profile defined for that device. z This key will zero ONLY the Maximum data - allowing new maximums to be tracked. Z This key will zero all the data. All arrays (Current, Peak, Maximum, and Average) are all reset to base values. ? This key is identical to the h key and displayes the help page. + If the Wi-Spy you are monitoring supports profiles (e.g., the DBx, the 2.4i, and the 900x), tapping this key will bring up the Add Profile display allowing you to create new frequency profiles. del If your are viewing a custom profile that you created, clicking the delete key will remove that profile and will begin displaying the next profile for that device. ^ If your are viewing the 2D linear graph the carat key (^) will toggle between the newer EaKiuRemote style display to the older EaKiu display. The differences are in how the Average/Current and Peak displays are drawn. In the older EaKiu format, Peak is a red line that decreases over time. Average/Current were yellow gradient rectangles. In the newer EaKiuRemote style display, Peak is a dim colored spectrum and Average/Current is the same spectrum but bright. The system now defaults to the newer format at startup. ( ) This will slow down ( or speed up ) the GL frame rate (frames per second) at which the window is refreshed. The values can span between 10 and 110 and indicate approximate frames per second. If you set the value to 111 it will read "OFF" and frame rate limiting will totally be turned off (meaning that GL will run full-speed). With version 1.4 the FPS defaults to 30 frames per second. Note that this is an approximation only. You can set FPS to a value that may be unreachable due to the current complexity of the display. The system tries to maintain as close to the selected FPS as it can, based on what else is happening in the system. < > This will decrease < or increase > the chart depth used for the 3D, and LINEAR averaging views. By default the chart depth is set to 400 rows. You can decrease the chart depth to as low as 5, or as high as 5000. Higher values allow you to view more consecutive samples of data (at a slower rate depending on your CPU). { } This will decrease { or increase } the flowing average. By default the flowing average is set to 3 consecutive samples. Using these keys you can get the flowing average to range anywhere from a low of 3 to a high of the current chart depth. The higher the value, the more consecutive signals are averaged to produce the average display for the charts. Use this to filter out noise or spikes in the data.   Help Support EaKiu EaKiu is provided at no charge and is kept up to date to the latest Wi-Spy devices by our programmers. If you find EaKiu to be invaluable to your work, please consider one of the two following ways that you can help us keep EaKiu development going: If you own an iPhone or iPod touch, consider purchasing our EaKiu Remote for iPhone. This $29.99 application is available from the iTunes App Store and lets you monitor EaKiu in Server mode from from your iPhone device. If you do not own an iPhone or iPod touch consider making a monetary Donation to help support EaKiu Development. Thank you very much!