Qualcomm Snapdragon 820/821 (MSM8996)
 MSM8996 in ceramic capsule | |
| Manufacturer | Qualcomm |
|---|---|
| Name | MSM8996 |
| Codenames | msmthulium/apqthulium |
| Architecture | aarch64 |
| CPU | 2x 2.2/2.3 GHz Kryo, 2x 1.6 GHz Kryo |
| GPU | Adreno 530 |
| Year | 2016 |
| Process | 14nm |
| Mainline | yes |
| Community Page | https://gitlab.com/msm8996-mainline |
| Components | |
| CPU |
Partial |
| UART |
Works |
| Storage |
Partial |
| USB |
Works |
| Display |
Works |
| GPU |
Works |
| Pinctrl |
Works |
| I²C |
Works |
| SPI | |
| Audio |
Works |
| Video |
Works |
| Thermal |
Works |
| Modem |
Partial |
| GPS | |
| Camera |
Partial |
| NPU | |
| Suspend |
Broken |
| Ethernet | |
MSM8996/APQ8096 (or Snapdragon 820) is a Qualcomm SoC released in 2016, with great mainline support orginally added for the Dragonboard 820c. There is also a slightly higher clocked (and supposedly less problematic architecture-wise) MSM8996Pro also known as Snapdragon 821.
Devices
APQ8096(SG) (Snapdragon 820E, WiFi-only)
| Device | Codename | Mainline |
|---|---|---|
| Arrow DragonBoard 820c | arrow-db820c | Y |
MSM8996 (Snapdragon 820)
| Device | Codename | Mainline |
|---|---|---|
| HTC 10 | htc-pme | |
| Lenovo ZUK Z2 plus | zuk-z2-plus | |
| Lenovo ZUK Z2 Pro | zuk-z2-row | |
| LG V20 | lg-us996 | |
| OnePlus 3 | oneplus-oneplus3 | Y |
| Xiaomi Mi 5 | xiaomi-gemini | Y |
| ZTE Axon 7 | zte-axon7 | P |
MSM8996Pro (Snapdragon 821)
| Device | Codename | Mainline |
|---|---|---|
| LeEco Le Pro3 | leeco-zl1 | N |
| LG G6 | lg-h870 | |
| OnePlus 3T | oneplus-oneplus3t | Y |
| Xiaomi Mi 5s Plus | xiaomi-natrium | Y |
| Xiaomi Mi Note 2 | xiaomi-scorpio | Y |
Porting to a new device
Getting mainline to boot on MSM8996 devices is generally a straightforward process. Check the mainlining guide to get started:
Booting
On at least the Xiaomi Mi Note 2, some IOMMU hacks (1, 2) are needed to let it to boot properly. Otherwise it would crash and reboot as soon as the MDP SMMU is probed.
USB
Enabling usb3 or usb2 depending on which one the USB port is connected to should be enough to make USB work, although forcing it to peripheral mode might be needed before adding support for extcon:
MSM8996 USB peripheral mode configuration
&usb3 {
...
dwc3@6a00000 {
dr_mode = "peripheral";
...
};
};
Some devices have a USB 2.0 port wired to usb3. In this case it must be limited to high-speed and have usb3phy removed from it:
MSM8996 USB 2.0 configuration
&usb3 {
/* Disable USB3 pipe_clk requirement */
qcom,select-utmi-as-pipe-clk;
...
dwc3@6a00000 {
/* usb3-phy is not used on this device */
phys = <&hsusb_phy1>;
phy-names = "usb2-phy";
/* Limit USB to high-speed */
maximum-speed = "high-speed";
...
};
};
Haptics
Haptics are supported, see Haptics for more details.
See also
- msm8996-mainline/linux a common near-mainline kernel tree for MSM8996 devices.
- Xiaomi_Mi_Note_2_(xiaomi-scorpio)#Mainline
Who's working on it
- User:Tooniis (@tooniis on Matrix)
- User:WolfLink115 (@WolfLink115 on Telegram, @wolflink115 on Discord)
 |
Please add yourself if you're working on MSM8996 mainlining! |