PTO Runtime - Task Runtime Execution Framework

Modular runtime for building and executing task dependency graphs on Ascend devices with coordinated AICPU and AICore execution. Three independently compiled programs (Host .so, AICPU .so, AICore .o) work together through clearly defined APIs.

Quick Start

# Clone the repository
git clone <repo-url>
cd simpler

# Run the vector example (simulation, no hardware required)
python examples/scripts/run_example.py \
  -k examples/a2a3/host_build_graph/vector_example/kernels \
  -g examples/a2a3/host_build_graph/vector_example/golden.py \
  -p a2a3sim

PTO ISA headers are automatically cloned on first run. See Getting Started for manual setup and troubleshooting.

Platforms

Platform	Description	Requirements
a2a3	Real Ascend hardware	CANN toolkit (ccec, aarch64 cross-compiler)
a2a3sim	Thread-based host simulation	gcc/g++ only (no Ascend SDK needed)

Runtime Variants

Three runtimes under src/{arch}/runtime/, each with a different graph-building strategy:

Runtime	Graph built on	Use case
host_build_graph	Host CPU	Development, debugging
aicpu_build_graph	AICPU (device)	Reduced host-device transfer
tensormap_and_ringbuffer	AICPU (device)	Production workloads

See runtime docs per arch: a2a3, a5.

Testing

# Simulation tests (no hardware)
./ci.sh -p a2a3sim

# Hardware tests (requires Ascend device)
./ci.sh -p a2a3 -d 4-7 --parallel

# Python unit tests
pytest tests -m "not requires_hardware" -v

# C++ unit tests
cmake -B tests/cpp/build -S tests/cpp && cmake --build tests/cpp/build && ctest --test-dir tests/cpp/build --output-on-failure

See Testing Guide for details.

Environment Setup

source /usr/local/Ascend/ascend-toolkit/latest/bin/setenv.bash
export ASCEND_HOME_PATH=/usr/local/Ascend/ascend-toolkit/latest

Documentation

Document	Description
Architecture	Three-program model, API layers, execution flow, handshake protocol
Getting Started	Setup, prerequisites, build process, configuration
Developer Guide	Directory structure, role ownership, conventions
Testing Guide	CI pipeline, test types, writing new tests
Per-arch (a2a3):
Runtimes	Runtime comparison and links to per-runtime docs
Platform	onboard vs sim, hardware requirements
Per-arch (a5):
Runtimes	Runtime comparison and links to per-runtime docs
Platform	onboard vs sim, hardware requirements

License

This project is licensed under the CANN Open Software License Agreement Version 2.0. See the LICENSE file for the full license text.

References

• src/a2a3/platform/ - Platform implementations
• src/a2a3/runtime/ - Runtime implementations
• examples/a2a3/ - Examples organized by runtime
• examples/scripts/ - Test framework
• python/ - Python bindings and compiler