smb1355-charger.txt 2.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. Qualcomm Technologies, Inc. SMB1355 Charger Specific Bindings
  2. SMB1355 slave charger is paired with QTI family of standalone chargers to
  3. enable a high current, low profile Li+ battery charging system.
  4. The device provides 28V DC withstand, wide operating input range of 3.8 to
  5. 14.2V for standard 5V USB inputs as well as a wide variety of HVDCP Travel
  6. Adapters and is compatible with QTI's Quick Charge technology.
  7. =======================
  8. Required Node Structure
  9. =======================
  10. SMB1355 Charger must be described in two levels of device nodes.
  11. ==================================
  12. First Level Node - SMB1355 Charger
  13. ==================================
  14. Charger specific properties:
  15. - compatible
  16. Usage: required
  17. Value type: <string>
  18. Definition: "qcom,smb1355".
  19. - qcom,pmic-revid
  20. Usage: required
  21. Value type: phandle
  22. Definition: Should specify the phandle of SMB's revid module. This is used
  23. to identify the SMB subtype.
  24. - qcom,disable-ctm
  25. Usage: optional
  26. Value type: <empty>
  27. Definition: boolean flag. Usually a thermistor near usb/typeC connector is
  28. connected to AUX. Set this flag to indicate the thermistor
  29. doesn't exist.
  30. - qcom,parallel-mode
  31. Usage: optional
  32. Value type: <u32>
  33. Definition: Specifies parallel charging mode. If not specified, MID-MID
  34. option is selected by default.
  35. - qcom,stacked-batfet
  36. Usage: optional
  37. Value type: <empty>
  38. Definition: boolean flag. Specifies if parallel charger has stacked BATFET
  39. configuration.
  40. In stacked batfet the main and parallel charger's batfet are
  41. stacked one after the other and thus all the charge current
  42. (FCC) flows through main. In a non-stacked configuration each
  43. charger controls the charge current (FCC) separately.
  44. ================================================
  45. Second Level Nodes - SMB1355 Charger Peripherals
  46. ================================================
  47. Peripheral specific properties:
  48. - reg
  49. Usage: required
  50. Value type: <prop-encoded-array>
  51. Definition: Address and size of the peripheral's register block.
  52. - interrupts
  53. Usage: required
  54. Value type: <prop-encoded-array>
  55. Definition: Peripheral interrupt specifier.
  56. - interrupt-names
  57. Usage: required
  58. Value type: <stringlist>
  59. Definition: Interrupt names. This list must match up 1-to-1 with the
  60. interrupts specified in the 'interrupts' property.
  61. =======
  62. Example
  63. =======
  64. smb1355_charger: qcom,smb1355-charger {
  65. compatible = "qcom,smb1355";
  66. #address-cells = <1>;
  67. #size-cells = <1>;
  68. qcom,chgr@1000 {
  69. reg = <0x1000 0x100>;
  70. interrupts = <0x10 0x1 IRQ_TYPE_EDGE_BOTH>;
  71. interrupt-names = "chg-state-change";
  72. };
  73. qcom,chgr-misc@1600 {
  74. reg = <0x1600 0x100>;
  75. interrupts = <0x16 0x1 IRQ_TYPE_EDGE_BOTH>;
  76. interrupt-names = "wdog-bark";
  77. };
  78. };