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

        bool matchesSubstr(const string &) const;

   117

        bool matchesAbbrev(const string &) const;

   118

   119

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

   120

   121

        typedef vector<string> StringVector;

   122

        virtual void execute(const StringVector &) = 0;

   123

   124

        static string numericInfo();

   125

   126

    protected:

   127

        enum {BreakAfterBytes = 16};

   128

   129

        void throwInvalidUsageException(const stringstream &) const;

   130

        void throwCommandException(const string &) const;

   131

        void throwCommandException(const stringstream &) const;

   132

        void throwSingleSlaveRequired(unsigned int) const;

   133

   134

        typedef list<ec_ioctl_slave_t> SlaveList;

   135

        SlaveList selectedSlaves(MasterDevice &);

   136

        typedef list<ec_ioctl_config_t> ConfigList;

   137

        ConfigList selectedConfigs(MasterDevice &);

   138

        typedef list<ec_ioctl_domain_t> DomainList;

   139

        DomainList selectedDomains(MasterDevice &);

   140

   141

        static string alStateString(uint8_t);

   142

   143

    private:

   144

        string name;

   145

        string briefDesc;

   146

        string masters;

   147

        Verbosity verbosity;

   148

        string aliases;

   149

        string positions;

   150

        string domains;

   151

        string dataType;

   152

        bool force;

   153

        string outputFile;

   154

   155

        Command();

   156

};

   157

   158

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

   159

   160

inline const string &Command::getName() const

   161

{

   162

    return name;

   163

}

   164

   165

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

   166

   167

inline const string &Command::getBriefDescription() const

   168

{

   169

    return briefDesc;

   170

}

   171

   172

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

   173

   174

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

   175

{

   176

    return verbosity;

   177

}

   178

   179

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

   180

   181

inline const string &Command::getDataType() const

   182

{

   183

    return dataType;

   184

}

   185

   186

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

   187

   188

inline bool Command::getForce() const

   189

{

   190

    return force;

   191

}

   192

   193

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

   194

   195

inline const string &Command::getOutputFile() const

   196

{

   197

    return outputFile;

   198

}

   199

   200

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

   201

   202

#endif