OnePlus X (oneplus-onyx)

Features
Flashing Whether it is possible to flash the device with pmbootstrap flasher.	Partial
USB Networking After connecting the device with USB to your PC, you can connect to it via telnet (initramfs) or SSH (booted system).	Works
Internal storage eMMC, SD cards, UFS...	Untested
SD card Also includes other external storage cards.	Untested
Battery Whether charging and battery level reporting work.	Untested
Screen Whether the display works; ideally with sleep mode and brightness control.	Broken
Touchscreen	Untested
Multimedia
3D Acceleration	Untested
Audio Audio playback, microphone, headset and buttons.	Untested
Camera	Untested
Camera Flash	Untested
Connectivity
WiFi	Untested
Bluetooth	Untested
GPS	Untested
Modem
Calls	Untested
SMS	Untested
Mobile data	Untested
Miscellaneous
FDE Full disk encryption and unlocking with unl0kr.	Partial
USB OTG USB On-The-Go or USB-C Role switching.	Untested
Sensors
Accelerometer Handles automatic screen rotation in many interfaces.	Untested
Magnetometer Sensor to measure the Earth's magnetism	Untested
Ambient Light Measures the light level; used for automatic screen dimming in many interfaces.	Untested
Proximity	Untested
Hall Effect Measures magnetic fields; usually used as a flip cover sensor	Untested
Haptics	Untested
Power Sensor Sensor to monitor current, voltage and power. Not fuel gauge!	Untested

OnePlus X
	; Oneplus X running Weston demos
Manufacturer	OnePlus
Name	X
Codename	oneplus-onyx
Model	E1001, E1003, E1005
Released	2015
Type	handset
Hardware
Chipset	Qualcomm Snapdragon 801 (MSM8974AB)
CPU	Quad-core (4x 2.3 GHz Krait 400)
GPU	450 MHz Adreno 330
Display	5 inch 16:9, 1080x1920 60 Hz AMOLED, 24 Bit (16777216 colors)
Storage	16 GB EMMC 5.0 + microSDXC + USB OTG
Memory	3 GB 800 MHz LPDDR3 dual-channel
Architecture	armv7
Software
Original software The software and version the device was shipped with.	Android (OxygenOS/HydrogenOS) 5.1.1
Extended version The most recent supported version from the manufacturer.	Android (OxygenOS/HydrogenOS) 6.0.1
Optional software	Android (LineageOS) (Unofficial)
FOSS bootloader	no
Nura
Category	archived
Pre-built images Whether pre-built images are available from the Nura Installation page.	no
Mainline Instead of a Linux kernel fork, it is possible to run (Close to) Mainline.	no
pmOS kernel The kernel version that runs on the device's port.	3.4.0
Device package	device-oneplus-onyx
Kernel package	linux-oneplus-onyx
Firmware package	firmware-oneplus-onyx out-of-tree

This device has been archived. This means that it no longer appears in pmbootstrap and is likely broken.
It can still be selected in pmbootstrap init by typing in the vendor and codename, but you will have to build the kernel package manually.

This device is based on the Snapdragon 801.
See the SoC page for common tips, guides and troubleshooting steps

Contributors

magmastonealex
Nimayer(Symmetrist)

Device owners

Fell (Notes: shattered screen)
Madhaxbro (Notes: ONE E1003, runs LineageOS + TWRP. Ready for testing. Rare. Does not boot lk2nd without porting. Could run mainline some day.)

Model variants

OnePlus X "Onyx"

ONE E1001 (China?) - Compatible.
ONE E1003 (Global?) - Compatible.
ONE E1005 (US?) - Compatible.

Also see #Similar devices.

Boot modes

Fastboot - hold Volume Up+Power

Recovery - hold Volume Down+Power

DFU (EDL) mode - connect a USB host or charger, then hold Volume Down+Power, or (using Fastboot) - execute $ fastboot reboot edl, or (with USB debugging enabled) - execute $ adb reboot edl on a connected USB host - This button combination is for recent OnePlus phones. Unconfirmed.

UART mode - appears to have a setting in aboot, should be $ fastboot oem uart enable - Needs more research.

JTAG mode - Needs investigation. For more details, see Serial debugging/Cable schematics.

Installation

Fastboot installation fails with an error like this.

Android recovery installation via sideload is recommended, as explained here.

Downstream kernel

What works

with LineageOS-built kernel

Boot with LineageOS kernel (with Nura configuration)
Weston
Touchscreen

With Nura built kernel

Boot
Touchscreen (but NOT display)

What does not work

Everything else

Mainline kernel

Currently unsupported. This device needs lk2nd support, and a DTS in the MSM8974 kernel fork. The panel may require firmware or a driver for lk2nd to work.

Mainlining TODO

See Mainlining Guide, MSM8916 Mainlining.
Needs lk2nd working. Sources
Needs a Device Tree (dtb). This could be a starting point. Bacon has similar firmware and hardware. See #Similar devices.
Probably needs a panel driver as well.

Notes

Development

Initial toolchain problems (now fixed)

Useful software

Bootloader builds

Latest official lk2nd build Required to boot mainline. Currently unsupported. Do not try this if you want a booting device!

Recovery builds

Latest official TWRP build Required to install without lk2nd. See #Installation.

Android builds

Latest unofficial LineageOS build Most up to date Custom ROM. Based on Android 13.

Device support

device-oneplus-onyx Deviceinfo.
linux-oneplus-onyx Downstream kernel. Currently experimental. Needs testing.
linux-postmarketos-qcom-msm8974 Mainlinine kernel. Currently unsupported.
firmware-oneplus-onyx ^out-of-tree Firmware.

Links

Source code

Specifications

GSMArena (Ads!)
DeviceSpecifications (Ads!)

Wiki pages

LineageOS Wiki

SailfishOS Wiki

Similar devices

OnePlus One (oneplus-bacon) Different SoC revision. Already boots mainline.
Oppo_Find_7a_(oppo-find-7a) Same SoC revision. Looks like bacon. Could be the same board as onyx or a similar one. Like OnePlus, Oppo belongs to BBK Electronics. Needs more research into compatibility.
Google_Nexus_5_(lg-hammerhead) Different SoC revision. Already boots mainline. Well supported and maintained.
Fairphone_2_(fairphone-fp2) Same SoC revision. Already boots mainline.
HTC_One_M8_(htc-m8) Same SoC revision. Already boots mainline.
Sony_Xperia_Z2_(sony-sirius) Same SoC revision. Already boots mainline.
Sony_Xperia_Z2_Tablet_LTE_(sony-castor) Same SoC revision. Already boots mainline.

Photos