Skip to content

feat(linux): Add eCAP documentation#733

Open
jmenti wants to merge 1 commit into
TexasInstruments:masterfrom
jmenti:ecap
Open

feat(linux): Add eCAP documentation#733
jmenti wants to merge 1 commit into
TexasInstruments:masterfrom
jmenti:ecap

Conversation

@jmenti

@jmenti jmenti commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

Add eCAP documentation and enable for devices currently enabling eCAP via overlays in TI Linux Kernel.

Add eCAP documentation and enable for devices currently enabling
eCAP via overlays in TI Linux Kernel.

Signed-off-by: Judith Mendez <jm@ti.com>
Comment on lines +5 to +6
Introduction
============

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Auxillary
BeagleBone
Broadcom
eCAP

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is an acronym, not a real word.

@@ -1,15 +1,19 @@
Armbian
Auxillary

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a misspelling of auxiliary and is not used in this pr oddly enough.

Debian
GStreamer
Jacinto
Kernel

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The term Kernel should normally be lowercase. It's not a proper name.

OpenCL
OpenGL
OpenVX
pinctrl

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This also isn't a real word. It's just shorthand for pin control.

Comment on lines +309 to +310
from module clock according to clock signal action. Every rising edge of clock
increments counter +1.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
from module clock according to clock signal action. Every rising edge of clock
increments counter +1.
from module clock according to clock signal action. Every rising edge increments the counter by one.

2

Attribute :file:`num_overflows` increments when counter wraps around
(0xFFFFFFFF → 0x00000000).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


**Verify PWM functionality:**

See troubleshooting in :doc:`PWM` guide and monitor eCAP PWM through :file:`/sys/kernel/debug/pwm`.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please avoid using the doc role. It's not as reliable as the usual ref cross-referencing mechanism.


$ cat /sys/bus/counter/devices/counterX/name

If not present, verify the overlay applied and check for pin conflicts in dmesg log.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If not present, verify the overlay applied and check for pin conflicts in dmesg log.
If not present, verify the overlay applied and check for pin conflicts reported in the ``dmesg`` log.

Comment on lines +372 to +373
Interrupt count increments on each capture event or overflow. High counts on
active signal indicate interrupts working correctly.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Interrupt count increments on each capture event or overflow. High counts on
active signal indicate interrupts working correctly.
The interrupt count will increment on each capture event or overflow. A high count on
the active signal indicates the interrupts are working correctly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants