How to Enable and Control PWM on AML-S905X-CC

librecomputer · November 4, 2022, 1:13pm

AML-S905X-CC Le Potato has 5 available hardware PWM multiplex over 6 pins. The hardware PWMs are grouped in chip pairs accessible via pwm0 and pwm1.

AO_A AO_B on c8100550
A on c1108550
E F on c11086c0

You cannot enable overlapping overlays within the grouped pair. This means you can not individually enable pwm-e and pwm-f. You have to enable pwm-ef to have both running at the same time.

In terms of pin routing:

AO_A on Pin 11 controlled via c8100550 pwm0
AO_B on Pin 12 or 13 controlled via c8100550 pwm1
E on Pin 32 controlled via c11086c0 pwm0
A on Pin 33 controlled via c1108550 pwm0
F on Pin 35 controlled via c11086c0 pwm1

For AO_A on pin 11, you must move the jumper for 2J1 to the edge of the board from the stock jumper position to connect the GPIO to the 40 pin header pin 11.

There are 9 dto combinations to select from:

pwm-ao-6 on Pin 11 and 12
pwm-ao-9 on Pin 11 and 13
pwm-ao-a on Pin 11
pwm-ao-b-6 on Pin 12
pwm-ao-b-9 on Pin 13
pwm-a on Pin 33
pwm-e on Pin 32
pwm-ef on Pin 32 and 35
pwm-f on Pin 35

The Linux kernel interface can be accessed via sysfs.

sudo ldto enable pwm-{x} # replace x with one of the dtos in list above
ls -al /sys/class/pwm # see the pwmchip{n} to hardware mapping
echo {0,1} | sudo tee /sys/class/pwm/pwmchip{n}/export
echo 1000000 | sudo tee /sys/class/pwm/pwmchip{n}/pwm{n}/period
echo 500000 | sudo tee /sys/class/pwm/pwmchip{n}/pwm{n}/duty_cycle
echo 1 | sudo tee /sys/class/pwm/pwmchip{n}/pwm{n}/enable

Mes · November 4, 2022, 10:14pm

Can you give an example for how to control a servo motor plugged into pin 11?

I assume pin 11 will have {n} = 0. How do we:

enable pin 11
set frequency to 50hz
change duty cycle
turn off pin (so there aren’t fluctuations) until we enable it again

librecomputer · November 5, 2022, 12:31am

Check the updated post. Please run sudo apt update && sudo apt dist-upgrade before trying the dtos. They were just added.

sudo ldto enable pwm-ao-a
The period is in nanoseconds per the kernel interface. So if you want a 1KHz signal, you need to put 1000000.
Duty cycle is also in nanoseconds so if you want a certain %, multiply it by the period.
echo 1 > enable

minitacoslayer · November 8, 2022, 7:37am

I moved the jumper over one pin to the edge, updated my board, ran commands below and wasnt able to get anything from my servo. i am connected to gpio pin 11, power on pin 4, and ground on pin 6. i used multiple brand new servos to rule out defected hardware. any thoughts?

sudo ./ldto enable pwm-ao-a
sudo ./ldto active
ls -al /sys/class/pwm
echo 1 > /sys/class/pwm/pwmchip0/export
echo 1000000 > /sys/class/pwm/pwmchip0/pwm1/period
echo 500000 > /sys/class/pwm/pwmchip0/pwm1/duty_cycle
echo 1 > /sys/class/pwm/pwmchip0/pwm1/enable

update: Just kidding i looked over the " AO_A on Pin 11 controlled via c8100550 pwm0" part. after echoing 0 instead of 1 to /sys/class/pwm/pwmchip0/export, that took care of the problem. Any thoughts on how to reverse the direction?

librecomputer · November 8, 2022, 12:12pm

There should be a file called polarity and you can echo a 0 or 1 and it should work.

technoryt · January 14, 2023, 9:50am

I am trying to follow the steps from minitacoslayer. However, I do not see the /sys/class/pwm folder:

