draft driver for STUSB4500

[SimonFilgis]

Right now it is only possible to change the delivered power on the fly by

1. selecting PDO2 slot
2. write to POO2
3. renegotiate power by sw reset command

Note: Please adhere to Contributing Guidelines.

Summary

Create a basic driver to negotiate power delivery with walladapter using STM STUSB4500 chip.
This is a standalone driver that does not change any other code. It may be selected, or not via kconfig.

Impact

New feature. No impact to any existing user or application expected.

Testing

Tested on custom board.

[nuttxpr]

[Experimental Bot, please feedback here]

No, this PR does not fully meet the NuttX requirements. While it provides a summary and testing information, it lacks crucial details. Here's a breakdown of what's missing:

• Summary: Needs to be more detailed.

  • Why is this change necessary? Just saying "Create an ioctl driver..." isn't enough. Explain the problem the driver solves. Why is the current method (PDO2/POO2/reset) insufficient? What benefits does the ioctl driver provide?
  • What functional part of the code is being changed? Be specific. Which subsystem is affected? Are new files being added? Are existing files being modified? Where is this ioctl driver located in the codebase?
  • How does the change exactly work? Explain the mechanism of the ioctl driver. What ioctl commands are being introduced? How does it interact with the hardware? How does it differ from the existing power negotiation method?
  • Related Issues: Are there any related issues in the NuttX or NuttX Apps repositories? If not, consider creating one to track the feature request/bug this PR addresses.

• Impact: "None expected" is almost never true. Think carefully about potential impacts.

  • New feature? Yes, explicitly state this.
  • Impact on the user: Will the user need to change their application code to use the new ioctl driver? If so, how? Provide examples.
  • Impact on build: Does the build system need to be modified to include the new driver? Are any new Kconfig options added?
  • Impact on hardware: Which architectures and boards are supported? Are any hardware-specific modifications required?
  • Impact on documentation: At a minimum, the new driver needs to be documented. State this explicitly. Where will the documentation be added?
  • Impact on security: Consider potential security implications. Could the ioctl driver be misused?
  • Impact on compatibility: Does this change break any existing functionality?

• Testing: Insufficient detail.

  • Build Host(s): Provide specific information: OS version, compiler version (e.g., "Linux Ubuntu 20.04, GCC 9.4.0").
  • Target(s): Be specific: Architecture, board, configuration (e.g., "sim:qemu-arm", "stm32f4discovery:default").
  • Testing logs: "Tested on custom board" is meaningless without actual logs. Show relevant logs demonstrating the functionality before and after the change. Include commands used, output, and evidence that the power delivery negotiation is working as expected. Demonstrate the benefits over the previous method.

By addressing these points, the PR will be much more likely to be accepted. Remember to be clear, concise, and provide as much detail as possible.

[acassis]

@SimonFilgis please fix these coding style issues:

 ../nuttx/tools/checkpatch.sh -u -m -g 27f278af902117c6b007ca4f234c5d736b781902..HEAD
Error: /home/runner/work/nuttx/nuttx/nuttx/drivers/usbmisc/stusb4500.c:239:86: error: Long line found
Error: /home/runner/work/nuttx/nuttx/nuttx/drivers/usbmisc/stusb4500.c:242:80: error: Long line found
Error: /home/runner/work/nuttx/nuttx/nuttx/drivers/usbmisc/stusb4500.c:245:81: error: Long line found
Error: Process completed with exit code 1.

[SimonFilgis]

https://github.com/ardnew/STUSB4500/blob/master/LICENSE

I think I should add the license to nuttx/LICENSE...

I took over defines and structs. The algorithm is from the STM app note.

Is there an opinion about that?

[acassis]

Hi Simon, Normally headers files are not covered by the license (at least for GPL), I think you can use the Apache license and put a note explaining that the definitions came from that project. BR, Alan

…

On Sun, Nov 24, 2024 at 2:45 PM SimonFilgis ***@***.***> wrote: https://github.com/ardnew/STUSB4500/blob/master/LICENSE I think I should add the license to nuttx/LICENSE... I took over defines and structs. The algorithm is from the STM app note. Is there an opinion about that? — Reply to this email directly, view it on GitHub <#14895 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAAJBCAOXY3LVGH26TEPMRT2CIGFPAVCNFSM6AAAAABSHMITK6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDIOJWGEZTGMRRGA> . You are receiving this because you commented.Message ID: ***@***.***>

[acassis]

@SimonFilgis please squash your commit and remove the draft from title when done