Implementing Virtio-sound for Asterinas

Getting Started

Get yourself an x86-64 Linux machine with Docker installed. Follow the three simple steps below to get Asterinas up and running.

1. Download the latest source code.

git clone https://github.com/loaringlyc/asterinas-driver.git

2. Run a Docker container as the development environment.

The official method goes as follows:

docker run -it --privileged --network=host --device=/dev/kvm -v $(pwd)/asterinas:/root/asterinas asterinas/asterinas:0.11.0

However, using this command may lead to some network problems. I highly recommend you to download the asterinas-docker.tar.xz file, unpack it into asterinas-docker.tar file, and then run the following command:

sudo podman load < /path/to/your/file/asterinas-docker.tar
sudo podman run -it --privileged --network=host --device=/dev/kvm -v $(pwd)/asterinas-driver:/root/asterinas docker.io/asterinas/asterinas:0.9.4
# note that sudo is necessary for podman for --device=/dev/kvm arg

or if you use docker:

docker load < /path/to/your/file/asterinas-docker.tar
docker run -it --privileged --network=host --device=/dev/kvm -v $(pwd)/asterinas-driver:/root/asterinas docker.io/asterinas/asterinas:0.9.4

3. Inside the container, go to the project folder to build and run Asterinas.

Fist install alsa sound backend using commands:

apt update
apt install alsa-utils alsa-base libasound2

The start the operating system by:

make build
make run

If everything goes well, Asterinas is now up and running inside a VM and a .wav file has been generated.

You could generate audio by using:

cat dev/snd

in the container. This will modify the generated .wav file by adding newly-generated audio to its end.

The Book

See The Asterinas Book to learn more about the project.