+/**
+ * Create/allocate a new sr_serial_port structure.
+ *
+ * @param name The OS dependent name of the serial port. Must not be NULL.
+ * @param description An end user friendly description for the serial port.
+ * Can be NULL (in that case the empty string is used
+ * as description).
+ *
+ * @return The newly allocated sr_serial_port struct.
+ */
+static struct sr_serial_port *sr_serial_new(const char *name,
+ const char *description)
+{
+ struct sr_serial_port *serial;
+
+ if (!name)
+ return NULL;
+
+ serial = g_malloc(sizeof(struct sr_serial_port));
+ serial->name = g_strdup(name);
+ serial->description = g_strdup(description ? description : "");
+
+ return serial;
+}
+
+/**
+ * Free a previously allocated sr_serial_port structure.
+ *
+ * @param serial The sr_serial_port struct to free. Must not be NULL.
+ */
+SR_API void sr_serial_free(struct sr_serial_port *serial)
+{
+ if (!serial)
+ return;
+ g_free(serial->name);
+ g_free(serial->description);
+ g_free(serial);
+}
+
+/**
+ * List available serial devices.
+ *
+ * @return A GSList of strings containing the path of the serial devices or
+ * NULL if no serial device is found. The returned list must be freed
+ * by the caller.
+ */
+SR_API GSList *sr_serial_list(const struct sr_dev_driver *driver)
+{
+ GSList *tty_devs = NULL;
+ struct sp_port **ports;
+ struct sr_serial_port *port;
+ int i;
+
+ /* Currently unused, but will be used by some drivers later on. */
+ (void)driver;
+
+ if (sp_list_ports(&ports) != SP_OK)
+ return NULL;
+
+ for (i = 0; ports[i]; i++) {
+ port = sr_serial_new(sp_get_port_name(ports[i]),
+ sp_get_port_description(ports[i]));
+ tty_devs = g_slist_append(tty_devs, port);
+ }
+
+ sp_free_port_list(ports);
+
+ return tty_devs;
+}
+