author | Florian Pose <fp@igh-essen.com> |
Wed, 06 Jul 2011 16:37:40 +0200 | |
branch | redundancy |
changeset 2133 | 74dbd0b7d6aa |
parent 1968 | 4f682084c643 |
permissions | -rw-r--r-- |
1142 | 1 |
/***************************************************************************** |
2 |
* |
|
1363
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
3 |
* $Id$ |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
4 |
* |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
5 |
* Copyright (C) 2006-2009 Florian Pose, Ingenieurgemeinschaft IgH |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
6 |
* |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
7 |
* This file is part of the IgH EtherCAT Master. |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
8 |
* |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
9 |
* The IgH EtherCAT Master is free software; you can redistribute it and/or |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
10 |
* modify it under the terms of the GNU General Public License version 2, as |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
11 |
* published by the Free Software Foundation. |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
12 |
* |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
13 |
* The IgH EtherCAT Master is distributed in the hope that it will be useful, |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
14 |
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
15 |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
16 |
* Public License for more details. |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
17 |
* |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
18 |
* You should have received a copy of the GNU General Public License along |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
19 |
* with the IgH EtherCAT Master; if not, write to the Free Software |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
20 |
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
21 |
* |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
22 |
* --- |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
23 |
* |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
24 |
* The license mentioned above concerns the source code only. Using the |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
25 |
* EtherCAT technology and brand is only permitted in compliance with the |
11c0b2caa253
Improved and added license headers.
Florian Pose <fp@igh-essen.com>
parents:
1334
diff
changeset
|
26 |
* industrial property and similar rights of Beckhoff Automation GmbH. |
1142 | 27 |
* |
28 |
****************************************************************************/ |
|
29 |
||
30 |
#include <iostream> |
|
31 |
#include <iomanip> |
|
32 |
using namespace std; |
|
33 |
||
34 |
#include "CommandUpload.h" |
|
1826
ec6223c3b7ec
Multi-master support for command-line tool. The --master option supports
Florian Pose <fp@igh-essen.com>
parents:
1804
diff
changeset
|
35 |
#include "MasterDevice.h" |
1142 | 36 |
|
37 |
/*****************************************************************************/ |
|
38 |
||
39 |
CommandUpload::CommandUpload(): |
|
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
40 |
SdoCommand("upload", "Read an SDO entry from a slave.") |
1142 | 41 |
{ |
42 |
} |
|
43 |
||
44 |
/*****************************************************************************/ |
|
45 |
||
1968
4f682084c643
Implemented drive_no for command-line tool; binary base name is now a
Florian Pose <fp@igh-essen.com>
parents:
1870
diff
changeset
|
46 |
string CommandUpload::helpString(const string &binaryBaseName) const |
1142 | 47 |
{ |
48 |
stringstream str; |
|
49 |
||
1968
4f682084c643
Implemented drive_no for command-line tool; binary base name is now a
Florian Pose <fp@igh-essen.com>
parents:
1870
diff
changeset
|
50 |
str << binaryBaseName << " " << getName() |
4f682084c643
Implemented drive_no for command-line tool; binary base name is now a
Florian Pose <fp@igh-essen.com>
parents:
1870
diff
changeset
|
51 |
<< " [OPTIONS] <INDEX> <SUBINDEX>" << endl |
1142 | 52 |
<< endl |
53 |
<< getBriefDescription() << endl |
|
54 |
<< endl |
|
1157
04d1c950cf9d
Added --help for alias and position parameters.
Florian Pose <fp@igh-essen.com>
parents:
1155
diff
changeset
|
55 |
<< "This command requires a single slave to be selected." << endl |
1804 | 56 |
<< endl |
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
57 |
<< "The data type of the SDO entry is taken from the SDO" << endl |
1142 | 58 |
<< "dictionary by default. It can be overridden with the" << endl |
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
59 |
<< "--type option. If the slave does not support the SDO" << endl |
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
60 |
<< "information service or the SDO is not in the dictionary," << endl |
1142 | 61 |
<< "the --type option is mandatory." << endl |
62 |
<< endl |
|
1868
489ea0becd74
Implemented SoE IDN parser for strings like 'P-0-0150'; moved data type
Florian Pose <fp@igh-essen.com>
parents:
1835
diff
changeset
|
63 |
<< typeInfo() |
1142 | 64 |
<< endl |
65 |
<< "Arguments:" << endl |
|
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
66 |
<< " INDEX is the SDO index and must be an unsigned" << endl |
1142 | 67 |
<< " 16 bit number." << endl |
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
68 |
<< " SUBINDEX is the SDO entry subindex and must be an" << endl |
1142 | 69 |
<< " unsigned 8 bit number." << endl |
70 |
<< endl |
|
71 |
<< "Command-specific options:" << endl |
|
1157
04d1c950cf9d
Added --help for alias and position parameters.
Florian Pose <fp@igh-essen.com>
parents:
1155
diff
changeset
|
72 |
<< " --alias -a <alias>" << endl |
04d1c950cf9d
Added --help for alias and position parameters.
Florian Pose <fp@igh-essen.com>
parents:
1155
diff
changeset
|
73 |
<< " --position -p <pos> Slave selection. See the help of" << endl |
04d1c950cf9d
Added --help for alias and position parameters.
Florian Pose <fp@igh-essen.com>
parents:
1155
diff
changeset
|
74 |
<< " the 'slaves' command." << endl |
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
75 |
<< " --type -t <type> SDO entry data type (see above)." << endl |
1142 | 76 |
<< endl |
77 |
<< numericInfo(); |
|
78 |
||
79 |
return str.str(); |
|
80 |
} |
|
81 |
||
82 |
/****************************************************************************/ |
|
83 |
||
1826
ec6223c3b7ec
Multi-master support for command-line tool. The --master option supports
Florian Pose <fp@igh-essen.com>
parents:
1804
diff
changeset
|
84 |
void CommandUpload::execute(const StringVector &args) |
1142 | 85 |
{ |
1151 | 86 |
SlaveList slaves; |
1142 | 87 |
stringstream err, strIndex, strSubIndex; |
88 |
ec_ioctl_slave_sdo_upload_t data; |
|
1393
979a7b26036d
Output (fixed-size) hex value before decimal value.
Florian Pose <fp@igh-essen.com>
parents:
1363
diff
changeset
|
89 |
const DataType *dataType = NULL; |
1142 | 90 |
unsigned int uval; |
91 |
||
92 |
if (args.size() != 2) { |
|
93 |
err << "'" << getName() << "' takes two arguments!"; |
|
94 |
throwInvalidUsageException(err); |
|
95 |
} |
|
96 |
||
97 |
strIndex << args[0]; |
|
98 |
strIndex |
|
99 |
>> resetiosflags(ios::basefield) // guess base from prefix |
|
100 |
>> data.sdo_index; |
|
101 |
if (strIndex.fail()) { |
|
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
102 |
err << "Invalid SDO index '" << args[0] << "'!"; |
1142 | 103 |
throwInvalidUsageException(err); |
104 |
} |
|
105 |
||
106 |
strSubIndex << args[1]; |
|
107 |
strSubIndex |
|
108 |
>> resetiosflags(ios::basefield) // guess base from prefix |
|
109 |
>> uval; |
|
110 |
if (strSubIndex.fail() || uval > 0xff) { |
|
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
111 |
err << "Invalid SDO subindex '" << args[1] << "'!"; |
1142 | 112 |
throwInvalidUsageException(err); |
113 |
} |
|
114 |
data.sdo_entry_subindex = uval; |
|
115 |
||
1870
0cee1fb7f0fd
Added getSingleMasterIndex() for command-line tool.
Florian Pose <fp@igh-essen.com>
parents:
1869
diff
changeset
|
116 |
MasterDevice m(getSingleMasterIndex()); |
1151 | 117 |
m.open(MasterDevice::Read); |
118 |
slaves = selectedSlaves(m); |
|
119 |
if (slaves.size() != 1) { |
|
1155
bd4e5b544473
Common message for single slave selections.
Florian Pose <fp@igh-essen.com>
parents:
1151
diff
changeset
|
120 |
throwSingleSlaveRequired(slaves.size()); |
1151 | 121 |
} |
122 |
data.slave_position = slaves.front().position; |
|
123 |
||
1166 | 124 |
if (!getDataType().empty()) { // data type specified |
125 |
if (!(dataType = findDataType(getDataType()))) { |
|
126 |
err << "Invalid data type '" << getDataType() << "'!"; |
|
1142 | 127 |
throwInvalidUsageException(err); |
128 |
} |
|
129 |
} else { // no data type specified: fetch from dictionary |
|
130 |
ec_ioctl_slave_sdo_entry_t entry; |
|
131 |
||
132 |
try { |
|
1151 | 133 |
m.getSdoEntry(&entry, data.slave_position, |
1142 | 134 |
data.sdo_index, data.sdo_entry_subindex); |
135 |
} catch (MasterDeviceException &e) { |
|
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
136 |
err << "Failed to determine SDO entry data type. " |
1142 | 137 |
<< "Please specify --type."; |
138 |
throwCommandException(err); |
|
139 |
} |
|
140 |
if (!(dataType = findDataType(entry.data_type))) { |
|
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
141 |
err << "PDO entry has unknown data type 0x" |
1142 | 142 |
<< hex << setfill('0') << setw(4) << entry.data_type << "!" |
143 |
<< " Please specify --type."; |
|
144 |
throwCommandException(err); |
|
145 |
} |
|
146 |
} |
|
147 |
||
148 |
if (dataType->byteSize) { |
|
149 |
data.target_size = dataType->byteSize; |
|
150 |
} else { |
|
151 |
data.target_size = DefaultBufferSize; |
|
152 |
} |
|
153 |
||
154 |
data.target = new uint8_t[data.target_size + 1]; |
|
155 |
||
1804 | 156 |
try { |
157 |
m.sdoUpload(&data); |
|
158 |
} catch (MasterDeviceSdoAbortException &e) { |
|
1184
75cd6681eb08
Introduced SdoCommand class to replace coe_datatypes.[ch]; added CoE abort codes in user space-
Florian Pose <fp@igh-essen.com>
parents:
1166
diff
changeset
|
159 |
delete [] data.target; |
1327
4d179b06dd3c
merge -c1604 branches/stable-1.4: Fixed spelling of EtherCAT terms.
Florian Pose <fp@igh-essen.com>
parents:
1254
diff
changeset
|
160 |
err << "SDO transfer aborted with code 0x" |
1184
75cd6681eb08
Introduced SdoCommand class to replace coe_datatypes.[ch]; added CoE abort codes in user space-
Florian Pose <fp@igh-essen.com>
parents:
1166
diff
changeset
|
161 |
<< setfill('0') << hex << setw(8) << e.abortCode |
75cd6681eb08
Introduced SdoCommand class to replace coe_datatypes.[ch]; added CoE abort codes in user space-
Florian Pose <fp@igh-essen.com>
parents:
1166
diff
changeset
|
162 |
<< ": " << abortText(e.abortCode); |
75cd6681eb08
Introduced SdoCommand class to replace coe_datatypes.[ch]; added CoE abort codes in user space-
Florian Pose <fp@igh-essen.com>
parents:
1166
diff
changeset
|
163 |
throwCommandException(err); |
1804 | 164 |
} catch (MasterDeviceException &e) { |
1142 | 165 |
delete [] data.target; |
166 |
throw e; |
|
167 |
} |
|
168 |
||
169 |
m.close(); |
|
170 |
||
1835
20748e9d2238
Sourced out data type handling into an own class.
Florian Pose <fp@igh-essen.com>
parents:
1826
diff
changeset
|
171 |
try { |
20748e9d2238
Sourced out data type handling into an own class.
Florian Pose <fp@igh-essen.com>
parents:
1826
diff
changeset
|
172 |
outputData(cout, dataType, data.target, data.data_size); |
20748e9d2238
Sourced out data type handling into an own class.
Florian Pose <fp@igh-essen.com>
parents:
1826
diff
changeset
|
173 |
} catch (SizeException &e) { |
20748e9d2238
Sourced out data type handling into an own class.
Florian Pose <fp@igh-essen.com>
parents:
1826
diff
changeset
|
174 |
delete [] data.target; |
20748e9d2238
Sourced out data type handling into an own class.
Florian Pose <fp@igh-essen.com>
parents:
1826
diff
changeset
|
175 |
throwCommandException(e.what()); |
1142 | 176 |
} |
177 |
||
178 |
delete [] data.target; |
|
179 |
} |
|
180 |
||
181 |
/*****************************************************************************/ |