// Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
// which accompanies this distribution, and is available
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
// Publish and Subscribe keys and categories.
// Allows clients to observe various events published by the Bluetooth subsystem,
// and for clients to influence some parameters in the Bluetooth subsystem
//
//
#ifndef BT_SUBSCRIBE_H
#define BT_SUBSCRIBE_H
#include <e32property.h>
/**
@publishedAll
@released
*/
const TInt KUidBluetoothPubSubKeyBase = 0x10203637; // Range of 32 values registered
// P&S Categories
/**
KPropertyUidBluetoothCategory
This is a deprecated constant, maintained for source compatibility with non-secured
Symbian OS platforms.
@publishedAll
@deprecated
*/
const TUid KPropertyUidBluetoothCategory = {KUidSystemCategoryValue};
/**
KPropertyUidBluetoothControlCategory
This is a deprecated constant, maintained for source compatibility with non-secured
Symbian OS platforms.
@publishedAll
@deprecated
*/
const TUid KPropertyUidBluetoothControlCategory = {KUidSystemCategoryValue};
// P&S Keys
//-------------
/**
KPropertyKeyBluetoothGetLocalDeviceAddress
The key to observe the device address of the local Bluetooth hardware
The P&S value will contain a descriptor of the device address
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetLocalDeviceAddress = (KUidBluetoothPubSubKeyBase + 0);
/**
KPropertyKeyBluetoothLocalDeviceAddress
This is a deprecated constant, maintained for source compatibility with non-secured
Symbian OS platforms.
@publishedAll
@deprecated
*/
const TUint KPropertyKeyBluetoothLocalDeviceAddress = KPropertyKeyBluetoothGetLocalDeviceAddress;
//-------------
/**
KPropertyKeyBluetoothGetPHYCount
The key to observe the the number of Bluetooth physical links attached to the local device
The P&S value will contain the number of physical links
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetPHYCount = (KUidBluetoothPubSubKeyBase + 1);
/**
KPropertyKeyBluetoothPHYCount
This is a deprecated constant, maintained for source compatibility with non-secured
Symbian OS platforms.
@publishedAll
@deprecated
*/
const TUint KPropertyKeyBluetoothPHYCount = KPropertyKeyBluetoothGetPHYCount;
//-------------
/**
KPropertyKeyBluetoothGetConnectingStatus
The key to observe whether the local device is paging another device (i.e. is connecting a physical link)
The P&S value will contain a boolean: ETrue if connecting, otherwise EFalse
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetConnectingStatus = (KUidBluetoothPubSubKeyBase + 2);
/**
KPropertyKeyBluetoothConnecting
This is a deprecated constant, maintained for source compatibility with non-secured
Symbian OS platforms.
@publishedAll
@deprecated
*/
const TUint KPropertyKeyBluetoothConnecting = KPropertyKeyBluetoothGetConnectingStatus;
//-------------
/**
KPropertyKeyBluetoothGetScanningStatus
The key to observe what scans the Bluetooth hardware is currently performing
The P&S value contains an integer with the scan value as published in the Bluetooth Core Specification
The use of this key is equivalent in a secure Symbian OS platform to the use of the key
KPropertyKeyBluetoothScanning with the category KPropertyUidBluetoothCategory in a non-secure
Symbian OS platform.
@see Bluetooth Core Specification
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetScanningStatus = (KUidBluetoothPubSubKeyBase + 3);
/**
KPropertyKeyBluetoothSetScanningStatus
The key to control what scans the Bluetooth hardware is currently performing
The P&S value contains an integer with the scan value as published in the Bluetooth Core Specification
The use of this key is equivalent in a secure Symbian OS platform to the use of the key
KPropertyKeyBluetoothScanning with the category KPropertyUidBluetoothControlCategory in a non-secure
Symbian OS platform.
@see Bluetooth Core Specification
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for both read and write access to this property
*/
const TUint KPropertyKeyBluetoothSetScanningStatus = (KUidBluetoothPubSubKeyBase + 4);
//-------------
/**
KPropertyKeyBluetoothGetLimitedDiscoverableStatus
The key to observe whether the local device is in Limited Discoverable mode
The P&S value will contain a boolean: ETrue if in limited discoverable mode, otherwise EFalse
The use of this key is equivalent in a secure Symbian OS platform to the use of the key
KPropertyKeyBluetoothLimitedDiscoverable with the category KPropertyUidBluetoothCategory in a non-secure
Symbian OS platform.
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetLimitedDiscoverableStatus = (KUidBluetoothPubSubKeyBase + 5);
/**
KPropertyKeyBluetoothSetLimitedDiscoverableStatus
The key to control whether the local device is in Limited Discoverable mode
The P&S value will contain a boolean: ETrue if in limited discoverable mode, otherwise EFalse
The use of this key is equivalent in a secure Symbian OS platform to the use of the key
KPropertyKeyBluetoothLimitedDiscoverable with the category KPropertyUidBluetoothControlCategory in a non-secure
Symbian OS platform.
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for both read and write access to this property
*/
const TUint KPropertyKeyBluetoothSetLimitedDiscoverableStatus = (KUidBluetoothPubSubKeyBase + 6);
//-------------
/**
KPropertyKeyBluetoothGetDeviceClass
The key to observe the class of device of the local device
The P&S value will contain an integer of the local device class.
The use of this key is equivalent in a secure Symbian OS platform to the use of the key
KPropertyKeyBluetoothDeviceClass with the category KPropertyUidBluetoothCategory in a non-secure
Symbian OS platform.
@see Bluetooth Core Specification
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetDeviceClass = (KUidBluetoothPubSubKeyBase + 7);
/**
KPropertyKeyBluetoothSetDeviceClass
The key to set the class of device of the local device
The P&S value will contain an integer of the local device class.
The use of this key is equivalent in a secure Symbian OS platform to the use of the key
KPropertyKeyBluetoothDeviceClass with the category KPropertyUidBluetoothControlCategory in a non-secure
Symbian OS platform.
@see Bluetooth Core Specification
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for both read and write access to this property
*/
const TUint KPropertyKeyBluetoothSetDeviceClass = (KUidBluetoothPubSubKeyBase + 8);
//-------------
/**
KPropertyKeyBluetoothSetAFHHostChannelClassification
The key to send an AFH Host Channel Classification to the local Bluetooth hardware
The P&S value will contain a descriptor containing the AFH Host Channel Classification
bit set. A bit which is set to zero instructs the local Bluetooth hardware
not to hop to the frequency represented by that bit in a connection in which
it is master and which is using AFH. Also, if the local Bluetooth hardware is slave in a
connection, which is using AFH, an AFH Host Channel Classification may be used to advise
the remote master what frequencies to avoid.
NB. THIS IS SUPPORTED ONLY IN VERSION 9.0 AND THEREAFTER. The same functionality can be
accessed in 8.1 also through the use of the KPropertyKeyBluetoothAFHHostChannelClassification
key in conjunction with category KPropertyUidBluetoothControlCategory.
@see TBTAFHHostChannelClassification
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for both read and write access to this property
*/
const TUint KPropertyKeyBluetoothSetAFHHostChannelClassification = (KUidBluetoothPubSubKeyBase + 9);
/**
KPropertyKeyBluetoothAFHHostChannelClassification
This is a deprecated constant, maintained for source compatibility with non-secured
Symbian OS platforms.
@publishedAll
@deprecated
*/
const TUint KPropertyKeyBluetoothAFHHostChannelClassification = KPropertyKeyBluetoothSetAFHHostChannelClassification;
//-------------
/**
KPropertyKeyBluetoothSetAFHChannelAssessmentMode
The key to send the Bluetooth AFH Channel Assessment Mode to the local Bluetooth hardware.
If AFH Channel Assessment Mode is on, then the local hardware will keep checking what
channels are busy and so should be avoided in a connection using AFH.
The P&S value will contain a boolean: ETrue if AFH Channel Assessment Mode is required,
EFalse if not.
The hardware is likely to support this either never, in master role only,
or in both master and slave roles.
The default setting of AFH Channel Assessment Mode in the hardware is 'on'
whenever the hardware can support it.
@publishedPartner
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for both read and write access to this property
*/
const TUint KPropertyKeyBluetoothSetAFHChannelAssessmentMode = (KUidBluetoothPubSubKeyBase + 10);
/**
KPropertyKeyBluetoothAFHChannelAssessmentMode
This is a deprecated constant, maintained for source compatibility with non-secured
Symbian OS platforms.
@publishedPartner
@deprecated
*/
const TUint KPropertyKeyBluetoothAFHChannelAssessmentMode = KPropertyKeyBluetoothSetAFHChannelAssessmentMode;
//-------------
/**
KPropertyKeyBluetoothGetRegistryTableChange
The key to observe changes in the Bluetooth Registry
The P&S value will contain an integer describing which of the tables in the Bluetooth Registry changed
see further in this header file.
This property is written to only by the Symbian OS Bluetooth sub-system.
@publishedAll
@released
@capability LocalServices Needed for read access to this property
*/
const TUint KPropertyKeyBluetoothGetRegistryTableChange = (KUidBluetoothPubSubKeyBase + 11);
/**
KPropertyKeyBluetoothRegistryTableChange
This is a deprecated constant, maintained for source compatibility with non-secured
Symbian OS platforms.
@publishedAll
@deprecated
*/
const TUint KPropertyKeyBluetoothRegistryTableChange = KPropertyKeyBluetoothGetRegistryTableChange;
//-------------
// Some keys have values that are "wellknown" - these are enumerated here
// RegistryTableChanges
//-------------
/**
KRegistryChangeRemoteTable
@see KPropertyKeyBluetoothGetRegistryTableChange
The value in the KPropertyKeyBluetoothGetRegistryTableChange key if the Remote device table changed
@publishedAll
@released
*/
const TUint KRegistryChangeRemoteTable = (KUidBluetoothPubSubKeyBase + 12);
//-------------
/**
KRegistryChangeLocalTable
@see KPropertyKeyBluetoothGetRegistryTableChange
The value in the KPropertyKeyBluetoothGetRegistryTableChange key if the Local device table changed
@publishedAll
@released
*/
const TUint KRegistryChangeLocalTable = (KUidBluetoothPubSubKeyBase + 13);
//-------------
/**
KRegistryChangeCSYTable
@see KPropertyKeyBluetoothGetRegistryTableChange
The value in the KPropertyKeyBluetoothGetRegistryTableChange key if the CSY-settings table changed
@publishedAll
@released
*/
const TUint KRegistryChangeCSYTable = (KUidBluetoothPubSubKeyBase + 14);
//-------------
/**
KPropertyKeyBluetoothGetDeviceName
The key to observe the name of device of the local device
The P&S value will be of type EText and contain the local device name in Unicode.
At all times the name must have a length <= KHCILocalDeviceNameMaxLength (defined in hciconsts.h).
@see Bluetooth Core Specification
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetDeviceName = (KUidBluetoothPubSubKeyBase + 15);
/**
KPropertyKeyBluetoothSetDeviceName
The key to set the name of device of the local device
The P&S value will be of type EText and contain the local device name in Unicode.
At all times the name must have a length <= KHCILocalDeviceNameMaxLength (defined in hciconsts.h).
@see Bluetooth Core Specification
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for both read and write access to this property
*/
const TUint KPropertyKeyBluetoothSetDeviceName = (KUidBluetoothPubSubKeyBase + 16);
//-------------
/**
KPropertyKeyBluetoothGetCorruptRegistryResetIndication
This key is intended to be used by the UI to be informed when a corrupt
Bluetooth registry has been detected so that the UI can inform the user
that all of the pairings they have made have been lost.
The P&S value will either be 0 or give the tick count, as given by
User::TickCount(), at the time which the corrupt Bluetooth Registry has
been restored or replaced. If the key is 0 this means that the Bluetooth
registry has not been found to be corrupt since the device was turned on.
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetCorruptRegistryResetIndication = (KUidBluetoothPubSubKeyBase + 17);
/**
KPropertyKeyBluetoothCorruptRegistryReset
This is a deprecated constant, maintained for source compatibility with non-secured
Symbian OS platforms.
@publishedAll
@deprecated
*/
const TUint KPropertyKeyBluetoothCorruptRegistryReset = KPropertyKeyBluetoothGetCorruptRegistryResetIndication;
//-------------
/**
KPropertyKeyBluetoothGetAcceptPairedOnlyMode
This key is intended to be used by the UI to discover whether a device will accept all connections or only paired ones.
The P&S value will contain a boolean: ETrue - the stack will only to accept connection requests from paired devices.
EFalse - the stack will accept connection requests from both paired and unpaired devices.
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetAcceptPairedOnlyMode = (KUidBluetoothPubSubKeyBase + 18);
/**
KPropertyKeyBluetoothSetAcceptPairedOnlyMode
The key to set the mode for handling connection requests
The P&S value will contain a boolean: ETrue - the user wishes ONLY to accept connection requests from paired devices.
EFalse - the user wishes to accept connection requests from both paired and unpaired devices.
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for both read and write access to this property
*/
const TUint KPropertyKeyBluetoothSetAcceptPairedOnlyMode = (KUidBluetoothPubSubKeyBase + 19);
/**
KPropertyKeyBluetoothHostResolverActive
The key is intended to be used by the UI to discover whether the device is attempting to do a discovery
If the device is attempting a discovery activities such as streaming of AV data will be affected
The P&S value will contain a boolean: ETrue - the stack is attempting a discovery/discovery+rnr
EFalse - the stack is curently not attempting a discovery
@publishedAll
@released
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothHostResolverActive = (KUidBluetoothPubSubKeyBase + 20);
/**
KPropertyKeyBluetoothSetSimplePairingDebugMode
The key is intended to be used by a platform to set the stack into simple pairing debug mode.
Once enabled (by setting to ETrue) then it cannot be disabled, the mode will remain set until
the Bluetooth stack has been restarted.
When the Symbian simple pairing debug mode is enabled then the stack will instruct the hardware
to generate debug link keys for use with air traffic capture.
When the Symbian simple pairing debug mode is disabled a remote device attempting to make a
connection with a debug link key will be rejected for secure reasons.
@publishedPartner
@released
@capability LocalServices Needed for both read and write access to this property
@capability CommDD Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothSetSimplePairingDebugMode = (KUidBluetoothPubSubKeyBase + 21);
/**
KPropertyKeyBluetoothGetSimplePairingDebugMode
The key is intended to be used by a UI to provide an indication to the user of the device that the
Symbian simple pairing debug mode has been enabled.
As this mode should only be being used by engineers, and provides a potential security risk for
end users the UI should make obvious to an end-user that they have entered this mode and what it
means for them.
@capability LocalServices Needed for both read and write access to this property
@capability NetworkControl Needed for write access to this property
*/
const TUint KPropertyKeyBluetoothGetSimplePairingDebugMode = (KUidBluetoothPubSubKeyBase + 22);
#endif //BT_SUBSCRIBE_H