source: mainline/tools/ew.py@ cd0a38e

ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since cd0a38e was 0436aec, checked in by Jakub Jermář <jakub@…>, 3 years ago

tools/ew.py: Allow to run sun4u with serial console only

  • Property mode set to 100755
File size: 15.1 KB
Line 
1#!/usr/bin/env python3
2#
3# Copyright (c) 2013 Jakub Jermar
4# All rights reserved.
5#
6# Redistribution and use in source and binary forms, with or without
7# modification, are permitted provided that the following conditions
8# are met:
9#
10# - Redistributions of source code must retain the above copyright
11# notice, this list of conditions and the following disclaimer.
12# - Redistributions in binary form must reproduce the above copyright
13# notice, this list of conditions and the following disclaimer in the
14# documentation and/or other materials provided with the distribution.
15# - The name of the author may not be used to endorse or promote products
16# derived from this software without specific prior written permission.
17#
18# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28#
29
30
31"""
32Emulator wrapper for running HelenOS
33"""
34
35import inspect
36import os
37import platform
38import re
39import subprocess
40import sys
41import _thread
42import time
43
44overrides = {}
45
46CONFIG = 'Makefile.config'
47
48TOOLS_DIR = os.path.dirname(inspect.getabsfile(inspect.currentframe()))
49
50def read_config():
51 "Read HelenOS build configuration"
52
53 inf = open(CONFIG, 'r')
54 config = {}
55
56 for line in inf:
57 res = re.match(r'^(?:#!# )?([^#]\w*)\s*=\s*(.*?)\s*$', line)
58 if (res):
59 config[res.group(1)] = res.group(2)
60
61 inf.close()
62 return config
63
64def is_override(str):
65 if str in overrides.keys():
66 return overrides[str]
67 return False
68
69def cfg_get(platform, machine, processor):
70 if machine == "" or "run" in emulators[platform]:
71 return emulators[platform]
72 elif processor == "" or "run" in emulators[platform][machine]:
73 return emulators[platform][machine]
74 else:
75 return emulators[platform][machine][processor]
76
77def termemu_detect():
78 emus = ['gnome-terminal', 'xfce4-terminal', 'xterm']
79 for termemu in emus:
80 try:
81 subprocess.check_output('which ' + termemu, shell = True)
82 return termemu
83 except:
84 pass
85
86 print('Could not find any of the terminal emulators %s.'%(emus))
87 sys.exit(1)
88
89def run_in_console(cmd, title):
90 temu = termemu_detect()
91 if temu == 'gnome-terminal':
92 cmdline = temu + ' -- ' + cmd
93 else:
94 ecmd = cmd.replace('"', '\\"')
95 cmdline = temu + ' -T ' + '"' + title + '"' + ' -e "' + ecmd + '"'
96
97 print(cmdline)
98 if not is_override('dryrun'):
99 subprocess.call(cmdline, shell = True)
100
101def get_host_native_width():
102 return int(platform.architecture()[0].strip('bit'))
103
104def pc_options(guest_width):
105 opts = ''
106
107 # Do not enable KVM if running 64 bits HelenOS
108 # on 32 bits host
109 host_width = get_host_native_width()
110 if guest_width <= host_width and not is_override('nokvm'):
111 opts = opts + ' -enable-kvm'
112
113 # Remove the leading space
114 return opts[1:]
115
116def malta_options():
117 return '-cpu 4Kc -append "console=devices/\\hw\\pci0\\00:0a.0\\com1\\a"'
118
119def find_firmware(name, environ_var, default_paths, extra_info=None):
120 """Find firmware image(s)."""
121
122 if environ_var in os.environ:
123 return os.environ[environ_var]
124
125 for path in default_paths:
126 if os.path.exists(path):
127 return path
128
129 sys.stderr.write("Cannot find %s binary image(s)!\n" % name)
130 sys.stderr.write(
131 "Either set %s environment variable accordingly or place the image(s) in one of the default locations: %s.\n" %
132 (environ_var, ", ".join(default_paths)))
133 if extra_info is not None:
134 sys.stderr.write(extra_info)
135 return None
136
137def platform_to_qemu_options(platform, machine, processor):
138 if platform == 'amd64':
139 return 'system-x86_64', pc_options(64)
140 elif platform == 'arm32':
141 if machine == 'integratorcp':
142 return 'system-arm', '-M integratorcp'
143 elif machine == 'raspberrypi':
144 return 'system-arm', '-M raspi1ap'
145 elif platform == 'arm64':
146 if machine == 'virt':
147 # Search for the EDK2 firmware image
148 default_paths = (
149 '/usr/local/qemu-efi-aarch64/QEMU_EFI.fd', # Custom
150 '/usr/share/edk2/aarch64/QEMU_EFI.fd', # Fedora
151 '/usr/share/qemu-efi-aarch64/QEMU_EFI.fd', # Ubuntu
152 )
153 extra_info = ("Pre-compiled binary can be obtained from "
154 "http://snapshots.linaro.org/components/kernel/leg-virt-tianocore-edk2-upstream/latest/QEMU-AARCH64/RELEASE_GCC5/QEMU_EFI.fd.\n")
155 efi_path = find_firmware(
156 "EDK2", 'EW_QEMU_EFI_AARCH64', default_paths, extra_info)
157 if efi_path is None:
158 raise Exception
159
160 return 'system-aarch64', \
161 '-M virt -cpu cortex-a57 -m 1024 -bios %s' % efi_path
162 elif platform == 'ia32':
163 return 'system-i386', pc_options(32)
164 elif platform == 'mips32':
165 if machine == 'lmalta':
166 return 'system-mipsel', malta_options()
167 elif machine == 'bmalta':
168 return 'system-mips', malta_options()
169 elif platform == 'ppc32':
170 return 'system-ppc', '-m 256'
171 elif platform == 'sparc64':
172 if machine != 'generic':
173 raise Exception
174 if processor == 'us':
175 cmdline = '-M sun4u'
176 if is_override('nographic'):
177 cmdline += ' --prom-env boot-args="console=devices/\\hw\\pci0\\01:01.0\\com1\\a"'
178 return 'system-sparc64', cmdline
179
180 # processor = 'sun4v'
181 opensparc_bins = find_firmware(
182 "OpenSPARC", 'OPENSPARC_BINARIES',
183 ('/usr/local/opensparc/image/', ))
184 if opensparc_bins is None:
185 raise Exception
186
187 return 'system-sparc64', '-M niagara -m 256 -L %s' % (opensparc_bins)
188
189
190def hdisk_mk():
191 if not os.path.exists('hdisk.img'):
192 subprocess.call(TOOLS_DIR + '/mkfat.py 1048576 dist/data hdisk.img', shell = True)
193
194def qemu_bd_options():
195 if is_override('nohdd'):
196 return ''
197
198 hdisk_mk()
199
200 hdd_options = ''
201 if 'hdd' in overrides.keys():
202 if 'ata' in overrides['hdd'].keys():
203 hdd_options += ''
204 elif 'virtio-blk' in overrides['hdd'].keys():
205 hdd_options += ',if=virtio'
206
207 return ' -drive file=hdisk.img,index=0,media=disk,format=raw' + hdd_options
208
209def qemu_nic_ne2k_options():
210 return ' -device ne2k_isa,irq=5,netdev=n1'
211
212def qemu_nic_e1k_options():
213 return ' -device e1000,netdev=n1'
214
215def qemu_nic_rtl8139_options():
216 return ' -device rtl8139,netdev=n1'
217
218def qemu_nic_virtio_options():
219 return ' -device virtio-net,netdev=n1'
220
221def qemu_net_options():
222 if is_override('nonet'):
223 return ''
224
225 nic_options = ''
226 if 'net' in overrides.keys():
227 if 'e1k' in overrides['net'].keys():
228 nic_options += qemu_nic_e1k_options()
229 if 'rtl8139' in overrides['net'].keys():
230 nic_options += qemu_nic_rtl8139_options()
231 if 'ne2k' in overrides['net'].keys():
232 nic_options += qemu_nic_ne2k_options()
233 if 'virtio-net' in overrides['net'].keys():
234 nic_options += qemu_nic_virtio_options()
235 else:
236 # Use the default NIC
237 nic_options += qemu_nic_e1k_options()
238
239 return nic_options + ' -netdev user,id=n1,hostfwd=udp::8080-:8080,hostfwd=udp::8081-:8081,hostfwd=tcp::8080-:8080,hostfwd=tcp::8081-:8081,hostfwd=tcp::2223-:2223'
240
241def qemu_usb_options():
242 if is_override('nousb'):
243 return ''
244 return ' -usb'
245
246def qemu_xhci_options():
247 if is_override('noxhci'):
248 return ''
249 return ' -device nec-usb-xhci,id=xhci'
250
251def qemu_tablet_options():
252 if is_override('notablet') or (is_override('nousb') and is_override('noxhci')):
253 return ''
254 return ' -device usb-tablet'
255
256def qemu_audio_options():
257 if is_override('nosnd'):
258 return ''
259 return ' -device intel-hda -device hda-duplex'
260
261def qemu_run(platform, machine, processor):
262 cfg = cfg_get(platform, machine, processor)
263 suffix, options = platform_to_qemu_options(platform, machine, processor)
264 cmd = 'qemu-' + suffix
265
266 cmdline = cmd
267 if 'qemu_path' in overrides.keys():
268 cmdline = overrides['qemu_path'] + cmd
269
270 if options != '':
271 cmdline += ' ' + options
272
273 if (not 'hdd' in cfg.keys() or cfg['hdd']):
274 cmdline += qemu_bd_options()
275 if (not 'net' in cfg.keys()) or cfg['net']:
276 cmdline += qemu_net_options()
277 if (not 'usb' in cfg.keys()) or cfg['usb']:
278 cmdline += qemu_usb_options()
279 if (not 'xhci' in cfg.keys()) or cfg['xhci']:
280 cmdline += qemu_xhci_options()
281 if (not 'tablet' in cfg.keys()) or cfg['tablet']:
282 cmdline += qemu_tablet_options()
283 if (not 'audio' in cfg.keys()) or cfg['audio']:
284 cmdline += qemu_audio_options()
285
286 console = ('console' in cfg.keys() and cfg['console'])
287
288 if (is_override('nographic')):
289 cmdline += ' -nographic'
290
291 if (not console and (not is_override('nographic')) and not is_override('noserial')):
292 cmdline += ' -serial stdio'
293
294 if (is_override('bigmem')):
295 cmdline += ' -m 4G'
296
297 if cfg['image'] == 'image.iso':
298 cmdline += ' -boot d -cdrom image.iso'
299 elif cfg['image'] == 'image.iso@arm64':
300 # Define image.iso cdrom backend.
301 cmdline += ' -drive if=none,file=image.iso,id=cdrom,media=cdrom'
302 # Define scsi bus.
303 cmdline += ' -device virtio-scsi-device'
304 # Define cdrom frontend connected to this scsi bus.
305 cmdline += ' -device scsi-cd,drive=cdrom'
306 elif cfg['image'] == 'image.boot':
307 cmdline += ' -kernel image.boot'
308 elif cfg['image'] == 'kernel.img@rpi':
309 cmdline += ' -bios boot/image.boot.bin'
310 else:
311 cmdline += ' ' + cfg['image']
312
313 if console:
314 cmdline += ' -nographic'
315
316 title = 'HelenOS/' + platform
317 if machine != '':
318 title += ' on ' + machine
319 if 'expect' in cfg.keys():
320 cmdline = 'expect -c \'spawn %s; expect "%s" { send "%s" } timeout exp_continue; interact\'' % (cmdline, cfg['expect']['src'], cfg['expect']['dst'])
321 run_in_console(cmdline, title)
322 else:
323 print(cmdline)
324 if not is_override('dryrun'):
325 subprocess.call(cmdline, shell = True)
326
327def ski_run(platform, machine, processor):
328 run_in_console('ski -i ' + TOOLS_DIR + '/conf/ski.conf', 'HelenOS/ia64 on ski')
329
330def msim_run(platform, machine, processor):
331 hdisk_mk()
332 run_in_console('msim -c ' + TOOLS_DIR + '/conf/msim.conf', 'HelenOS/mips32 on msim')
333
334def spike_run(platform, machine, processor):
335 run_in_console('spike -m1073741824:1073741824 image.boot', 'HelenOS/risvc64 on Spike')
336
337emulators = {
338 'amd64' : {
339 'run' : qemu_run,
340 'image' : 'image.iso'
341 },
342 'arm32' : {
343 'integratorcp' : {
344 'run' : qemu_run,
345 'image' : 'image.boot',
346 'net' : False,
347 'audio' : False,
348 'xhci' : False,
349 'tablet' : False
350 },
351 'raspberrypi' : {
352 'run' : qemu_run,
353 'image' : 'kernel.img@rpi',
354 'audio' : False,
355 'console' : True,
356 'hdd' : False,
357 'net' : False,
358 'tablet' : False,
359 'usb' : False,
360 'xhci' : False
361 },
362 },
363 'arm64' : {
364 'virt' : {
365 'run' : qemu_run,
366 'image' : 'image.iso@arm64',
367 'audio' : False,
368 'console' : True,
369 'hdd' : False,
370 'net' : False,
371 'tablet' : False,
372 'usb' : False,
373 'xhci' : False
374 }
375 },
376 'ia32' : {
377 'run' : qemu_run,
378 'image' : 'image.iso'
379 },
380 'ia64' : {
381 'ski' : {
382 'run' : ski_run
383 }
384 },
385 'mips32' : {
386 'msim' : {
387 'run' : msim_run
388 },
389 'lmalta' : {
390 'run' : qemu_run,
391 'image' : 'image.boot',
392 'console' : True
393 },
394 'bmalta' : {
395 'run' : qemu_run,
396 'image' : 'image.boot',
397 'console' : True
398 },
399 },
400 'ppc32' : {
401 'run' : qemu_run,
402 'image' : 'image.iso',
403 'audio' : False
404 },
405 'riscv64' : {
406 'run' : spike_run,
407 'image' : 'image.boot'
408 },
409 'sparc64' : {
410 'generic' : {
411 'us' : {
412 'run' : qemu_run,
413 'image' : 'image.iso',
414 'audio' : False,
415 'console' : is_override('nographic'),
416 'net' : False,
417 'usb' : False,
418 'xhci' : False,
419 'tablet' : False
420 },
421 'sun4v' : {
422 'run' : qemu_run,
423 'image' : '-drive if=pflash,readonly=on,file=image.iso',
424 'audio' : False,
425 'console' : True,
426 'net' : False,
427 'usb' : False,
428 'xhci' : False,
429 'tablet' : False,
430 'expect' : {
431 'src' : 'ok ',
432 'dst' : 'boot\n'
433 },
434 }
435 }
436 },
437}
438
439def usage():
440 print("%s - emulator wrapper for running HelenOS\n" % os.path.basename(sys.argv[0]))
441 print("%s [-d] [-h] [-net e1k|rtl8139|ne2k|virtio-net] [-hdd ata|virtio-blk] [-nohdd] [-nokvm] [-nonet] [-nosnd] [-nousb] [-noxhci] [-notablet]\n" %
442 os.path.basename(sys.argv[0]))
443 print("-d\tDry run: do not run the emulation, just print the command line.")
444 print("-h\tPrint the usage information and exit.")
445 print("-nohdd\tDisable hard disk, if applicable.")
446 print("-nokvm\tDisable KVM, if applicable.")
447 print("-nonet\tDisable networking support, if applicable.")
448 print("-nosnd\tDisable sound, if applicable.")
449 print("-nousb\tDisable USB support, if applicable.")
450 print("-noxhci\tDisable XHCI support, if applicable.")
451 print("-notablet\tDisable USB tablet (use only relative-position PS/2 mouse instead), if applicable.")
452 print("-nographic\tDisable graphical output. Serial port output must be enabled for this to be useful.")
453 print("-noserial\tDisable serial port output in the terminal.")
454 print("-bigmem\tSets maximum RAM size to 4GB.")
455
456def fail(platform, machine):
457 print("Cannot start emulation for the chosen configuration. (%s/%s)" % (platform, machine))
458
459
460def run():
461 expect_nic = False
462 expect_hdd = False
463 expect_qemu = False
464
465 for i in range(1, len(sys.argv)):
466
467 if expect_nic:
468 expect_nic = False
469 if not 'net' in overrides.keys():
470 overrides['net'] = {}
471 if sys.argv[i] == 'e1k':
472 overrides['net']['e1k'] = True
473 elif sys.argv[i] == 'rtl8139':
474 overrides['net']['rtl8139'] = True
475 elif sys.argv[i] == 'ne2k':
476 overrides['net']['ne2k'] = True
477 elif sys.argv[i] == 'virtio-net':
478 overrides['net']['virtio-net'] = True
479 else:
480 usage()
481 exit()
482 continue
483
484 if expect_hdd:
485 expect_hdd = False
486 if not 'hdd' in overrides.keys():
487 overrides['hdd'] = {}
488 if sys.argv[i] == 'ata':
489 overrides['hdd']['ata'] = True
490 elif sys.argv[i] == 'virtio-blk':
491 overrides['hdd']['virtio-blk'] = True
492 else:
493 usage()
494 exit()
495 continue
496
497 if expect_qemu:
498 expect_qemu = False
499 overrides['qemu_path'] = sys.argv[i]
500
501 elif sys.argv[i] == '-h':
502 usage()
503 exit()
504 elif sys.argv[i] == '-d':
505 overrides['dryrun'] = True
506 elif sys.argv[i] == '-net' and i < len(sys.argv) - 1:
507 expect_nic = True
508 elif sys.argv[i] == '-hdd' and i < len(sys.argv) - 1:
509 expect_hdd = True
510 elif sys.argv[i] == '-nohdd':
511 overrides['nohdd'] = True
512 elif sys.argv[i] == '-nokvm':
513 overrides['nokvm'] = True
514 elif sys.argv[i] == '-nonet':
515 overrides['nonet'] = True
516 elif sys.argv[i] == '-nosnd':
517 overrides['nosnd'] = True
518 elif sys.argv[i] == '-nousb':
519 overrides['nousb'] = True
520 elif sys.argv[i] == '-noxhci':
521 overrides['noxhci'] = True
522 elif sys.argv[i] == '-notablet':
523 overrides['notablet'] = True
524 elif sys.argv[i] == '-nographic':
525 overrides['nographic'] = True
526 elif sys.argv[i] == '-bigmem':
527 overrides['bigmem'] = True
528 elif sys.argv[i] == '-noserial':
529 overrides['noserial'] = True
530 elif sys.argv[i] == '-qemu_path' and i < len(sys.argv) - 1:
531 expect_qemu = True
532 else:
533 usage()
534 exit()
535
536 config = read_config()
537
538 if 'PLATFORM' in config.keys():
539 platform = config['PLATFORM']
540 else:
541 platform = ''
542
543 if 'MACHINE' in config.keys():
544 mach = config['MACHINE']
545 else:
546 mach = ''
547
548 if 'PROCESSOR' in config.keys():
549 processor = config['PROCESSOR']
550 else:
551 processor = ''
552
553 try:
554 emu_run = cfg_get(platform, mach, processor)['run']
555 emu_run(platform, mach, processor)
556 except:
557 fail(platform, mach)
558 return
559
560run()
Note: See TracBrowser for help on using the repository browser.