13b76df4bSBjorn AnderssonQualcomm Hexagon Peripheral Image Loader 23b76df4bSBjorn Andersson 33b76df4bSBjorn AnderssonThis document defines the binding for a component that loads and boots firmware 43b76df4bSBjorn Anderssonon the Qualcomm Hexagon core. 53b76df4bSBjorn Andersson 63b76df4bSBjorn Andersson- compatible: 73b76df4bSBjorn Andersson Usage: required 83b76df4bSBjorn Andersson Value type: <string> 93b76df4bSBjorn Andersson Definition: must be one of: 103a3d4163SSricharan R "qcom,ipq8074-wcss-pil" 1134364712SGovind Singh "qcom,qcs404-wcss-pil" 123b76df4bSBjorn Andersson 133b76df4bSBjorn Andersson- reg: 143b76df4bSBjorn Andersson Usage: required 153b76df4bSBjorn Andersson Value type: <prop-encoded-array> 163b76df4bSBjorn Andersson Definition: must specify the base address and size of the qdsp6 and 173b76df4bSBjorn Andersson rmb register blocks 183b76df4bSBjorn Andersson 193b76df4bSBjorn Andersson- reg-names: 203b76df4bSBjorn Andersson Usage: required 213b76df4bSBjorn Andersson Value type: <stringlist> 223b76df4bSBjorn Andersson Definition: must be "q6dsp" and "rmb" 233b76df4bSBjorn Andersson 243b76df4bSBjorn Andersson- interrupts-extended: 253b76df4bSBjorn Andersson Usage: required 263b76df4bSBjorn Andersson Value type: <prop-encoded-array> 2705f9f575SSibi Sankar Definition: reference to the interrupts that match interrupt-names 283b76df4bSBjorn Andersson 293b76df4bSBjorn Andersson- interrupt-names: 303b76df4bSBjorn Andersson Usage: required 313b76df4bSBjorn Andersson Value type: <stringlist> 32*bdea1422SSibi Sankar Definition: must be "wdog", "fatal", "ready", "handover", "stop-ack" 33a5cb1ee8SSibi Sankar 343b76df4bSBjorn Andersson- clocks: 353b76df4bSBjorn Andersson Usage: required 363b76df4bSBjorn Andersson Value type: <phandle> 372808cd5eSSibi Sankar Definition: reference to the clocks that match clock-names 383b76df4bSBjorn Andersson 393b76df4bSBjorn Andersson- clock-names: 403b76df4bSBjorn Andersson Usage: required 413b76df4bSBjorn Andersson Value type: <stringlist> 422808cd5eSSibi Sankar Definition: The clocks needed depend on the compatible string: 432808cd5eSSibi Sankar qcom,ipq8074-wcss-pil: 442808cd5eSSibi Sankar no clock names required 4534364712SGovind Singh qcom,qcs404-wcss-pil: 4634364712SGovind Singh must be "xo", "gcc_abhs_cbcr", "gcc_abhs_cbcr", 4734364712SGovind Singh "gcc_axim_cbcr", "lcc_ahbfabric_cbc", "tcsr_lcc_cbc", 4834364712SGovind Singh "lcc_abhs_cbc", "lcc_tcm_slave_cbc", "lcc_abhm_cbc", 4934364712SGovind Singh "lcc_axim_cbc", "lcc_bcr_sleep" 503b76df4bSBjorn Andersson 513b76df4bSBjorn Andersson- resets: 523b76df4bSBjorn Andersson Usage: required 533b76df4bSBjorn Andersson Value type: <phandle> 54*bdea1422SSibi Sankar Definition: reference to the list of 3 reset-controllers for the 553a3d4163SSricharan R wcss sub-system 563b76df4bSBjorn Andersson 573b76df4bSBjorn Andersson- reset-names: 583b76df4bSBjorn Andersson Usage: required 593b76df4bSBjorn Andersson Value type: <stringlist> 60*bdea1422SSibi Sankar Definition: must be "wcss_aon_reset", "wcss_reset", "wcss_q6_reset" 61f8611645SSibi Sankar for the wcss sub-system 623b76df4bSBjorn Andersson 63d964b0b1SSibi Sankar- memory-region: 64d964b0b1SSibi Sankar Usage: required 65d964b0b1SSibi Sankar Value type: <phandle> 66*bdea1422SSibi Sankar Definition: reference to wcss reserved-memory region. 67d964b0b1SSibi Sankar 68688c4375SSibi SankarFor the compatible string below the following supplies are required: 6934364712SGovind Singh "qcom,qcs404-wcss-pil" 7034364712SGovind Singh- cx-supply: 7134364712SGovind Singh Usage: required 7234364712SGovind Singh Value type: <phandle> 7334364712SGovind Singh Definition: reference to the regulators to be held on behalf of the 7434364712SGovind Singh booting of the Hexagon core 7534364712SGovind Singh 763b76df4bSBjorn Andersson- qcom,smem-states: 773b76df4bSBjorn Andersson Usage: required 783b76df4bSBjorn Andersson Value type: <phandle> 793b76df4bSBjorn Andersson Definition: reference to the smem state for requesting the Hexagon to 803b76df4bSBjorn Andersson shut down 813b76df4bSBjorn Andersson 823b76df4bSBjorn Andersson- qcom,smem-state-names: 833b76df4bSBjorn Andersson Usage: required 843b76df4bSBjorn Andersson Value type: <stringlist> 853b76df4bSBjorn Andersson Definition: must be "stop" 863b76df4bSBjorn Andersson 873b76df4bSBjorn Andersson- qcom,halt-regs: 883b76df4bSBjorn Andersson Usage: required 893b76df4bSBjorn Andersson Value type: <prop-encoded-array> 903b76df4bSBjorn Andersson Definition: a phandle reference to a syscon representing TCSR followed 91*bdea1422SSibi Sankar by the three offsets within syscon for q6, wcss and nc 923b76df4bSBjorn Andersson halt registers. 93c42c0a5eSSibi Sankar 943b76df4bSBjorn Andersson- memory-region: 953b76df4bSBjorn Andersson Usage: required 963b76df4bSBjorn Andersson Value type: <phandle> 973b76df4bSBjorn Andersson Definition: reference to the reserved-memory for the region 983b76df4bSBjorn Andersson 992b41d6c8SBjorn AnderssonThe Hexagon node may also have an subnode named either "smd-edge" or 1002b41d6c8SBjorn Andersson"glink-edge" that describes the communication edge, channels and devices 101375eed5fSKrzysztof Kozlowskirelated to the Hexagon. See ../soc/qcom/qcom,smd.yaml and 1022b41d6c8SBjorn Andersson../soc/qcom/qcom,glink.txt for details on how to describe these. 103