Qualcomm SOC Mainlining Project

= Overview = Here is some information about the Qualcomm SOC mainlining project. On this page are currently some lists of different IP SoC IP blocks or functional areas, with status for each one.

= Project List =

July 2015
List of items "in flight" (as of July 2015)
 * regulators (bjorn)
 * backlight driver (bjorn)
 * coincell driver (tim.b)
 * dts support for 8064 SATA, i2c, USB OTG/host, regulators (srinivas.k)
 * 8016 sound card/lpass (srinivas.k)
 * SPM (subsystem power manager) driver (lina)
 * GDSC (global distributed switch controllers) (rnayak)

June 2014
List of items that need to be mainlined, or are "in flight" (as of June, 2014):


 * regulators - Josh Cartwright?, Bjorn Andersson?
 * clocks - Stephen Boyd
 * RPM
 * SD Card Controller - Srinivas Kandagatla
 * 8084 clock controller - Georgi Djakov
 * dma engine - Andy Gross
 * SOC-specific
 * 8084
 * 8974
 * USB support
 * USB host mode for HS port - Tim Bird
 * dwc3 (superspeed) USB driver
 * spmi - ??

= Status =

Merged into 4.1

 * dts support for 8064 SATA, i2c, USB OTG/host, regulators (srinivas.k)
 * 8016 sound card/lpass (srinivas.k)
 * SPM (subsystem power manager) driver (lina)
 * regulator: add spmi regulator driver (sboyd)

Merged into 4.0

 * spi: qpu: add DMA support (agross)
 * dts TCSR support for 8960, 8660, 8064 (agross)

Merged into 3.19

 * clk: qcom: LCC driver (806x LPASS clocks) (rnayak)

Merged into 3.17

 * clk: 8064 PLL required for USB (agross)
 * i2c: qup fix order for pm init (agross)
 * sdcc support for 8064 (sdcc4 for wlan), via mcci driver (srinivas.k)

Merged into 3.16

 * spi: qup fixups (agross)
 * usb: phy fixups (srinivas.k)
 * mmc: mmci: SD card controller (srinivas.k)
 * SATA phy for 8064 (srinivas.k)
 * 8064 GCC support (sboyd)

Merged into 3.15

 * pinctrl for 8064 (agross)
 * GSBI driver (agross)
 * amba work for qcom (srinivas.k)

Merged into 3.14

 * BAM dma driver (agross)
 * ARM perf work (sboyd)
 * update vibrator, powerkey and keypad drivers to DT (sboyd)
 * some pm8921 fixups (sboyd)

Merged into 3.10

 * Use common clock framework (sboyd)

= Working area =

people submitting patches
Here is a list of people submitting patches for linux-arm-msm:

June/July 2015

 * Rajendra Nayak 
 * GDSC support
 * LCC for 806x


 * Andy Gross  (scanned)
 * SCM (secure channel Manager)


 * Srinivas Kadagatla  (scanned)
 * QFPROM (fuses)
 * nvmem framework
 * i2c:qup bugfix and refactor


 * Maxime Ripard 
 * nvmem framework


 * Stephen Boyd 
 * pmic8xxx-pwrkey - Support shutdown
 * SPMI regulator driver


 * Sricharan R 
 * i2c:qup, BAM DMA
 * iommu/arm-smmu: Add support for specifying regulators


 * Ivan T. Ivanov 
 * sdhci
 * pinctrl: qpnp


 * Lina Iyer 
 * hwspinlocks


 * Bjorn Andersson 
 * SMEM
 * mfd: pm8921: Implement irq_get_irqchip_state
 * firmware: qcom: scm: Peripheral Authentication Service


 * Timur Tabi 
 * pinctrl: add support for Qualcomm Technologies QDF2xxx ARM64 SoC (v2)
 * pinctrl: qcom: spmi-mpp:


 * Archit Taneja 
 * drm/misc: Kconfig cleanup
 * drm: fb emulation


 * Georgi Djakov 
 * clk: qcom: Add support for RPM Clocks

July 2014

 * Olav Haugan 
 * iommu-api: Add map_sg/unmap_sg functions


 * Stanimir Varbanov 
 * Support for Qualcomm QPNP PMIC's


 * David Collins 


 * Josh Cartwright 
 * saravana Kannan <skanna(at)codeaurora(dot)org>
 * clk stuff

