samples/rpmsg: add an rpmsg driver sample

Add an rpmsg driver sample, which demonstrates how to communicate with an AMP-configured remote processor over the rpmsg bus. Note how once probed, the driver can immediately start sending messages using the rpmsg_send() API, without having to worry about creating endpoints or allocating rpmsg addresses: all that work is done by the rpmsg bus, and the required information is already embedded in the rpmsg channel that the driver is probed with. In this sample, the driver simply sends a "Hello World!" message to the remote processor repeatedly. Designed with Brian Swetland <swetland@google.com>. Signed-off-by: Ohad Ben-Cohen <ohad@wizery.com> Cc: Brian Swetland <swetland@google.com> Cc: Arnd Bergmann <arnd@arndb.de> Cc: Grant Likely <grant.likely@secretlab.ca> Cc: Tony Lindgren <tony@atomide.com> Cc: Russell King <linux@arm.linux.org.uk> Cc: Rusty Russell <rusty@rustcorp.com.au> Cc: Andrew Morton <akpm@linux-foundation.org> Cc: Greg KH <greg@kroah.com> Cc: Stephen Boyd <sboyd@codeaurora.org>

samples/rpmsg: add an rpmsg driver sample
Add an rpmsg driver sample, which demonstrates how to communicate with an AMP-configured remote processor over the rpmsg bus. Note how once probed, the driver can immediately start sending messages using the rpmsg_send() API, without having to worry about creating endpoints or allocating rpmsg addresses: all that work is done by the rpmsg bus, and the required information is already embedded in the rpmsg channel that the driver is probed with. In this sample, the driver simply sends a "Hello World!" message to the remote processor repeatedly. Designed with Brian Swetland <swetland@google.com>. Signed-off-by: Ohad Ben-Cohen <ohad@wizery.com> Cc: Brian Swetland <swetland@google.com> Cc: Arnd Bergmann <arnd@arndb.de> Cc: Grant Likely <grant.likely@secretlab.ca> Cc: Tony Lindgren <tony@atomide.com> Cc: Russell King <linux@arm.linux.org.uk> Cc: Rusty Russell <rusty@rustcorp.com.au> Cc: Andrew Morton <akpm@linux-foundation.org> Cc: Greg KH <greg@kroah.com> Cc: Stephen Boyd <sboyd@codeaurora.org>
Ohad Ben-Cohen
1 parent bcabbccabf
Showing 4 changed files with 110 additions and 1 deletions Side-by-side Diff
samples/Kconfig
samples/Makefile
samples/rpmsg/Makefile
samples/rpmsg/rpmsg_client_sample.c
@@ -61,5 +61,13 @@
 	  Build an example of how to dynamically add the hello
 	  command to the kdb shell.
  
+config SAMPLE_RPMSG_CLIENT
+	tristate "Build rpmsg client sample -- loadable modules only"
+	depends on RPMSG && m
+	help
+	  Build an rpmsg client sample driver, which demonstrates how
+	  to communicate with an AMP-configured remote processor over
+	  the rpmsg bus.
+
 endif # SAMPLES
 # Makefile for Linux samples code
  
 obj-$(CONFIG_SAMPLES)	+= kobject/ kprobes/ tracepoints/ trace_events/ \
