Merge pull request #438 from oopsbagel/doc-supported-devices

documentation: Attempt to clarify supported devices

doc/supported-devices.md

@@ -1,17 +1,29 @@
 # Supported devices
 
+Be sure to check your location's [supported frequencies](https://www.frequencycheck.com/) against a device page before obtaining a device.
+
+## 1. Recommended devices
+These devices have been extensively tested by the core developers and are widely used. **Use one of these devices if you can.**
+
+| Device | Recommended region |
+| ------ | ------ |
+| [Orbic RC400L](./orbic.md) | Americas |
+| [TP-Link M7350](./tplink-m7350.md) | Africa, Europe, Middle East |
+
+The TP-Link M7350 also works in the Americas but is usually more expensive.
+
+![device_regions](device_regions.svg)
+_Derivative work of [this file](https://commons.wikimedia.org/wiki/File:International_Telecommunication_Union_regions_with_dividing_lines.svg) by [Maximillian Dörrbecker](https://de.wikipedia.org/wiki/User:Chumwa) licensed [CC BY-SA 2.5](https://creativecommons.org/licenses/by-sa/2.5)_
+
+## 2. Functional devices
+Rayhunter is confirmed to work on these devices.
+
+| Device | Recommended region |
+| ------ | ------ |
+| [Wingtech CT2MHS01](./wingtech-ct2mhs01.md) | Americas |
+| [TP-Link M7310](./tplink-m7310.md) | Africa, Europe, Middle East |
+
+## Adding new devices
 Rayhunter was built and tested primarily on the Orbic RC400L mobile hotspot, but the community has been working hard at adding support for other devices. Theoretically, if a device runs a Qualcomm modem and exposes a `/dev/diag` interface, Rayhunter may work on it.
 
 If you have a device in mind which you'd like Rayhunter to support, please [open a discussion on our Github](https://github.com/EFForg/rayhunter/discussions)!
-
-## Tier 1 - Fully supported devices
-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)
-
-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/wingtech-ct2mhs01.md

@@ -4,24 +4,6 @@ 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>
-
-Rayhunter has been tested on 
-
-```sh
-WT_INNER_VERSION=SW_Q89323AA1_V057_M10_CRICKET_USR_MP
-WT_PRODUCTION_VERSION=CT2MHS01_0.04.55
-WT_HARDWARE_VERSION=89323_1_20
-```
-
-Please consider sharing the contents of your device's /etc/wt_version file here.
-
 ## Supported bands
 
 There are likely variants of the device for all three ITU regions.
@@ -39,6 +21,13 @@ According to FCC ID 2APXW-CT2MHS01 Test Report No. [I20N02441-RF-LTE](https://ap
 
 Note that Band 5 (850 MHz, CLR) is suitable for roaming in ITU regions 2 and 3.
 
+## Hardware
+Wingtechs are abundant on ebay and can also be found on Amazon:
+- <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>
+
 ## Installing
 Connect to the Wingtech's network over wifi or usb tethering, then run the installer:
 
@@ -68,3 +57,13 @@ similarly to the Orbic RC400L, although the userspace program
 Orbic. This causes the green line on the screen to subtly flicker and
 only be displayed during some frames. Subsequent work to fully control
 the display without removing the OEM interface is desired.
+
+Rayhunter has been tested on:
+
+```sh
+WT_INNER_VERSION=SW_Q89323AA1_V057_M10_CRICKET_USR_MP
+WT_PRODUCTION_VERSION=CT2MHS01_0.04.55
+WT_HARDWARE_VERSION=89323_1_20
+```
+
+Please consider sharing the contents of your device's /etc/wt_version file here.