Provide possibility to set "exotic" ports' names

[andrey-patin-1979]

Some drivers for different OSes can call serial ports with different "exotic" names (e.g. "muiO" for Moxa on Linux (https://moxa.com/en/support/product-support/software-and-documentation?psid=114475)).
It would be helpful if there were possibility to provide such "exotic" ports names into the library.

[andrey-patin-1979]

I hope can provide solution for this issue on next week.

[tresf]

The page linked does not reference a specific port pattern, but has documents that allude to the port pattern.

• The pattern for Windows seems to leverage the existing COM# pattern and no changes should be needed
• The pattern for macOS seems to leverage the existing /dev/tty.USB* pattern and no changes should be needed
• The pattern for Linux seems to leverage /dev/ttyMXUSB* pattern and will require a patch.

Relevant code:

jssc/src/main/java/jssc/SerialPortList.java

Lines 51 to 55 in 8dd99a4

	case SerialNativeInterface.OS_LINUX: {
	PORTNAMES_REGEXP = Pattern.compile("(ttyS|ttyUSB|ttyACM|ttyAMA|rfcomm|ttyO)[0-9]{1,3}");
	PORTNAMES_PATH = "/dev/";
	break;
	}

Excerpt from MOXA manual:

[tresf]

"exotic" names (e.g. "muiO" for Moxa on Linux

@andrey-patin-1979 Please link direct documentation to support this statement.

[andrey-patin-1979]

tresf, for instance in the https://www.moxa.com/getmedia/bf07835c-fdca-43c2-8879-0eaa24bdcd4d/moxa-industrial-linux-3-debian-11-manual-with-security-hardening-guide-v1.0.pdf / section "Serial Port" (on page 31) as an examples of names stated following "Device node (e.g., /dev/ttyM0)", and another example "exotic" port naming for MOXA is here "https://docs.moxa.online/mil/manuals/tools/mx-uart-ctl/#da-680".
Actually I faced this "names problem" for Moxa on Linux when using this one driver (https://github.com/uecasm/mxser/blob/3188030d088e2f12bec4de91956be16488e3bcd5/driver/msmknod#L13), but I'm not sure that it is only example since a lot of different devices are developed so far and can be present in different OSes with such "exotic" names.

[tresf]

I'm not sure that it is only example since a lot of different devices are developed so far and can be present in different OSes with such "exotic" names.

Right, but we can only code for what we know.

So far the proposal as we've identified are:

 case SerialNativeInterface.OS_LINUX: { 
-    PORTNAMES_REGEXP = Pattern.compile("(ttyS|ttyUSB|ttyACM|ttyAMA|rfcomm|ttyO)[0-9]{1,3}"); 
+    PORTNAMES_REGEXP = Pattern.compile("(ttyS|ttyUSB|ttyACM|ttyAMA|rfcomm|ttyO|ttyM|ttyMXUSB|ttyMUE)[0-9]{1,3}"); 
     PORTNAMES_PATH = "/dev/"; 
     break; 
 } 

This adds three new options that are compatible with Moxa's documentation:

• /dev/ttyM<number>
• /dev/ttyMXUSB<number>
• /dev/ttyMUE<number>

We may choose to recognize all /dev/ttyM* patterns as valid serial ports, however the regex would need to change for that to work, so adding the three separate patterns is what I would recommend for now.

[andrey-patin-1979]

@tresf, actually I was thinking about adding special Java-option that will allow to add "exotic names" to PORTNAMES_REGEXP for any OSes. It looks more convenient way to fix this issue once and for all. Do you agree?

[tresf]

@tresf, actually I was thinking about adding special Java-option that will allow to add "exotic names" to PORTNAMES_REGEXP for any OSes. It looks more convenient way to fix this issue once and for all. Do you agree?

I don't see this feature being particularly useful for Windows, but I think it would be a nice addition to the API regardless due to its usefulness on macOS and Linux. Like any feature, it may be a security concern for companies to offer an arbitrary codepath to flat file reads, so I think this feature should have an option to disable it. I still believe that the library should "Just work", so adding values -- such as those introduced by MOXA devices -- is still desired, they've been in the industry for decades.

[andrey-patin-1979]

Just to make sure I understand you, @tresf, correctly, you want to add this feature by yourself?
Or you want me to make MR with this feature, in that case what kind of change you want to see in the MR from me, only update of PORTNAMES_REGEXP or add java-option (if you mean this by API) or both?

[tresf]

I would ask for two PRs, one with well-known names one with the REGEX/future unknown names feature.

[andrey-patin-1979]

I would ask for two PRs, one with well-known names one with the REGEX/future unknown names feature.

OK, would you, @tresf, please create a branches for both of these changes (seems I don't have rights to do it)?

[tresf]

You would normally create your own fork, then your own branch, then PR.