-			   hw_breakpoint/ kfifo/ kdb/ hidraw/
+			   hw_breakpoint/ kfifo/ kdb/ hidraw/ rpmsg/
+obj-$(CONFIG_SAMPLE_RPMSG_CLIENT) += rpmsg_client_sample.o
+/*
+ * Remote processor messaging - sample client driver
+ *
+ * Copyright (C) 2011 Texas Instruments, Inc.
+ * Copyright (C) 2011 Google, Inc.
+ *
+ * Ohad Ben-Cohen <ohad@wizery.com>
+ * Brian Swetland <swetland@google.com>
+ *
+ * This software is licensed under the terms of the GNU General Public
+ * License version 2, as published by the Free Software Foundation, and
+ * may be copied, distributed, and modified under those terms.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ */
+
+#include <linux/kernel.h>
+#include <linux/module.h>
+#include <linux/rpmsg.h>
+
+#define MSG		"hello world!"
+#define MSG_LIMIT	100
+
+static void rpmsg_sample_cb(struct rpmsg_channel *rpdev, void *data, int len,
+						void *priv, u32 src)
+{
+	int ret;
+	static int rx_count;
+
+	dev_info(&rpdev->dev, "incoming msg %d (src: 0x%x)\n", ++rx_count, src);
+
+	print_hex_dump(KERN_DEBUG, __func__, DUMP_PREFIX_NONE, 16, 1,
+		       data, len,  true);
+
+	/* samples should not live forever */
+	if (rx_count >= MSG_LIMIT) {
+		dev_info(&rpdev->dev, "goodbye!\n");
+		return;
+	}
+
+	/* send a new message now */
+	ret = rpmsg_send(rpdev, MSG, strlen(MSG));
+	if (ret)
+		dev_err(&rpdev->dev, "rpmsg_send failed: %d\n", ret);
+}
+
+static int rpmsg_sample_probe(struct rpmsg_channel *rpdev)
+{
+	int ret;
+
+	dev_info(&rpdev->dev, "new channel: 0x%x -> 0x%x!\n",
+					rpdev->src, rpdev->dst);
+
+	/* send a message to our remote processor */
+	ret = rpmsg_send(rpdev, MSG, strlen(MSG));
+	if (ret) {
+		dev_err(&rpdev->dev, "rpmsg_send failed: %d\n", ret);
+		return ret;
+	}
+
+	return 0;
+}
+
+static void __devexit rpmsg_sample_remove(struct rpmsg_channel *rpdev)
+{
+	dev_info(&rpdev->dev, "rpmsg sample client driver is removed\n");
+}
+
+static struct rpmsg_device_id rpmsg_driver_sample_id_table[] = {
+	{ .name	= "rpmsg-client-sample" },
+	{ },
+};
+MODULE_DEVICE_TABLE(rpmsg, rpmsg_driver_sample_id_table);
+
+static struct rpmsg_driver rpmsg_sample_client = {
+	.drv.name	= KBUILD_MODNAME,
+	.drv.owner	= THIS_MODULE,
+	.id_table	= rpmsg_driver_sample_id_table,
+	.probe		= rpmsg_sample_probe,
+	.callback	= rpmsg_sample_cb,
+	.remove		= __devexit_p(rpmsg_sample_remove),
+};
+
+static int __init rpmsg_client_sample_init(void)
+{
+	return register_rpmsg_driver(&rpmsg_sample_client);
+}
+module_init(rpmsg_client_sample_init);
+
+static void __exit rpmsg_client_sample_fini(void)
+{
+	unregister_rpmsg_driver(&rpmsg_sample_client);
+}
+module_exit(rpmsg_client_sample_fini);
+
+MODULE_DESCRIPTION("Remote processor messaging sample client driver");
+MODULE_LICENSE("GPL v2");
...	...	@@ -61,5 +61,13 @@
61	61	Build an example of how to dynamically add the hello
62	62	command to the kdb shell.
63	63
	64	+config SAMPLE_RPMSG_CLIENT
	65	+ tristate "Build rpmsg client sample -- loadable modules only"
	66	+ depends on RPMSG && m
	67	+ help
	68	+ Build an rpmsg client sample driver, which demonstrates how
	69	+ to communicate with an AMP-configured remote processor over
	70	+ the rpmsg bus.
	71	+
