92 lines
2.9 KiB
C
92 lines
2.9 KiB
C
/* Copyright (c) 2015, The Linux Foundation. All rights reserved.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License version 2 and
|
|
* only version 2 as published by the Free Software Foundation.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef _UAPI_SPCOM_H_
|
|
#define _UAPI_SPCOM_H_
|
|
|
|
#include <linux/types.h> /* uint32_t, bool */
|
|
#ifndef BIT
|
|
#define BIT(x) (1 << x)
|
|
#endif
|
|
|
|
/**
|
|
* @brief - Secure Processor Communication interface to user space spcomlib.
|
|
*
|
|
* Sending data and control commands by write() file operation.
|
|
* Receiving data by read() file operation.
|
|
* Getting the next request size by read() file operation,
|
|
* with special size SPCOM_GET_NEXT_REQUEST_SIZE.
|
|
*/
|
|
|
|
/* Maximum size (including null) for channel names */
|
|
#define SPCOM_CHANNEL_NAME_SIZE 32
|
|
|
|
/*
|
|
* file read(fd, buf, size) with this size,
|
|
* hints the kernel that user space wants to read the next-req-size.
|
|
* This size is bigger than both SPCOM_MAX_REQUEST_SIZE and
|
|
* SPCOM_MAX_RESPONSE_SIZE , so it is not a valid data size.
|
|
*/
|
|
#define SPCOM_GET_NEXT_REQUEST_SIZE (PAGE_SIZE-1)
|
|
|
|
/* Command Id between spcomlib and spcom driver, on write() */
|
|
enum spcom_cmd_id {
|
|
SPCOM_CMD_LOAD_APP = 0x4C4F4144, /* "LOAD" = 0x4C4F4144 */
|
|
SPCOM_CMD_RESET_SP = 0x52455354, /* "REST" = 0x52455354 */
|
|
SPCOM_CMD_SEND = 0x53454E44, /* "SEND" = 0x53454E44 */
|
|
SPCOM_CMD_FSSR = 0x46535352, /* "FSSR" = 0x46535352 */
|
|
SPCOM_CMD_CREATE_CHANNEL = 0x43524554, /* "CRET" = 0x43524554 */
|
|
};
|
|
|
|
/*
|
|
* @note: Event types that are always implicitly polled:
|
|
* POLLERR=0x08 | POLLHUP=0x10 | POLLNVAL=0x20
|
|
* so bits 3,4,5 can't be used
|
|
*/
|
|
enum spcom_poll_events {
|
|
SPCOM_POLL_LINK_STATE = BIT(1),
|
|
SPCOM_POLL_CH_CONNECT = BIT(2),
|
|
SPCOM_POLL_READY_FLAG = BIT(14), /* output */
|
|
SPCOM_POLL_WAIT_FLAG = BIT(15), /* if set , wait for the event */
|
|
};
|
|
|
|
/* Common Command structure between User Space and spcom driver, on write() */
|
|
struct spcom_user_command {
|
|
enum spcom_cmd_id cmd_id;
|
|
uint32_t arg;
|
|
} __packed;
|
|
|
|
/* Command structure between userspace spcomlib and spcom driver, on write() */
|
|
struct spcom_user_load_app_command {
|
|
enum spcom_cmd_id cmd_id;
|
|
char ch_name[SPCOM_CHANNEL_NAME_SIZE];
|
|
uint32_t app_image_size;
|
|
char *app_buf_ptr;
|
|
uint32_t app_buf_size;
|
|
} __packed;
|
|
|
|
/* Command structure between User Space and spcom driver, on write() */
|
|
struct spcom_send_command {
|
|
enum spcom_cmd_id cmd_id;
|
|
uint32_t timeout_msec;
|
|
uint32_t buf_size;
|
|
char buf[0]; /* Variable buffer size - must be last field */
|
|
} __packed;
|
|
|
|
/* Command structure between userspace spcomlib and spcom driver, on write() */
|
|
struct spcom_user_create_channel_command {
|
|
enum spcom_cmd_id cmd_id;
|
|
char ch_name[SPCOM_CHANNEL_NAME_SIZE];
|
|
} __packed;
|
|
|
|
#endif /* _UAPI_SPCOM_H_ */
|