switch to host, primary, or over-arching as appropriate
Signed-off-by: Scott Johnson <scottdj@google.com>
diff --git a/util/dvsim/FlowCfg.py b/util/dvsim/FlowCfg.py
index fec3c46..64ac88d 100644
--- a/util/dvsim/FlowCfg.py
+++ b/util/dvsim/FlowCfg.py
@@ -51,15 +51,15 @@
# are overridden with the override values.
self.overrides = []
- # List of cfgs if the parsed cfg is a master cfg list
+ # List of cfgs if the parsed cfg is a primary cfg list
self.cfgs = []
- # Add a notion of "master" cfg - this is indicated using
+ # Add a notion of "primary" cfg - this is indicated using
# a special key 'use_cfgs' within the hjson cfg.
- self.is_master_cfg = False
+ self.is_primary_cfg = False
- # For a master cfg, it is the aggregated list of all deploy objects under self.cfgs.
- # For a non-master cfg, it is the list of items slated for dispatch.
+ # For a primary cfg, it is the aggregated list of all deploy objects under self.cfgs.
+ # For a non-primary cfg, it is the list of items slated for dispatch.
self.deploy = []
# Timestamp
@@ -97,7 +97,7 @@
def __post_init__(self):
# Run some post init checks
- if not self.is_master_cfg:
+ if not self.is_primary_cfg:
# Check if self.cfgs is a list of exactly 1 item (self)
if not (len(self.cfgs) == 1 and self.cfgs[0].name == self.name):
log.error("Parse error!\n%s", self.cfgs)
@@ -129,12 +129,12 @@
'''
hjson_dict = parse_hjson(flow_cfg_file)
- # Check if this is the master cfg, if this is the entry point cfg file
+ # Check if this is the primary cfg, if this is the entry point cfg file
if is_entry_point:
- self.is_master_cfg = self.check_if_master_cfg(hjson_dict)
+ self.is_primary_cfg = self.check_if_primary_cfg(hjson_dict)
- # If not a master cfg, then register self with self.cfgs
- if self.is_master_cfg is False:
+ # If not a primary cfg, then register self with self.cfgs
+ if self.is_primary_cfg is False:
self.cfgs.append(self)
# Resolve the raw hjson dict to build this object
@@ -148,8 +148,8 @@
self.rel_path = os.path.dirname(self.flow_cfg_file).replace(
self.proj_root + '/', '')
- def check_if_master_cfg(self, hjson_dict):
- # This is a master cfg only if it has a single key called "use_cfgs"
+ def check_if_primary_cfg(self, hjson_dict):
+ # This is a primary cfg only if it has a single key called "use_cfgs"
# which contains a list of actual flow cfgs.
hjson_cfg_dict_keys = hjson_dict.keys()
return ("use_cfgs" in hjson_cfg_dict_keys and type(hjson_dict["use_cfgs"]) is list)
@@ -226,15 +226,15 @@
import_cfgs.extend(hjson_dict[key])
rm_hjson_dict_keys.append(key)
- # If this is a master cfg list and the key is 'use_cfgs'
- elif self.is_master_cfg and key == "use_cfgs":
+ # If this is a primary cfg list and the key is 'use_cfgs'
+ elif self.is_primary_cfg and key == "use_cfgs":
use_cfgs.extend(hjson_dict[key])
- # If this is a not master cfg list and the key is 'use_cfgs'
- elif not self.is_master_cfg and key == "use_cfgs":
+ # If this is a not primary cfg list and the key is 'use_cfgs'
+ elif not self.is_primary_cfg and key == "use_cfgs":
# Throw an error and exit
log.error(
- "Key \"use_cfgs\" encountered in a non-master cfg file list \"%s\"",
+ "Key \"use_cfgs\" encountered in a non-primary cfg file list \"%s\"",
self.flow_cfg_file)
sys.exit(1)
@@ -254,8 +254,8 @@
else:
log.error("Cfg file \"%s\" has already been parsed", cfg_file)
- # Parse master cfg files
- if self.is_master_cfg:
+ # Parse primary cfg files
+ if self.is_primary_cfg:
for entry in use_cfgs:
if type(entry) is str:
# Treat this as a file entry
@@ -290,10 +290,10 @@
def _conv_inline_cfg_to_hjson(self, idict):
'''Dump a temp hjson file in the scratch space from input dict.
- This method is to be called only by a master cfg'''
+ This method is to be called only by a primary cfg'''
- if not self.is_master_cfg:
- log.fatal("This method can only be called by a master cfg")
+ if not self.is_primary_cfg:
+ log.fatal("This method can only be called by a primary cfg")
sys.exit(1)
name = idict["name"] if "name" in idict.keys() else None
@@ -412,7 +412,7 @@
item._print_list()
def prune_selected_cfgs(self):
- '''Prune the list of configs for a master config file'''
+ '''Prune the list of configs for a primary config file'''
# This should run after self.cfgs has been set
assert self.cfgs
@@ -421,10 +421,10 @@
if self.select_cfgs is None:
return
- # If the user passed --select-cfgs, but this isn't a master config
+ # If the user passed --select-cfgs, but this isn't a primary config
# file, we should probably complain.
- if not self.is_master_cfg:
- log.error('The configuration file at {!r} is not a master config, '
+ if not self.is_primary_cfg:
+ log.error('The configuration file at {!r} is not a primary config, '
'but --select-cfgs was passed on the command line.'
.format(self.flow_cfg_file))
sys.exit(1)
@@ -443,7 +443,7 @@
'''Public facing API for _create_deploy_objects().
'''
self.prune_selected_cfgs()
- if self.is_master_cfg:
+ if self.is_primary_cfg:
self.deploy = []
for item in self.cfgs:
item._create_deploy_objects()
@@ -475,7 +475,7 @@
results.append(result)
self.errors_seen |= item.errors_seen
- if self.is_master_cfg:
+ if self.is_primary_cfg:
self.gen_results_summary()
self.gen_email_html_summary()
@@ -492,7 +492,7 @@
return "[%s](%s)" % (link_text, results_page_url)
def gen_email_html_summary(self):
- if self.is_master_cfg:
+ if self.is_primary_cfg:
# user can customize email content by using email_summary_md,
# otherwise default to send out results_summary_md
gen_results = self.email_summary_md or self.results_summary_md
@@ -651,7 +651,7 @@
for item in self.cfgs:
item._publish_results()
- if self.is_master_cfg:
+ if self.is_primary_cfg:
self.publish_results_summary()
def publish_results_summary(self):
diff --git a/util/dvsim/LintCfg.py b/util/dvsim/LintCfg.py
index 6cb895c..f28e14f 100644
--- a/util/dvsim/LintCfg.py
+++ b/util/dvsim/LintCfg.py
@@ -107,7 +107,7 @@
# parsing script that transforms the tool output into the hjson above
# needs to be adapted.
#
- # note that if this is a master config, the results will
+ # note that if this is a primary config, the results will
# be generated using the _gen_results_summary function
# '''
diff --git a/util/dvsim/OneShotCfg.py b/util/dvsim/OneShotCfg.py
index 578ba47..d574133 100644
--- a/util/dvsim/OneShotCfg.py
+++ b/util/dvsim/OneShotCfg.py
@@ -93,8 +93,8 @@
self.__dict__,
ignored_wildcards)
- # Stuff below only pertains to individual cfg (not master cfg).
- if not self.is_master_cfg:
+ # Stuff below only pertains to individual cfg (not primary cfg).
+ if not self.is_primary_cfg:
# Print info
log.info("[scratch_dir]: [%s]: [%s]", self.name, self.scratch_path)
@@ -113,7 +113,7 @@
self._process_exports()
# Create objects from raw dicts - build_modes, sim_modes, run_modes,
- # tests and regressions, only if not a master cfg obj
+ # tests and regressions, only if not a primary cfg obj
self._create_objects()
# Post init checks
diff --git a/util/dvsim/SimCfg.py b/util/dvsim/SimCfg.py
index 62516d7..2060c45 100644
--- a/util/dvsim/SimCfg.py
+++ b/util/dvsim/SimCfg.py
@@ -160,7 +160,7 @@
self.cov_report_deploy = None
self.results_summary = OrderedDict()
- # If is_master_cfg is set, then each cfg will have its own cov_deploy.
+ # If is_primary_cfg is set, then each cfg will have its own cov_deploy.
# Maintain an array of those in cov_deploys.
self.cov_deploys = []
@@ -190,19 +190,19 @@
self.__dict__ = find_and_substitute_wildcards(self.__dict__,
self.__dict__,
ignored_wildcards,
- self.is_master_cfg)
+ self.is_primary_cfg)
# Set the title for simulation results.
self.results_title = self.name.upper() + " Simulation Results"
- # Stuff below only pertains to individual cfg (not master cfg)
+ # Stuff below only pertains to individual cfg (not primary cfg)
# or individual selected cfgs (if select_cfgs is configured via command line)
# TODO: find a better way to support select_cfgs
- if not self.is_master_cfg and (not self.select_cfgs or
- self.name in self.select_cfgs):
+ if not self.is_primary_cfg and (not self.select_cfgs or
+ self.name in self.select_cfgs):
# If self.tool is None at this point, there was no --tool argument on
# the command line, and there is no default tool set in the config
- # file. That's ok if this is a master config (where the
+ # file. That's ok if this is a primary config (where the
# sub-configurations can choose tools themselves), but not otherwise.
if self.tool is None:
log.error('Config file does not specify a default tool, '
@@ -227,7 +227,7 @@
self._process_exports()
# Create objects from raw dicts - build_modes, sim_modes, run_modes,
- # tests and regressions, only if not a master cfg obj
+ # tests and regressions, only if not a primary cfg obj
self._create_objects()
# Post init checks
diff --git a/util/dvsim/SynCfg.py b/util/dvsim/SynCfg.py
index 4a6991c..53473da 100644
--- a/util/dvsim/SynCfg.py
+++ b/util/dvsim/SynCfg.py
@@ -119,7 +119,7 @@
# }
# }
#
- # note that if this is a master config, the results will
+ # note that if this is a primary config, the results will
# be generated using the _gen_results_summary function
# '''
diff --git a/util/dvsim/dvsim.py b/util/dvsim/dvsim.py
index 16c28c3..3f94485 100755
--- a/util/dvsim/dvsim.py
+++ b/util/dvsim/dvsim.py
@@ -244,10 +244,10 @@
whatg.add_argument("--select-cfgs",
nargs="*",
metavar="CFG",
- help=('The .hjson file is a master config. Only run '
+ help=('The .hjson file is a primary config. Only run '
'the given configs from it. If this argument is '
'not used, dvsim will process all configs listed '
- 'in a master config.'))
+ 'in a primary config.'))
disg = parser.add_argument_group('Dispatch options')
diff --git a/util/fpga/README.md b/util/fpga/README.md
index 85d41fa..dab4314 100644
--- a/util/fpga/README.md
+++ b/util/fpga/README.md
@@ -20,7 +20,7 @@
This directory contains following files:
-* `splice_nexysvideo.sh` - master script
+* `splice_nexysvideo.sh` - main script to load memory contents into bitfile
* `bram_load.mmi` - format which vivado tool understands on which FPGA
BRAM locations the SW contents should go
* `addr4x.py` - utility script used underneath to do address calculation
diff --git a/util/i2csvg/convert.py b/util/i2csvg/convert.py
index 452ee16..bf93e17 100644
--- a/util/i2csvg/convert.py
+++ b/util/i2csvg/convert.py
@@ -2,7 +2,7 @@
# Licensed under the Apache License, Version 2.0, see LICENSE for details.
# SPDX-License-Identifier: Apache-2.0
#
-# Convert I2C master format to SVG
+# Convert I2C host format to SVG
import logging as log
from collections import namedtuple
@@ -121,7 +121,7 @@
S - Start flag, P - stop flag,
R - read flag, C - continue read flag, N - NackOk flag
followed by the data byte
- Special cases:
+ Special cases:
M - indicates multiple bytes instead of data byte
A - followed by 0 or 1 address/direction or 2 address/data
Data value in quotes is a tag
diff --git a/util/i2csvg/smbus/SMBus.md b/util/i2csvg/smbus/SMBus.md
index 8dad018..173363b 100644
--- a/util/i2csvg/smbus/SMBus.md
+++ b/util/i2csvg/smbus/SMBus.md
@@ -1,6 +1,6 @@
-# Using I2C master for SMBus commands
+# Using I2C host for SMBus commands
-The I2C master can generate all the SMBus commands listed in the Rev 3.0 SMBus specification.
+The I2C host can generate all the SMBus commands listed in the Rev 3.0 SMBus specification.
### Quick Command
diff --git a/util/simplespi/spitest.py b/util/simplespi/spitest.py
index 14d754c..f69004e 100755
--- a/util/simplespi/spitest.py
+++ b/util/simplespi/spitest.py
@@ -87,8 +87,8 @@
# interfaces start from 1 here, so this is Channel A (called 0 in jtag)
spi.configure('ftdi://ftdi:2232h/1')
- # Get a port to a SPI slave w/ /CS on A*BUS3 and SPI mode 0 @ 1MHz
- slave = spi.get_port(cs=0, freq=1E6, mode=0)
+ # Get a port to a SPI device w/ /CS on A*BUS3 and SPI mode 0 @ 1MHz
+ device = spi.get_port(cs=0, freq=1E6, mode=0)
# Get GPIO port to manage extra pins
# BUS4 = JTAG TRST_N, BUS5 = JTAG SRST_N, BUS6 = JTAG_SPIN
@@ -120,7 +120,7 @@
print("Select SPI")
gpio.write(0x30)
- # Synchronous exchange with the remote SPI slave
+ # Synchronous exchange with the remote SPI device
if args.length:
s = ''
for i in range(args.length):
@@ -137,7 +137,7 @@
while len(s):
write_buf = bytes(s[:4], encoding='utf8')
- read_buf = slave.exchange(write_buf, duplex=True).tobytes()
+ read_buf = device.exchange(write_buf, duplex=True).tobytes()
print("Got " + str(read_buf))
s = s[4:]