Vlsi VS1005 Manuel utilisateur

PUBLIC DOCUMENT

VS1005 VSOS AUDIO SUBSYSTEM

VS1005g

All information in this document is provided as-is without warranty. Features are

subject to change without notice.

Revision History

Rev. Date Author Description

3.57 2019-04-10 HH Minor corrections.

3.55b 2018-06-22 HH Added Noise Killer audio driver.

3.55a 2018-04-24 HH New features to Reverb Generator audio driver.

3.55 2018-04-05 HH Added Reverb Generator audio driver.

3.52 2018-01-22 HH Updated for VSOS 3.52.

3.42 2017-05-18 HH More S/PDIF drivers, FLAC Encoder, Pitch Shifter.

3.40 2016-11-03 HH Updated for VSOS 3.40.

3.30a 2016-07-14 HH Bug patch release for VSOS 3.30.

3.30 2016-06-22 HH Updated for VSOS 3.30.

1.03 2016-02-15 HH New AUXPLAY, fract. rates, updated AuOutput.

1.02 2016-01-27 HH Added AuOutput app and Slave Sync drivers.

1.01 2015-09-14 HH Corrections, e.g. Figure 8.

1.00 2015-09-04 HH Initial release.

Rev. 3.57 2019-04-10 Page 1(62)

VS1005 VSOS AUDIO SUBSYSTEM VS1005g

Contents

VS1005 VSOS Audio Subsystem Front Page 1

Table of Contents 2

1 Introduction 6

2 Disclaimer 7

3 Deﬁnitions 7

4 Overview 8

5 Requirements 9

6 The VS1005 VSOS Audio Subsystem 10

6.1 StandardAudio................................. 10

6.2 VSOS Audio Output Example Program . . . . . . . . . . . . . . . . . . . . 11

6.3 VSOS Audio Input/Output Example Program . . . . . . . . . . . . . . . . 12

7 Audio Drivers 13

7.1 General ..................................... 13

7.2 Analog Output DAC Audio Drivers . . . . . . . . . . . . . . . . . . . . . . 15

7.2.1 Driver AUODAC.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 15

7.3 Analog Side Path Audio Drivers . . . . . . . . . . . . . . . . . . . . . . . . 16

7.3.1 Driver AUOOSET.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . 16

7.4 Analog Input ADC Audio Drivers . . . . . . . . . . . . . . . . . . . . . . . 17

7.4.1 Driver AUIADC.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 17

7.5 I2SAudioDrivers................................ 19

7.5.1 Driver AUOI2SMA.DL3 . . . . . . . . . . . . . . . . . . . . . . . . 19

7.5.2 Driver AUOI2SM.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . 20

7.5.3 Driver AUOI2SS.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 20

7.5.4 Driver AUII2SM.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 21

7.5.5 Driver AUII2SS.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 21

7.5.6 Driver AUXI2SM.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . 21

7.5.7 Driver AUXI2SS.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 21

7.6 S/PDIFAudioDrivers ............................. 22

7.6.1 Driver AUOSPDA.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . 22

7.6.2 Driver AUISPD.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 23

7.6.3 Driver AUXSPD.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 24

7.6.4 Driver AUXSPD48.DL3 . . . . . . . . . . . . . . . . . . . . . . . . 25

7.6.5 Driver AUOSP48S.DL3 . . . . . . . . . . . . . . . . . . . . . . . . 25

7.6.6 Driver AUOSPD48.DL3 . . . . . . . . . . . . . . . . . . . . . . . . 25

7.7 Slave Audio Input Synchronization Drivers . . . . . . . . . . . . . . . . . . 26

7.7.1 Driver AUXSYNCS.DL3 . . . . . . . . . . . . . . . . . . . . . . . . 26

7.8 Audio Input to Output Copying Driver . . . . . . . . . . . . . . . . . . . . . 27

7.8.1 Driver AUXPLAY.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . 27

8 Audio Filter Drivers 28

Rev. 3.57 2019-04-10 Page 2(62)

VS1005 VSOS AUDIO SUBSYSTEM VS1005g

8.1 Equalizer Audio Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

8.1.1 Driver FTOEQU.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 30

8.1.2 Control Program SETEQU.DL3 . . . . . . . . . . . . . . . . . . . . 30

8.2 DC Offset/AGC Audio Drivers . . . . . . . . . . . . . . . . . . . . . . . . . 31

8.2.1 Driver FTIDCBL.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 32

8.2.2 Driver FTIAGC.DL3 . . . . . . . . . . . . . . . . . . . . . . . . . . 32

8.2.3 Control Program SETAGC.DL3 . . . . . . . . . . . . . . . . . . . . 32

