On 08/03/14 14:23, Grant Likely wrote: >>> That's fine. In that case the driver would specifically require the >>> endpoint to be that one node.... although the above looks a little weird >> >> The driver can't require that. It's up to the board designer to decide >> how many endpoints are used. A driver may say that it has a single input >> port. But the number of endpoints for that port is up to the use case. > > Come now, when you're writing a driver you know if it will ever be > possible to have more than one port. If that is the case then the > binding should be specifically laid out for that. If there will never be > multiple ports and the binding is unambiguous, then, and only then, > should the shortcut be used, and only the shortcut should be accepted. I was talking about endpoints, not ports. There's no unclarity about the number of ports, that comes directly from the hardware for that specific component. The number of endpoints, however, come from the board hardware. The driver writer cannot know that. >>> to me. I would recommend that if there are other non-port child nodes >>> then the ports should still be encapsulated by a ports node. The device >>> binding should not be ambiguous about which nodes are ports. >> >> Hmm, ambiguous in what way? > > Parsing the binding now consists of a ladder of 'ifs' that gives three > distinct different behaviours for no benefit. You don't want that in It considerably lessens the amount of text in the DT for many use cases, making it easier to write and maintain the dts files. > bindings because it makes it more difficult to get the parsing right in > the first place, and to make sure that all users parse it in the same > way (Linux, U-Boot, BSD, etc). Bindings should be as absolutely simple > as possible. Well, yes, I agree there. This is not the simplest of bindings. I'd be more than happy if we would come up with simpler version of this, which would still allow us to have the same descriptive power. > Just to be clear, I have no problem with having the option in the > pattern, but the driver needs to be specific about what layout it > expects. If we forget the shortened endpoint format, I think it can be quite specific. A device has either one port, in which case it should require the 'ports' node to be omitted, or the device has more than one port, in which case it should require 'ports' node. Note that the original v4l2 binding doc says that 'ports' is always optional. Tomi
Attachment:
signature.asc
Description: OpenPGP digital signature
