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

   100

        void setAliases(const string &);

   101

        void setPositions(const string &);

   102

   103

        void setDomains(const string &);

   104

        typedef list<unsigned int> DomainIndexList;

   105

        DomainIndexList getDomainIndices() const;

   106

   107

        void setDataType(const string &);

   108

        const string &getDataType() const;

   109

   110

        void setForce(bool);

   111

        bool getForce() const;

   112

   113

        void setOutputFile(const string &);

   114

        const string &getOutputFile() const;

   115

   116

        void setSkin(const string &);

   117

        const string &getSkin() const;

   118

   119

        bool matchesSubstr(const string &) const;

   120

        bool matchesAbbrev(const string &) const;

   121

   122

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

   123

   124

        typedef vector<string> StringVector;

   125

        virtual void execute(const StringVector &) = 0;

   126

   127

        static string numericInfo();

   128

   129

    protected:

   130

        enum {BreakAfterBytes = 16};

   131

   132

        void throwInvalidUsageException(const stringstream &) const;

   133

        void throwCommandException(const string &) const;

   134

        void throwCommandException(const stringstream &) const;

   135

        void throwSingleSlaveRequired(unsigned int) const;

   136

   137

        typedef list<ec_ioctl_slave_t> SlaveList;

   138

        SlaveList selectedSlaves(MasterDevice &);

   139

        typedef list<ec_ioctl_config_t> ConfigList;

   140

        ConfigList selectedConfigs(MasterDevice &);

   141

        typedef list<ec_ioctl_domain_t> DomainList;

   142

        DomainList selectedDomains(MasterDevice &, const ec_ioctl_master_t &);

   143

   144

        static string alStateString(uint8_t);

   145

   146

    private:

   147

        string name;

   148

        string briefDesc;

   149

        string masters;

   150

        Verbosity verbosity;

   151

        string aliases;

   152

        string positions;

   153

        string domains;

   154

        string dataType;

   155

        bool force;

   156

        string outputFile;

   157

        string skin;

   158

   159

        Command();

   160

};

   161

   162

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

   163

   164

inline const string &Command::getName() const

   165

{

   166

    return name;

   167

}

   168

   169

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

   170

   171

inline const string &Command::getBriefDescription() const

   172

{

   173

    return briefDesc;

   174

}

   175

   176

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

   177

   178

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

   179

{

   180

    return verbosity;

   181

}

   182

   183

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

   184

   185

inline const string &Command::getDataType() const

   186

{

   187

    return dataType;

   188

}

   189

   190

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

   191

   192

inline bool Command::getForce() const

   193

{

   194

    return force;

   195

}

   196

   197

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

   198

   199

inline const string &Command::getOutputFile() const

   200

{

   201

    return outputFile;

   202

}

   203

   204

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

   205

   206

inline const string &Command::getSkin() const

   207

{

   208

    return skin;

   209

}

   210

   211

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

   212

   213

#endif