1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
|
"""
mbed SDK
Copyright (c) 2011-2016 ARM Limited
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Author: Przemyslaw Wirkus <Przemyslaw.Wirkus@arm.com>
"""
"""! @package mbed-host-tests
Flash, reset and perform host supervised tests on mbed platforms.
Write your own programs (import this package) or use 'mbedhtrun' command line tool instead.
"""
import os
import imp
import inspect
from os import listdir
from os.path import isfile, join, abspath, basename
import sys
from optparse import OptionParser
from optparse import SUPPRESS_HELP
from mbed_host_tests import host_tests_plugins
from mbed_host_tests.host_tests_registry import HostRegistry
from mbed_host_tests.host_tests import BaseHostTest, event_callback
# Set the default baud rate
DEFAULT_BAUD_RATE = 9600
###############################################################################
# Functional interface for test supervisor registry
###############################################################################
def get_plugin_caps(methods=None):
if not methods:
methods = ['CopyMethod', 'ResetMethod']
result = {}
for method in methods:
result[method] = host_tests_plugins.get_plugin_caps(method)
return result
def init_host_test_cli_params():
"""! Function creates CLI parser object and returns populated options object.
@return Function returns 'options' object returned from OptionParser class
@details Options object later can be used to populate host test selector script.
"""
parser = OptionParser()
parser.add_option("-m", "--micro",
dest="micro",
help="Target microcontroller name",
metavar="MICRO")
parser.add_option("-p", "--port",
dest="port",
help="Serial port of the target",
metavar="PORT")
parser.add_option("-d", "--disk",
dest="disk",
help="Target disk (mount point) path",
metavar="DISK_PATH")
parser.add_option("-t", "--target-id",
dest="target_id",
help="Unique Target Id or mbed platform",
metavar="TARGET_ID")
parser.add_option("", "--sync",
dest="sync_behavior",
default=2,
type=int,
help="Define how many times __sync packet will be sent to device: 0: none; -1: forever; 1,2,3... - number of times (Default 2 time)",
metavar="SYNC_BEHAVIOR")
parser.add_option("", "--sync-timeout",
dest="sync_timeout",
default=5,
type=int,
help="Define delay in seconds between __sync packet (Default is 5 seconds)",
metavar="SYNC_TIMEOUT")
parser.add_option("-f", "--image-path",
dest="image_path",
help="Path with target's binary image",
metavar="IMAGE_PATH")
copy_methods_str = "Plugin support: " + ', '.join(host_tests_plugins.get_plugin_caps('CopyMethod'))
parser.add_option("-c", "--copy",
dest="copy_method",
help="Copy (flash the target) method selector. " + copy_methods_str,
metavar="COPY_METHOD")
parser.add_option("", "--retry-copy",
dest="retry_copy",
default=3,
type=int,
help="Number of attempts to flash the target",
metavar="RETRY_COPY")
parser.add_option("", "--tag-filters",
dest="tag_filters",
default="",
type=str,
help="Comma seperated list of device tags used when allocating a target to specify required hardware or attributes [--tag-filters tag1,tag2]",
metavar="TAG_FILTERS")
reset_methods_str = "Plugin support: " + ', '.join(host_tests_plugins.get_plugin_caps('ResetMethod'))
parser.add_option("-r", "--reset",
dest="forced_reset_type",
help="Forces different type of reset. " + reset_methods_str)
parser.add_option("-C", "--program_cycle_s",
dest="program_cycle_s",
default=4,
help="Program cycle sleep. Define how many seconds you want wait after copying binary onto target (Default is 4 second)",
type="float",
metavar="PROGRAM_CYCLE_S")
parser.add_option("-R", "--reset-timeout",
dest="forced_reset_timeout",
default=1,
metavar="NUMBER",
type="float",
help="When forcing a reset using option -r you can set up after reset idle delay in seconds (Default is 1 second)")
parser.add_option("--process-start-timeout",
dest="process_start_timeout",
default=60,
metavar="NUMBER",
type="float",
help="This sets the maximum time in seconds to wait for an internal process to start. This mostly only affects machines under heavy load (Default is 60 seconds)")
parser.add_option("-e", "--enum-host-tests",
dest="enum_host_tests",
action="append",
default=["./test/host_tests"],
help="Define directory with local host tests")
parser.add_option('', '--test-cfg',
dest='json_test_configuration',
help='Pass to host test class data about host test configuration')
parser.add_option('', '--list',
dest='list_reg_hts',
default=False,
action="store_true",
help='Prints registered host test and exits')
parser.add_option('', '--plugins',
dest='list_plugins',
default=False,
action="store_true",
help='Prints registered plugins and exits')
parser.add_option('-g', '--grm',
dest='global_resource_mgr',
help='[Experimental] Global resource manager service module name, IP and port, example remote_client:10.2.123.43:3334')
# Show --fm option only if "fm_agent" module installed
try:
imp.find_module('fm_agent')
except ImportError:
fm_help=SUPPRESS_HELP
else:
fm_help='Fast Model connection, This option requires mbed-fastmodel-agent module installed, list CONFIGs via "mbedfm"'
parser.add_option('', '--fm',
dest='fast_model_connection',
metavar="CONFIG",
default=None,
help=fm_help)
parser.add_option('', '--run',
dest='run_binary',
default=False,
action="store_true",
help='Runs binary image on target (workflow: flash, reset, output console)')
parser.add_option('', '--skip-flashing',
dest='skip_flashing',
default=False,
action="store_true",
help='Skips use of copy/flash plugin. Note: target will not be reflashed')
parser.add_option('', '--skip-reset',
dest='skip_reset',
default=False,
action="store_true",
help='Skips use of reset plugin. Note: target will not be reset')
parser.add_option('-P', '--polling-timeout',
dest='polling_timeout',
default=60,
metavar="NUMBER",
type="int",
help='Timeout in sec for readiness of mount point and serial port of local or remote device. Default 60 sec')
parser.add_option('-b', '--send-break',
dest='send_break_cmd',
default=False,
action="store_true",
help='Send reset signal to board on specified port (-p PORT) and print serial output. You can combine this with (-r RESET_TYPE) switch')
parser.add_option('', '--baud-rate',
dest='baud_rate',
help="Baud rate of target, overrides values from mbed-ls, disk/mount point (-d, --disk-path), and serial port -p <port>:<baud rate>",
metavar="BAUD_RATE")
parser.add_option('-v', '--verbose',
dest='verbose',
default=False,
action="store_true",
help='More verbose mode')
parser.add_option('', '--serial-output-file',
dest='serial_output_file',
default=None,
help='Save target serial output to this file.')
parser.add_option('', '--compare-log',
dest='compare_log',
default=None,
help='Log file to compare with the serial output from target.')
parser.add_option('', '--version',
dest='version',
default=False,
action="store_true",
help='Prints package version and exits')
parser.description = """Flash, reset and perform host supervised tests on mbed platforms"""
parser.epilog = """Example: mbedhtrun -d E: -p COM5 -f "test.bin" -C 4 -c shell -m K64F"""
(options, _) = parser.parse_args()
if len(sys.argv) == 1:
parser.print_help()
sys.exit()
return options
|
