LXR linux/include/uapi/linux/hsi/cs-protocol.h

   1/*
   2 * cmt-speech interface definitions
   3 *
   4 * Copyright (C) 2008,2009,2010 Nokia Corporation. All rights reserved.
   5 *
   6 * Contact: Kai Vehmanen <kai.vehmanen@nokia.com>
   7 * Original author: Peter Ujfalusi <peter.ujfalusi@nokia.com>
   8 *
   9 * This program is free software; you can redistribute it and/or
  10 * modify it under the terms of the GNU General Public License
  11 * version 2 as published by the Free Software Foundation.
  12 *
  13 * This program is distributed in the hope that it will be useful, but
  14 * WITHOUT ANY WARRANTY; without even the implied warranty of
  15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16 * General Public License for more details.
  17 *
  18 * You should have received a copy of the GNU General Public License
  19 * along with this program; if not, write to the Free Software
  20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
  21 * 02110-1301 USA
  22 */
  23
  24#ifndef _CS_PROTOCOL_H
  25#define _CS_PROTOCOL_H
  26
  27#include <linux/types.h>
  28#include <linux/ioctl.h>
  29
  30/* chardev parameters */
  31#define CS_DEV_FILE_NAME                "/dev/cmt_speech"
  32
  33/* user-space API versioning */
  34#define CS_IF_VERSION                   2
  35
  36/* APE kernel <-> user space messages */
  37#define CS_CMD_SHIFT                    28
  38#define CS_DOMAIN_SHIFT                 24
  39
  40#define CS_CMD_MASK                     0xff000000
  41#define CS_PARAM_MASK                   0xffffff
  42
  43#define CS_CMD(id, dom) \
  44        (((id) << CS_CMD_SHIFT) | ((dom) << CS_DOMAIN_SHIFT))
  45
  46#define CS_ERROR                        CS_CMD(1, 0)
  47#define CS_RX_DATA_RECEIVED             CS_CMD(2, 0)
  48#define CS_TX_DATA_READY                CS_CMD(3, 0)
  49#define CS_TX_DATA_SENT                 CS_CMD(4, 0)
  50
  51/* params to CS_ERROR indication */
  52#define CS_ERR_PEER_RESET               0
  53
  54/* ioctl interface */
  55
  56/* parameters to CS_CONFIG_BUFS ioctl */
  57#define CS_FEAT_TSTAMP_RX_CTRL          (1 << 0)
  58#define CS_FEAT_ROLLING_RX_COUNTER      (2 << 0)
  59
  60/* parameters to CS_GET_STATE ioctl */
  61#define CS_STATE_CLOSED                 0
  62#define CS_STATE_OPENED                 1 /* resource allocated */
  63#define CS_STATE_CONFIGURED             2 /* data path active */
  64
  65/* maximum number of TX/RX buffers */
  66#define CS_MAX_BUFFERS_SHIFT            4
  67#define CS_MAX_BUFFERS                  (1 << CS_MAX_BUFFERS_SHIFT)
  68
  69/* Parameters for setting up the data buffers */
  70struct cs_buffer_config {
  71        __u32 rx_bufs;  /* number of RX buffer slots */
  72        __u32 tx_bufs;  /* number of TX buffer slots */
  73        __u32 buf_size; /* bytes */
  74        __u32 flags;    /* see CS_FEAT_* */
  75        __u32 reserved[4];
  76};
  77
  78/*
  79 * struct for monotonic timestamp taken when the
  80 * last control command was received
  81 */
  82struct cs_timestamp {
  83        __u32 tv_sec;  /* seconds */
  84        __u32 tv_nsec; /* nanoseconds */
  85};
  86
  87/*
  88 * Struct describing the layout and contents of the driver mmap area.
  89 * This information is meant as read-only information for the application.
  90 */
  91struct cs_mmap_config_block {
  92        __u32 reserved1;
  93        __u32 buf_size;         /* 0=disabled, otherwise the transfer size */
  94        __u32 rx_bufs;          /* # of RX buffers */
  95        __u32 tx_bufs;          /* # of TX buffers */
  96        __u32 reserved2;
  97        /* array of offsets within the mmap area for each RX and TX buffer */
  98        __u32 rx_offsets[CS_MAX_BUFFERS];
  99        __u32 tx_offsets[CS_MAX_BUFFERS];
 100        __u32 rx_ptr;
 101        __u32 rx_ptr_boundary;
 102        __u32 reserved3[2];
 103        /* enabled with CS_FEAT_TSTAMP_RX_CTRL */
 104        struct cs_timestamp tstamp_rx_ctrl;
 105};
 106
 107#define CS_IO_MAGIC             'C'
 108
 109#define CS_IOW(num, dtype)      _IOW(CS_IO_MAGIC, num, dtype)
 110#define CS_IOR(num, dtype)      _IOR(CS_IO_MAGIC, num, dtype)
 111#define CS_IOWR(num, dtype)     _IOWR(CS_IO_MAGIC, num, dtype)
 112#define CS_IO(num)              _IO(CS_IO_MAGIC, num)
 113
 114#define CS_GET_STATE            CS_IOR(21, unsigned int)
 115#define CS_SET_WAKELINE         CS_IOW(23, unsigned int)
 116#define CS_GET_IF_VERSION       CS_IOR(30, unsigned int)
 117#define CS_CONFIG_BUFS          CS_IOW(31, struct cs_buffer_config)
 118
 119#endif /* _CS_PROTOCOL_H */
 120