Nobody asked for it but it's here, so you might as well give it a spin...
It's mainly designed for laptop users but I've heard quite a few "nonstandard" uses for it:
The idea behind it: you map WiFi SSID names to "friendly" names like "home", "at work", "at school" and, where applicable, for a given SSID you can map signal strenghth intervals to "positions" like [80-100%] would be close to the router, so it would be "in my room"; [30-80%] would be "in the house" and [0-30%] could be "in the basement".
A technical note: I've avoided ATL and MFC as deployed technologies so that no additinal installs are required (in this sense I have a new "scaffold" for a VC 2008 plugin DLL, ask if interested); the API used for the detection of WiFi signals has been found missing on some computers running XP SP3 (even though Microsoft's documentation says this shouldn't happen). If this
does happen, go here:
http://www.microsoft.com/downloads/details.aspx?familyid=52A43BAB-DC4E-413F-AC71-158EFD1ADA50&displaylang=en Disregard the "Supported Operating Systems: Windows XP Service Pack 2" at the bottom, it works just fine on SP3 too; a fair warning: it'll ask you to reboot your system.
An application (.exe) made with that API that is run on a system where the API isn't present will report that it cannot start for various reasons (missing DLL file, improper configuration etc); if you try to load the plugin DLL in HyperIM, I have no honest clue what would happen; most likely it will either fail to load the plugin or, in the worst case, it will crash; proceed with caution. If you have Vista or Win7, I've heard of no problems regarding the API there.
Instructions: The configuration panel has "Networks" on the left side ,"Maps" on the right and some general configurations in the bottom.
The "Networks" part is where you associate SSIDs with your own names for them. Just type them in and click "Add/Edit", it will add a new entry or update an existing one if the name is already taken. You can select one already in the list and it will copy its data in the edit boxes.
"Unknown" refers to "any other SSID that isn't in the list" and "Disconnected" refers to whenever you're not on WiFi (ie. a cable connection). If you check the "Mapped" checkbox, that particular SSID will become mapped and the right part ("Maps") of the config will "light up" to allow you to edit. That part is a bit more tricky: "From" means the starting percentage of the range; the end is the start of the next one or implicitely "100%" if the end of the list is reached. The example given in the description would map as: From 0: "in the basement"; From 30: "in the house"; From 80: "in my room". There are three types of ranges you can set up: Normal (just like above, normal named ranges), Null (unnamed ranges) and Hysteresis (ranges that will keep your previous position's value if your signal drifts into it). "Unknown" refers to the name the "", Null ranges and any value outside of any defined range (the only way in which you could do that, that I know of would be to delete the From 0 range).
Also, the plugin defines a separator that takes one of two values, based on whether both the "location" and "position" are present (and not ""), and if either or both are absent.
Another short technical note: SSIDs have no name constraints (like invalid symbols etc) and hence I've left the naming parameters unchecked. Be careful since you can accidentally add "" in the list. I've had security in mind when I designed this so it's unlikely you'll BOF the plugin, but you might not get the expected results if you mess with it too much. Be careful if you want to edit its raw config file, too, the format isn't hard to figure out but I wouldn't recommend it.
And a final disposition: I really hope this will be useful to at least a few people; please report any dubious behavior and/or crashes. Enjoy!
