Blame attrib/att.h

Packit 34410b
/*
Packit 34410b
 *
Packit 34410b
 *  BlueZ - Bluetooth protocol stack for Linux
Packit 34410b
 *
Packit 34410b
 *  Copyright (C) 2010  Nokia Corporation
Packit 34410b
 *  Copyright (C) 2010  Marcel Holtmann <marcel@holtmann.org>
Packit 34410b
 *
Packit 34410b
 *
Packit 34410b
 *  This program is free software; you can redistribute it and/or modify
Packit 34410b
 *  it under the terms of the GNU General Public License as published by
Packit 34410b
 *  the Free Software Foundation; either version 2 of the License, or
Packit 34410b
 *  (at your option) any later version.
Packit 34410b
 *
Packit 34410b
 *  This program is distributed in the hope that it will be useful,
Packit 34410b
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 34410b
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit 34410b
 *  GNU General Public License for more details.
Packit 34410b
 *
Packit 34410b
 *  You should have received a copy of the GNU General Public License
Packit 34410b
 *  along with this program; if not, write to the Free Software
Packit 34410b
 *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
Packit 34410b
 *
Packit 34410b
 */
Packit 34410b
Packit 34410b
#include "src/shared/crypto.h"
Packit 34410b
Packit 34410b
/* Len of signature in write signed packet */
Packit 34410b
#define ATT_SIGNATURE_LEN		12
Packit 34410b
Packit 34410b
/* Attribute Protocol Opcodes */
Packit 34410b
#define ATT_OP_ERROR			0x01
Packit 34410b
#define ATT_OP_MTU_REQ			0x02
Packit 34410b
#define ATT_OP_MTU_RESP			0x03
Packit 34410b
#define ATT_OP_FIND_INFO_REQ		0x04
Packit 34410b
#define ATT_OP_FIND_INFO_RESP		0x05
Packit 34410b
#define ATT_OP_FIND_BY_TYPE_REQ		0x06
Packit 34410b
#define ATT_OP_FIND_BY_TYPE_RESP	0x07
Packit 34410b
#define ATT_OP_READ_BY_TYPE_REQ		0x08
Packit 34410b
#define ATT_OP_READ_BY_TYPE_RESP	0x09
Packit 34410b
#define ATT_OP_READ_REQ			0x0A
Packit 34410b
#define ATT_OP_READ_RESP		0x0B
Packit 34410b
#define ATT_OP_READ_BLOB_REQ		0x0C
Packit 34410b
#define ATT_OP_READ_BLOB_RESP		0x0D
Packit 34410b
#define ATT_OP_READ_MULTI_REQ		0x0E
Packit 34410b
#define ATT_OP_READ_MULTI_RESP		0x0F
Packit 34410b
#define ATT_OP_READ_BY_GROUP_REQ	0x10
Packit 34410b
#define ATT_OP_READ_BY_GROUP_RESP	0x11
Packit 34410b
#define ATT_OP_WRITE_REQ		0x12
Packit 34410b
#define ATT_OP_WRITE_RESP		0x13
Packit 34410b
#define ATT_OP_WRITE_CMD		0x52
Packit 34410b
#define ATT_OP_PREP_WRITE_REQ		0x16
Packit 34410b
#define ATT_OP_PREP_WRITE_RESP		0x17
Packit 34410b
#define ATT_OP_EXEC_WRITE_REQ		0x18
Packit 34410b
#define ATT_OP_EXEC_WRITE_RESP		0x19
Packit 34410b
#define ATT_OP_HANDLE_NOTIFY		0x1B
Packit 34410b
#define ATT_OP_HANDLE_IND		0x1D
Packit 34410b
#define ATT_OP_HANDLE_CNF		0x1E
Packit 34410b
#define ATT_OP_SIGNED_WRITE_CMD		0xD2
Packit 34410b
Packit 34410b
/* Error codes for Error response PDU */
Packit 34410b
#define ATT_ECODE_INVALID_HANDLE		0x01
Packit 34410b
#define ATT_ECODE_READ_NOT_PERM			0x02
Packit 34410b
#define ATT_ECODE_WRITE_NOT_PERM		0x03
Packit 34410b
#define ATT_ECODE_INVALID_PDU			0x04
Packit 34410b
#define ATT_ECODE_AUTHENTICATION		0x05
Packit 34410b
#define ATT_ECODE_REQ_NOT_SUPP			0x06
Packit 34410b
#define ATT_ECODE_INVALID_OFFSET		0x07
Packit 34410b
#define ATT_ECODE_AUTHORIZATION			0x08
Packit 34410b
#define ATT_ECODE_PREP_QUEUE_FULL		0x09
Packit 34410b
#define ATT_ECODE_ATTR_NOT_FOUND		0x0A
Packit 34410b
#define ATT_ECODE_ATTR_NOT_LONG			0x0B
Packit 34410b
#define ATT_ECODE_INSUFF_ENCR_KEY_SIZE		0x0C
Packit 34410b
#define ATT_ECODE_INVAL_ATTR_VALUE_LEN		0x0D
Packit 34410b
#define ATT_ECODE_UNLIKELY			0x0E
Packit 34410b
#define ATT_ECODE_INSUFF_ENC			0x0F
Packit 34410b
#define ATT_ECODE_UNSUPP_GRP_TYPE		0x10
Packit 34410b
#define ATT_ECODE_INSUFF_RESOURCES		0x11
Packit 34410b
/* Application error */
Packit 34410b
#define ATT_ECODE_IO				0x80
Packit 34410b
#define ATT_ECODE_TIMEOUT			0x81
Packit 34410b
#define ATT_ECODE_ABORTED			0x82
Packit 34410b
Packit 34410b
#define ATT_MAX_VALUE_LEN			512
Packit 34410b
#define ATT_DEFAULT_L2CAP_MTU			48
Packit 34410b
#define ATT_DEFAULT_LE_MTU			23
Packit 34410b
Packit 34410b
#define ATT_CID					4
Packit 34410b
#define ATT_PSM					31
Packit 34410b
Packit 34410b
/* Flags for Execute Write Request Operation */
Packit 34410b
#define ATT_CANCEL_ALL_PREP_WRITES		0x00
Packit 34410b
#define ATT_WRITE_ALL_PREP_WRITES		0x01
Packit 34410b
Packit 34410b
/* Find Information Response Formats */
Packit 34410b
#define ATT_FIND_INFO_RESP_FMT_16BIT		0x01
Packit 34410b
#define ATT_FIND_INFO_RESP_FMT_128BIT		0x02
Packit 34410b
Packit 34410b
struct att_data_list {
Packit 34410b
	uint16_t num;
Packit 34410b
	uint16_t len;
Packit 34410b
	uint8_t **data;
Packit 34410b
};
Packit 34410b
Packit 34410b
struct att_range {
Packit 34410b
	uint16_t start;
Packit 34410b
	uint16_t end;
Packit 34410b
};
Packit 34410b
Packit 34410b
struct att_data_list *att_data_list_alloc(uint16_t num, uint16_t len);
Packit 34410b
void att_data_list_free(struct att_data_list *list);
Packit 34410b
Packit 34410b
const char *att_ecode2str(uint8_t status);
Packit 34410b
uint16_t enc_read_by_grp_req(uint16_t start, uint16_t end, bt_uuid_t *uuid,
Packit 34410b
						uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_read_by_grp_req(const uint8_t *pdu, size_t len, uint16_t *start,
Packit 34410b
					uint16_t *end, bt_uuid_t *uuid);
Packit 34410b
uint16_t enc_read_by_grp_resp(struct att_data_list *list, uint8_t *pdu,
Packit 34410b
								size_t len);
Packit 34410b
uint16_t enc_find_by_type_req(uint16_t start, uint16_t end, bt_uuid_t *uuid,
Packit 34410b
				const uint8_t *value, size_t vlen, uint8_t *pdu,
Packit 34410b
				size_t len);
Packit 34410b
uint16_t dec_find_by_type_req(const uint8_t *pdu, size_t len, uint16_t *start,
Packit 34410b
		uint16_t *end, bt_uuid_t *uuid, uint8_t *value, size_t *vlen);
Packit 34410b
uint16_t enc_find_by_type_resp(GSList *ranges, uint8_t *pdu, size_t len);
Packit 34410b
GSList *dec_find_by_type_resp(const uint8_t *pdu, size_t len);
Packit 34410b
struct att_data_list *dec_read_by_grp_resp(const uint8_t *pdu, size_t len);
Packit 34410b
uint16_t enc_read_by_type_req(uint16_t start, uint16_t end, bt_uuid_t *uuid,
Packit 34410b
						uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_read_by_type_req(const uint8_t *pdu, size_t len, uint16_t *start,
Packit 34410b
					uint16_t *end, bt_uuid_t *uuid);
Packit 34410b
uint16_t enc_read_by_type_resp(struct att_data_list *list, uint8_t *pdu,
Packit 34410b
								size_t len);
Packit 34410b
uint16_t enc_write_cmd(uint16_t handle, const uint8_t *value, size_t vlen,
Packit 34410b
						uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_write_cmd(const uint8_t *pdu, size_t len, uint16_t *handle,
Packit 34410b
						uint8_t *value, size_t *vlen);
Packit 34410b
uint16_t enc_signed_write_cmd(uint16_t handle,
Packit 34410b
					const uint8_t *value, size_t vlen,
Packit 34410b
					struct bt_crypto *crypto,
Packit 34410b
					const uint8_t csrk[16],
Packit 34410b
					uint32_t sign_cnt,
Packit 34410b
					uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_signed_write_cmd(const uint8_t *pdu, size_t len,
Packit 34410b
						uint16_t *handle,
Packit 34410b
						uint8_t *value, size_t *vlen,
Packit 34410b
						uint8_t signature[12]);
Packit 34410b
struct att_data_list *dec_read_by_type_resp(const uint8_t *pdu, size_t len);
Packit 34410b
uint16_t enc_write_req(uint16_t handle, const uint8_t *value, size_t vlen,
Packit 34410b
						uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_write_req(const uint8_t *pdu, size_t len, uint16_t *handle,
Packit 34410b
						uint8_t *value, size_t *vlen);
Packit 34410b
uint16_t enc_write_resp(uint8_t *pdu);
Packit 34410b
uint16_t dec_write_resp(const uint8_t *pdu, size_t len);
Packit 34410b
uint16_t enc_read_req(uint16_t handle, uint8_t *pdu, size_t len);
Packit 34410b
uint16_t enc_read_blob_req(uint16_t handle, uint16_t offset, uint8_t *pdu,
Packit 34410b
								size_t len);
Packit 34410b
uint16_t dec_read_req(const uint8_t *pdu, size_t len, uint16_t *handle);
Packit 34410b
uint16_t dec_read_blob_req(const uint8_t *pdu, size_t len, uint16_t *handle,
Packit 34410b
							uint16_t *offset);
Packit 34410b
uint16_t enc_read_resp(uint8_t *value, size_t vlen, uint8_t *pdu, size_t len);
Packit 34410b
uint16_t enc_read_blob_resp(uint8_t *value, size_t vlen, uint16_t offset,
Packit 34410b
						uint8_t *pdu, size_t len);
Packit 34410b
ssize_t dec_read_resp(const uint8_t *pdu, size_t len, uint8_t *value,
Packit 34410b
								size_t vlen);
Packit 34410b
uint16_t enc_error_resp(uint8_t opcode, uint16_t handle, uint8_t status,
Packit 34410b
						uint8_t *pdu, size_t len);
Packit 34410b
uint16_t enc_find_info_req(uint16_t start, uint16_t end, uint8_t *pdu,
Packit 34410b
								size_t len);
Packit 34410b
uint16_t dec_find_info_req(const uint8_t *pdu, size_t len, uint16_t *start,
Packit 34410b
								uint16_t *end);
Packit 34410b
uint16_t enc_find_info_resp(uint8_t format, struct att_data_list *list,
Packit 34410b
						uint8_t *pdu, size_t len);
Packit 34410b
struct att_data_list *dec_find_info_resp(const uint8_t *pdu, size_t len,
Packit 34410b
							uint8_t *format);
Packit 34410b
uint16_t enc_notification(uint16_t handle, uint8_t *value, size_t vlen,
Packit 34410b
						uint8_t *pdu, size_t len);
Packit 34410b
uint16_t enc_indication(uint16_t handle, uint8_t *value, size_t vlen,
Packit 34410b
						uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_indication(const uint8_t *pdu, size_t len, uint16_t *handle,
Packit 34410b
						uint8_t *value, size_t vlen);
Packit 34410b
uint16_t enc_confirmation(uint8_t *pdu, size_t len);
Packit 34410b
Packit 34410b
uint16_t enc_mtu_req(uint16_t mtu, uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_mtu_req(const uint8_t *pdu, size_t len, uint16_t *mtu);
Packit 34410b
uint16_t enc_mtu_resp(uint16_t mtu, uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_mtu_resp(const uint8_t *pdu, size_t len, uint16_t *mtu);
Packit 34410b
Packit 34410b
uint16_t enc_prep_write_req(uint16_t handle, uint16_t offset,
Packit 34410b
					const uint8_t *value, size_t vlen,
Packit 34410b
					uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_prep_write_req(const uint8_t *pdu, size_t len, uint16_t *handle,
Packit 34410b
				uint16_t *offset, uint8_t *value, size_t *vlen);
Packit 34410b
uint16_t enc_prep_write_resp(uint16_t handle, uint16_t offset,
Packit 34410b
					const uint8_t *value, size_t vlen,
Packit 34410b
					uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_prep_write_resp(const uint8_t *pdu, size_t len, uint16_t *handle,
Packit 34410b
						uint16_t *offset, uint8_t *value,
Packit 34410b
						size_t *vlen);
Packit 34410b
uint16_t enc_exec_write_req(uint8_t flags, uint8_t *pdu, size_t len);
Packit 34410b
uint16_t dec_exec_write_req(const uint8_t *pdu, size_t len, uint8_t *flags);
Packit 34410b
uint16_t enc_exec_write_resp(uint8_t *pdu);
Packit 34410b
uint16_t dec_exec_write_resp(const uint8_t *pdu, size_t len);