BlueNRG-MS pack for STM32CubeMX: GATT functions

Send an Execute Write Request.

Note

The Execute Write Request is used to request the server to write or cancel the write of all the prepared values currently held in the prepare queue from this client. The result of the procedure is given through the EVT_BLUE_ATT_EXEC_WRITE_RESP event. The end of the procedure is indicated by a EVT_BLUE_GATT_PROCEDURE_COMPLETE event.

Parameters

conn_handle	Connection handle for which the command is given.
execute	0x00 – Cancel all prepared writes 0x01 – Immediately write all pending prepared values.

Returns

Value indicating success or error code.

Send a Find By Type Value Request.

Note

The Find By Type Value Request is used to obtain the handles of attributes that have a given 16-bit UUID attribute type and a given attribute value. The responses of the procedure are given through the EVT_BLUE_ATT_FIND_BY_TYPE_VAL_RESP event. The end of the procedure is indicated by a EVT_BLUE_GATT_PROCEDURE_COMPLETE event.

Parameters

conn_handle	Connection handle for which the command is given.
start_handle	First requested handle number
end_handle	Last requested handle number
uuid	2 octet UUID to find (little-endian)
attr_val_len	Length of attribute value (maximum value is ATT_MTU - 7).
attr_val	Attribute value to find

Returns

Value indicating success or error code.

Send a Find Information Request.

Note

This command is used to obtain the mapping of attribute handles with their associated types. The responses of the procedure are given through the EVT_BLUE_ATT_FIND_INFORMATION_RESP event. The end of the procedure is indicated by a EVT_BLUE_GATT_PROCEDURE_COMPLETE event.

Parameters

conn_handle	Connection handle for which the command is given
start_handle	Starting handle of the range of attributes to be discovered on the server
end_handle	Ending handle of the range of attributes to be discovered on the server

Returns

Value indicating success or error code.

Send a Prepare Write Request.

Note

The Prepare Write Request is used to request the server to prepare to write the value of an attribute. The responses of the procedure are given through the EVT_BLUE_ATT_PREPARE_WRITE_RESP event. The end of the procedure is indicated by a EVT_BLUE_GATT_PROCEDURE_COMPLETE.

Parameters

conn_handle	Connection handle for which the command is given.
attr_handle	The handle of the attribute to be written
value_offset	The offset of the first octet to be written
attr_val_len	Length of attribute value (maximum value is ATT_MTU - 5).
attr_val	The value of the attribute to be written

Returns

Value indicating success or error code.

Send a Read By Group Type Request.

Note

The Read By Group Type Request is used to obtain the values of grouping attributes where the attribute type is known but the handle is not known. Grouping attributes are defined at GATT layer. The grouping attribute types are: «Primary Service», «Secondary Service» and «Characteristic». The responses of the procedure are given through the EVT_BLUE_ATT_READ_BY_GROUP_TYPE_RESP event. The end of the procedure is indicated by a EVT_BLUE_GATT_PROCEDURE_COMPLETE.

Parameters

conn_handle	Connection handle for which the command is given.
start_handle	First requested handle number
end_handle	Last requested handle number
uuid_type	UUID_TYPE_16 UUID_TYPE_128
uuid	2 or 16 octet UUID

Returns

Value indicating success or error code.

Send a Read By Type Request.

Note

The Read By Type Request is used to obtain the values of attributes where the attribute type is known but the handle is not known. The responses of the procedure are given through the EVT_BLUE_ATT_READ_BY_TYPE_RESP event. The end of the procedure is indicated by a EVT_BLUE_GATT_PROCEDURE_COMPLETE event.

Parameters

conn_handle	Connection handle for which the command is given.
start_handle	First requested handle number
end_handle	Last requested handle number
uuid_type	UUID_TYPE_16 UUID_TYPE_128
uuid	2 or 16 octet UUID

Returns

Value indicating success or error code.

Add a characteristic to a service.

Parameters

