VS1005g VSOS3 and Applications with Source Code

Introduction to VSOS3

VS1005g programs (.AP3 and .DL3 applications and drivers) run under VSOS3 (VLSI Solution's Operating System version 3).

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

  • Program the latest VSOS3 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 VSOS3 System Root Files and your own applications to the SPI flash using USB

For the current development status of VSOS3, click here.

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

Two Basic Ways of Using VS1005g / VSOS3

There are two basic ways of how to use VSOS3:

  • Classical stand-alone mode, with a graphical touchscreen interface
    • Makes it possible to create a complete stand-alone system with a graphical user interface
  • UART-controlled player mode (new mode, released October 2015)
    • User can list files, load and unload drivers, and run programs using the UART VSOS Shell environment
    • Makes it possible to create a flexible audio system controlled by a microcontroller through UART
    • Easy to test with a PC and terminal emulation program (115200 bps, 8N1)

VSOS3 3.25 Kernel

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

The latest stable release is included in the newest revision of VSIDE, which you can download by clicking here.

For the latest development non-stable revision of VSOS, see VSDSP Forum's VS1005 section. 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.25:

  • 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
  • Unicode support
  • Zero-pointer call tracking

VSOS3 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.

  • System Root Files, libraries, drivers + documentation for VSOS 3.25 and newer
    • Includes source code for most applications and drivers
      • For more information on how to use a certain driver, look for README.TXT or .PDF files in the driver source code folder
    • Documentation for the brand-new UART VSOS Shell and the VSOS Audio Subsystem
    • See README.TXT for how to use and copy the root folders
    • Note! If you want to try/use the VSOS UART Shell environment, either push S2 on the Development board when booting the Development Board, or switch around config.txt lines that say [0] and [2]

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

VSOS Applications

Below are some application solutions running under VSOS which are not an integral part of VSIDE.


  • 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

VS1005 Loopback Test

  • Demonstrates performance of the VS1005 Developer Board: how to measure it, and what results to expect.
  • Binary files AudioLoopback.ap3 (for VSOS3) and AudioLoopback.app (for VSOS0.2) included.

Version: 1.20
Modified: 2014-02-24
VSOS version: 3.06 / 0.24
Download: LoopbackTest.zip
Document: vs1005an_devboardperf.pdf

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 version 0.20 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. Later messages also show how to unbrick a board containing VSOS3.

Legacy Software

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