You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
113 lines
3.7 KiB
113 lines
3.7 KiB
/* Copyright (c) 2015-2016, 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 _SPCOM_H_ |
|
#define _SPCOM_H_ |
|
|
|
#include <linux/types.h> /* uint32_t, bool */ |
|
#ifndef BIT |
|
#define BIT(x) (1 << x) |
|
#endif |
|
#ifndef PAGE_SIZE |
|
#define PAGE_SIZE 4096 |
|
#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_SEND_MODIFIED = 0x534E444D, /* "SNDM" = 0x534E444D */ |
|
SPCOM_CMD_LOCK_ION_BUF = 0x4C4F434B, /* "LOCK" = 0x4C4F434B */ |
|
SPCOM_CMD_UNLOCK_ION_BUF = 0x554C434B, /* "ULCK" = 0x4C4F434B */ |
|
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; |
|
} __attribute__((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 */ |
|
} __attribute__((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]; |
|
} __attribute__((packed)); |
|
|
|
/* maximum ION buf for send-modfied-command */ |
|
#define SPCOM_MAX_ION_BUF 4 |
|
|
|
struct spcom_ion_info { |
|
int32_t fd; /* ION buffer File Descriptor, set -1 for invalid fd */ |
|
uint32_t buf_offset; /* virtual address offset in request/response */ |
|
}; |
|
|
|
/* Pass this FD to unlock all ION buffer for the specific channel */ |
|
#define SPCOM_ION_FD_UNLOCK_ALL 0xFFFF |
|
|
|
struct spcom_ion_handle { |
|
int32_t fd; /* File Descriptor associated with the buffer */ |
|
}; |
|
|
|
/* Command structure between User Space and spcom driver, on write() */ |
|
struct spcom_user_send_modified_command { |
|
enum spcom_cmd_id cmd_id; |
|
struct spcom_ion_info ion_info[SPCOM_MAX_ION_BUF]; |
|
uint32_t timeout_msec; |
|
uint32_t buf_size; |
|
char buf[0]; /* Variable buffer size - must be last field */ |
|
} __attribute__((packed)); |
|
|
|
|
|
#endif /* _SPCOM_H_ */
|
|
|