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 <map>

    32

using namespace std;

    33

    34

#include "CommandGraph.h"

    35

#include "MasterDevice.h"

    36

    37

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

    38

    39

CommandGraph::CommandGraph():

    40

    Command("graph", "Output the bus topology as a graph.")

    41

{

    42

}

    43

    44

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

    45

    46

string CommandGraph::helpString(const string &binaryBaseName) const

    47

{

    48

    stringstream str;

    49

    50

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

    51

        << endl

    52

        << getBriefDescription() << endl

    53

        << endl

    54

        << "The bus is output in DOT language (see" << endl

    55

        << "http://www.graphviz.org/doc/info/lang.html), which can" << endl

    56

        << "be processed with the tools from the Graphviz" << endl

    57

        << "package. Example:" << endl

    58

        << endl

    59

        << "  ethercat graph | dot -Tsvg > bus.svg" << endl

    60

        << endl

    61

        << "See 'man dot' for more information." << endl;

    62

    63

    return str.str();

    64

}

    65

    66

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

    67

    68

void CommandGraph::execute(const StringVector &args)

    69

{

    70

    ec_ioctl_master_t master;

    71

    unsigned int i;

    72

    typedef vector<ec_ioctl_slave_t> SlaveVector;

    73

    SlaveVector slaves;

    74

    ec_ioctl_slave_t slave;

    75

    SlaveVector::const_iterator si;

    76

    map<int, string> portMedia;

    77

    map<int, string>::const_iterator mi;

    78

    map<int, int> mediaWeights;

    79

    map<int, int>::const_iterator wi;

    80

    81

    portMedia[EC_PORT_MII] = "MII";

    82

    mediaWeights[EC_PORT_MII] = 1;

    83

    84

    portMedia[EC_PORT_EBUS] = "EBUS";

    85

    mediaWeights[EC_PORT_EBUS] = 5;

    86

    87

    if (args.size()) {

    88

        stringstream err;

    89

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

    90

        throwInvalidUsageException(err);

    91

    }

    92

    93

    MasterDevice m(getSingleMasterIndex());

    94

    m.open(MasterDevice::Read);

    95

    m.getMaster(&master);

    96

    97

    for (i = 0; i < master.slave_count; i++) {

    98

        m.getSlave(&slave, i);

    99

        slaves.push_back(slave);

   100

    }

   101

   102

    cout << "/* EtherCAT bus graph. Generated by 'ethercat graph'. */" << endl

   103

        << endl

   104

        << "strict graph bus {" << endl

   105

        << "    rankdir=\"LR\"" << endl

   106

        << "    ranksep=0.8" << endl

   107

        << "    nodesep=0.8" << endl

   108

        << "    node [fontname=\"Helvetica\"]" << endl

   109

        << "    edge [fontname=\"Helvetica\",fontsize=\"10\"]" << endl

   110

        << endl

   111

        << "    master [label=\"EtherCAT\\nMaster\"]" << endl;

   112

   113

    if (slaves.size()) {

   114

        cout << "    master -- slave0";

   115

        mi = portMedia.find(slaves.front().ports[0].desc);

   116

        if (mi != portMedia.end())

   117

            cout << "[label=\"" << mi->second << "\"]";

   118

   119

        cout << endl;

   120

    }

   121

    cout << endl;

   122

   123

    for (si = slaves.begin(); si != slaves.end(); si++) {

   124

        cout << "    slave" << si->position << " [shape=\"box\""

   125

            << ",label=\"" << si->position;

   126

        if (string(si->order).size())

   127

            cout << "\\n" << si->order;

   128

        if (si->dc_supported) {

   129

            cout << "\\nDC: ";

   130

            if (si->has_dc_system_time) {

   131

                switch (si->dc_range) {

   132

                    case EC_DC_32:

   133

                        cout << "32 bit";

   134

                        break;

   135

                    case EC_DC_64:

   136

                        cout << "64 bit";

   137

                        break;

   138

                    default:

   139

                        break;

   140

                }

   141

            } else {

   142

                cout << "Delay meas.";

   143

            }

   144

            cout << "\\nDelay: " << si->transmission_delay << " ns";

   145

        }

   146

        cout << "\"]" << endl;

   147

   148

        for (i = 1; i < EC_MAX_PORTS; i++) {

   149

            uint16_t next_pos = si->ports[i].next_slave;

   150

            ec_ioctl_slave_t *next = NULL;

   151

   152

            if (next_pos == 0xffff)

   153

                continue;

   154

   155

            if (next_pos < slaves.size()) {

   156

                next = &slaves[next_pos];

   157

            } else {

   158

                cerr << "Invalid next slave pointer." << endl;

   159

            }

   160

   161

            cout << "    slave" << si->position << " -- "

   162

                << "slave" << next_pos << " [taillabel=\"" << i;

   163

   164

            if (si->dc_supported) {

   165

                cout << " [" << si->ports[i].delay_to_next_dc << "]";

   166

            }

   167

            cout << "\",headlabel=\"0";

   168

   169

            if (next && next->dc_supported) {

   170

                cout << " [" << next->ports[0].delay_to_next_dc << "]";

   171

            }

   172

            cout << "\"";

   173

   174

            mi = portMedia.find(si->ports[i].desc);

   175

            if (mi == portMedia.end() && next) {

   176

                /* Try medium of next-hop slave. */

   177

                mi = portMedia.find(next->ports[0].desc);

   178

            }

   179

   180

            if (mi != portMedia.end())

   181

                cout << ",label=\"" << mi->second << "\"";

   182

   183

            wi = mediaWeights.find(si->ports[i].desc);

   184

            if (wi != mediaWeights.end())

   185

                cout << ",weight=\"" << wi->second << "\"";

   186

   187

            cout << "]" << endl;

   188

        }

   189

   190

        cout << endl;

   191

    }

   192

   193

    cout << "}" << endl;

   194

}

   195

   196

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