Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools


products:sbc:common:applications:gpio:pwm

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
products:sbc:common:applications:gpio:pwm [2022/11/04 10:00]
nick [VIM1/3/3L/4]
products:sbc:common:applications:gpio:pwm [2024/08/22 02:40] (current)
nick
Line 5: Line 5:
 This page introduces the usage of hardware PWM, and leads you to control the hardware PWM on the [[products:sbc:common:applications:gpio:40pin-header|40-Pin Header]]. This page introduces the usage of hardware PWM, and leads you to control the hardware PWM on the [[products:sbc:common:applications:gpio:40pin-header|40-Pin Header]].
  
-===== PWM Information =====+===== PWM Reference Table ===== 
 + 
 +|          PWM            PIN  ^  GPIO name      ^  DT overlay node  ^  Device node              ^ 
 +^  VIM1    ''PWM_AO_A''  |  35    ''GPIOAO_3''    ''pwm_ao_a''      /sys/class/pwm/pwmchip4 
 +^  VIM2    ''PWM_D''      35    ''GPIODV_28''  |  ''pwm_d''        |  /sys/class/pwm/pwmchip1 
 +^  VIM3    ''PWM_F''      35    ''GPIOH_5''    |  ''pwm_f''        |  /sys/class/pwm/pwmchip4 
 +^  VIM3L  |  ''PWM_F''      35    ''GPIOH_5''    |  ''pwm_f''        | /sys/class/pwm/pwmchip0   | 
 +^  VIM4    ''PWM_F''      35    ''GPIOY_8''    |  ''pwm_f''        |  /sys/class/pwm/pwmchip4 
 +^  VIM1S  |  ''PWM_F''      35    ''GPIOZ_6''    |  ''pwm_f''        |  /sys/class/pwm/pwmchip0 
  
-|            PWM        PIN  ^  GPIO Name  ^  GPIO Number  ^  DT Overlays Node  ^  Device Node              ^ 
-^  VIM1      PWM_AO_A  |  35    GPIOAO_3    504          |  pwm_ao_a          |  /sys/class/pwm/pwmchip4  | 
-^  VIM2      PWM_D      35    GPIODV_28  |  478          |  pwm_d              /sys/class/pwm/pwmchip1  | 
-^  VIM3/3L  |  PWM_F      35    GPIOX_7    |  432          |  pwm_f              /sys/class/pwm/pwmchip4  | 
-^  VIM4      PWM_F      35    GPIOY_8    |  482          |  pwm_f              /sys/class/pwm/pwmchip4  | 
-^  VIM1S    |  PWM_F      35    GPIOZ_6    |  503          |  pwm_f              /sys/class/pwm/pwmchip0  | 
-^  Edge2    |  PWM14      13    GPIO3_C2    114          |  pwm14              /sys/class/pwm/pwmchip2  | 
 ===== Enable PWM ===== ===== Enable PWM =====
 +
 +==== Linux ====
 +
  
 In order to use the PWM, you need to enable the PWM function via [[products:sbc:common:configurations:device-tree-overlay|Device Tree Overlay]]. In order to use the PWM, you need to enable the PWM function via [[products:sbc:common:configurations:device-tree-overlay|Device Tree Overlay]].
  
-<tabbox VIM1/2/3/3L/Edge1>+<tabbox VIM1/2/3/Edge1>
  
 Edit ''/boot/env.txt'' to add the pwm node to ''overlays'' node if it doesn't exist. Edit ''/boot/env.txt'' to add the pwm node to ''overlays'' node if it doesn't exist.
Line 25: Line 30:
  
 ```shell ```shell
-overlays=uart4 pwm_ao_a pwm_f+overlays=uart3 pwm_f i2c3 i2s os08a10 watchdog
 ``` ```
  
