Alessandro Bonazzi
8c43d5cf2f
Files correlati : cg0.exe cg0700a.msk cg0700b.msk cg3.exe cg4.exe Bug : Commento: Merge 1.0 libraries
228 lines
9.2 KiB
C++
228 lines
9.2 KiB
C++
/****************************************************************************
|
|
**
|
|
** Copyright (C) 2015 The Qt Company Ltd.
|
|
** Contact: http://www.qt.io/licensing/
|
|
**
|
|
** This file is part of the tools applications of the Qt Toolkit.
|
|
**
|
|
** $QT_BEGIN_LICENSE:LGPL$
|
|
** Commercial License Usage
|
|
** Licensees holding valid commercial Qt licenses may use this file in
|
|
** accordance with the commercial license agreement provided with the
|
|
** Software or, alternatively, in accordance with the terms contained in
|
|
** a written agreement between you and The Qt Company. For licensing terms
|
|
** and conditions see http://www.qt.io/terms-conditions. For further
|
|
** information use the contact form at http://www.qt.io/contact-us.
|
|
**
|
|
** GNU Lesser General Public License Usage
|
|
** Alternatively, this file may be used under the terms of the GNU Lesser
|
|
** General Public License version 2.1 or version 3 as published by the Free
|
|
** Software Foundation and appearing in the file LICENSE.LGPLv21 and
|
|
** LICENSE.LGPLv3 included in the packaging of this file. Please review the
|
|
** following information to ensure the GNU Lesser General Public License
|
|
** requirements will be met: https://www.gnu.org/licenses/lgpl.html and
|
|
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
|
|
**
|
|
** As a special exception, The Qt Company gives you certain additional
|
|
** rights. These rights are described in The Qt Company LGPL Exception
|
|
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
|
|
**
|
|
** GNU General Public License Usage
|
|
** Alternatively, this file may be used under the terms of the GNU
|
|
** General Public License version 3.0 as published by the Free Software
|
|
** Foundation and appearing in the file LICENSE.GPL included in the
|
|
** packaging of this file. Please review the following information to
|
|
** ensure the GNU General Public License version 3.0 requirements will be
|
|
** met: http://www.gnu.org/copyleft/gpl.html.
|
|
**
|
|
** $QT_END_LICENSE$
|
|
**
|
|
****************************************************************************/
|
|
|
|
#ifndef LAUNCHER_H
|
|
#define LAUNCHER_H
|
|
|
|
#include "trkdevice.h"
|
|
#include "trkutils.h"
|
|
|
|
#include <QtCore/QObject>
|
|
#include <QtCore/QVariant>
|
|
#include <QtCore/QSharedPointer>
|
|
|
|
namespace trk {
|
|
|
|
struct TrkResult;
|
|
struct TrkMessage;
|
|
struct LauncherPrivate;
|
|
|
|
typedef QSharedPointer<TrkDevice> TrkDevicePtr;
|
|
|
|
class SYMBIANUTILS_EXPORT Launcher : public QObject
|
|
{
|
|
Q_OBJECT
|
|
Q_DISABLE_COPY(Launcher)
|
|
public:
|
|
typedef void (Launcher::*TrkCallBack)(const TrkResult &);
|
|
|
|
enum InstallationMode {
|
|
InstallationModeSilent = 0x1,
|
|
InstallationModeUser = 0x2,
|
|
InstallationModeSilentAndUser = InstallationModeSilent|InstallationModeUser
|
|
//first attempt is silent and if it fails then the user installation is launched
|
|
};
|
|
|
|
enum Actions {
|
|
ActionPingOnly = 0x0,
|
|
ActionCopy = 0x1,
|
|
ActionInstall = 0x2,
|
|
ActionCopyInstall = ActionCopy | ActionInstall,
|
|
ActionRun = 0x4,
|
|
ActionDownload = 0x8,
|
|
ActionCopyRun = ActionCopy | ActionRun,
|
|
ActionInstallRun = ActionInstall | ActionRun,
|
|
ActionCopyInstallRun = ActionCopy | ActionInstall | ActionRun
|
|
};
|
|
|
|
enum State { Disconnected, Connecting, Connected,
|
|
WaitingForTrk, // This occurs only if the initial ping times out after
|
|
// a reasonable timeout, indicating that Trk is not
|
|
// running. Note that this will never happen with
|
|
// Bluetooth as communication immediately starts
|
|
// after connecting.
|
|
DeviceDescriptionReceived };
|
|
|
|
explicit Launcher(trk::Launcher::Actions startupActions = trk::Launcher::ActionPingOnly,
|
|
const TrkDevicePtr &trkDevice = TrkDevicePtr(),
|
|
QObject *parent = 0);
|
|
~Launcher();
|
|
|
|
State state() const;
|
|
|
|
void addStartupActions(trk::Launcher::Actions startupActions);
|
|
void setTrkServerName(const QString &name);
|
|
QString trkServerName() const;
|
|
void setFileName(const QString &name);
|
|
void setCopyFileNames(const QStringList &srcName, const QStringList &dstName);
|
|
void setDownloadFileName(const QString &srcName, const QString &dstName);
|
|
void setInstallFileNames(const QStringList &names);
|
|
void setCommandLineArgs(const QString &args);
|
|
bool startServer(QString *errorMessage);
|
|
void setInstallationMode(InstallationMode installation);
|
|
void setInstallationDrive(char drive);
|
|
void setVerbose(int v);
|
|
void setSerialFrame(bool b);
|
|
|
|
InstallationMode installationMode() const;
|
|
char installationDrive() const;
|
|
|
|
bool serialFrame() const;
|
|
// Close device or leave it open
|
|
bool closeDevice() const;
|
|
void setCloseDevice(bool c);
|
|
|
|
TrkDevicePtr trkDevice() const;
|
|
|
|
// becomes valid after successful execution of ActionPingOnly
|
|
QString deviceDescription(unsigned verbose = 0u) const;
|
|
|
|
// Acquire a device from SymbianDeviceManager, return 0 if not available.
|
|
// The device will be released on destruction.
|
|
static Launcher *acquireFromDeviceManager(const QString &serverName,
|
|
QObject *parent,
|
|
QString *errorMessage);
|
|
// Preliminary release of device, disconnecting the signal.
|
|
static void releaseToDeviceManager(Launcher *l);
|
|
|
|
// Create Trk message to start a process.
|
|
static QByteArray startProcessMessage(const QString &executable,
|
|
const QString &arguments);
|
|
// Create Trk message to read memory
|
|
static QByteArray readMemoryMessage(uint pid, uint tid, uint from, uint len);
|
|
static QByteArray readRegistersMessage(uint pid, uint tid);
|
|
// Parse a TrkNotifyStopped message
|
|
static bool parseNotifyStopped(const QByteArray &a,
|
|
uint *pid, uint *tid, uint *address,
|
|
QString *why = 0);
|
|
// Helper message
|
|
static QString msgStopped(uint pid, uint tid, uint address, const QString &why);
|
|
|
|
signals:
|
|
void deviceDescriptionReceived(const QString &port, const QString &description);
|
|
void copyingStarted(const QString &fileName);
|
|
void canNotConnect(const QString &errorMessage);
|
|
void canNotCreateFile(const QString &filename, const QString &errorMessage);
|
|
void canNotOpenFile(const QString &filename, const QString &errorMessage);
|
|
void canNotOpenLocalFile(const QString &filename, const QString &errorMessage);
|
|
void canNotWriteFile(const QString &filename, const QString &errorMessage);
|
|
void canNotCloseFile(const QString &filename, const QString &errorMessage);
|
|
void installingStarted(const QString &packageName);
|
|
void canNotInstall(const QString &packageFilename, const QString &errorMessage);
|
|
void installingFinished();
|
|
void startingApplication();
|
|
void applicationRunning(uint pid);
|
|
void canNotRun(const QString &errorMessage);
|
|
void finished();
|
|
void applicationOutputReceived(const QString &output);
|
|
void copyProgress(int percent);
|
|
void stateChanged(int);
|
|
void processStopped(uint pc, uint pid, uint tid, const QString &reason);
|
|
void processResumed(uint pid, uint tid);
|
|
void libraryLoaded(const trk::Library &lib);
|
|
void libraryUnloaded(const trk::Library &lib);
|
|
void registersAndCallStackReadComplete(const QList<uint>& registers, const QByteArray& stack);
|
|
// Emitted by the destructor, for releasing devices of SymbianDeviceManager by name
|
|
void destroyed(const QString &serverName);
|
|
|
|
public slots:
|
|
void terminate();
|
|
void resumeProcess(uint pid, uint tid);
|
|
//can be used to obtain traceback after a breakpoint / exception
|
|
void getRegistersAndCallStack(uint pid, uint tid);
|
|
|
|
private slots:
|
|
void handleResult(const trk::TrkResult &data);
|
|
void slotWaitingForTrk();
|
|
|
|
private:
|
|
// kill process and breakpoints
|
|
void cleanUp();
|
|
void disconnectTrk();
|
|
|
|
void handleRemoteProcessKilled(const TrkResult &result);
|
|
void handleConnect(const TrkResult &result);
|
|
void handleFileCreation(const TrkResult &result);
|
|
void handleFileOpened(const TrkResult &result);
|
|
void handleCopy(const TrkResult &result);
|
|
void handleRead(const TrkResult &result);
|
|
void continueCopying(uint lastCopiedBlockSize = 0);
|
|
void continueReading();
|
|
void closeRemoteFile(bool failed = false);
|
|
void handleFileCopied(const TrkResult &result);
|
|
void handleInstallPackageFinished(const TrkResult &result);
|
|
void handleCpuType(const TrkResult &result);
|
|
void handleCreateProcess(const TrkResult &result);
|
|
void handleWaitForFinished(const TrkResult &result);
|
|
void handleStop(const TrkResult &result);
|
|
void handleSupportMask(const TrkResult &result);
|
|
void handleTrkVersion(const TrkResult &result);
|
|
void handleReadRegisters(const TrkResult &result);
|
|
void handleReadStack(const TrkResult &result);
|
|
|
|
void copyFileToRemote();
|
|
void copyFileFromRemote();
|
|
void installRemotePackageSilently();
|
|
void installRemotePackageByUser();
|
|
void installRemotePackage();
|
|
void startInferiorIfNeeded();
|
|
void handleFinished();
|
|
|
|
void logMessage(const QString &msg);
|
|
void setState(State s);
|
|
|
|
LauncherPrivate *d;
|
|
};
|
|
|
|
} // namespace Trk
|
|
|
|
#endif // LAUNCHER_H
|