8.3 Pitch Shifter / Speed Shifter Audio Drivers . . . . . . . . . . . . . . . . . . 33

8.3.1 DriverFTOPITCH ........................... 33

8.3.2 Control Program SETPITCH . . . . . . . . . . . . . . . . . . . . . 33

8.4 Reverb Generator Audio Drivers . . . . . . . . . . . . . . . . . . . . . . . 34

8.4.1 DriverFTOREV............................. 34

8.4.2 DriverFTOREV23 ........................... 35

8.4.3 Control Program SETREV . . . . . . . . . . . . . . . . . . . . . . . 36

8.5 Noise Killer Audio Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

8.5.1 DriverFTINOISE............................ 39

8.5.2 Control Program SETNOISE . . . . . . . . . . . . . . . . . . . . . 39

9 Audio Control Programs 41

9.1 Control Program AUINPUT.DL3 . . . . . . . . . . . . . . . . . . . . . . . . 41

9.2 Control Program AUOUTPUT.DL3 . . . . . . . . . . . . . . . . . . . . . . 42

10 Conﬁguration Examples 43

10.1 Minimal conﬁg.sys for Playback . . . . . . . . . . . . . . . . . . . . . . . . 43

10.2 conﬁg.sys for Playback with Bass/Treble Controls and I2S + S/PDIF Outputs 43

10.3 Basic conﬁg.sys for Recording . . . . . . . . . . . . . . . . . . . . . . . . 43

10.4 Versatile conﬁg.sys for Recording with AGC and I2S + S/PDIF Outputs . . 44

10.5 conﬁg.sys for Playback/Recording from I2S in Slave Mode, and Monitor-

ing to DAC with Automatic Synchronization . . . . . . . . . . . . . . . . . 44

10.6 Loading/Unloading Drivers Using the VSOS Shell . . . . . . . . . . . . . . 44

11 VSOS Audio ioctl() Controls 46

11.1ResettingaDriver ............................... 46

11.1.1IOCTL_RESTART ........................... 46

11.2 Controlling Sample Rate and Bit Width . . . . . . . . . . . . . . . . . . . . 47

11.2.1 IOCTL_AUDIO_SET_RATE_AND_BITS . . . . . . . . . . . . . . . 47

11.2.2 IOCTL_AUDIO_GET_IRATE, IOCTL_AUDIO_GET_ORATE . . . . 47

11.2.3 IOCTL_AUDIO_SET_IRATE, IOCTL_AUDIO_SET_ORATE . . . . 48

11.2.4 IOCTL_AUDIO_GET_BITS . . . . . . . . . . . . . . . . . . . . . . 48

11.2.5 IOCTL_AUDIO_SET_BITS . . . . . . . . . . . . . . . . . . . . . . 48

11.3 Controlling Audio Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

11.3.1 IOCTL_AUDIO_GET_INPUT_BUFFER_FILL . . . . . . . . . . . . 49

11.3.2 IOCTL_AUDIO_GET_INPUT_BUFFER_SIZE . . . . . . . . . . . . 49

11.3.3 IOCTL_AUDIO_SET_INPUT_BUFFER_SIZE . . . . . . . . . . . . 49

11.3.4 IOCTL_AUDIO_GET_OUTPUT_BUFFER_FREE . . . . . . . . . . 49

11.3.5 IOCTL_AUDIO_GET_OUTPUT_BUFFER_SIZE . . . . . . . . . . 50

11.3.6 IOCTL_AUDIO_GET_OUTPUT_BUFFER_SIZE . . . . . . . . . . 50

11.4VolumeControl................................. 51

Rev. 3.57 2019-04-10 Page 3(62)

VS1005 VSOS AUDIO SUBSYSTEM VS1005g

11.4.1 IOCTL_AUDIO_GET_VOLUME . . . . . . . . . . . . . . . . . . . . 51

11.4.2 IOCTL_AUDIO_SET_VOLUME . . . . . . . . . . . . . . . . . . . . 51

11.5 Miscellaneous Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

11.5.1 IOCTL_AUDIO_GET_SAMPLE_COUNTER . . . . . . . . . . . . . 52

11.5.2 IOCTL_AUDIO_GET_OVERFLOWS . . . . . . . . . . . . . . . . . 52

11.5.3 IOCTL_AUDIO_GET_UNDERFLOWS . . . . . . . . . . . . . . . . 52

11.5.4 IOCTL_AUDIO_SELECT_INPUT . . . . . . . . . . . . . . . . . . . 53

11.6 Fractional Sample Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

12 Controlling Audio from VSOS Shell with UiMessages 55

