linux/drivers/mailbox/mailbox-test.c
<<
>>
Prefs
   1/*
   2 * Copyright (C) 2015 ST Microelectronics
   3 *
   4 * Author: Lee Jones <lee.jones@linaro.org>
   5 *
   6 * This program is free software; you can redistribute it and/or modify
   7 * it under the terms of the GNU General Public License as published by
   8 * the Free Software Foundation; either version 2 of the License, or
   9 * (at your option) any later version.
  10 */
  11
  12#include <linux/debugfs.h>
  13#include <linux/err.h>
  14#include <linux/io.h>
  15#include <linux/kernel.h>
  16#include <linux/mailbox_client.h>
  17#include <linux/module.h>
  18#include <linux/of.h>
  19#include <linux/platform_device.h>
  20#include <linux/slab.h>
  21#include <linux/uaccess.h>
  22
  23#define MBOX_MAX_SIG_LEN        8
  24#define MBOX_MAX_MSG_LEN        128
  25#define MBOX_BYTES_PER_LINE     16
  26#define MBOX_HEXDUMP_LINE_LEN   ((MBOX_BYTES_PER_LINE * 4) + 2)
  27#define MBOX_HEXDUMP_MAX_LEN    (MBOX_HEXDUMP_LINE_LEN *                \
  28                                 (MBOX_MAX_MSG_LEN / MBOX_BYTES_PER_LINE))
  29
  30static struct dentry *root_debugfs_dir;
  31
  32struct mbox_test_device {
  33        struct device           *dev;
  34        void __iomem            *mmio;
  35        struct mbox_chan        *tx_channel;
  36        struct mbox_chan        *rx_channel;
  37        char                    *rx_buffer;
  38        char                    *signal;
  39        char                    *message;
  40        spinlock_t              lock;
  41};
  42
  43static ssize_t mbox_test_signal_write(struct file *filp,
  44                                       const char __user *userbuf,
  45                                       size_t count, loff_t *ppos)
  46{
  47        struct mbox_test_device *tdev = filp->private_data;
  48        int ret;
  49
  50        if (!tdev->tx_channel) {
  51                dev_err(tdev->dev, "Channel cannot do Tx\n");
  52                return -EINVAL;
  53        }
  54
  55        if (count > MBOX_MAX_SIG_LEN) {
  56                dev_err(tdev->dev,
  57                        "Signal length %zd greater than max allowed %d\n",
  58                        count, MBOX_MAX_SIG_LEN);
  59                return -EINVAL;
  60        }
  61
  62        tdev->signal = kzalloc(MBOX_MAX_SIG_LEN, GFP_KERNEL);
  63        if (!tdev->signal)
  64                return -ENOMEM;
  65
  66        ret = copy_from_user(tdev->signal, userbuf, count);
  67        if (ret) {
  68                kfree(tdev->signal);
  69                return -EFAULT;
  70        }
  71
  72        return ret < 0 ? ret : count;
  73}
  74
  75static const struct file_operations mbox_test_signal_ops = {
  76        .write  = mbox_test_signal_write,
  77        .open   = simple_open,
  78        .llseek = generic_file_llseek,
  79};
  80
  81static ssize_t mbox_test_message_write(struct file *filp,
  82                                       const char __user *userbuf,
  83                                       size_t count, loff_t *ppos)
  84{
  85        struct mbox_test_device *tdev = filp->private_data;
  86        void *data;
  87        int ret;
  88
  89        if (!tdev->tx_channel) {
  90                dev_err(tdev->dev, "Channel cannot do Tx\n");
  91                return -EINVAL;
  92        }
  93
  94        if (count > MBOX_MAX_MSG_LEN) {
  95                dev_err(tdev->dev,
  96                        "Message length %zd greater than max allowed %d\n",
  97                        count, MBOX_MAX_MSG_LEN);
  98                return -EINVAL;
  99        }
 100
 101        tdev->message = kzalloc(MBOX_MAX_MSG_LEN, GFP_KERNEL);
 102        if (!tdev->message)
 103                return -ENOMEM;
 104
 105        ret = copy_from_user(tdev->message, userbuf, count);
 106        if (ret) {
 107                ret = -EFAULT;
 108                goto out;
 109        }
 110
 111        /*
 112         * A separate signal is only of use if there is
 113         * MMIO to subsequently pass the message through
 114         */
 115        if (tdev->mmio && tdev->signal) {
 116                print_hex_dump(KERN_INFO, "Client: Sending: Signal: ", DUMP_PREFIX_ADDRESS,
 117                               MBOX_BYTES_PER_LINE, 1, tdev->signal, MBOX_MAX_SIG_LEN, true);
 118
 119                data = tdev->signal;
 120        } else
 121                data = tdev->message;
 122
 123        print_hex_dump(KERN_INFO, "Client: Sending: Message: ", DUMP_PREFIX_ADDRESS,
 124                       MBOX_BYTES_PER_LINE, 1, tdev->message, MBOX_MAX_MSG_LEN, true);
 125
 126        ret = mbox_send_message(tdev->tx_channel, data);
 127        if (ret < 0)
 128                dev_err(tdev->dev, "Failed to send message via mailbox\n");
 129
 130out:
 131        kfree(tdev->signal);
 132        kfree(tdev->message);
 133
 134        return ret < 0 ? ret : count;
 135}
 136
 137static ssize_t mbox_test_message_read(struct file *filp, char __user *userbuf,
 138                                      size_t count, loff_t *ppos)
 139{
 140        struct mbox_test_device *tdev = filp->private_data;
 141        unsigned long flags;
 142        char *touser, *ptr;
 143        int l = 0;
 144        int ret;
 145
 146        touser = kzalloc(MBOX_HEXDUMP_MAX_LEN + 1, GFP_KERNEL);
 147        if (!touser)
 148                return -ENOMEM;
 149
 150        if (!tdev->rx_channel) {
 151                ret = snprintf(touser, 20, "<NO RX CAPABILITY>\n");
 152                ret = simple_read_from_buffer(userbuf, count, ppos,
 153                                              touser, ret);
 154                goto out;
 155        }
 156
 157        if (tdev->rx_buffer[0] == '\0') {
 158                ret = snprintf(touser, 9, "<EMPTY>\n");
 159                ret = simple_read_from_buffer(userbuf, count, ppos,
 160                                              touser, ret);
 161                goto out;
 162        }
 163
 164        spin_lock_irqsave(&tdev->lock, flags);
 165
 166        ptr = tdev->rx_buffer;
 167        while (l < MBOX_HEXDUMP_MAX_LEN) {
 168                hex_dump_to_buffer(ptr,
 169                                   MBOX_BYTES_PER_LINE,
 170                                   MBOX_BYTES_PER_LINE, 1, touser + l,
 171                                   MBOX_HEXDUMP_LINE_LEN, true);
 172
 173                ptr += MBOX_BYTES_PER_LINE;
 174                l += MBOX_HEXDUMP_LINE_LEN;
 175                *(touser + (l - 1)) = '\n';
 176        }
 177        *(touser + l) = '\0';
 178
 179        memset(tdev->rx_buffer, 0, MBOX_MAX_MSG_LEN);
 180
 181        spin_unlock_irqrestore(&tdev->lock, flags);
 182
 183        ret = simple_read_from_buffer(userbuf, count, ppos, touser, MBOX_HEXDUMP_MAX_LEN);
 184out:
 185        kfree(touser);
 186        return ret;
 187}
 188
 189static const struct file_operations mbox_test_message_ops = {
 190        .write  = mbox_test_message_write,
 191        .read   = mbox_test_message_read,
 192        .open   = simple_open,
 193        .llseek = generic_file_llseek,
 194};
 195
 196static int mbox_test_add_debugfs(struct platform_device *pdev,
 197                                 struct mbox_test_device *tdev)
 198{
 199        if (!debugfs_initialized())
 200                return 0;
 201
 202        root_debugfs_dir = debugfs_create_dir("mailbox", NULL);
 203        if (!root_debugfs_dir) {
 204                dev_err(&pdev->dev, "Failed to create Mailbox debugfs\n");
 205                return -EINVAL;
 206        }
 207
 208        debugfs_create_file("message", 0600, root_debugfs_dir,
 209                            tdev, &mbox_test_message_ops);
 210
 211        debugfs_create_file("signal", 0200, root_debugfs_dir,
 212                            tdev, &mbox_test_signal_ops);
 213
 214        return 0;
 215}
 216
 217static void mbox_test_receive_message(struct mbox_client *client, void *message)
 218{
 219        struct mbox_test_device *tdev = dev_get_drvdata(client->dev);
 220        unsigned long flags;
 221
 222        spin_lock_irqsave(&tdev->lock, flags);
 223        if (tdev->mmio) {
 224                memcpy_fromio(tdev->rx_buffer, tdev->mmio, MBOX_MAX_MSG_LEN);
 225                print_hex_dump(KERN_INFO, "Client: Received [MMIO]: ",
 226                               DUMP_PREFIX_ADDRESS, MBOX_BYTES_PER_LINE, 1,
 227                               tdev->rx_buffer, MBOX_MAX_MSG_LEN, true);
 228        } else if (message) {
 229                print_hex_dump(KERN_INFO, "Client: Received [API]: ",
 230                               DUMP_PREFIX_ADDRESS, MBOX_BYTES_PER_LINE, 1,
 231                               message, MBOX_MAX_MSG_LEN, true);
 232                memcpy(tdev->rx_buffer, message, MBOX_MAX_MSG_LEN);
 233        }
 234        spin_unlock_irqrestore(&tdev->lock, flags);
 235}
 236
 237static void mbox_test_prepare_message(struct mbox_client *client, void *message)
 238{
 239        struct mbox_test_device *tdev = dev_get_drvdata(client->dev);
 240
 241        if (tdev->mmio) {
 242                if (tdev->signal)
 243                        memcpy_toio(tdev->mmio, tdev->message, MBOX_MAX_MSG_LEN);
 244                else
 245                        memcpy_toio(tdev->mmio, message, MBOX_MAX_MSG_LEN);
 246        }
 247}
 248
 249static void mbox_test_message_sent(struct mbox_client *client,
 250                                   void *message, int r)
 251{
 252        if (r)
 253                dev_warn(client->dev,
 254                         "Client: Message could not be sent: %d\n", r);
 255        else
 256                dev_info(client->dev,
 257                         "Client: Message sent\n");
 258}
 259
 260static struct mbox_chan *
 261mbox_test_request_channel(struct platform_device *pdev, const char *name)
 262{
 263        struct mbox_client *client;
 264        struct mbox_chan *channel;
 265
 266        client = devm_kzalloc(&pdev->dev, sizeof(*client), GFP_KERNEL);
 267        if (!client)
 268                return ERR_PTR(-ENOMEM);
 269
 270        client->dev             = &pdev->dev;
 271        client->rx_callback     = mbox_test_receive_message;
 272        client->tx_prepare      = mbox_test_prepare_message;
 273        client->tx_done         = mbox_test_message_sent;
 274        client->tx_block        = true;
 275        client->knows_txdone    = false;
 276        client->tx_tout         = 500;
 277
 278        channel = mbox_request_channel_byname(client, name);
 279        if (IS_ERR(channel)) {
 280                dev_warn(&pdev->dev, "Failed to request %s channel\n", name);
 281                return NULL;
 282        }
 283
 284        return channel;
 285}
 286
 287static int mbox_test_probe(struct platform_device *pdev)
 288{
 289        struct mbox_test_device *tdev;
 290        struct resource *res;
 291        int ret;
 292
 293        tdev = devm_kzalloc(&pdev->dev, sizeof(*tdev), GFP_KERNEL);
 294        if (!tdev)
 295                return -ENOMEM;
 296
 297        /* It's okay for MMIO to be NULL */
 298        res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 299        tdev->mmio = devm_ioremap_resource(&pdev->dev, res);
 300        if (IS_ERR(tdev->mmio))
 301                tdev->mmio = NULL;
 302
 303        tdev->tx_channel = mbox_test_request_channel(pdev, "tx");
 304        tdev->rx_channel = mbox_test_request_channel(pdev, "rx");
 305
 306        if (!tdev->tx_channel && !tdev->rx_channel)
 307                return -EPROBE_DEFER;
 308
 309        tdev->dev = &pdev->dev;
 310        platform_set_drvdata(pdev, tdev);
 311
 312        spin_lock_init(&tdev->lock);
 313
 314        if (tdev->rx_channel) {
 315                tdev->rx_buffer = devm_kzalloc(&pdev->dev,
 316                                               MBOX_MAX_MSG_LEN, GFP_KERNEL);
 317                if (!tdev->rx_buffer)
 318                        return -ENOMEM;
 319        }
 320
 321        ret = mbox_test_add_debugfs(pdev, tdev);
 322        if (ret)
 323                return ret;
 324
 325        dev_info(&pdev->dev, "Successfully registered\n");
 326
 327        return 0;
 328}
 329
 330static int mbox_test_remove(struct platform_device *pdev)
 331{
 332        struct mbox_test_device *tdev = platform_get_drvdata(pdev);
 333
 334        debugfs_remove_recursive(root_debugfs_dir);
 335
 336        if (tdev->tx_channel)
 337                mbox_free_channel(tdev->tx_channel);
 338        if (tdev->rx_channel)
 339                mbox_free_channel(tdev->rx_channel);
 340
 341        return 0;
 342}
 343
 344static const struct of_device_id mbox_test_match[] = {
 345        { .compatible = "mailbox_test" },
 346        {},
 347};
 348
 349static struct platform_driver mbox_test_driver = {
 350        .driver = {
 351                .name = "mailbox_sti_test",
 352                .of_match_table = mbox_test_match,
 353        },
 354        .probe  = mbox_test_probe,
 355        .remove = mbox_test_remove,
 356};
 357module_platform_driver(mbox_test_driver);
 358
 359MODULE_DESCRIPTION("Generic Mailbox Testing Facility");
 360MODULE_AUTHOR("Lee Jones <lee.jones@linaro.org");
 361MODULE_LICENSE("GPL v2");
 362