Line 34: Line 39:
 device  export  npwm  power  subsystem  uevent  unexport device  export  npwm  power  subsystem  uevent  unexport
 ``` ```
 +
 +<tabbox VIM3L>
 +
 +Edit ''/boot/env.txt'' to add the pwm node to ''overlays'' node if it doesn't exist.
 +
 +Take VIM3L as an example to enable ''PWM_F'', you need to add ''pwm_f'' node to ''overlays'' node if it doesn't exist.
 +
 +```shell
 +overlays=uart3 pwm_f i2c3 i2s watchdog
 +```
 +
 +After reboot, you will see the pwm device node.
 +
 +```shell
 +$ ls /sys/class/pwm/pwmchip0
 +device  export  npwm  power  subsystem  uevent  unexport
 +```
 +
 +
 +<tabbox VIM3 with 5.15 kernel>
 +
 +Edit ''/boot/dtb/amlogic/kvim3.dtb.overlay.env'' to add pwm node to ''fdt_overlays'' node if it doesn't exist.
 +
 +
 +You need to add ''pwm_f'' to node ''fdt_overlays'' if it doesn't exist to enable ''PWM_F''.
 +
 +```shell
 +fdt_overlays=pwm_f
 +
 +```
 +
 +After reboot, you will see the pwm device node.
 +
 +<tabbox VIM3L with 5.15 kernel>
 +
 +Edit ''/boot/dtb/amlogic/kvim3l.dtb.overlay.env'' to add pwm node to ''fdt_overlays'' node if it doesn't exist.
 +
 +
 +You need to add ''pwm_f'' to node ''fdt_overlays'' if it doesn't exist to enable ''PWM_F''.
 +
 +```shell
 +fdt_overlays=pwm_f
 +
 +```
 +
 +After reboot, you will see the pwm device node.
  
 <tabbox VIM4> <tabbox VIM4>
Line 72: Line 123:
 device  export  npwm  power  subsystem  uevent  unexport device  export  npwm  power  subsystem  uevent  unexport
 ``` ```
 +</tabbox>
  
-<tabbox Edge2> 
  
-Edit ''/boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlay.env'' to add pwm node to ''fdt_overlays'' node if it doesn't exist.+==== Android ====
  
 +<tabbox VIM4>
  
-You need to add ''pwm14'' to node ''fdt_overlays'' if it doesn't exist to enable ''PWM14''.+The ''PWM'' function is disabled by default, you need to modify the dts to enable it.
  
