mirror of
https://github.com/saymrwulf/xous-core.git
synced 2026-11-22 09:23:16 +00:00
83 lines
3.1 KiB
Python
83 lines
3.1 KiB
Python
"""
|
|
Baochip CLI — entry point for host-side utilities.
|
|
|
|
Usage examples:
|
|
python tools-bao/bao.py ports
|
|
python tools-bao/bao.py monitor -p COM3 -b 115200 --ts
|
|
python tools-bao/bao.py build --target dabao
|
|
"""
|
|
|
|
import argparse
|
|
from re import sub
|
|
import sys
|
|
|
|
# Subcommand imports
|
|
from commands.ports import cmd_ports
|
|
from commands.monitor import cmd_monitor
|
|
from commands.flash import cmd_flash
|
|
from commands.doctor import cmd_doctor
|
|
from commands.build import cmd_build
|
|
from commands.artifacts import cmd_artifacts
|
|
from commands.update_all import cmd_update_all
|
|
|
|
def main():
|
|
ap = argparse.ArgumentParser(prog="bao.py")
|
|
sub = ap.add_subparsers(dest="cmd", required=True)
|
|
|
|
# artifacts
|
|
a = sub.add_parser("artifacts", help="List newest UF2 images (release only)")
|
|
a.add_argument("--json", action="store_true")
|
|
a.set_defaults(func=cmd_artifacts)
|
|
|
|
# ports
|
|
s = sub.add_parser("ports", help="List serial ports")
|
|
s.add_argument("-v", "--verbose", action="store_true")
|
|
s.set_defaults(func=cmd_ports)
|
|
|
|
# update-all
|
|
ua = sub.add_parser("update-all", help="Return true if board Xous/loader version differs from local")
|
|
ua.add_argument("-p", "--port", required=True, help="Monitor serial port")
|
|
ua.add_argument("-b", "--baud", type=int, default=115200)
|
|
ua.add_argument("--timeout", type=float, default=3.0, help="Seconds to wait for version response")
|
|
ua.add_argument("--json", action="store_true", help='Emit {"updateAll": bool, "current": "...", "board": "..."}')
|
|
ua.set_defaults(func=cmd_update_all)
|
|
|
|
# monitor
|
|
m = sub.add_parser("monitor", help="Open a serial monitor")
|
|
m.add_argument("-p", "--port", required=True)
|
|
m.add_argument("-b", "--baud", type=int, default=115200)
|
|
m.add_argument("--ts", action="store_true", help="Show timestamps")
|
|
m.add_argument("--save", help="Append output to a file")
|
|
m.add_argument("--reset", action="store_true", help="Toggle DTR/RTS on open")
|
|
m.set_defaults(func=cmd_monitor)
|
|
|
|
# build (Xous via cargo xtask)
|
|
b = sub.add_parser("build", help="Build Xous image for Baochip via cargo xtask")
|
|
b.add_argument("--target", required=True, help="Bao target (e.g. dabao, baosec)")
|
|
b.add_argument("--release", action="store_true", help="Use release build")
|
|
b.add_argument("--extra-args", help="Extra args to pass to cargo xtask")
|
|
b.set_defaults(func=cmd_build)
|
|
|
|
# doctor
|
|
d = sub.add_parser("doctor", help="Check Python environment and ports")
|
|
d.set_defaults(func=cmd_doctor)
|
|
|
|
# flash
|
|
f = sub.add_parser("flash", help="Copy UF2 file(s) to a mounted drive")
|
|
f.add_argument("--dest", required=True, help="Mount path of the UF2 boot drive (e.g., D:\\ or /Volumes/BAOBOOT)")
|
|
f.add_argument("files", nargs="+", help="One or more UF2 files to copy (e.g., loader.uf2 xous.uf2 app.uf2)")
|
|
f.set_defaults(func=cmd_flash)
|
|
|
|
args = ap.parse_args()
|
|
try:
|
|
args.func(args)
|
|
except KeyboardInterrupt:
|
|
print("\n[bao] aborted by user.")
|
|
sys.exit(1)
|
|
except Exception as e:
|
|
print(f"[bao] error: {e}", file=sys.stderr)
|
|
sys.exit(1)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|