1

/*****************************************************************************

     2

 *

     3

 *  $Id$

     4

 *

     5

 *  Copyright (C) 2006-2009  Florian Pose, Ingenieurgemeinschaft IgH

     6

 *

     7

 *  This file is part of the IgH EtherCAT Master.

     8

 *

     9

 *  The IgH EtherCAT Master is free software; you can redistribute it and/or

    10

 *  modify it under the terms of the GNU General Public License version 2, as

    11

 *  published by the Free Software Foundation.

    12

 *

    13

 *  The IgH EtherCAT Master is distributed in the hope that it will be useful,

    14

 *  but WITHOUT ANY WARRANTY; without even the implied warranty of

    15

 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General

    16

 *  Public License for more details.

    17

 *

    18

 *  You should have received a copy of the GNU General Public License along

    19

 *  with the IgH EtherCAT Master; if not, write to the Free Software

    20

 *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

    21

 *

    22

 *  ---

    23

 *

    24

 *  The license mentioned above concerns the source code only. Using the

    25

 *  EtherCAT technology and brand is only permitted in compliance with the

    26

 *  industrial property and similar rights of Beckhoff Automation GmbH.

    27

 *

    28

 ****************************************************************************/

    29

    30

#ifndef __COMMAND_H__

    31

#define __COMMAND_H__

    32

    33

#include <stdexcept>

    34

#include <vector>

    35

#include <list>

    36

#include <sstream>

    37

using namespace std;

    38

    39

#include "../master/ioctl.h"

    40

    41

class MasterDevice;

    42

    43

/****************************************************************************/

    44

    45

class InvalidUsageException:

    46

    public runtime_error

    47

{

    48

    friend class Command;

    49

    50

    protected:

    51

        /** Constructor with stringstream parameter. */

    52

        InvalidUsageException(

    53

                const stringstream &s /**< Message. */

    54

                ): runtime_error(s.str()) {}

    55

};

    56

    57

/****************************************************************************/

    58

    59

class CommandException:

    60

    public runtime_error

    61

{

    62

    friend class Command;

    63

    64

    protected:

    65

        /** Constructor with char * parameter. */

    66

        CommandException(

    67

                const string &msg /**< Message. */

    68

                ): runtime_error(msg) {}

    69

    70

        /** Constructor with stringstream parameter. */

    71

        CommandException(

    72

                const stringstream &s /**< Message. */

    73

                ): runtime_error(s.str()) {}

    74

};

    75

    76

/****************************************************************************/

    77

    78

class Command

    79

{

    80

    public:

    81

        Command(const string &, const string &);

    82

        virtual ~Command();

    83

    84

        const string &getName() const;

    85

        const string &getBriefDescription() const;

    86

    87

        typedef list<unsigned int> MasterIndexList;

    88

        void setMasters(const string &);

    89

        MasterIndexList getMasterIndices() const;

    90

		unsigned int getSingleMasterIndex() const;

    91

    92

        enum Verbosity {

    93

            Quiet,

    94

            Normal,

    95

            Verbose

    96

        };

    97

        void setVerbosity(Verbosity);

    98

        Verbosity getVerbosity() const;

    99

        void setAlias(int);

   100

        int getAlias() const;

   101

        void setPosition(int);

   102

        int getPosition() const;

   103

        void setDomain(int);

   104

        int getDomain() const;

   105

        void setDataType(const string &);

   106

        const string &getDataType() const;

   107

        void setForce(bool);

   108

        bool getForce() const;

   109

        void setOutputFile(const string &);

   110

        const string &getOutputFile() const;

   111

   112

        bool matchesSubstr(const string &) const;

   113

        bool matchesAbbrev(const string &) const;

   114

   115

        virtual string helpString(const string &) const = 0;

   116

   117

        typedef vector<string> StringVector;

   118

        virtual void execute(const StringVector &) = 0;

   119

   120

        static string numericInfo();

   121

   122

    protected:

   123

        enum {BreakAfterBytes = 16};

   124

   125

        void throwInvalidUsageException(const stringstream &) const;

   126

        void throwCommandException(const string &) const;

   127

        void throwCommandException(const stringstream &) const;

   128

        void throwSingleSlaveRequired(unsigned int) const;

   129

   130

        typedef list<ec_ioctl_slave_t> SlaveList;

   131

        SlaveList selectedSlaves(MasterDevice &);

   132

        typedef list<ec_ioctl_config_t> ConfigList;

   133

        ConfigList selectedConfigs(MasterDevice &);

   134

        typedef list<ec_ioctl_domain_t> DomainList;

   135

        DomainList selectedDomains(MasterDevice &);

   136

   137

        static string alStateString(uint8_t);

   138

   139

    private:

   140

        string name;

   141

        string briefDesc;

   142

        string masters;

   143

        Verbosity verbosity;

   144

        int alias;

   145

        int position;

   146

        int domain;

   147

        string dataType;

   148

        bool force;

   149

        string outputFile;

   150

   151

        Command();

   152

};

   153

   154

/****************************************************************************/

   155

   156

inline const string &Command::getName() const

   157

{

   158

    return name;

   159

}

   160

   161

/****************************************************************************/

   162

   163

inline const string &Command::getBriefDescription() const

   164

{

   165

    return briefDesc;

   166

}

   167

   168

/****************************************************************************/

   169

   170

inline Command::Verbosity Command::getVerbosity() const

   171

{

   172

    return verbosity;

   173

}

   174

   175

/****************************************************************************/

   176

   177

inline int Command::getAlias() const

   178

{

   179

    return alias;

   180

}

   181

   182

/****************************************************************************/

   183

   184

inline int Command::getPosition() const

   185

{

   186

    return position;

   187

}

   188

   189

/****************************************************************************/

   190

   191

inline int Command::getDomain() const

   192

{

   193

    return domain;

   194

}

   195

   196

/****************************************************************************/

   197

   198

inline const string &Command::getDataType() const

   199

{

   200

    return dataType;

   201

}

   202

   203

/****************************************************************************/

   204

   205

inline bool Command::getForce() const

   206

{

   207

    return force;

   208

}

   209

   210

/****************************************************************************/

   211

   212

inline const string &Command::getOutputFile() const

   213

{

   214

    return outputFile;

   215

}

   216

   217

/****************************************************************************/

   218

   219

#endif