introduce rpmsg-utils binaries

examples/linux/rpmsg-utils/Makefile

@@ -1,6 +1,7 @@
 EPT := rpmsg_export_ept
 EPTD = rpmsg_destroy_ept
 PING = rpmsg_ping
+DEV  = rpmsg_export_dev
 
 CFLAGS := -Wall -g -O2
 LDFLAGS := 
@@ -9,9 +10,10 @@ prefix := /usr/local
 SRCS := rpmsg_export_ept.c
 SRCS += rpmsg_destroy_ept.c
 SRCS += rpmsg_ping.c
+SRCS += rpmsg_export_dev.c
 OBJS := $(SRCS:.c=.o)
 
-all: $(EPT) $(EPTD) $(PING)
+all: $(EPT) $(EPTD) $(PING) $(DEV)
 .PHONY : all
 
 $(EPT): rpmsg_export_ept.o
@@ -23,15 +25,21 @@ $(EPTD): rpmsg_destroy_ept.o
 $(PING): rpmsg_ping.o
 	$(CC) $(LDFLAGS) -o $@ $^
 
-install: $(EPT) $(EPTD) $(PING)
+
+$(DEV): rpmsg_export_dev.o
+	$(CC) $(LDFLAGS) -o $@ $^
+
+install: $(EPT) $(EPTD) $(PING) $(DEV)
 	install -D -m 755 $(EPT) $(DESTDIR)$(prefix)/bin/$(EPT)
 	install -D -m 755 $(EPTD) $(DESTDIR)$(prefix)/bin/$(EPTD)
 	install -D -m 755 $(PING) $(DESTDIR)$(prefix)/bin/$(PING)
+	install -D -m 755 $(DEV) $(DESTDIR)$(prefix)/bin/$(DEV)
 
 clean:
-	rm -f $(EPT) $(EPTD) $(PING) $(OBJS)
+	rm -f $(EPT) $(EPTD) $(PING) $(OBJS) $(DEV)
 
 distclean:
 	rm -f $(DESTDIR)$(prefix)/bin/$(EPT)
 	rm -f $(DESTDIR)$(prefix)/bin/$(EPTD)
-	rm -f $(DESTDIR)$(prefix)/bin/$(PING)
+	rm -f $(DESTDIR)$(prefix)/bin/$(PING)
+	rm -f $(DESTDIR)$(prefix)/bin/$(DEV)

examples/linux/rpmsg-utils/README

@@ -30,4 +30,10 @@ eptdestroy
 ping
 ====
 "rpmsg_ping" is a test binary that open a rpmsg chardev for a an echo
-test (write a pattern and wait an answer).
+test (write a patern and wait an answer)
+
+rpmsgexportdev
+==============
+"rpmsg_export_dev" implements RPMSG_CREATE_DEV_IOCTL to create local RPMsg device
+as remoteproc devices are booted.
+Adding option -d as first argument release the device using RPMSG_RELEASE_DEV_IOCTL control.

examples/linux/rpmsg-utils/rpmsg_export_dev.c

@@ -0,0 +1,112 @@
+/*
+ * Copyright (C) 2022, STMicroelectronics
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its contributors
+ * may be used to endorse or promote products derived from this software without
+ * specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+#include <sys/ioctl.h>
+
+#include <err.h>
+#include <fcntl.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <string.h>
+
+struct rpmsg_endpoint_info {
+	char name[32];
+	uint32_t src;
+	uint32_t dst;
+};
+
+#define RPMSG_CREATE_DEV_IOCTL	_IOW(0xb5, 0x3, struct rpmsg_endpoint_info)
+#define RPMSG_RELEASE_DEV_IOCTL	_IOW(0xb5, 0x4, struct rpmsg_endpoint_info)
+
+static void usage(void)
+{
+	extern char *__progname;
+
+	fprintf(stderr, "%s <ctrl> [-d] <name> [<src> <dst>]\n", __progname);
+	exit(1);
+}
+
+int main(int argc, char **argv)
+{
+	struct rpmsg_endpoint_info ept;
+	int ret, fd;
+	int release = 0;
+	char *endptr;
+
+	if (argv[2][0] == '-') {
+		if (argv[1][1] == 'd') {
+			if (argc != 4 && argc != 6)
+				goto error_usage;
+			release = 1;
+		} else if (argv[1][1] == 'h') {
+			usage();
+			return 0;
+		} else {
+			printf("Invalid option.\n");
+			goto error_usage;
+		}
+	} else if (argc != 3 && argc != 5) {
+		goto error_usage;
+	}
+
+	fd = open(argv[1], O_RDWR);
+	if (fd < 0)
+		err(1, "failed to open %s\n", argv[1]);
+
+	strncpy(ept.name, argv[2 + release], sizeof(ept.name));
+	ept.name[sizeof(ept.name) - 1] = '\0';
+
+	if (argc >= 5) {
+		ept.src = strtoul(argv[3 + release], &endptr, 10);
+
+		if (*endptr)
+			usage();
+
+		ept.dst = strtoul(argv[4 + release], &endptr, 10);
+
+		if (*endptr)
+			usage();
+	}
+
+	if (!release)
+		ret = ioctl(fd, RPMSG_CREATE_DEV_IOCTL, &ept);
+	else
+		ret = ioctl(fd, RPMSG_RELEASE_DEV_IOCTL, &ept);
+	if (ret < 0)
+		fprintf(stderr, "failed to %s rpmsg device\n", release ? "release" : "create");
+	close(fd);
+	return ret;
+
+error_usage:
+	usage();
+	return 2;
+}