VS1005g VSOS and Applications with Source Code

Introduction to VSOS

VS1005g programs (.DL3 and .AP3 applications and drivers) run under VSOS (VLSI Solution's Real-Time Operating System).

To get the VSOS operating system environment up and running, you need to

  • Program the latest VSOS Kernel to either the VS1005g internal SPI flash, or external SPI flash.
    • The kernel is included as a template in the free VSIDE software development system
    • VSIDE can be used to upload the kernel to the VS1005g DevBoard or BreakOut Board
  • Copy the VSOS System Root Files and your own applications to the SPI flash using USB

For the current development status of VSOS, click here.

If you have any questions, you are welcome to join the VS1005 and VSOS Software section of our VSDSP Forum.

Using VS1005g / VSOS

You interact with VSOS through a UART-controlled Shell:

  • User can list files, load and unload drivers, and run programs using the VS1005 VSOS Shell through UART
  • Makes it possible to create a flexible VS1005 Audio Subsystem controlled by a microcontroller through UART
  • Easy to test with a PC and terminal emulation program (115200 bps, 8N1)

VS1005 VSOS Kernel 3.67

This is the VS1005 Operating System kernel. All VSOS applications require the kernel to be installed into the development board to work.

The latest revision of VSOS that is included in VSIDE is v3.67. Download the latest VSIDE by clicking here.

The latest stable release of VSOS is 3.67, which you can find in VSDSP Forum's VS1005 section. New, unstable and experimental releases are also going to be there. There you can also find installation instructions and other useful information. See for the latest messages for the newest version.

Below are the some main features of VSOS 3.67:

  • Modular microkernel
  • Device drivers and libraries can be loaded and unloaded on-demand
  • Startup configuration file config.txt tells device what drivers to load upon startup
  • UART command line shell makes it easy to configure on the run either using a terminal program or microcontroller
  • FAT12/16/32 file system read/write support from SD Card or SPI Flash
  • Unicode/UTF-8 support
  • Zero-pointer call tracking
  • ROM-independent binaries

VS1005 VSOS System Root Files

Below is a link to the current stable release of VSOS drivers and base applications, most of them with full source code, compilable with VSIDE.

In addition to this package, VSIDE contains some example application, library, and device driver templates. Check VSIDE for details.

VS1005 VSOS Applications

The best place to look for VSOS applications is the "VSOS System Root Files, Libraries, Drivers + Documentation" package mentioned in the previous section. The package contains more than 160 software packages, most with source code and documentation.

In addition to the package, below are some application solutions running under VSOS which are not an integral part of VSIDE.

VS1005 Amp Board Software

Software specifically written for the VS1005 Amp Board is available at the VS1005 Amp Board page.

VSIDE DSP Library

  • DSP Library for FIR filter implementation.
  • Full documentation with examples.
  • Contains VSIDE example solution with source code for VS1005.

Version: 1.00
Updated: 2015-04-30
Devices: VS1005g, VS1063a, VS1053b, VS1003b, VS1103b
Download: See VSDSP Forum page for VSIDE DSP Library

Instruction videos

Instruction videos on how to install VSOS, and how to compile and install drivers and applications, are available on YouTube. You can also download them from here.

Restoring a 'bricked' VS1005 board

Click this link to find out how to install the firmware and VSOS kernel to a VS1005g Developer Board which either has a corrupted firmware so that it cannot boot, or which you have built yourself and doesn't have VLSI's preinstalled firmware. Note that the earlier messages of the thread handle old VSOS kernel 0.20.

Legacy Software

Below is some non-supported legacy software written for earlier versions of VSOS. Please use the current release whenever possible.