ubuntu@lepotato:~$ sudo ldto enable pwm-ao-a
Overlay pwm-ao-a: applied
ubuntu@lepotato:~$ sudo ldto active 
#Overlays active:
pwm-ao-a
ubuntu@lepotato:~$ ls -al /sys/class/pwm
ls: cannot access '/sys/class/pwm': No such file or directory

Any idea on why this is happening?

librecomputer · January 15, 2023, 5:23am

This was a bug on our part. Please update the kernel and try again.

Samuel · January 16, 2023, 5:03pm

I was trying to enable pwm on pin 33:

sudo ldto enable pwm-a
echo 0 > pwmchip0/export 
echo 100000000 > pwmchip0/pwm0/period 
echo 10000000 > pwmchip0/pwm0/duty_cycle
echo 1 > pwmchip0/pwm0/enable

But I get an error: “-bash: echo: write error: Invalid argument” on this last line. What could this be?

technoryt · January 16, 2023, 8:00pm

I am encountering the same issue as @Samuel
As additional information, these are the active DTOs I have:

#Overlays active:
pwm-ao-6
pwm-ef

Note that the error is not uniform across chips/lines:

pwmchip0/pwm0: I can set duty_cycle and period but cannot set enable.
pwmchip0/pwm1: I cannot set duty_cycle
pwmchip2/pwm0 and pmwchip2/pwm1: works, I can set duty_cycle, period and enable.

Again, by “cannot set” I mean I get “write error: Invalid argument”.

librecomputer · January 16, 2023, 11:47pm

You don’t have permission as you are not the root user. You need to add yourself to the gpio group via sudo adduser USERNAME gpio or run sudo su.

Samuel · January 17, 2023, 10:56am

I try both solutions. And still, I wasn´t able to set enable on pins 32, 33 and 35. After rebooting the system I was able to write to pmw0/enable (for pin33 and 32). However, for some reason, I still cannot write (write error: Invalid argument) to pmw1/enable for pin35.

Aditional info

Like @technoryt, I was always able to set period and duty_cycle for all pins. I only had issues while setting enable (echo 1 > /sys/class/pwm/pwmchip{x}/pwm[n}/enable ) for pins 32, 33 and 35.
I only have one active DTO each time. And I’m using rasbian.

technoryt · January 17, 2023, 8:57pm

Actually, I rebooted after using ldto merge (so that I do not need to use ldto activate, I don’t think I changed anything else). Now I can successfully use all four PWM lines. I started from the Ubuntu 22.04 Desktop image.

@Samuel: did you manage to use the PWM lines from a non-root user? If I try to add my user to the gpio group as mentioned by @librecomputer, I have the error that the group does not exist. All the directories under /sys/class/pwm are all owned by root:root.