12.1 Setting Volume anywhere from VSOS Shell . . . . . . . . . . . . . . . . . 55

12.2 Sending Equalizer Controls from VSOS Shell . . . . . . . . . . . . . . . . 55

13 Audio Decoders 56

13.1 Decoder Loop Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . 58

14 Audio Encoders 59

14.1 ENCVORB.DL3 - Ogg Vorbis Encoder . . . . . . . . . . . . . . . . . . . . 59

14.2 ENCMP3.DL3 - MP3 Encoder (VS1205 only) . . . . . . . . . . . . . . . . 59

14.3 ENCFLAC.DL3 - FLAC Encoder . . . . . . . . . . . . . . . . . . . . . . . 59

15 Latest Document Version Changes 60

16 Contact Information 62

Rev. 3.57 2019-04-10 Page 4(62)

VS1005 VSOS AUDIO SUBSYSTEM VS1005g

List of Figures

1 VS1005g playback (DA) audio paths . . . . . . . . . . . . . . . . . . . . . 13

2 VS1005g recording (AD, FM, etc) signal paths . . . . . . . . . . . . . . . 14

3 AUODAC.DL3 signal paths shown in bold brown .............. 15

4 AUOOSET.DL3 signal paths shown in bold brown ............. 16

5 AUIADC.DL3 selectable input signal paths shown in bold green for the

left channel, and bold brown for the right channel. Alternative RF audio

path shown in bold magenta ......................... 17

6 AUOI2SMA.DL3 audio path shown in bold brown ............. 19

7 AUOI2SM.DL3 audio path shown in bold brown .............. 20

8 AUII2SM.DL3 audio path shown in bold brown ............... 21

9 AUOSPDA.DL3 audio path shown in bold brown. Software driver con-

necting to the ﬁlterless sample rate converter (bold green) shown in bold

magenta .................................... 23

10 A ﬁlter input driver connects to the stdaudioin chain . . . . . . . . . . . . . 28

11 A ﬁlter output driver connects to the stdaudioout chain . . . . . . . . . . . 28

12 Audio with exaggerated DC offset . . . . . . . . . . . . . . . . . . . . . . . 31

13 AudiowithDCblocking ............................ 31

14 Reverb Generator FTOREV signal paths . . . . . . . . . . . . . . . . . . . 34

15 Reverb Generator FTOREV23 signal paths . . . . . . . . . . . . . . . . . 35

Rev. 3.57 2019-04-10 Page 5(62)

VS1005 VSOS AUDIO SUBSYSTEM VS1005g

1 Introduction

The VS1005 VSOS offers many, versatile audio drivers.

This document explains how to use the numerous drivers to your best advantage.

After the disclaimer and deﬁnitions in Chapters 2 and 3, an overview of the Audio sub-

system is given in Chapter 4, Overview, followed by requirements in Chapter 5, Require-

ments.

The VSOS audio subsystem is presented in Chapter 6, The VS1005 VSOS Audio Sub-

system.

The currently existing audio drivers are presented in Chapter 7, Audio Drivers, followed

by a presentation of the currently existing ﬁlters in Chapter 8, Audio Driver Filters, and

control programs in Chapter 9, Audio Control Programs,

Some examples on how to start audio drivers from conﬁg.txt or the VSOS Shell are

shown in Chapter 10, Conﬁguration Examples.

Chapter 12 shows how to control some aspects on audio using UiMessages, even if the

program that is currently running doesn’t have any audio controls.

Audio Decoders are presented in Chapter 13, and Audio Encoders in Chapter 14.

The document ends with Chapter 15, Latest Document Version Changes, and Chap-

ter 16, Contact Information.

Rev. 3.57 2019-04-10 Page 6(62)

VS1005 VSOS AUDIO SUBSYSTEM VS1005g

2 Disclaimer

VLSI Solution makes everything it can to make this documentation as accurate as pos-

sible. However, no warranties or guarantees are given for the correctness of this docu-

mentation.

3 Deﬁnitions

DSP Digital Signal Processor.

I-mem Instruction Memory.

LSW Least Signiﬁcant (16-bit) Word.

MSW Most Signiﬁcant (16-bit) Word.

RISC Reduced Instruction Set Computer.

VS_DSP4VLSI Solution’s DSP core.

VSIDE VLSI Solution’s Integrated Development Environment.

VSOS VLSI Solution’s Operating System.

X-mem X Data Memory.

Y-mem Y Data Memory.

Rev. 3.57 2019-04-10 Page 7(62)

VS1005 VSOS AUDIO SUBSYSTEM VS1005g

4 Overview

The VSOS Audio Subsystem provides numerous drivers to handle the many audio In-

