zdatasessionmanager.h

motorola E680I的EZK SDK.

/*
 * Unofficial EZX Native Software Development Kit
 * Copyright (C) 2005 Sam Revitch <[e-mail]>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU 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 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.
 *
 * Further, this software is distributed without any warranty that it is
 * free of the rightful claim of any third person regarding infringement
 * or the like.  Any license provided herein, whether implied or
 * otherwise, applies only to this software file.  Patent licenses, if
 * any, provided herein do not apply to combinations of this program with
 * other software, or any other product whatsoever.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

#if !defined(__ZDATASESSIONMANAGER_H__)
#define __ZDATASESSIONMANAGER_H__

/*
 * This is the GPRS/CSD connection management API.
 * I spent some time figuring out how this works, and the comments
 * should be relatively complete.
 */

#include <qwssocket_qws.h>

/*
 * As a warning, the NAPI API does not appear to be the least bit
 * thread-safe -- it stores its state in global variables.
 *
 * getProfileNamebySelect() presents a dialog box to the user
 * displaying the possible network connection profiles.  It will
 * block for the lifetime of the dialog box.
 *
 * The name_inout parameter may contain the name of the profile
 * that should be initially selected, and will contain the name of
 * the selected profile on return.
 *
 * Return value:
 *	0	Success, name_inout contains the string name of the
 *		chosen profile.
 *	-100	User clicked "Cancel"
 */
int getProfileNamebySelect(QString &name_inout);


/* These names are all educated guesses from perusing a disassembly */
enum NAPI_RESULT_T {
	NAPI_ERROR_NOT_INITIALIZED = -1,
	NAPI_ERROR_INVALID_PROFILE = -2,
	NAPI_ERROR_ALREADY_INITIALIZED = -3,
	NAPI_ERROR_DSM_SOCKET = -4,
	NAPI_ERROR_NAME_TOO_LONG = -5,
	NAPI_ERROR_DSM_RESPONSE = -6,
	NAPI_ERROR_BIND_FAILED = -8,
	NAPI_ERROR_LINK_REMOVED = -100,
};


/*
 * ZLinkInfo is passed to slot methods of ZDataSessionManager
 * and describes a network link.
 */

struct ZLinkInfo {
	/* Unknown */
	int	li_flags;

	/* li_linkid is a number [1..15] describing the connection */
	int	li_linkid;

	/* li_dest is the string name of the APN, for GPRS connections */
	char	li_dest[96];
};

/* ZStateDialog seems to be internal to this module */
class ZStateDialog;

class ZDataSessionManager : public QWSSocket {
	Q_OBJECT
public:
	ZDataSessionManager(QObject *parent = NULL,
			    char const *obj_name = NULL);
	virtual ~ZDataSessionManager();

	/*
	 * init() opens a connection to the SYStapi/dsm process.
	 *
	 * The boolean parameter decides whether notifications are
	 * sent for *all* link events vs. just events initiated by
	 * this application.
	 *
	 * Return value:
	 *	>=0	Success, the value is the notification file
	 *		descriptor, which this class has already
	 *		setu up event handlers for.
	 *	<0	Failure, the value is a NAPI_RESULT_T.
	 */
	int init(bool notifyAll = false);

	/*
	 * openLink() tries to connect to a data service profile,
	 * and displays a message box on the screen apprising the
	 * user of this.
	 *
	 * It will return before the connection is complete.  To
	 * find out when the connection completes, and therefore
	 * when the dialog goes away or it is possible to use the
	 * link, use the connected and openFailed slots.
	 *
	 * Return value:
	 *	>0	Success, the value is the link ID of the
	 *		connection.
	 *	<0	Failure, the value is a NAPI_RESULT_T.
	 */
	int openLink(QString const &profilename);

	/*
	 * openLinkNoDialog() is otherwise identical to openLink(),
	 * but suppresses the message box.
	 */
	int openLinkNoDialog(QString const &profilename);

	int closeLink(int linkid);

	/*
	 * getDeviceInfo() retrieves parameters of an active connection.
	 *
	 * Return value:
	 *	0	Success, iface_out and ipaddr_out are filled in.
	 *	<0	Failure, the value is a NAPI_RESULT_T.
	 */
	int getDeviceInfo(int linkid,
			  QString &iface_out, unsigned long *ipaddr_out);

	/*
	 * bindSocket2Link() will determine the interface parameters
	 * of the given data connection, and will setsockopt() the
	 * given socket so that it may only operate over that link.
	 */
	int bindSocket2Link(int fd, int linkid);


	/* There don't appear to be any users of these methods. */
	int attach(int, QString const&);
	int hold(int, QString const&);
	int drop(int, QString const&);


	int			m_napifd38;
	int			m_linkid3c;
	ZStateDialog		*m_dialog40;

signals:
	void connected(int linkid, ZLinkInfo&);
	void openFailed(int, unsigned short, unsigned short);
	void broken(int linkid, ZLinkInfo&);

public slots:
	/*
	 * This is for cancelation of dialog-oriented connections.
	 * It will invoke openFailed().
	 */
	void slotCancelBtnClicked();

	/* These appear to be internal slots for the DSM socket */
	void slotReadIndicator();
	void slotLoseConnection();
};


#endif  /* !defined(__ZDATASESSIONMANAGER_H__) */