serviceHandle	Handle of the service to which the characteristic has to be added.
charUuidType	Type of characteristic UUID (16-bit or 128-bit). See UUID Types. UUID_TYPE_16 UUID_TYPE_128
charUuid	16-bit or 128-bit UUID.
charValueLen	Maximum length of the characteristic value.
charProperties	Bitwise OR values of Characteristic Properties (defined in Volume 3, Section 3.3.3.1 of Bluetooth Specification 4.0). See Characteristic properties.
secPermissions	Security permissions for the added characteristic. See Security permissions. ATTR_PERMISSION_NONE ATTR_PERMISSION_AUTHEN_READ ATTR_PERMISSION_AUTHOR_READ ATTR_PERMISSION_ENCRY_READ ATTR_PERMISSION_AUTHEN_WRITE ATTR_PERMISSION_AUTHOR_WRITE ATTR_PERMISSION_ENCRY_WRITE
gattEvtMask	Bit mask that enables events that will be sent to the application by the GATT server on certain ATT requests. See Gatt Event Mask. GATT_DONT_NOTIFY_EVENTS GATT_NOTIFY_ATTRIBUTE_WRITE GATT_NOTIFY_WRITE_REQ_AND_WAIT_FOR_APPL_RESP GATT_NOTIFY_READ_REQ_AND_WAIT_FOR_APPL_RESP
encryKeySize	The minimum encryption key size requirement for this attribute. Valid Range: 7 to 16.
isVariable	If the attribute has a variable length value field (1) or not (0).
charHandle	Handle of the Characteristic that has been added. It is the handle of the characteristic declaration. The attribute that holds the characteristic value is allocated at the next handle, followed by the Client Characteristic Configuration descriptor if the characteristic has CHAR_PROP_NOTIFY or CHAR_PROP_INDICATE properties.

Returns

Value indicating success or error code.

Add a characteristic descriptor to a service.

Parameters

	serviceHandle	Handle of the service to which the characteristic belongs
	charHandle	Handle of the characteristic to which description has to be added.
	descUuidType	16-bit or 128-bit UUID. See UUID Types. UUID_TYPE_16 UUID_TYPE_128
[in]	uuid	UUID of the Characteristic descriptor. It can be one of the UUID assigned by Bluetooth SIG (Well_known_UUIDs) or a user-defined one.
	descValueMaxLen	The maximum length of the descriptor value
	descValueLen	Current Length of the characteristic descriptor value
[in]	descValue	Value of the characteristic description
	secPermissions	Security permissions for the added descriptor. See Security permissions. ATTR_PERMISSION_NONE ATTR_PERMISSION_AUTHEN_READ ATTR_PERMISSION_AUTHOR_READ ATTR_PERMISSION_ENCRY_READ ATTR_PERMISSION_AUTHEN_WRITE ATTR_PERMISSION_AUTHOR_WRITE ATTR_PERMISSION_ENCRY_WRITE
	accPermissions	Access permissions for the added descriptor. See Access permissions. ATTR_NO_ACCESS ATTR_ACCESS_READ_ONLY ATTR_ACCESS_WRITE_REQ_ONLY ATTR_ACCESS_READ_WRITE ATTR_ACCESS_WRITE_WITHOUT_RESPONSE ATTR_ACCESS_SIGNED_WRITE_ALLOWED
	gattEvtMask	Bit mask that enables events that will be sent to the application by the GATT server on certain ATT requests. See Gatt Event Mask.
	encryKeySize	The minimum encryption key size requirement for this attribute. Valid Range: 7 to 16.
	isVariable	If the attribute has a variable length value field (1) or not (0).
[out]	descHandle	Handle of the Characteristic Descriptor.

Returns

Value indicating success or error code.

Add a service to the GATT Server. When a service is created in the server, the Host needs to reserve the handle ranges for this service using max_attr_records parameter. This parameter specifies the maximum number of attribute records that can be added to this service (including the service attribute, include attribute, characteristic attribute, characteristic value attribute and characteristic descriptor attribute). Handle of the created service is returned.

Note

Service declaration is taken from the service pool. The attributes for characteristics and descriptors are allocated from the attribute pool.

Parameters

	service_uuid_type	Type of service UUID (16-bit or 128-bit). See UUID Types.
[in]	service_uuid	16-bit or 128-bit UUID based on the UUID Type field
	service_type	Primary or secondary service. See Service Type.
	max_attr_records	Maximum number of attribute records that can be added to this service (including the service declaration itself)
[out]	serviceHandle	Handle of the Service. When this service is added to the service, a handle is allocated by the server to this service. Server also allocates a range of handles for this service from serviceHandle to <serviceHandle + max_attr_records>.

Returns

Value indicating success or error code.

Allow the GATT server to send a response to a read request from a client.

Note