ubuntu@lepotato:~$ sudo adduser ubuntu gpio
[sudo] password for ubuntu: 
adduser: The group `gpio' does not exist.

librecomputer · January 17, 2023, 11:44pm

Check the group ownership of the files under /sys/class/pwm. Different OSes use different groups based on udev rules.

Samuel · January 18, 2023, 5:08pm

@librecomputer: Regarding your last post. All the files under sys/class/pwm/pwmchip{X} belong to the gpio group. Except for the pwmchip{X}, which are owned by root group. So, I tried to change the group of these directories (assuming that it should be gpio) but nothing changed:

inl@raspberrypi:~ $ sudo chgrp gpio /sys/class/pwm/pwmchip0
inl@raspberrypi:~ $ ls -l /sys/class/pwm/
total 0
lrwxrwxrwx 1 root root 0 Jan 18 16:43 pwmchip0 → …/…/devices/platform/soc/c1100000.bus/c11086c0.pwm/pwm/pwmchip0

By way, it is not very clear to me which group should own these directories. Should It be gpio?

For some reason, now I can control pin35, but cannot control pin33 anymore (refer to my previous post). Why could this be?

@technoryt: Regarding your question, I believe so, at least for pins 12 and 13. Relative to your comment, my user was already a member of gpio group.

librecomputer · January 18, 2023, 5:46pm

Permissions are setup by udev and can be arbitrarily customized.

You need to enable pwm-ef rather than pwm-e or pwm-f. They’re a combo pair.

Once you add yourself to a group. You need to logout and log back in to have it take effect. Also the permission should have group write.

YasushikoX · April 8, 2023, 6:00pm

Hello, I am new to this space and have no idea what do I do. So I tried enabling pin 32 and 33.

ls -al /sys/class/pwm # see the pwmchip{n} to hardware mapping
echo {0,1} | sudo tee /sys/class/pwm/pwmchip0/export
echo 1000000 | sudo tee /sys/class/pwm/pwmchip0/pwm0/period
echo 500000 | sudo tee /sys/class/pwm/pwmchip0/pwm0/duty_cycle
echo 1 | sudo tee /sys/class/pwm/pwmchip0/pwm0/enable
Overlay pwm-ef: already exists
total 0
drwxr-xr-x  2 root root 0 Dec 31  1969 .
drwxr-xr-x 75 root root 0 Dec 31  1969 ..
lrwxrwxrwx  1 root root 0 Apr  8 13:48 pwmchip0 -> ../../devices/platform/soc/c1100000.bus/c11086c0.pwm/pwm/pwmchip0
lrwxrwxrwx  1 root root 0 Apr  8 13:52 pwmchip2 -> ../../devices/platform/soc/c1100000.bus/c1108550.pwm/pwm/pwmchip2
0 1
tee: /sys/class/pwm/pwmchip0/export: Invalid argument
tee: /sys/class/pwm/pwmchip0/pwm0/period: No such file or directory
1000000
tee: /sys/class/pwm/pwmchip0/pwm0/duty_cycle: No such file or directory
500000
tee: /sys/class/pwm/pwmchip0/pwm0/enable: No such file or directory
1

I am not sure what is wrong and why, or even the right way to do that. Also, what do I use for python to control PWM? Is periphery good? Also weird thing is that It says in spreadsheet that port 32 is controlled by chip 1 and not 0…
image_2023-04-08_140533192

librecomputer · April 8, 2023, 9:07pm

You have to echo 0 or 1 based on which PWM you want to export. {0,1} is an invalid entry. You have to replace all things in {} with the proper value as outlined in the OP.

YasushikoX · April 8, 2023, 11:32pm

Ok that worked. But how do I control it? When I try using periphery, it gives me

periphery.pwm.PWMError: [Errno 19] Exporting PWM channel: No such device

I do not understand channels and how do I find right one for pin 32.

Here is what I got from activating pin 32:

yasushiko@raspberrypi:~ $ sudo ldto enable pwm-e # replace x with one of the dtos in list above
ls -al /sys/class/pwm # see the pwmchip to hardware mapping
echo 0 | sudo tee /sys/class/pwm/pwmchip0/export
echo 1000000 | sudo tee /sys/class/pwm/pwmchip0/pwm0/period
echo 500000 | sudo tee /sys/class/pwm/pwmchip0/pwm0/duty_cycle
echo 1 | sudo tee /sys/class/pwm/pwmchip0/pwm0/enable
Overlay pwm-e: applied
total 0
drwxr-xr-x  2 root root 0 Dec 31  1969 .
drwxr-xr-x 87 root root 0 Dec 31  1969 ..
lrwxrwxrwx  1 root root 0 Apr  8 19:28 pwmchip0 -> ../../devices/platform/soc/c1100000.bus/c11086c0.pwm/pwm/pwmchip0
0
1000000
500000
1

librecomputer · April 9, 2023, 1:25am

You set the period and the duty cycle to what you want via sysfs per the 3rd and 4th commands.

YasushikoX · April 9, 2023, 3:53am

But if I want to control it through periphery, how do I do that? I want to control Victor SPX. Also, could I control two of them at the same time? What is chip, and what is channel when I set up periphery in the code down below?

# Open PWM chip 0, channel 10
pwm = PWM(0, 10)