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 =

October 2015

 * wcn36xx (bjorn)

September 2015

 * remoteproc for wifi core (bjorn)
 * smem state stuff (bjorn)
 * bt hci smd (bjorn)
 * extcon USB int (for ID detect) (tim.b)
 * chipidea USB controller extcon support (ivan)
 * smbb charger (courtney)
 * including regulator for OTG vbus (tim.b)

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 =

Expected in 4.3

 * qcom_smbb charger

Merged into 4.2

 * coincell charger driver
 * RPM regulators?

[need to fill this in more]

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 Kandagatla  (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) <<half-done>> not doing voltage, only doing idle path
 * RPM - Resource power manager - regulator voting thingy - (DONE) - 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 - there's one for A-family done. probably the same, but on different bus
 * GPIO - (DONE)
 * MPP - (DONE)
 * Charger - (DONE) - Courtney, Bjorn - (missing USB current hook)
 * IADC - (DONE)
 * BMS - battery monitoring system (not done)
 * PON - power on thingy - (DONE)
 * RTC - realtime clock - (DONE)
 * coincell - (DONE) - Tim
 * regulators - (DONE) (except for the corner regulators)
 * RPM regulators - (DONE) (see RPM) - Bjorn, AGross - <<only thing missing is 8016/8084 tables>>
 * two buckets for RPM active state and sleep state, SPM switches modes. aggregation of messages not working
 * SPMI regulators - (DONE - 4.0) - sboyd
 * PMIC clocks - (not done) < > RF clock and XO buffers probably sucked into rpm clocks, could be pinctrl.
 * VADC - (DONE?) - Ivan
 * PM8841 - analog regulators - (not done)
 * MODEM - (not done) (but see RemoteProc) - not likelty to chage
 * PIL - lives in remoteproc, used for firmware load, have a common scheme, for wifi, modem, dsp, venus, Q6, etc.
 * TLMM - top level mode manager (DONE)
 * PINCTRL - (DONE)
 * QUP - configurable serial blocks (not done) - have lots of fixes for i2c and spi
 * I2C - (not DONE) - agross
 * SPI - (not DONE) - agross - patches coming in from server guys.
 * BLSP - UART - (DONE) (could use high speed improvements) - Ivan has patches for that.
 * SDHCI - SD Card/emmc/EMMC controller - (DONE - but needs regulator for HPM mode) - Bjorn
 * GCC - global clocks - (DONE)
 * GDSC - global distributed switch controllers - (in next (4.4)) - rnayak
 * MMCC - multimedia clocks - (DONE)
 * LCC - LPASS (audio) clocks - (DONE)
 * LPASS - Audio - (not done) - some 3rd party?? - on 8016 the DSP is cut out. Normally would load DSP for this
 * 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) < >, is it needed? If you don't have it, you can't suspend. nobody working on (a year away).  Depends on all of PM to be there first.
 * OCMEM - multimedia memory = (not done) - rob (may already be 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) - dwc3 - needs some massaging
 * USB 3.0 controller - dwc3 - (DONE)
 * slimbus - peripheral bus - (in progress) audio bus - work was done on 8064, - Sagar Dharia was in development, probably still in progress.
 * MI2S - multi-channel audio - (??) - done for 8064, can use same code for 8016, completely different in 8074, register layout changes.
 * I2S - sound thingy - (not done) - outgoing audio on most SOCs - unknown status, 8016 works upstream
 * QCRYPTO - (DONE)
 * PRND - random number generator - (DONE)
 * RIVA - radio controller - (Done, but needs major rewrite) - -older generation for qcom wifi
 * HDMI - (DONE)
 * DSI - (DONE)
 * eDP - display port - (DONE)
 * VENUS - video codec thingy - (in progress) - firmware blob, v4l driver being worked on, have some support on 4.2, 8016 version of IP is 'lite' version of IP block.
 * VFE - video front end - (not done)
 * VPE - video processing engine - (not done)
 * CSI - camera high speed serial interface (mipi spec) - (not done) - ivan on 8016??
 * CCI - camera i2c interface (mipi spec) - (not done)- ivan on 8016??
 * TCSR - (?)
 * hardware mutex - hwspinlock - (DONE)
 * hwspinlock DT support - (DONE)
 * halt control - (unknown)
 * QFPROM - fuses - (DONE)
 * BAM - dma stuff - (DONE - but missing utilization by individual drivers)
 * TSENSE - thermal sensing - (DONE)
 * IOMMU - IO memmory management unit - it's complicated, nobody working on 8074 or 8016.

Features
Here is a list of features (related to IP blocks) for an 8974 processor:
 * charger (DONE) - Courtney
 * regulators (DONE) - Bjorn
 * remoteproc-tz - loading firmware through trustzone - (in progress) - Bjorn
 * 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 - (DONE) - Bjorn
 * See Qualcomm SMEM_Items
 * SMD - inter-processor ring buffers - (DONE) - Bjorn
 * SMP2P - interprocessor state signaling - (DONE) - Bjorn
 * SMSM - interprocessor state signaling - (DONE) - Bjorn
 * Bluetooth (in progress) - Bjorn, Courtney
 * FM radio
 * WiFi - wcn36xx - (in progress) - Bjorn
 * MHL
 * NFC
 * Vibrator - (DONE)
 * Audio Codec
 * IRDA
 * irq_read_line - (DONE)
 * ipcrouter - (in progress) - Courtney
 * Adreno GPU - (in progress) - Rob Clark

Outstanding dependencies
Dependencies: '->' = "depends on"

= Resources = LCU15 Qualcomm Mainlining meeting notes - Notes from meeting on September 24

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)