The application has to send this command when it receives the EVT_BLUE_GATT_READ_PERMIT_REQ or EVT_BLUE_GATT_READ_MULTI_PERMIT_REQ. This command indicates to the stack that the response can be sent to the client. So if the application wishes to update any of the attributes before they are read by the client, it has to update the characteristic values using the aci_gatt_update_char_value and then give this command. The application should perform the required operations within 30 seconds, otherwise the GATT procedure will go to timeout.

Parameters

conn_handle

Connection handle for which the command is given.

Returns

Value indicating success or error code.

Confirm an indication.

Note

This command has to be sent when the application receives the event EVT_BLUE_GATT_INDICATION.

Parameters

conn_handle

Connection handle for which the command is given.

Returns

Value indicating success or error code.

Delete the specified characteristic from the service.

Parameters

servHandle	Handle of the service to which characteristic belongs
charHandle	Handle of the characteristic to be deleted

Returns

Value indicating success or error code.

Delete the Include definition from the service.

Parameters

servHandle	Handle of the service to which Include definition belongs
includeServHandle	Handle of the Included definition to be deleted

Returns

Value indicating success or error code.

Delete the specified service from the GATT server database.

Parameters

servHandle

Handle of the service to be deleted

Returns

Value indicating success or error code.

Start the procedure to discover all characteristic descriptors on the server.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. Before procedure completion the response packets are given through EVT_BLUE_ATT_FIND_INFORMATION_RESP event.

Parameters

conn_handle	Connection handle for which the command is given.
char_val_handle	Starting handle of the characteristic
char_end_handle	End handle of the characteristic

Returns

Value indicating success or error code.

Start the procedure to discover all the characteristics of a given service.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. Before procedure completion the response packets are given through EVT_BLUE_ATT_READ_BY_TYPE_RESP event.

Parameters

conn_handle	Connection handle for which the command is given
start_attr_handle	Start attribute handle of the service
end_attr_handle	End attribute handle of the service

Returns

Value indicating success or error code.

This command will start the GATT client procedure to discover all primary services on the server.

Note

The responses of the procedure are given through the EVT_BLUE_ATT_READ_BY_GROUP_TYPE_RESP event. The end of the procedure is indicated by a EVT_BLUE_GATT_PROCEDURE_COMPLETE event.

Parameters

conn_handle

Connection handle for which the command is given.

Returns

Value indicating success or error code.

Start the procedure to discover all the characteristics specified by a UUID.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. Before procedure completion the response packets are given through EVT_BLUE_GATT_DISC_READ_CHAR_BY_UUID_RESP event.

Parameters

conn_handle	Connection handle for which the command is given
start_handle	Start attribute handle of the service
end_handle	End attribute handle of the service
uuid_type	UUID_TYPE_16 UUID_TYPE_128
uuid	2 or 16 octet UUID

Returns

Value indicating success or error code.

Start the procedure to discover the primary services of the specified UUID on the server.

Note

The responses of the procedure are given through the EVT_BLUE_ATT_FIND_BY_TYPE_VAL_RESP event. The end of the procedure is indicated by a EVT_BLUE_GATT_PROCEDURE_COMPLETE event.

Parameters

conn_handle	Connection handle for which the command is given.
uuid_type	UUID_TYPE_16 UUID_TYPE_128
uuid	2 or 16 octet UUID

Returns

Value indicating success or error code.

Perform an ATT MTU exchange procedure.

Note

When the ATT MTU exchange procedure is completed, a EVT_BLUE_ATT_EXCHANGE_MTU_RESP event is generated. A EVT_BLUE_GATT_PROCEDURE_COMPLETE event is also generated to indicate the end of the procedure.

Parameters

conn_handle

Connection handle for which the command is given.

Returns

Value indicating success or error code.

Start the procedure to find all included services.

Note

The responses of the procedure are given through the EVT_BLUE_ATT_READ_BY_TYPE_RESP event. The end of the procedure is indicated by a EVT_BLUE_GATT_PROCEDURE_COMPLETE event.

Parameters

conn_handle	Connection handle for which the command is given.
start_handle	Start handle of the service
end_handle	End handle of the service

Returns

Value indicating success or error code.

Include a service given by included_start_handle and included_end_handle to another service given by service_handle. Attribute server creates an INCLUDE definition attribute and return the handle of this attribute in included_handle.