64	72	endif # SAMPLES
1	1	# Makefile for Linux samples code
2	2
3	3	obj-$(CONFIG_SAMPLES) += kobject/ kprobes/ tracepoints/ trace_events/ \
4		- hw_breakpoint/ kfifo/ kdb/ hidraw/
	4	+ hw_breakpoint/ kfifo/ kdb/ hidraw/ rpmsg/
	1	+/*
	2	+ * Remote processor messaging - sample client driver
	3	+ *
	4	+ * Copyright (C) 2011 Texas Instruments, Inc.
	5	+ * Copyright (C) 2011 Google, Inc.
	6	+ *
	7	+ * Ohad Ben-Cohen <ohad@wizery.com>
	8	+ * Brian Swetland <swetland@google.com>
	9	+ *
	10	+ * This software is licensed under the terms of the GNU General Public
	11	+ * License version 2, as published by the Free Software Foundation, and
	12	+ * may be copied, distributed, and modified under those terms.
	13	+ *
	14	+ * This program is distributed in the hope that it will be useful,
	15	+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
	16	+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	17	+ * GNU General Public License for more details.
	18	+ */
	19	+
	20	+#include <linux/kernel.h>
	21	+#include <linux/module.h>
	22	+#include <linux/rpmsg.h>
	23	+
	24	+#define MSG "hello world!"
	25	+#define MSG_LIMIT 100
	26	+
	27	+static void rpmsg_sample_cb(struct rpmsg_channel rpdev, void data, int len,
	28	+ void *priv, u32 src)
	29	+{
	30	+ int ret;
	31	+ static int rx_count;
	32	+
	33	+ dev_info(&rpdev->dev, "incoming msg %d (src: 0x%x)\n", ++rx_count, src);
	34	+
	35	+ print_hex_dump(KERN_DEBUG, __func__, DUMP_PREFIX_NONE, 16, 1,
	36	+ data, len, true);
	37	+
	38	+ /* samples should not live forever */
	39	+ if (rx_count >= MSG_LIMIT) {
	40	+ dev_info(&rpdev->dev, "goodbye!\n");
	41	+ return;
	42	+ }
	43	+
	44	+ /* send a new message now */
	45	+ ret = rpmsg_send(rpdev, MSG, strlen(MSG));
	46	+ if (ret)
	47	+ dev_err(&rpdev->dev, "rpmsg_send failed: %d\n", ret);
	48	+}
	49	+
	50	+static int rpmsg_sample_probe(struct rpmsg_channel *rpdev)
	51	+{
	52	+ int ret;
	53	+
	54	+ dev_info(&rpdev->dev, "new channel: 0x%x -> 0x%x!\n",
	55	+ rpdev->src, rpdev->dst);
	56	+
	57	+ /* send a message to our remote processor */
	58	+ ret = rpmsg_send(rpdev, MSG, strlen(MSG));
	59	+ if (ret) {
	60	+ dev_err(&rpdev->dev, "rpmsg_send failed: %d\n", ret);
	61	+ return ret;
	62	+ }
	63	+
	64	+ return 0;
	65	+}
	66	+
	67	+static void __devexit rpmsg_sample_remove(struct rpmsg_channel *rpdev)
	68	+{
	69	+ dev_info(&rpdev->dev, "rpmsg sample client driver is removed\n");
	70	+}
	71	+
	72	+static struct rpmsg_device_id rpmsg_driver_sample_id_table[] = {
	73	+ { .name = "rpmsg-client-sample" },
	74	+ { },
	75	+};
	76	+MODULE_DEVICE_TABLE(rpmsg, rpmsg_driver_sample_id_table);
	77	+
	78	+static struct rpmsg_driver rpmsg_sample_client = {
	79	+ .drv.name = KBUILD_MODNAME,
	80	+ .drv.owner = THIS_MODULE,
	81	+ .id_table = rpmsg_driver_sample_id_table,
	82	+ .probe = rpmsg_sample_probe,
	83	+ .callback = rpmsg_sample_cb,
	84	+ .remove = __devexit_p(rpmsg_sample_remove),
	85	+};
	86	+
	87	+static int __init rpmsg_client_sample_init(void)
	88	+{
	89	+ return register_rpmsg_driver(&rpmsg_sample_client);
	90	+}
	91	+module_init(rpmsg_client_sample_init);
	92	+
	93	+static void __exit rpmsg_client_sample_fini(void)
	94	+{
	95	+ unregister_rpmsg_driver(&rpmsg_sample_client);
	96	+}
	97	+module_exit(rpmsg_client_sample_fini);
	98	+
	99	+MODULE_DESCRIPTION("Remote processor messaging sample client driver");
	100	+MODULE_LICENSE("GPL v2");