diff --git a/doc/SUMMARY.md b/doc/SUMMARY.md index 4ae6ee6..ddd5114 100644 --- a/doc/SUMMARY.md +++ b/doc/SUMMARY.md @@ -17,5 +17,6 @@ - [TP-Link M7310](./tplink-m7310.md) - [Tmobile TMOHS1](./tmobile-tmohs1.md) - [Wingtech CT2MHS01](./wingtech-ct2mhs01.md) + - [PinePhone and PinePhone Pro](./pinephone.md) - [Support, feedback, and community](./support-feedback-community.md) - [Frequently Asked Questions](./faq.md) diff --git a/doc/pinephone.md b/doc/pinephone.md new file mode 100644 index 0000000..444d038 --- /dev/null +++ b/doc/pinephone.md @@ -0,0 +1,62 @@ +# PinePhone and PinePhone Pro + +The PinePhone and PinePhone Pro both use a Qualcomm mdm9607 modem as part of their [Quectel EG25-G LTE module](https://www.quectel.com/product/lte-eg25-g/). The EG25-G has global LTE band support and contains a GNSS positioning module. Rayhunter does not currently make direct use of GNSS. + +The modem is fully capable of running Rayhunter, but lacks both a screen and a network connection. The modem exposes an AT interface that can enable adb. + +## Hardware +- +- + +## Supported bands + +| Band | Frequency | +| ---- | ----------------- | +| 1 | 2100 MHz (IMT) | +| 2 | 1900 MHz (PCS) | +| 3 | 1800 MHz (DCS) | +| 4 | 1700 MHz (AWS-1) | +| 5 | 850 MHz (CLR) | +| 7 | 2600 MHz (IMT-E) | +| 8 | 900 MHz (E-GSM) | +| 12 | 700 MHz (LSMH) | +| 13 | 700 MHz (USMH) | +| 18 | 850 MHz (LSMH) | +| 19 | 850 MHz (L800) | +| 20 | 800 MHz (DD) | +| 25 | 1900 MHz (E-PCS) | +| 26 | 850 MHz (E-CLR) | +| 28 | 700 MHz (APT) | +| 38 | 2600 MHz (IMT-E) | +| 39 | 850 MHz (E-CLR) | +| 40 | 2300 MHz (S-Band) | +| 41 | 2500 MHz (BRS) | + +Note that the Quectel EG25-G does not support LTE band 48 (CBRS 3500MHz), used in the US for unlicensed 4G/5G connectivity. + +## Installing +```sh +./installer pinephone +``` + +## Accessing rayhunter +Because the modem does not have its own display or network interface, rayhunter is only accessible on the pinephone by forwarding tcp over adb. + +```sh +adb forward tcp:8080 tcp:8080 +``` + +## Shell access +Use this command to enable adb access: + +```sh +./installer util pinephone-start-adb +adb shell +``` + +## Power saving (disable adb) +The modem won't be able to sleep (power save) with adb enabled, even if Rayhunter is stopped. Disable adb with the following command: + +```sh +./installer util pinephone-stop-adb +``` diff --git a/doc/supported-devices.md b/doc/supported-devices.md index 92f82d6..db6751e 100644 --- a/doc/supported-devices.md +++ b/doc/supported-devices.md @@ -23,6 +23,7 @@ Rayhunter is confirmed to work on these devices. | [Wingtech CT2MHS01](./wingtech-ct2mhs01.md) | Americas | | [Tmobile TMOHS1](./tmobile-tmohs1.md) | Americas | | [TP-Link M7310](./tplink-m7310.md) | Africa, Europe, Middle East | +| [PinePhone and PinePhone Pro](./pinephone.md) | Global | ## 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.