Parameters

	service_handle	Handle of the service to which another service has to be included
	included_start_handle	Start Handle of the service which has to be included in service
	included_end_handle	End Handle of the service which has to be included in service
	included_uuid_type	Type of UUID for included service (16-bit or 128-bit). See Well-Known UUIDs.
[in]	included_uuid	16-bit or 128-bit UUID.
[out]	included_handle	Handle of the include declaration.

Returns

Value indicating success or error code.

Initialize the GATT layer for server and client roles.

Note

It adds also the GATT service with Service Changed Characteristic. Until this command is issued the GATT channel will not process any commands even if the connection is opened. This command has to be given before using any of the GAP features.

Returns

Value indicating success or error code.

Start the procedure to read the descriptor specified.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. Before procedure completion the response packet is given through EVT_BLUE_ATT_READ_RESP event.

Parameters

conn_handle	Connection handle for which the command is given
attr_handle	Handle of the descriptor to be read

Returns

Value indicating success or error code.

Start the procedure to read the attribute value.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. Before procedure completion the response packet is given through EVT_BLUE_ATT_READ_RESP event.

Parameters

conn_handle	Connection handle for which the command is given
attr_handle	Handle of the characteristic to be read

Returns

Value indicating success or error code.
It can be BLE_STATUS_NOT_ALLOWED in the following cases:

• If the exchange has already taken place
  
• If GATT is expecting response for previous request
  
• Already a request is in the queue to be sent
  
• Channel not open
  
• Already one GATT procedure is started

Reads the value of the attribute handle specified from the local GATT database.

Parameters

	attr_handle	Handle of the attribute to read
	data_len	Length of the data buffer.
[out]	data_len_out_p	Length of the read attribute.
[out]	data	Pointer to the buffer that will contain the read value. The buffer will be filled with the attribute value. The length will be the minimum between the provided data_len and the actual length of the attribute (in data_len_out_p).

Returns

Value indicating success or error code.

Reads the value of the attribute handle specified from the local GATT database, starting from a given offset.

Parameters

	attr_handle	Handle of the attribute to read
	offset	Offset from which the value needs to be read
	data_len	Length of the data buffer.
[out]	data_len_out_p	Length of the read attribute.
[out]	data	Pointer to the buffer that will contain the read value. The buffer will be filled with the attribute value. The length will be the minimum between the provided data_len and the actual length of the attribute (in data_len_out_p).

Returns

Value indicating success or error code.

Start the procedure to read a long characteristic value.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. Before procedure completion the response packets are given through EVT_BLUE_ATT_READ_BLOB_RESP event.

Parameters

conn_handle	Connection handle for which the command is given
attr_handle	Handle of the characteristic descriptor
val_offset	Offset from which the value needs to be read

Returns

Value indicating success or error code.

Start the procedure to read a long characteristic value.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. Before procedure completion the response packets are given through EVT_BLUE_ATT_READ_BLOB_RESP event.

Parameters

conn_handle	Connection handle for which the command is given
attr_handle	Handle of the characteristic to be read
val_offset	Offset from which the value needs to be read

Returns

Value indicating success or error code.
It can be BLE_STATUS_NOT_ALLOWED in the following cases:

• If the exchange has already taken place
  
• If GATT is expecting response for previous request
  
• Already a request is in the queue to be sent
  
• Channel not open
  
• Already one GATT procedure is started

Start a procedure to read multiple characteristic values from a server.

Note

This sub-procedure is used to read multiple Characteristic Values from a server when the client knows the Characteristic Value Handles. When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. Before procedure completion the response packets are given through EVT_BLUE_ATT_READ_MULTIPLE_RESP event.

Parameters

conn_handle	Connection handle for which the command is given
num_handles	The number of handles for which the value has to be read
set_of_handles	The handles for which the attribute value has to be read

Returns

Value indicating success or error code.

Start the procedure to read all the characteristics specified by the UUID.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. Before procedure completion the response packets are given through EVT_BLUE_GATT_DISC_READ_CHAR_BY_UUID_RESP event.

Parameters

conn_handle	Connection handle for which the command is given
start_handle	Starting handle of the range to be searched
end_handle	End handle of the range to be searched
uuid_type	UUID_TYPE_16 UUID_TYPE_128
uuid	2 or 16 octet UUID

Returns

Value indicating success or error code.

This command sets the value of the descriptor specified by charDescHandle.

