Generate a UPF (IEEE 1801) power-intent file from an Excel spreadsheet of power domains, supply sets, isolation, retention, level shifters and power states.
Translates a power-intent spreadsheet into a UPF (IEEE 1801) file, default output.upf, for UPF 2.1, 3.0, 3.1 (default) or 4.0. Two input layouts are read, .xlsx or .xls either way.
- Template 2.0 (any workbook with a [design] block; write one with -write_template): every 1801 command, names entered once and checked, supplies/supply sets/power states derived, sub-IPs (hierarchy), version checking. This is the layout to use. - Template 1.x (the older one-worksheet-per-construct layout of the shipped examples/*.xls): still translated, worksheet by worksheet, without the checks above.
Changes in release 10.0
- Sequenced workbooks: a
seqcolumn writes rows exactly as given, in that order; a new[extern]block names what another file defines;[sub_ips]has modesource; names are per scope; new rows coverupf_version, power models andset_related_supply_net. Hand-entered workbooks (noseq) produce the same output as before.
Usage
xls2upf -in <file.xlsx|file.xls> [-out <file.upf>] [-upf_version 2.1|3.0|3.1|4.0] [-user <email>]
xls2upf -write_template <file.xlsx>
Every option is listed by xls2upf -help, and the complete reference is in the capability file that ships with the tool's AGENTS.md.
Exit status
- 0: translated with no error. 2: the translation reported errors (the UPF is still written, for inspection, but is not to be trusted), or
-write_templatefailed. 1: an option without its value, or a bad-upf_version; alsoEDAUTILS_ROOTmissing/invalid (launcher). 10: no valid license file. - Message format:
xls2upf: <Severity>: <id>: <text>; template 2.0 messages start with the cell, e.g.worksheet 'Isolation' row 3 column 'domain': the domain 'PD_B' is not defined anywhere in this workbook. - The run ends with
xls2upf: Note: <id>: Found N error(s) and M warning(s) ....
Requirements
Java 11 or newer on PATH (Java 21 recommended), Linux or Windows. Unpack the bundle, run source setup_env.sh and call xls2upf. Install in one command with curl -fsSL https://edautils.com/install.sh | sh -s -- xls2upf.