filenames

 * devicetree/bindings/firmware/qcom,scm.txt
 * drivers/firmware/qcom_scm.c
 * drivers/mmc/host/sdhci-msm.c
 * drivers/hwspinlock/qcom_hwspinlock.c
 * drivers/regulator/qcom_spmi-regulator.c
 * drivers/qcom/smem.c
 * drivers/clk/qcom/clk-rpm.c

Possible file regex for 'git log' search: (*qcom*, *msm*)

slow responses

 * v2, hwspinlock: Introduce raw capability for hwspinlock_device - submitted Jun 9, first response June 27 by Ohad Ben-Cohen

= Specific Hardware =
 * 8074 (Dragonboard/APQ8074)
 * 8064 (Dragonboard/IFC6410, Dragonboard/SYS6440)

IP blocks on the 8974

 * KRAIT - arm processor - (DONE)
 * SAW - SPM AVS wrapper - adaptive wakup, sleep, voltage
 * AVS - adaptive voltage scaler
 * SPM - subsystem power manager - (DONE)
 * RPM - Resource power manager - regulator voting thingy - (in progress) - Bjorn, AGross
 * PM8941 - power management IC (PMIC) - see sub-parts for status
 * WLED - (DONE) - Courtney
 * PWM - pulse width modulator outputs - (in progress) - Courtney
 * LPG - (RGB LEDS) - (in progress) - Courtney
 * VIB - vibrator drivers
 * GPIO - (DONE)
 * MPP - (DONE)
 * Charger - (in progress) - Courtney, Bjorn
 * IADC - (DONE)
 * BMS - battery monitoring system (not done)
 * PON - power on thingy - (DONE)
 * RTC - realtime clock - (DONE)
 * coincell - (in progress) - Tim
 * regulators
 * RPM regulators - (in progress) (see RPM) - Bjorn, AGross
 * SPMI regulators - (DONE - 4.0) - sboyd
 * PMIC clocks - (not done)
 * VADC - (DONE?) - Ivan
 * PM8841 - analog regulators - (not done)
 * MODEM - (not done) (but see RemoteProc)
 * TLMM - top level mode manager (DONE)
 * PINCTRL - (DONE)
 * QUP - configurable serial blocks
 * I2C - (DONE)
 * SPI - (DONE)
 * BLSP - UART - (DONE) (could use high speed improvements)
 * SDHCI - SD Card/emmc/EMMC controller - (DONE - but needs regulator for HPM mode) - Bjorn
 * GCC - global clocks - (DONE)
 * GDSC - global distributed switch controllers - (in progress) - rnayak
 * MMCC - multimedia clocks - (DONE)
 * LCC - LPASS (audio) clocks - (DONE)
 * LPASS - Audio - (not done) - some 3rd party??
 * MDP - 2d display stuff - (DONE) - Rob
 * SATA - (DONE)
 * DSP - (in progress) - Bjorn - (see ??? RemoteProc??) - can send audio via slimbus, and handles sensor stuff
 * SPMI - (DONE)
 * QGIC - interrupt controller - (DONE)
 * MPM - power manager - (not done)
 * OCMEM - multimedia memory = (not done)
 * USB 2.0 controller - chipidea - (Done, but needs more) - Tim
 * USB 2.0 PHY - (DONE, but needs more) - Tim - needs regulator support
 * HSIC PHY - (not done)
 * USB 3.0 PHY - (not done)
 * USB 3.0 controller - dwc3 - (not done)
 * slimbus - peripheral bus - (not done)
 * MI2S - multi-channel audio - (not done) - Kenneth?
 * I2S - sound thingy - (not done)
 * QCRYPTO - (DONE)
 * PRND - random number generator - (DONE)
 * RIVA - radio controller - (Done, but needs major rewrite)
 * HDMI - (DONE)
 * DSI - (not done)
 * eDP - display port - (not done)
 * VENUS - video codec thingy - (not done)
 * VFE - video front end - (not done)
 * VPE - video processing engine - (not done)
 * CSI - camera high speed serial interface (mipi spec) - (not done)
 * CCI - camera i2c interface (mipi spec) - (not done)
 * TCSR - (unknown)
 * hardware mutex - hwspinlock - (DONE)
 * hwspinlock DT support - (DONE)
 * halt control - (unknown)
 * QFPROM - fuses - (not done)
 * BAM - dma stuff - (DONE - but missing utilization by individual drivers)
 * TSENSE - thermal sensing - (in progress)