-```shell +```diff 
-fdt_overlays=pwm14+diff --git a/arch/arm64/boot/dts/amlogic/kvim4.dts b/arch/arm64/boot/dts/amlogic/kvim4.dts 
 +--- a/arch/arm64/boot/dts/amlogic/kvim4.dts 
 ++++ b/arch/arm64/boot/dts/amlogic/kvim4.dts 
 + &pwm_ef { 
 ++    pinctrl-names = "default"; 
 ++    pinctrl-0 = <&pwm_f_pins>; 
 +        status = "okay"; 
 + }; 
 +  
 +diff --git a/arch/arm64/boot/dts/amlogic/kvim4n.dts b/arch/arm64/boot/dts/amlogic/kvim4n.dts 
 +--- a/arch/arm64/boot/dts/amlogic/kvim4n.dts 
 ++++ b/arch/arm64/boot/dts/amlogic/kvim4n.dts 
 + &pwm_ef { 
 ++    pinctrl-names = "default"; 
 ++    pinctrl-0 = <&pwm_f_pins>; 
 +        status = "okay"; 
 + }; 
 +  
 +diff --git a/arch/arm64/boot/dts/amlogic/mesont7_an400-panel.dtsi b/arch/arm64/boot/dts/amlogic/mesont7_an400-panel.dtsi 
 +--- a/arch/arm64/boot/dts/amlogic/mesont7_an400-panel.dtsi 
 ++++ b/arch/arm64/boot/dts/amlogic/mesont7_an400-panel.dtsi 
 +@@ -1442,13 +1442,13 @@ 
 +  
 +        backlight1{ 
 +                compatible = "amlogic, backlight-t7"; 
 +-               status = "okay"; 
 ++               status = "disabled"; 
 +                index = <1>; 
 +                key_valid = <0>; 
 +                pinctrl-names = "pwm_on", 
 +                                "pwm_off"; 
 +-               pinctrl-0 = <&pwm_f_pins>; 
 +-               pinctrl-1 = <&bl1_pwm_off_pins>; 
 +                pinctrl_version = <2>; /* for uboot */ 
 +                interrupts <0 197 1
  
 ``` ```
  
-After reboot, you will see the pwm device node.+<tabbox VIM1S> 
 + 
 +The ''PWM'' function is disabled by default, you need to modify the dts to enable it. 
 + 
 +```diff 
 +--- a/arch/arm64/boot/dts/amlogic/kvim1s.dts 
 ++++ b/arch/arm64/boot/dts/amlogic/kvim1s.dts 
 +@@ -1411,8 +1411,8 @@ 
 + }; 
 +  
 + &pwm_ef { 
 +-       /*pinctrl-0 = <&pwm_f_pins2>;*/ 
 +-       /*pinctrl-names = "default";*/ 
 ++       pinctrl-0 = <&pwm_f_pins2>; 
 ++       pinctrl-names = "default"; 
 +        status = "okay"; 
 + };
  
-```shell 
-$ ls /sys/class/pwm/pwmchip2 
-device  export  npwm  power  subsystem  uevent  unexport 
 ``` ```
- 
 </tabbox> </tabbox>
- 
-===== Disable PWM to Use GPIO ===== 
- 
-If you want to use normal GPIO instead of PWM, you can remove the PWM node in [[products:sbc:common:configurations:device-tree-overlay|Device Tree Overlay]]. 
  
 ===== Control PWM ===== ===== Control PWM =====
Line 102: Line 196:
 **Enable PWM:** **Enable PWM:**
  
-<tabbox VIM1/3/3L/4> +<tabbox VIM1/3/4> 
  
 ```shell ```shell
Line 110: Line 204:
 echo 1 | sudo tee /sys/class/pwm/pwmchip4/pwm1/enable echo 1 | sudo tee /sys/class/pwm/pwmchip4/pwm1/enable
 ``` ```
 +
 <tabbox VIM2>  <tabbox VIM2> 
  
 ```shell ```shell
-echo 1 | sudo tee /sys/class/pwm/pwmchip1/export +echo 1 | sudo tee /sys/class/pwm/pwmchip1/export 
-echo 1000000 | sudo tee /sys/class/pwm/pwmchip1/pwm1/period +echo 1000000 | sudo tee /sys/class/pwm/pwmchip1/pwm1/period 
-echo 500000 | sudo tee /sys/class/pwm/pwmchip1/pwm1/duty_cycle +echo 500000 | sudo tee /sys/class/pwm/pwmchip1/pwm1/duty_cycle 
-echo 1 | sudo tee /sys/class/pwm/pwmchip1/pwm1/enable+echo 1 | sudo tee /sys/class/pwm/pwmchip1/pwm1/enable
 ``` ```
  
-<tabbox VIM1S+<tabbox VIM3L/1S
  
 ```shell ```shell
-echo 1 | sudo tee /sys/class/pwm/pwmchip0/export +echo 1 | sudo tee /sys/class/pwm/pwmchip0/export 
-echo 1000000 | sudo tee /sys/class/pwm/pwmchip0/pwm1/period +echo 1000000 | sudo tee /sys/class/pwm/pwmchip0/pwm1/period 
-echo 500000 | sudo tee /sys/class/pwm/pwmchip0/pwm1/duty_cycle +echo 500000 | sudo tee /sys/class/pwm/pwmchip0/pwm1/duty_cycle 
-echo 1 | sudo tee /sys/class/pwm/pwmchip0/pwm1/enable +echo 1 | sudo tee /sys/class/pwm/pwmchip0/pwm1/enable
-``` +
-<tabbox Edge2>  +
- +
-```shell +
-echo 0 | sudo tee /sys/class/pwm/pwmchip2/export +
-echo 1000000 | sudo tee /sys/class/pwm/pwmchip2/pwm0/period +
-echo 500000 | sudo tee /sys/class/pwm/pwmchip2/pwm0/duty_cycle +
-echo 1 | sudo tee /sys/class/pwm/pwmchip2/pwm0/enable+
 ``` ```
  
Line 148: Line 235:
 **Disable PWM:** **Disable PWM:**
  
-<tabbox VIM1/3/3L/4> +<tabbox VIM1/3/4> 
 ```shell ```shell
-echo 0 | sudo tee /sys/class/pwm/pwmchip4/pwm1/enable+echo 0 | sudo tee /sys/class/pwm/pwmchip4/pwm1/enable
 ``` ```
 <tabbox VIM2>  <tabbox VIM2> 
 ```shell ```shell
-echo 0 | sudo tee /sys/class/pwm/pwmchip1/pwm1/enable+echo 0 | sudo tee /sys/class/pwm/pwmchip1/pwm1/enable
 ``` ```
-<tabbox VIM1S+<tabbox VIM3L/1S
 ```shell ```shell
-echo 0 | sudo tee /sys/class/pwm/pwmchip0/pwm1/enable +echo 0 | sudo tee /sys/class/pwm/pwmchip0/pwm1/enable
-``` +
-<tabbox Edge2>  +
-```shell +
-$ echo 0 | sudo tee /sys/class/pwm/pwmchip2/pwm0/enable+
 ``` ```
 +
 </tabbox> </tabbox>
 +
 +===== Disable PWM to Use GPIO =====
 +
 +If you want to use normal GPIO instead of PWM, you can remove the PWM node in [[products:sbc:common:configurations:device-tree-overlay|Device Tree Overlay]].
 +
  
  
Last modified: 2022/11/04 10:00 by nick