https://github.com/captainirs/dsplang
A Vector DSL targeting Qualcomm's Hexagon Vector eXtensions built using MLIR
https://github.com/captainirs/dsplang
Last synced: 5 months ago
JSON representation
A Vector DSL targeting Qualcomm's Hexagon Vector eXtensions built using MLIR
- Host: GitHub
- URL: https://github.com/captainirs/dsplang
- Owner: CaptainIRS
- License: mit
- Created: 2025-05-06T22:41:02.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-06T15:37:15.000Z (8 months ago)
- Last Synced: 2025-10-06T17:39:40.870Z (8 months ago)
- Language: MLIR
- Homepage:
- Size: 8.08 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DSPLang
> [!WARNING]
> WIP: This is a work in progress.
## Overview
DSPLang is a programming language designed for building efficient vector operations targeting architectures with very wide registers. In particular, it is designed to be used with the Hexagon Vector eXtensions (HVX) of the Qualcomm Hexagon platform.
Details about the current implementation can be found [here](./DSPLang.pdf).
### New dialects
* HLHVX dialect: A high-level dialect with the correct type information, suitable as a lowering target from other dialects in the MLIR ecosystem.
* LLHVX dialect: A one-to-one mapping to the HVX LLVM intrinsics, which directly translate to LLVM IR.
## Setup
Clone the repository.
### Setting up LLVM for the Hexagon platform
1. Using conda is recommended. `conda env create -f setup/hexagon-env.yaml`,
`conda activate hexagon`
2. `git clone https://github.com/quic/toolchain_for_hexagon`
3. `cd toolchain_for_hexagon`
4. `git apply ../setup/hexagon-toolchain.patch`
5. `./build.sh`
### Building DSPLang
1. Create a python environment: `python3 -m venv venv`
2. Activate the environment: `source venv/bin/activate`
3. Install the required packages: `pip install -r requirements.txt`
2. `mkdir build`
3. `cd build`
4. `cmake -G Ninja -DMLIR_DIR=$PWD/toolchain_for_hexagon/clang+llvm-fork-cross-hexagon-unknown-linux-musl/x86_64-linux-gnu/lib/cmake/mlir -DCMAKE_PREFIX_PATH=$PWD/venv/bin -DLLVM_EXTERNAL_LIT=$PWD/venv/bin/lit ..`
5. `ninja`
### Running the examples (simulator)
Note: You need to have the Hexagon SDK installed as the examples use functionalities from the SDK for instrumentation. Make sure that the environment variables are set up correctly.
1. `cd examples`
2. `make sim EXP=basic IMPL=dsp` to run the DSPLang version of the `basic` example.
### Running the examples (device)
Note: Only the QCS8550 SoC (Snapdragon 8 Gen 2) is supported at the moment. Connect the device to your computer and make sure that `adb devices -l` shows the device.
1. `cd examples`
2. `make device EXP=basic IMPL=dsp` to run the DSPLang version of the `basic` example.