Features
Here is a list of features (related to IP blocks) for an 8974 processor:
 * charger (see charger IP block) - Courtney
 * regulators (depends on RPM) - Bjorn
 * remoteproc-tz - loading firmware through trustzone
 * USB 2.0 gadget - (DONE - but needs regulators) - Tim
 * USB 2.0 host - (not done)
 * USB 2.0 OTG - (in progress) - Tim
 * SMEM - provides an inter-processor heap - (in progress) - Bjorn
 * SMD - inter-processor ring buffers - (in-progress) - Bjorn
 * SMP2P - interprocessor state signaling - (in progress) - Bjorn
 * SMSM - interprocessor state signaling - (in progress) - Bjorn
 * Bluetooth
 * FM radio
 * WiFi - wcn36xx - (in progress) - Bjorn
 * MHL
 * NFC
 * Vibrator
 * Audio Codec
 * IRDA
 * irq_read_line - (DONE)
 * ipcrouter - (in progress) - Courtney

Dependencies
Dependencies: '->' = "depends on"
 * Regulators -> RPM -> SMD -> SMEM -> tcsr-mutex
 * SMP2P -> SMEM
 * SMSM -> SMEM
 * SMD -> SMEM -> tcsr-mutex
 * DSI -> regulators -> RPM -> SMD -> SMEM -> tcsr-mutex
 * USB 2.0 controller -> charger PMIC ID -> irq_read_line
 * USB 2.0 phy -> regulators -> RPM -> SMD -> SMEM -> tcsr-mutex
 * USB 2.0 controller -> charger OTG switch -> charger
 * charger -> irq_read_line

= Resources =

mailing list

 * Web site: http://vger.kernel.org/vger-lists.html#linux-arm-msm
 * subscribe or unsubscribe via e-mail, by following links on the above page
 * Archives
 * mail-archive.com: https://www.mail-archive.com/linux-arm-msm@vger.kernel.org/
 * gmain: http://dir.gmane.org/gmane.linux.ports.arm.msm

IRC channel

 * Server: freenode (chat.freenode.net)
 * Channel ##linux-msm
 * Link: http://webchat.freenode.net/

You can access the IRC channel from inside a corporate firewall using the web interface.

git trees

 * git trees:
 * Sony github integration ("next") tree: https://github.com/andersson/kernel/tree/next
 * Sony maintains this tree by keeping patch sets for individual technology areas or features in separate git branches. We have an internal tool called 'splash', that is used to integrate the separate branches into a single integration branch (the "next" branch).  This tool is available upon request, if you want to use the same workflow as Sony.
 * Code Aurora git trees: https://www.codeaurora.org/cgit/quic/kernel
 * Linaro Qualcomm integration tree: https://git.linaro.org/landing-teams/working/qualcomm/kernel.git/shortlog/refs/heads/integration-linux-qcomlt

Other resources

 * Linaro patch queue for msm (??): https://patches.linaro.org/project/linux-arm-msm/
 * Linaro mainline patch queue: https://patches.linaro.org/team/linaro-landing-team-qualcomm/

= Stakeholders = This is a list of parties who are (or should be) interested in the progress of this work:
 * Qualcomm
 * Code Aurora Forum
 * Linaro
 * Qualcomm Innovation Center
 * Sony
 * Samsung
 * LG
 * HTC
 * Lenovo/Motorola
 * Xiaomi

Table of phones, processors and download sites
For links to different download sites, see Phones Processors and Download Sites

= Status = [Figure out a metric for what remains to be done]
 * brainstorming ideas for metric to measure:
 * # of features out of tree (should be going down)
 * size of diff between latest msm tree and server it was based on? (should be going down)
 * linaro uses patch queue length (outstanding vs. already mainlined)