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

#include <iostream>

    31

#include <iomanip>

    32

using namespace std;

    33

    34

#include "CommandDomains.h"

    35

#include "MasterDevice.h"

    36

    37

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

    38

    39

CommandDomains::CommandDomains():

    40

    Command("domains", "Show configured domains.")

    41

{

    42

}

    43

    44

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

    45

    46

string CommandDomains::helpString() const

    47

{

    48

    stringstream str;

    49

    50

    str << getName() << " [OPTIONS]" << endl

    51

        << endl

    52

        << getBriefDescription() << endl

    53

        << endl

    54

        << "Without the --verbose option, the domains are displayed" << endl

    55

        << "one-per-line. Example:" << endl

    56

        << endl

    57

        << "Domain0: LogBaseAddr 0x00000000, Size   6, WorkingCounter 0/1"

    58

        << endl << endl

    59

        << "The domain's base address for the logical datagram" << endl

    60

        << "(LRD/LWR/LRW) is displayed followed by the domain's" << endl

    61

        << "process data size in byte. The last values are the current" << endl

    62

        << "datagram working counter sum and the expected working" << endl

    63

        << "counter sum. If the values are equal, all PDOs were" << endl

    64

        << "exchanged during the last cycle." << endl

    65

        << endl

    66

        << "If the --verbose option is given, the participating slave" << endl

    67

        << "configurations/FMMUs and the current process data are" << endl

    68

        << "additionally displayed:" << endl

    69

        << endl

    70

        << "Domain1: LogBaseAddr 0x00000006, Size   6, WorkingCounter 0/1"

    71

        << endl

    72

        << "  SlaveConfig 1001:0, SM3 ( Input), LogAddr 0x00000006, Size 6"

    73

        << endl

    74

        << "    0x00 0x00 0x00 0x00 0x00 0x00" << endl

    75

        << endl

    76

        << "The process data are displayed as hexadecimal bytes." << endl

    77

        << endl

    78

        << "Command-specific options:" << endl

    79

        << "  --domain  -d <index>  Positive numerical domain index." << endl

    80

        << "                        If ommitted, all domains are" << endl

    81

        << "                        displayed." << endl

    82

        << endl

    83

        << "  --verbose -v          Show FMMUs and process data" << endl

    84

        << "                        in addition." << endl

    85

        << endl

    86

        << numericInfo();

    87

    88

    return str.str();

    89

}

    90

    91

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

    92

    93

void CommandDomains::execute(const StringVector &args)

    94

{

    95

    DomainList domains;

    96

    DomainList::const_iterator di;

    97

    bool doIndent;

    98

    99

    if (args.size()) {

   100

        stringstream err;

   101

        err << "'" << getName() << "' takes no arguments!";

   102

        throwInvalidUsageException(err);

   103

    }

   104

   105

    doIndent = getMasterIndices().size() > 1;

   106

    MasterIndexList::const_iterator mi;

   107

    for (mi = getMasterIndices().begin();

   108

            mi != getMasterIndices().end(); mi++) {

   109

        MasterDevice m(*mi);

   110

        m.open(MasterDevice::Read);

   111

        domains = selectedDomains(m);

   112

   113

        if (domains.size() && doIndent) {

   114

            cout << "Master" << dec << *mi << endl;

   115

        }

   116

   117

        for (di = domains.begin(); di != domains.end(); di++) {

   118

            showDomain(m, *di, doIndent);

   119

        }

   120

    }

   121

}

   122

   123

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

   124

   125

void CommandDomains::showDomain(

   126

        MasterDevice &m,

   127

        const ec_ioctl_domain_t &domain,

   128

        bool doIndent

   129

        )

   130

{

   131

    unsigned char *processData;

   132

    ec_ioctl_domain_data_t data;

   133

    unsigned int i, j;

   134

    ec_ioctl_domain_fmmu_t fmmu;

   135

    unsigned int dataOffset;

   136

    string indent(doIndent ? "  " : "");

   137

   138

    cout << indent << "Domain" << dec << domain.index << ":"

   139

        << " LogBaseAddr 0x"

   140

        << hex << setfill('0')

   141

        << setw(8) << domain.logical_base_address

   142

        << ", Size " << dec << setfill(' ')

   143

        << setw(3) << domain.data_size

   144

        << ", WorkingCounter "

   145

        << domain.working_counter << "/"

   146

        << domain.expected_working_counter << endl;

   147

   148

    if (!domain.data_size || getVerbosity() != Verbose)

   149

        return;

   150

   151

    processData = new unsigned char[domain.data_size];

   152

   153

    try {

   154

        m.getData(&data, domain.index, domain.data_size, processData);

   155

    } catch (MasterDeviceException &e) {

   156

        delete [] processData;

   157

        throw e;

   158

    }

   159

   160

    for (i = 0; i < domain.fmmu_count; i++) {

   161

        m.getFmmu(&fmmu, domain.index, i);

   162

   163

        cout << indent << "  SlaveConfig "

   164

            << dec << fmmu.slave_config_alias

   165

            << ":" << fmmu.slave_config_position

   166

            << ", SM" << (unsigned int) fmmu.sync_index << " ("

   167

            << setfill(' ') << setw(6)

   168

            << (fmmu.dir == EC_DIR_INPUT ? "Input" : "Output")

   169

            << "), LogAddr 0x"

   170

            << hex << setfill('0')

   171

            << setw(8) << fmmu.logical_address

   172

            << ", Size " << dec << fmmu.data_size << endl;

   173

   174

        dataOffset = fmmu.logical_address - domain.logical_base_address;

   175

        if (dataOffset + fmmu.data_size > domain.data_size) {

   176

            stringstream err;

   177

            delete [] processData;

   178

            err << "Fmmu information corrupted!";

   179

            throwCommandException(err);

   180

        }

   181

   182

        cout << indent << "    " << hex << setfill('0');

   183

        for (j = 0; j < fmmu.data_size; j++) {

   184

            if (j && !(j % BreakAfterBytes))

   185

                cout << endl << indent << "    ";

   186

            cout << "0x" << setw(2)

   187

                << (unsigned int) *(processData + dataOffset + j) << " ";

   188

        }

   189

        cout << endl;

   190

    }

   191

   192

    delete [] processData;

   193

}

   194

   195

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