Parameters

	servHandle	Handle of the service which contains the descriptor.
	charHandle	Handle of the characteristic which contains the descriptor.
	charDescHandle	Handle of the descriptor whose value has to be set.
	charDescValOffset	Offset from which the descriptor value has to be updated.
	charDescValueLen	Length of the descriptor value
[in]	charDescValue	descriptor value

Returns

Value indicating success or error code.

Set the security permission for the attribute handle specified.

Note

Currently the setting of security permission is allowed only for client configuration descriptor.

Parameters

service_handle	Handle of the service which contains the attribute whose security permission has to be modified.
attr_handle	Handle of the attribute whose security permission has to be modified.
security_permission	Security permissions for the descriptor. See Security permissions. ATTR_PERMISSION_NONE ATTR_PERMISSION_AUTHEN_READ ATTR_PERMISSION_AUTHOR_READ ATTR_PERMISSION_ENCRY_READ ATTR_PERMISSION_AUTHEN_WRITE ATTR_PERMISSION_AUTHOR_WRITE ATTR_PERMISSION_ENCRY_WRITE

Returns

Value indicating success or error code.

Start a signed write without response from the server.

Note

The procedure i used to write a characteristic value with an authentication signature without waiting for any response from the server. It cannot be used when the link is encrypted.

Parameters

conn_handle	Connection handle for which the command is given
attr_handle	Handle of the attribute to be written
val_len	Length of the value to be written (up to ATT_MTU - 13).
attr_val	Value to be written

Returns

Value indicating success or error code

Update a characteristic value in a service.

Note

If notifications (or indications) are enabled on that characteristic, a notification (or indication) will be sent to the client after sending this command to the BlueNRG. The command is queued into the BlueNRG command queue. If the buffer is full, because previous commands could not be still processed, the function will return BLE_STATUS_INSUFFICIENT_RESOURCES. This will happen if notifications (or indications) are enabled and the application calls aci_gatt_update_char_value() at an higher rate than what is allowed by the link. Throughput on BLE link depends on connection interval and connection length parameters (decided by the master, see aci_l2cap_connection_parameter_update_request() for more info on how to suggest new connection parameters from a slave). If the application does not want to lose notifications because BlueNRG buffer becomes full, it has to retry again till the function returns BLE_STATUS_SUCCESS or any other error code.
Example:
Here if BlueNRG buffer become full because BlueNRG was not able to send packets for a while, some notifications will be lost.

tBleStatus Free_Fall_Notify(void)

{

uint8_t val;

tBleStatus ret;

val = 0x01;

ret = aci_gatt_update_char_value(accServHandle, freeFallCharHandle, 0, 1, &val);

if (ret != BLE_STATUS_SUCCESS){

PRINTF("Error while updating FFall characteristic.\n") ;

return BLE_STATUS_ERROR ;

}

return BLE_STATUS_SUCCESS;

}

Here if BlueNRG buffer become full, the application try again to send the notification.

struct timer t;

Timer_Set(&t, CLOCK_SECOND*10);

while(aci_gatt_update_char_value(chatServHandle,TXCharHandle,0,len,array_val)==BLE_STATUS_INSUFFICIENT_RESOURCES){

// Radio is busy (buffer full).

if(Timer_Expired(&t))

break;

}

Parameters

	servHandle	Handle of the service to which characteristic belongs
	charHandle	Handle of the characteristic
	charValOffset	The offset from which the attribute value has to be updated. If this is set to 0, and the attribute value is of variable length, then the length of the attribute will be set to the charValueLen. If the charValOffset is set to a value greater than 0, then the length of the attribute will be set to the maximum length as specified for the attribute while adding the characteristic.
	charValueLen	Length of the characteristic value in octets
[in]	charValue	Characteristic value

Returns

Value indicating success or error code.

Update the value of a characteristic and sends notifications or indications.

Note

This command is a more flexible version of ACI_GATT_UPDATE_CHAR_VALUE to support update of long attribute up to 512 bytes and indicate selectively the generation of indications and notifications.

Parameters

	service_handle	Handle of the service to which the characteristic belongs.
	char_handle	Handle of the characteristic
	update_type	Bitmask that controls generation of notifications and indications. It can be a combination NOTIFICATION (0x01): send notification, if enabled. INDICATION (0x02): send indication, if enabled. If set to 0 no notifications or indications are sent.
	char_length	Total length of the characteristic value. In case of a variable size characteristic, this field specifies the new length of the characteristic value after the update; in case of fixed length characteristic this field is ignored.
	value_offset	The offset from which the attribute value has to be updated
	value_length	Length of the value to be updated
