rustscript-embedded 0.3.2

Embedded RustScript VMBC runtime with a no_std host-function ABI
Documentation 
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

#!/usr/bin/env python3

import argparse
import pathlib
import shutil
import subprocess
import sys
import tempfile

from vmbc_image import find_partition, pack_vmbc


def compile_rss(source, output, project_dir):
    installed = shutil.which("rustscript-compile-vmbc")
    if installed:
        command = [installed, str(source), str(output)]
        cwd = None
    elif (project_dir / "Cargo.toml").is_file():
        command = [
            "cargo",
            "run",
            "--quiet",
            "--bin",
            "rustscript-compile-vmbc",
            "--",
            str(source),
            str(output),
        ]
        cwd = project_dir
    else:
        raise RuntimeError(
            "RSS compilation needs rustscript-compile-vmbc on PATH or a micro-rustscript checkout"
        )
    subprocess.run(command, cwd=cwd, check=True)


def main():
    script_dir = pathlib.Path(__file__).resolve().parent
    project_dir = script_dir.parent
    default_partitions = project_dir / "partitions.csv"
    if not default_partitions.is_file():
        default_partitions = script_dir / "partitions.csv"
    parser = argparse.ArgumentParser(
        description="Compile/package and independently flash VMBC into the ESP32 script partition."
    )
    parser.add_argument("input", type=pathlib.Path, help=".vmbc or .rss input")
    parser.add_argument("--port", help="serial port; omit to only create the partition image")
    parser.add_argument("--output", type=pathlib.Path, help="write the packed partition image here")
    parser.add_argument("--partitions", type=pathlib.Path, default=default_partitions)
    parser.add_argument("--chip", default="esp32c3")
    parser.add_argument("--baud", default="921600")
    args = parser.parse_args()

    offset, partition_size = find_partition(args.partitions)
    with tempfile.TemporaryDirectory(prefix="rustscript-vmbc-") as temporary:
        temporary = pathlib.Path(temporary)
        if args.input.suffix.lower() == ".rss":
            vmbc = temporary / (args.input.stem + ".vmbc")
            compile_rss(args.input.resolve(), vmbc, project_dir)
            payload = vmbc.read_bytes()
        else:
            payload = args.input.read_bytes()
        image = pack_vmbc(payload, partition_size)
        output = args.output or temporary / "rustscript.partition.bin"
        output.parent.mkdir(parents=True, exist_ok=True)
        output.write_bytes(image)
        print(
            f"packed {len(payload)} VMBC bytes into {len(image)} bytes "
            f"for offset 0x{offset:x}"
        )
        if args.output:
            print(f"wrote {output}")
        if args.port:
            command = [
                sys.executable,
                "-m",
                "esptool",
                "--chip",
                args.chip,
                "--port",
                args.port,
                "--baud",
                args.baud,
                "write_flash",
                hex(offset),
                str(output),
            ]
            subprocess.run(command, check=True)
        elif not args.output:
            parser.error("provide --port, --output, or both")


if __name__ == "__main__":
    main()