From d03debe67c53083ab9c0fd4e0953eba40a98e048 Mon Sep 17 00:00:00 2001 From: oopsbagel Date: Sun, 29 Jun 2025 02:05:58 -0700 Subject: [PATCH 1/4] doc: add region table, map for recommended devices Implement reordering from untitaker's suggested changes. --- doc/device_regions.svg | 14708 +++++++++++++++++++++++++++++++++++++ doc/supported-devices.md | 34 +- 2 files changed, 14731 insertions(+), 11 deletions(-) create mode 100644 doc/device_regions.svg diff --git a/doc/device_regions.svg b/doc/device_regions.svg new file mode 100644 index 00000000..9ab9d82a --- /dev/null +++ b/doc/device_regions.svg @@ -0,0 +1,14708 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A + B + C + C + C + +Orbic RC400LTP-Link M7350 diff --git a/doc/supported-devices.md b/doc/supported-devices.md index 1dd24dd8..f7ae6765 100644 --- a/doc/supported-devices.md +++ b/doc/supported-devices.md @@ -1,17 +1,29 @@ # Supported 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. +Be sure to check your location's [supported frequencies](https://www.frequencycheck.com/) against a device page before obtaining a device. -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)! +## 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 | 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. -## 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) +![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)_ -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. +## 2. Functional devices +Rayhunter is confirmed to work on these devices. -## 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) +| Device | Region | +| ------ | ------ | +| [Wingtech CT2MHS01](./wingtech-ct2mhs01.md) | Americas | +| [TP-Link M7310](./tplink-m7310.md) | Africa, Europe, Middle East & Americas | + +## 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)! From 664ffc8c758a7013e11377938de7e59d81a74c48 Mon Sep 17 00:00:00 2001 From: oopsbagel Date: Sun, 29 Jun 2025 02:07:22 -0700 Subject: [PATCH 2/4] doc: move wingtech developer details to the bottom --- doc/wingtech-ct2mhs01.md | 35 +++++++++++++++++------------------ 1 file changed, 17 insertions(+), 18 deletions(-) diff --git a/doc/wingtech-ct2mhs01.md b/doc/wingtech-ct2mhs01.md index ab220127..efe270a4 100644 --- a/doc/wingtech-ct2mhs01.md +++ b/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: -- -- -- -- - -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: +- +- +- +- + ## 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. From 8de4dcfd187b45331488523383c418aa19a7e043 Mon Sep 17 00:00:00 2001 From: oopsbagel Date: Sun, 29 Jun 2025 12:14:54 -0700 Subject: [PATCH 3/4] doc: add white background to map for dark mode --- doc/device_regions.svg | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/doc/device_regions.svg b/doc/device_regions.svg index 9ab9d82a..dae88845 100644 --- a/doc/device_regions.svg +++ b/doc/device_regions.svg @@ -27,7 +27,7 @@ inkscape:pagecheckerboard="0" inkscape:deskcolor="#d1d1d1" inkscape:zoom="0.8773442" - inkscape:cx="749.99071" + inkscape:cx="750.56061" inkscape:cy="210.29375" inkscape:window-width="2560" inkscape:window-height="1392" @@ -35,7 +35,15 @@ inkscape:window-y="27" inkscape:window-maximized="1" inkscape:current-layer="svg9" /> - Date: Sun, 29 Jun 2025 12:16:07 -0700 Subject: [PATCH 4/4] doc: supported devices: say "recommended region" Individual device pages can go into detail about specific bands and roaming. This page is primarily for steering users towards which device to buy, and we only want to recommend devices that are affordable in their region. --- doc/supported-devices.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/supported-devices.md b/doc/supported-devices.md index f7ae6765..51f5ca57 100644 --- a/doc/supported-devices.md +++ b/doc/supported-devices.md @@ -5,7 +5,7 @@ Be sure to check your location's [supported frequencies](https://www.frequencych ## 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 | Region | +| Device | Recommended region | | ------ | ------ | | [Orbic RC400L](./orbic.md) | Americas | | [TP-Link M7350](./tplink-m7350.md) | Africa, Europe, Middle East | @@ -18,10 +18,10 @@ _Derivative work of [this file](https://commons.wikimedia.org/wiki/File:Internat ## 2. Functional devices Rayhunter is confirmed to work on these devices. -| Device | Region | +| Device | Recommended region | | ------ | ------ | | [Wingtech CT2MHS01](./wingtech-ct2mhs01.md) | Americas | -| [TP-Link M7310](./tplink-m7310.md) | Africa, Europe, Middle East & 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.