[out]	value	Updated characteristic value

Returns

Value indicating success or error code.

Start the procedure to write a characteristic descriptor.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated.

Parameters

	conn_handle	Connection handle for which the command is given
	attr_handle	Handle of the attribute to be written
	value_len	Length of the value to be written
[in]	attr_value	Value to be written

Returns

Value indicating success or error code.
It can be BLE_STATUS_NOT_ALLOWED in the following cases:

• If the exchange has already taken place
  
• If GATT is expecting response for previous request
  
• Already a request is in the queue to be sent
  
• Channel not open
  
• Already one GATT procedure is started

Start the procedure to write a characteristic reliably.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. During the procedure, EVT_BLUE_ATT_PREPARE_WRITE_RESP and EVT_BLUE_ATT_EXEC_WRITE_RESP events are raised.

Parameters

conn_handle	Connection handle for which the command is given
attr_handle	Handle of the attribute to be written
val_offset	Offset at which the attribute has to be written
val_len	Length of the value to be written
attr_val	Value to be written

Returns

Value indicating success or error code.

Start the procedure to write a characteristic value.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated.

Parameters

	conn_handle	Connection handle for which the command is given
	attr_handle	Handle of the characteristic to be written
	value_len	Length of the value to be written
[in]	attr_value	Value to be written

Returns

Value indicating success or error code.
It can be BLE_STATUS_NOT_ALLOWED in the following cases:

• If the exchange has already taken place
  
• If GATT is expecting response for previous request
  
• Already a request is in the queue to be sent
  
• Channel not open
  
• Already one GATT procedure is started

Start the procedure to write a long characteristic descriptor.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. During the procedure, EVT_BLUE_ATT_PREPARE_WRITE_RESP and EVT_BLUE_ATT_EXEC_WRITE_RESP events are raised.

Parameters

conn_handle	Connection handle for which the command is given
attr_handle	Handle of the attribute to be written
val_offset	Offset at which the attribute has to be written
val_len	Length of the value to be written
attr_val	Value to be written

Returns

Value indicating success or error code.

Start the procedure to write a long characteristic value.

Note

When the procedure is completed, a EVT_BLUE_GATT_PROCEDURE_COMPLETE event is generated. During the procedure, EVT_BLUE_ATT_PREPARE_WRITE_RESP and EVT_BLUE_ATT_EXEC_WRITE_RESP events are raised.

Parameters

conn_handle	Connection handle for which the command is given
attr_handle	Handle of the attribute to be written
val_offset	Offset at which the attribute has to be written
val_len	Length of the value to be written
attr_val	Value to be written

Returns

Value indicating success or error code.

Allow or reject a write request from a client.

Note

This command has to be sent by the application when it receives the EVT_BLUE_GATT_WRITE_PERMIT_REQ. If the write is allowed, then the status and error code has to be set to 0. If the write is not allowed, then the status has to be set to 1 and the error code has to be set to the error code that has to be passed to the client.

Parameters

conn_handle	Connection handle for which the command is given
attr_handle	Handle of the attribute that was passed in the event EVT_BLUE_GATT_WRITE_PERMIT_REQ.
write_status	0x00: The value can be written to the attribute specified by attr_handle 0x01: The value cannot be written to the attribute specified by the attr_handle.
err_code	The error code that has to be passed to the client in case the write has to be rejected.
att_val_len	Length of the value to be written as passed in the event EVT_BLUE_GATT_WRITE_PERMIT_REQ.
att_val	Value as passed in the event EVT_BLUE_GATT_WRITE_PERMIT_REQ.

Returns

Value indicating success or error code.

Start the procedure to write a characteristic value without waiting for any response from the server.

Note

No events are generated after this command is executed.

Parameters

	conn_handle	Connection handle for which the command is given
	attr_handle	Handle of the attribute to be written
	val_len	Length of the value to be written (up to ATT_MTU - 3)
[in]	attr_val	Value to be written

Returns

Value indicating success or error code.
It can be BLE_STATUS_NOT_ALLOWED in the following cases:

• If the exchange has already taken place
  
• If GATT is expecting response for previous request
  
• Already a request is in the queue to be sent
  
• Channel not open
  
• Already one GATT procedure is started