Merge pull request #421 from EFForg/doc-recommended-devices

doc: Give guidance on which device to get

doc/SUMMARY.md

@@ -12,9 +12,9 @@
   - [Rayhunter's heuristics](./heuristics.md)
   - [How we analyze a capture](./analyzing-a-capture.md)
 - [Supported devices](./supported-devices.md)
+  - [Orbic RC400L](./orbic.md)
   - [TP-Link M7350](./tplink-m7350.md)
   - [TP-Link M7310](./tplink-m7310.md)
-  - [Orbic RC400L](./orbic.md)
   - [Wingtech CT2MHS01](./wingtech-ct2mhs01.md)
 - [Support, feedback, and community](./support-feedback-community.md)
   - [Frequently Asked Questions](./faq.md)

doc/installing-from-release-windows.md

@@ -4,7 +4,7 @@ Windows support in Rayhunter's installer is a work-in-progress. Depending on the
 
 ## TP-Link
 
-1. Connect the device via WiFi or USB Tethering -- you should be able to view the TP-Link admin page on [http://192.168.0.1](http://192.168.0.1).
+1. Connect the device via WiFi or USB Tethering -- you should be able to view the TP-Link admin page on <http://192.168.0.1>.
 2. Download the latest release (must be at least 0.3.0), and unpack the zipfile.
 3. Open PowerShell or CMD in that extracted folder, and run the binary appropriate for your operating system: `./installer-windows-x86_64/installer tplink`
 4. Follow the instructions on the screen, if there are any.

doc/supported-devices.md

@@ -8,8 +8,10 @@ If you have a device in mind which you'd like Rayhunter to support, please [open
 These devices have been extensively tested by the core developers and are widely used. We recommend running Rayhunter on one of these devices if you can.
 - [Orbic RC400L](./orbic.md)
 - [TP-Link M7350](./tplink-m7350.md)
-- [TP-Link M7310](./tplink-m7310.md)
+
+If you are in the US, use the Orbic. TP-Link M7350 also works but is usually more expensive to obtain. Otherwise use TP-Link M7350.
 
 ## Tier 2 - Functional devices
 Some developers have succeeded in getting Rayhunter running on these devices, but they have not received the same level of adoption as tier 1 devices.
 - [Wingtech CT2MHS01](./wingtech-ct2mhs01.md)
+- [TP-Link M7310](./tplink-m7310.md)

doc/tplink-m7310.md

@@ -1,6 +1,10 @@
 # TP-Link M7310
 
-The TP-Link M7310 is **supported by Rayhunter since 0.3.5**. The device
-works similarly to the [M7350](./tplink-m7350.md) and is essentially an older,
-more expensive version of it. Hardware version v1.0 has been successfully
-tested, later versions may work as well.
+Supported in Rayhunter since version 0.4.0.
+
+The TP-Link M7310 works similarly to the [M7350](./tplink-m7350.md) and is
+essentially an older, more expensive version of it. The installation procedure
+is identical, `./installer tplink`.
+
+Hardware version v1.0 has been successfully tested, later versions may work as
+well.

doc/tplink-m7350.md

@@ -1,6 +1,8 @@
 # TP-Link M7350
 
-The TP-Link M7350 is **supported by Rayhunter since 0.3.0**. TP-Link M7350 supports many more frequency bands than Orbic and therefore works in Europe and also in some Asian and African countries.
+Supported in Rayhunter since version 0.3.0.
+
+The TP-Link M7350 supports many more frequency bands than Orbic and therefore works in Europe and also in some Asian and African countries.
 
 ## Hardware versions
 
@@ -26,7 +28,7 @@ You can get your TP-Link M7350 from:
 
 ## Installation & Usage
 
-Follow the [release installation guide](./installing-from-release.md). Substitute `./installer orbic` for `./installer tplink` in other documentation. The Rayhunter UI will be available at [http://192.168.0.1:8080](http://192.168.0.1:8080).
+Follow the [release installation guide](./installing-from-release.md). Substitute `./installer orbic` for `./installer tplink` in other documentation. The Rayhunter UI will be available at <http://192.168.0.1:8080>.
 
 ## Obtaining a shell
 

doc/using-rayhunter.md

@@ -11,15 +11,15 @@ It also serves a web UI that provides some basic controls, such as being able to
 You can access this UI in one of two ways:
 
 * **Connect over WiFi:** Connect your phone/laptop to your device's WiFi
-  network and visit [http://192.168.1.1:8080](http://192.168.1.1:8080) (orbic)
-  or [http://192.168.0.1:8080](http://192.168.0.1:8080) (tplink).
+  network and visit <http://192.168.1.1:8080> (orbic)
+  or <http://192.168.0.1:8080> (tplink).
 
   Click past your browser warning you about the connection not being secure, Rayhunter doesn't have HTTPS yet.
 
   On the **Orbic**, you can find the WiFi network password by going to the Orbic's menu > 2.4 GHz WIFI Info > Enter > find the 8-character password next to the lock 🔒 icon.
   On the **TP-Link**, you can find the WiFi network password by going to the TP-Link's menu > Advanced > Wireless > Basic Settings.
 
-* **Connect over USB (Orbic):** Connect your device to your laptop via USB. Run `adb forward tcp:8080 tcp:8080`, then visit [http://localhost:8080](http://localhost:8080).
+* **Connect over USB (Orbic):** Connect your device to your laptop via USB. Run `adb forward tcp:8080 tcp:8080`, then visit <http://localhost:8080>.
     * For this you will need to install the Android Debug Bridge (ADB) on your computer, you can copy the version that was downloaded inside the `releases/platform-tools/` folder to somewhere else in your path or you can install it manually.
     * You can find instructions for doing so on your platform [here](https://www.xda-developers.com/install-adb-windows-macos-linux/#how-to-set-up-adb-on-your-computer), (don't worry about instructions for installing it on a phone/device yet).
     * On MacOS, the easiest way to install ADB is with Homebrew: First [install Homebrew](https://brew.sh/), then run `brew install android-platform-tools`.

doc/wingtech-ct2mhs01.md

@@ -5,11 +5,12 @@ Supported in Rayhunter since version 0.4.0.
 The Wingtech CT2MHS01 hotspot is a Qualcomm mdm9650-based device with a screen available for US$15-35. This device is often used as a base platform for white labeled versions like the T-Mobile TMOHS1. AT&T branded versions of the hotspot seem to be the most abundant.
 
 ## Hardware
+
 Wingtechs are abundant on ebay and can also be found on Amazon:
-- https://www.amazon.com/AT-Turbo-Hotspot-256-Black/dp/B09YWLXVWT
-- https://www.ebay.com/itm/135205906535
-- https://www.ebay.com/itm/126987839936
-- https://www.ebay.com/itm/127147132518
+- <https://www.amazon.com/AT-Turbo-Hotspot-256-Black/dp/B09YWLXVWT>
+- <https://www.ebay.com/itm/135205906535>
+- <https://www.ebay.com/itm/126987839936>
+- <https://www.ebay.com/itm/127147132518>
 
 Rayhunter has been tested on