btdiscoverer.h

Go to the documentation of this file.

/*
 * btdiscoverer.h,v 1.6 2003/11/09 13:38:21 mattid Exp
 *
 * COBAIN - Communications API for EPOC Environments
 * Copyright (C) 2002-2003 Matti Dahlbom, Matti Kokkola
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * Contact: Matti Dahlbom <matti@777-team.org>
 *          Matti Kokkola <matti.kokkola@iki.fi>
 */

#ifndef __BTDISCOVERER_H
#define __BTDISCOVERER_H

#include "clientservercommon.h"

class CServerSession;

// panic category and errors
_LIT(KBTDiscovererPanic, "CBTDiscoverer");

const TInt KErrBtdiscovererBase = -10500;
const TInt KErrBtdiscovererAllocFailed = KErrBtdiscovererBase - 1;

// bluetooth device address list type for device discovery
typedef RPointerArray<TNameRecord> RDeviceAddressList;

// for discovering blueooth devices and services
class CBTDiscoverer : public CActive, 
                      public MSdpAgentNotifier,
                      public MSdpAttributeValueVisitor
{
    public:
        static CBTDiscoverer * NewL(RMessage &aMessage, CServerSession &aSession);
        ~CBTDiscoverer();

        void StartL(RSocketServ &aSocketServ);

        // from CActive
        void RunL();
        TInt RunError(TInt aError); 
        void DoCancel();

        // from MSdpNotifier
        void AttributeRequestComplete(TSdpServRecordHandle aHandle, TInt aError);
        void AttributeRequestResult(TSdpServRecordHandle aHandle, 
                                    TSdpAttributeID aAttrID, 
                                    CSdpAttrValue* aAttrValue);
        void NextRecordRequestComplete(TInt aError, 
                                       TSdpServRecordHandle aHandle, 
                                       TInt aTotalRecordsCount);

        // from MSdpAttributeValueVisitor
        void VisitAttributeValueL(CSdpAttrValue &aValue, TSdpElementType aType);
        void StartListL(CSdpAttrValueList &aList);
        void EndListL();
    private:
        enum TDiscoveryState {
            ENone = 1, 
            EDiscoveringDevice,
            EDiscoveringService
        };

        CBTDiscoverer(RMessage &aMessage, CServerSession &aSession);
        void ConstructL();
        void DeviceDiscovered();
        void DiscoverServices(TNameRecord &aNameRecord);
        void FinishDiscovery();

        RMessage &iMessage;
        CServerSession &iSession;

        // device discovery resources
        RHostResolver iHr;
        TNameEntry iNameEntry;

        // service discovery resources
        CSdpSearchPattern *iSdpPattern;
        CSdpAgent *iAgent;

        // attribute parsing state variables
        TInt iAttrNum;
        TBool iPeerOk;

        // addresses of discovered devices 
        RDeviceAddressList iDeviceAddresses;

        // ordinal (index in iDeviceAddresses) of the device whose are being discovered
        TInt iCurrentDeviceIndex;

        // discovered peers
        TInt iNumPeers;
        //##TODO## maybe use RPointerArray instead?
        TPeerDataList *iPeerList;
};

#endif

---