put/Output options of VS1005. The audio drivers can be controlled either with ioctl()

calls from the C language, or from VSOS Shell control program.

While instructions for how to use each audio driver are provided in the README.TXT

or documentation .PDF ﬁles of the drivers, this document will provide an overview of

the capabilities of the drivers. However, for details, refer to documentation of the audio

drivers themselves.

Rev. 3.57 2019-04-10 Page 8(62)

VS1005 VSOS AUDIO SUBSYSTEM VS1005g

5 Requirements

To test the audio drivers in this document, you need to have the following building blocks:

•VS1005g Developer Board. The VS1005g BreakOut Board should also work, but

these instructions have been tested with the DevBoard.

•Latest version of VSOS installed (at least v3.23, released 2015-09-04).

•USB cable between DevBoard and PC for uploading new software.

•If you want to use the VSOS Shell environment, you will also need:

–UART or USB->UART cable connected between DevBoard and PC for using

the UART interface. Data speed is 115200 bps, format is 8N1.

–Your favorite UART Terminal Emulation program installed on the PC. Read

the “VS1005 VSOS Shell” for further details.

When all of this is in order, you are ready to test the VSOS Audio Subystem.

Rev. 3.57 2019-04-10 Page 9(62)

VS1005 VSOS AUDIO SUBSYSTEM VS1005g

6 The VS1005 VSOS Audio Subsystem

As a default, VSOS offers a simple audio output driver that lets the user output 16-bit

mono or stereo audio to the VS1005 analog output pins LEFT and RIGHT, and control

the sample rate.

VSOS Audio makes it very easy to produce sound with its standard-C-like standard

audio interface (Chapter 6.1, Standard Audio). Instead of being forced to use audio-

speciﬁc I/O routines, audio looks just like ﬁles.

More complex audio operations and redirections can be done using the audio drivers,

described Chapter 7, Audio Drivers.

6.1 Standard Audio

VSOS offers the user a standard audio source and destination, although the audio

source is only activated if an appropriate audio input driver is loaded (Chapter 7). Called

stdaudioin and stdaudioout, standard audio ﬁle handles are to sound much like stdin

and stdout are to standard input and output in standard C. It is not allowed for the user

to close standard audio input or output ﬁles, but the user may modify their parameters.

By default, stdaudioout is connected to analog output pins LEFT and RIGHT, although

this can be changed with appropriate audio drivers.

Both standard audio input and output open in stereo, 16-bit, 48 kHz mode. These pa-

rameters can be changed by the user, with driver and hardware dependent limitations.

The user may use all standard read and write operations to read from and write to

standard audio. It is, however, required that fread() / fwrite() functions are used instead

of character-based operations like fgetc() and fprintf(). It is also recommended to handle

larger chunks of samples, like 32, at a time.

Stereo samples are stored in an interleaved fashion. In 32-bit mode, the least signiﬁcant

word is stored ﬁrst. This is the same as the native VSDSP 32-bit word order.

Audio sample buffer 16-bit word order

Audio format Word 0 Word 1 Word 2 Word 3

16-bit stereo Left 0 Right 0 Left 1 Right 1

32-bit stereo Left 0 LSW Left 0 MSW Right 0 LSW Right 0 MSW

Rev. 3.57 2019-04-10 Page 10(62)

Ce manuel convient aux modèles suivants

Table des matières

Manuels Carte mère populaires d'autres marques

DFI

DFI SD170 Manuel utilisateur

ASROCK

ASROCK ROMED8-2T Manuel utilisateur

Asus

Asus P2L97A Manuel utilisateur

Winmate

Winmate IC70 Manuel utilisateur

Asus

Asus MES-B Manuel utilisateur

Grantech

Grantech SYS8F377VGGA-3OMN Manuel utilisateur

Telit Wireless Solutions

Telit Wireless Solutions SL869-3DR Manuel utilisateur

Gigabyte

Gigabyte GA-9IVDT Manuel utilisateur

Texas Instruments

Texas Instruments ADS8372EVM Manuel utilisateur

Commell

Commell MS-C73 Manuel utilisateur

IBT Technologies

IBT Technologies MB860 Manuel utilisateur

Nvidia

Nvidia TEGRA DG-04927-001_V01 Manuel utilisateur

Biostar

Biostar M7VIT Bravo Instructions d'utilisation et d'installation

Intel

Intel D33217CK Manuel utilisateur

Asus

Asus F1A55-M LX PLUS R2.0 Manuel utilisateur

EPC

EPC EPC9147C Manuel utilisateur

Asus

Asus EX-B760M-V5 D4 Manuel utilisateur

EPOX

EPOX MU-8KHA0010 Manuel utilisateur