nuttx/can.h: support timestamp for can frame.

[OceanfromXiaomi]

Summary

nuttx/can.h: support timestamp for can frame
and update "can.rst" file for add struct timeval ch_ts info.

Impact

NULL.

Testing

tested on the board with cortex-M architecture.

[nuttxpr]

[Experimental Bot, please feedback here]

No, this PR does not meet the NuttX requirements.

Here's why and how to improve it:

• Insufficient Summary:
  • Missing Why: You need to explain the reason for adding timestamps. What problems does it solve? What use cases does it enable?
  • Missing How: Be specific about how timestamps are implemented. What data structure is used? Where is the timestamp information stored? How is it accessed?
• Incomplete Impact:
  • Potential Hardware Impact: Adding timestamps might impact hardware timers or require driver modifications. Address this possibility.
  • Documentation: If this adds a new feature, documentation is crucial. Mention if documentation is included or needs to be added.
• Vague Testing:
  • Insufficient Detail: Specify the exact board and configuration used.
  • Missing Logs: Provide relevant snippets of logs showing the timestamps working as expected.

Example of an Improved Summary:

"This PR adds support for CAN frame timestamps to provide more precise timing information for applications requiring accurate event sequencing or time-sensitive control. A new struct can_msg_ts structure is introduced that includes the standard struct can_msg fields along with a microsecond timestamp. The timestamp is captured by the CAN driver when a frame is received or transmitted. This change enables applications to analyze CAN bus traffic with higher temporal resolution."

[acassis]

@OceanfromXiaomi please include a driver example to be used as reference, also please update Documentation/

[OceanfromXiaomi]

l

let me ask, how to deal with "include a driver example to be used as reference"

[acassis]

l

let me ask, how to deal with "include a driver example to be used as reference"

@OceanfromXiaomi just implement the usage of CONFIG_CAN_TIMESTAMP in the can driver

[OceanfromXiaomi]

l

let me ask, how to deal with "include a driver example to be used as reference"

@OceanfromXiaomi just implement the usage of CONFIG_CAN_TIMESTAMP in the can driver

@acassis OK, I will code this driver example.

[OceanfromXiaomi]

@OceanfromXiaomi please include a driver example to be used as reference, also please update Documentation/

@acassis please tell me update what and where in Documentation/, Thank you~

[acassis]

@OceanfromXiaomi please include a driver example to be used as reference, also please update Documentation/

@acassis please tell me update what and where in Documentation/, Thank you~

https://nuttx.apache.org/docs/latest/components/drivers/character/can.html

[xiaoxiang781216]

@OceanfromXiaomi remove the merged patch from pr.