Skip to content

About

SoundNet AES67LINK Controller repo

Resources

Stars

26 stars

Watchers

1 watching

Forks

Latest commit

 

History

23 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

AES67LINK GUI Instruction manual

AES67LINK logo

The AES67LINK is a comprehensive platform that covers all DSP functions of the entire audio chain, from source input and DSP processing to speaker output.

AES67LINK logo

The system is capable of routing and distributing all audio signals, performing DSP processing, and controlling and monitoring all devices, while maintaining lossless audio signal quality and ultra-low latency in accordance with the AES67 standard.

Any audio device can equipped with DL series network modules.

AES67LINK GUI Controller performs audio routing, DSP processing and network monitoring on DL module embedded devices and Digisyn VSC (AES67 Virtual Sound Card).

The AES67LINK system is optimized for large, demanding audio systems and is an ideal choice for any location that requires a powerful audio processing system and full compliance with broadcasting standards.

1. Software installation

  • Double-click the software installation package to install. You can choose the installation language. Simplified Chinese/English is supported. After selection, click OK.

  • Choose whether you need a shortcut. After selection, click Next.

  • If you need to reselect, you can click the previous step to return. If not, click Install.

  • Wait for about 5 seconds for the installation to be completed.

  • Click Finish to enter the software.

2. Language switching

At the lower left corner of the software, click the language button to switch languages. Simplified Chinese/English is supported:

2-1

3. Discover device

The software discovers and controls devices through the local area network. When opening the software, it is necessary to specify which network card of the computer is used (different network cards may correspond to different local area networks). If there is only one network card, the software will select it by default. If there are multiple network cards, it needs to be manually specified:

3-1

If the network cable of the computer is plugged or unplugged or the network is switched, the corresponding network card needs to be reselected. Click the menu and select it in the drop-down windowSet network card:

3-2

After selecting the network card, the software will automatically discover the devices in the corresponding local area network. Wait for about 5 seconds to discover the devices:

3-3

You can also refresh the device list by Menu - Refresh:

3-4

4. View device information and parameters

On the left side of the software, click Device Information column,You can view the basic information of the device:

4-1

  • Device name:_The name displayed by the device on the interface. You can be modified in theDevice configuration.Double-click the name of the device, click Device Configuration, find the device name in the device information column, and then click to modify it:

  • Device type:Used to distinguish device types. Different types correspond to different products, functions, and numbers of channels and cannot be modified.

  • Device ID:Used to uniquely identify a device. It will not change, will not be repeated, and cannot be modified.

  • Synchronization status: This status indicates the synchronization state of this device with the network's PTP master clock. A "Locked" status signifies that the device's clock is precisely synchronized with the master clock and the signal is stable; an "Unlock" status means the device is initializing, searching for the master clock, or undergoing time calibration. After connecting to the network, the device automatically starts the synchronization process and typically achieves a lock within one minute. This status information refreshes automatically every 5-10 seconds.

  • PPM:Description parameter for clock alignment of master and slave devices. Generally, it is within ±30.

  • Master/Slave:Whether it is a master device or a slave device. There is only one master device in a local area network. If there are other non-AES67LINK devices using PTP clocks, they will also participate in the selection of master and slave devices together. That is, if there is a non-AES67LINK device in the same local area network and its clock priority is higher, all AES67LINK devices on the software may act as slaves.

  • Clock priority: A parameter used to select master and slave devices. The range is 0-255. The smaller the value, the higher the priority. The default is 128. The system will automatically select the device with the highest priority (smallest value) in the network as the master device. You can manually specify a certain device to be the master (increase the priority). Virtual sound cards (VSC) and some special devices cannot be masters. The clock priority cannot be modified and is displayed as NA.

  • Version: Displays the firmware version number of the device. The version of the virtual sound card is viewed on the virtual sound card software. This page shows NA.

4-3

On the left side of the software, click the device parametercolumn,You can view the parameter information of the device:

  • Device name:Same as above. Device type: same as above. Device ID: same as above.

  • Sampling rate:The audio sampling rate of the device. If audio is transmitted between different devices, make sure the sampling rates are the same. It can be modified in "Device Configuration".

  • Packet time:A setting parameter for network audio data packets. It can be modified in "Device Configuration".

  • Running time:The continuous running time of the device since this startup. It can be sorted from largest to smallest or from smallest to largest.

  • Network latency:A setting parameter for network audio transmission latency. It can be modified in "Device Configuration".

  • Temperature:The temperature of the core part of the device. During normal use, control the temperature below 70°C and do not exceed 80°C.

  • Clock priority:It is a parameter used to select master and slave devices. The range is 0 to 255. The smaller the value, the higher the priority. The default is 128. The system will automatically select the device with the highest priority (smallest value) in the network as the master device. You can manually specify a certain device to be the master (increase the priority). Virtual sound cards and some special devices cannot be masters and cannot modify the clock priority, so "NA" is displayed.

  • Version:It shows the firmware version number of the device. The version of the virtual sound card can be viewed on the virtual sound card software. This page shows "NA".

5. Clock priority setting

It can be modified in the "Device Information" column. Click Device Informationto enter. Select the required device in the clock priority column for modification:

5

6. PTP DSCP Priority setting

It can be modified on the Device Details - Others page. After modification, click Restart to complete:

6

This parameter, in switches that support QoS, will affect the priority of the audio transmission stream. The range is 0 to 63, and the default is 46. The larger the value, the higher the priority and the higher the transmission stability.

7. IP Address setting

It can be modified on the Device Details - Device Configuration page of device Config. Two methods are supported: automatic acquisition and manual setting:

7

  • If it is automatic acquisition, make sure that the IP address of the computer is also obtained automatically, or manually set the same network segment.
  • If it is manual setting, make sure that the IP of the computer is also manually set and set in the same network segment. If the IP addresses of the computer or device are not in the same network segment, it will cause the device to be unable to be viewed/controlled normally (except when the switch is set to support cross-network segments).

8.Device details

8

On any page of Device Routing、Device Information、Device Parameters ,double-clicking the device name or device row will pop up theDevice Details page:

8.1 Device configuration

8.1

  • Device name:The name of the device can be modified. It cannot exceed 32 characters. By default, it is the same as the device ID.

  • Device ID:The unique ID for identifying the device cannot be modified.

  • Device type:Used to distinguish the device type and cannot be modified.

  • sampling rate:Audio sampling rate. It is distinguished according to the device type. For some types, it can be modified.

  • network latency:Network latency parameter. The smaller the value, the smaller the latency. However, it requires a better sending device and network environment. If you need the smallest possible latency, it can be set to 1ms (requiring a sufficiently good sending device and network environment). If you need better compatibility with the sending device and network environment, it can be set to 10ms. The default is 5ms. If using a virtual sound card as the sending device, since the virtual sound card depends on the computer system, it cannot be set to 1ms. You can set it to 5ms or 10ms according to the actual situation. (If there is discontinuity or packet loss at 5ms, it can be changed to 10ms).

  • Packet time: A parameter for network data packets. The network latency must be not less than 4 times the packet time. That is, if the packet time is set to 0.25ms, the network latency can be set to a minimum of 1ms. If the packet time is set to 1ms, the network latency can be set to a minimum of 5ms and cannot be set to 1ms. If you want to set the network latency to 1ms, you must first change the packet time to 0.25ms.

  • IP address:Display the IP address of the current device.

  • DHCP settings:The acquisition method of the device IP address supports automatic acquisition and manual setting. When setting manually, first click Modify, then enter the specified value in the corresponding input box, and click Submit. When setting manually, it is necessary to ensure that the IP address, subnet mask, DNS server address, gateway, etc. are correct. Otherwise, it may not be possible to view/obtain device information normally.

  • Reset IP address:If the IP address is in manual setting mode and incorrect parameters are set, resulting in the software being unable to view/obtain device information, the IP can be reset to change the device to automatic acquisition mode.

8.1-2

8.2 transport stream

8.2

Unicast stream:This page displays the unicast receiving, sending routing, stream records and status of the device. (This data is updated every time the device details are opened.)

  • rxChArr(rtpChId):The routing records of the receiving channels. The first number represents the channel ID (0 represents channel 1). The content in parentheses represents the subscript of rtpChArr, corresponding to the index of the rtcChArr(srcDevId,srcChId) list. -1 means there is no routing. For example, 0(-1) means that there is no routing record for receiving channel 1. 4(4) means that there is a routing record for receiving channel 5, and the routing record corresponds to the record 4(dmx208-5a7b066, 0) with an index of 4 in the rtcChArr(srcDevId,srcChId) list.The routing records are generated and deleted when checking the network audio routing on the routing interface. Generally, there is no need for manual maintenance. If the other device associated with the routing is offline and the routing record needs to be deleted, you can double-click the corresponding channel in the rxChArr(rtpChId) column to delete it.

  • rtpChArr(srcDevId, srcChId):srcDevId corresponds to the ID of the sending device. srcChId corresponds to the channel index of the sending device. 0 represents channel 1.

  • ucastArrRx(active, srcIp):It represents the array of unicast received data streams. "active" indicates whether it is active. 0 means inactive, and 1 means active. Only in the active state can audio streams be transmitted. "srcIp" represents the IP address of the sending device.

  • mcastArrRx(active, srcIp): Represents the array of multicast received data streams. "active" indicates whether it is active. 0 means inactive, and 1 means active. Only in the active state can audio streams be transmitted. "srcIp" represents the IP address of the sending device.

  • ucastArrTx(dstIp):Represents the array of sending channels that have currently established connections (the array index has nothing to do with the channel). "dstIp" represents the IP address of the receiving device.

  • mcastArrTx(dstIp, name):The array of multicast sending streams that have been created. "dstIp" represents the multicast stream address. "name" represents the multicast stream name.

8.2-2

multicast stream:This page can create, view, and delete multicast streams.

  • Multicast stream name:The name displayed after creation. It should not exceed 32 characters.

  • destination address:The address of the multicast stream. If there are no special requirements, automatic allocation can be selected. You can also customize the address.

  • Select channel:The sending channels that the multicast stream needs to include. The selected channels can be sent out using the multicast stream.

  • delete:You can delete the created multicast stream.

8.2-3

flow chart:Here you can view the functions of DSP input and output channels.

  1. The area represents the groups that the channels join. After the channels join the groups, they will be displayed here.
  2. The area represents the channel level indication. Green indicates there is a level, and gray indicates there is no level.
  3. The area represents the DSP function of the channel. Bright color indicates that the function is enabled (non-pass-through), and gray indicates that the function is not enabled (pass-through). Double-clicking the corresponding function box will pop up the detailed parameter setting page. Multiple detailed parameter setting pages can be opened at the same time. The DSP functions of different channels may be different.

8.2-4

  1. The area represents the mute, reverse, and gain functions. Mute and reverse can be toggled by clicking. Double-click gain to open the adjustment window.
  2. The area represents the current CPU usage. Enabling DSP functions (non-pass-through) will increase CPU usage, and disabling DSP functions (pass-through) will reduce CPU usage. CPU usage should not exceed 85%. Right-click on the channel number to pop up the function menu. You can copy and paste channel parameters and add/cancel channel grouping. Right-click on the DSP function block to pop up the function menu. You can copy and paste function parameters.

8.3 Channel volume and grouping:

8.2-5

  1. The area represents input, output channels, and group switching.
  2. The area represents the channel name. The gray part cannot be modified. It indicates whether it is an analog or network channel and the channel subscript. The black name can be modified by yourself. The length should not exceed 32 characters.
  3. The area refreshes the level of the channel in real time.
  4. The area represents channel gain, mute, and reverse.

8.2-6

  1. The area represents the group name.
  2. The area indicates which channels are under the corresponding group. It is divided into two parts. The upper part is the input/output channel and subscript, and the lower part is the channel name.

Matrix control:

8.2-7

  1. Area 1 contains shortcut functions for setting parameters in bulk.
  2. Area 2 is for selecting the mix type. If "Gain Sharing" is selected, the gain sharing method will be used when multiple input channels are mixed to a single output channel.
  3. Area 3 is a one-touch gain reset button that resets the gain of all input channels for the corresponding output channel to zero.
  4. Area 4 is the level meter display, which makes it easy to check for signal presence on the input and output channels.
  5. Area 5 indicates if the corresponding input channel is mixed to the corresponding output channel. Blue means it is mixed; blank means it is not.
  6. Area 6 shows the gain of the corresponding input channel mixed to the corresponding output channel. You can click it to open an adjustment window.

Program management:

8.2-8

  1. The area represents the system's default program. This program cannot be modified, deleted, saved, etc.
  2. The area represents the programs saved by yourself. 1-20 are customizations, supporting 20 custom programs.
  3. The area is the program manually loaded last time. If after loading, the parameters are manually adjusted, then the parameters will be saved in the state before shutdown and will not be automatically saved to the corresponding program. That is, if program A is manually loaded and then the parameters are modified, then after shutdown and restart, the modified parameters will still be effective. However, if program A is reloaded, the modified parameters will be lost. If you want to save the modified parameters to program A, you need to manually click "Save Program" to save them.
  4. The area is the management function area.
    • Save Program: Select the corresponding serial number in the list to save the current machine parameters to the program.
    • Load Program: Select the corresponding program in the list to load the program parameters into the machine.
    • Delete Program: Select the corresponding program in the list to delete the program from the machine.
    • Export to PC: Select the corresponding program in the list to export the program to a computer file. Import from PC: Select the corresponding serial number in the list to import a computer file into the machine.

8.4 Channel volume

8.4

  1. The area represents the switching between input and output channels.
  2. The area represents the channel name. The gray part cannot be modified and distinguishes between analog input, network input and channel number. The black part can be modified and the length should not exceed 32 characters.
  3. The area represents the channel level.
  4. The area represents channel gain and mute. Only analog channels have this function, while network channels do not.
  5. The area has functions for some specific models, but general models do not.

8.5 Delay statistics

8.5

  1. The area represents the data stream. If data is received from multiple devices or the number of receiving channels exceeds the number of channels that a stream can accommodate, there will be multiple data streams at this time. Switching can view the statistical data of different streams.
  2. The area represents statistical data. Before the machine is powered on and synchronized, the data will appear as a red bar. This is normal. At the beginning of power-on, the clock is not synchronized. After the clock is synchronized, the red color will no longer increase.
  3. The area can clear the data and perform statistics again. Generally, if an occasional individual red bar appears, it is due to fluctuations in the network environment and does not affect sound transmission. If there is a continuous increase in red data at intervals, it indicates abnormal network or device transmission, and troubleshooting is required.

8.6 Clock log

8.6

When the clock log page is opened, it will monitor the log information of the device. This information is used for device debugging and can be used to check whether the clock synchronization is normal.

8.7 Others

8.7 This page displays the version information, device code, temperature, running time, etc. of the device. This page can set the Ptp DSCP priority. This page can restart the device (some models support this function. For some devices, a full power-off restart is required).

9. Device network routing settings

The device routing configuration is all configured for network channels. The channels in the following figure are all network input and output channels.

9

  1. The area is the sending device list. After expanding it, you can see the network sending channels of the device.
  2. The area is the receiving device list. After expanding it, you can see the network receiving channels of the device.
  3. The area is whether to route. The selected state means that the network sending channel signal of the device corresponding to area 1 is sent to the network receiving channel of the device corresponding to area 2.

10. Device firmware upgrade

10

ClickMenu - Firmware Upgrade,and the firmware upgrade interface will pop up:

10.-2

  • Select network card:For a computer with only one network card, the default selection is fine. For a computer with multiple network cards, select the network card corresponding to the device local area network. If they are not in the same local area network, the device cannot be found.

  • Select firmware:Select the firmware upgrade package used for machine upgrade. Do not unzip the upgrade package. Just select it directly. The upgrade package model must be corresponding, otherwise the upgrade will fail. The version of the device and the upgrade package must be corresponding, otherwise the upgrade will fail and the machine will be abnormal. For devices with version 3.x.x, the latest firmware version can be directly upgraded. For devices with version 2.x.x, a specific firmware upgrade package needs to be used to upgrade to 3.0.7 first, and then upgrade to the latest version. Click "Refresh Device", and all devices in the network will be displayed. If there are any that do not appear, click "Refresh" twice more. Select the corresponding device. Be sure to check the type and distinguish the device to be upgraded through IP address, device name, and device ID. Click "Start Upgrade" and observe the "Status" column until the upgrade is completed.

11. Advanced functions

11.1 Custom DSP function

11.1-1

For device types that support the DSP function, enter the "Audio Processing" page. Press and hold Ctrl+8 at the same time, and enter the control code 6689. A "Customize" button will be displayed in the upper left corner. Click "Customize" to enter the custom DSP page.

11.1-2

  1. The area is for devices that support automatic mixing and echo cancellation. Functions can be added here.
  2. The area is for canceling customizations and saving custom functions.
  3. The area is for CPU usage assessment. The custom DSP function cannot exceed the maximum CPU occupancy rate.
  4. The area is the button for adding DSP functions. Clicking it can freely add function blocks. For equalization, high pass, and low pass, only one can be set for each channel. For the delay function, all channels share a delay upper limit.
  5. In the area, for the corresponding DSP function, right-click to delete the function block. Right-click on the channel ID to copy the function block of the entire channel and paste it to other channels.

11.2 Modify the number of channels of the module

Note: For devices with DSP functionality, after modifying the channel count, you must also update the DSP configuration file according to section "11.3". Otherwise, the channel count will not match the original configuration file, and the DSP function will not load correctly.

1. Modify Module Channel Count Directly in the GUI

On the device you wish to modify, switch to the "Status" page. Press ctrl + 8 and enter the control code 6688. The parameter configuration page shown below will appear. Here, you can modify various parameter configurations, including the device channel count.

ChangeDeviceConfgi

  1. Area 1 displays the current configuration parameters of the device. You can modify the value corresponding to each parameter directly (e.g., to change the current device's analog input channel count from 4 to 2, change chNum_phyRx=4 to chNum_phyRx=2). After modification, click the "Modify Config" button in Area 3 on the right, and wait for the device to restart for the changes to take effect.
  2. Area 2 functions consistently with Area 1 (when modifying device parameters, using either area is sufficient). Each parameter provides several common configuration options (if the option you want is not provided here, you can modify the corresponding parameter line in Area 1). After modification, click "Modify Config" on the right and wait for the device to restart.

Each parameter line in Area 1 corresponds to a parameter in Area 2, as follows:

Parameter in Area 1 Corresponding Parameter in Area 2
chNum_phyRx Analog Input Channel Count
chNum_phyTx Analog Output Channel Count
chNum_dspFromNet Network Input Channel Count
chNum_dspToNet Network Output Channel Count
sampleRate Sample Rate
fmtType Audio Format
fmtIndex Audio Format Type
mclk Master Clock Frequency
inv_lrclk LR Clock Inversion
inv_bclk Bit Clock Inversion

2. Modify Module Channel Count via UDP Control Commands

For some devices, after entering the 6688 control code, the situation shown below may occur. This indicates that the device does not support direct parameter modification via the interface. You need to set the device's configuration parameters by sending control commands via UDP.

11.2

The GUI includes a built-in UDP tool (refer to "11.4 UDP Test Tool"). On the "Status" tab of the device interface, press ctrl + 8 and then enter 8008. The following interface will appear.

11 .4

  • In the UDP send window on the right, send the following JSON string to the fixed port 9993 to set the specified configuration parameters for the target device. (Note: The values in cfg are examples only; fill them in as needed. You do not need to include all parameters. If you only want to modify the analog channel count, cfg only needs to include chNum_phyRx=?\nchNum_phyTx=?\n.)
{
    "ops": "setCfg",
    "cfg": "chNum_phyRx=8\nchNum_phyTx=8\nchNum_dspFromNet=0\nchNum_dspToNet=0\nsampleRate=48000\nfmtType=i2s\nfmtIndex=0\nmclk=24576000\ninv_lrclk=0\ninv_bclk=0"
}
  • After modifying the device's configuration parameters, manually restart the device and wait for the restart to complete.

11.3 Modifying the default DSP configuration

For devices equipped with DSP functionality, after modifying the channel count, the DSP configuration file must be updated. Otherwise, the channel count will not match the original configuration file, and the DSP function will not load correctly.

After modifying the channel count in section 11.2, reboot the device to apply the changes. Then, enter "Advanced Config".

EnterAdvancedConfig

As shown in the image, verify that the input/output channel counts and sample rate are correct. Click "SetDevDefault" (Do not click the "DSP" page before completing this step, otherwise the advanced configuration modification will fail), to reset the DSP configuration. After resetting the DSP configuration, the device must be rebooted for the changes to take effect, completing the modification process.

11.3

11.4 UDP Test tool

11 .4 For devices that support UDP communication, on the Device Information - Other page, simultaneously hold down 'Ctrl+8' and enter the control code '8008', and the UDP test tool page will be displayed.

  1. The area can be used to receive UDP data;

    • If no data is received for a long time, check whether the firewall has blocked the UDP communication.
    • setctl can enable the ssh remote login function of the device.
    • Checking the memory can display the memory status of the device.
  2. The area can be used to send UDP data;

    • The data to be sent can be entered in the text box. The sent data and the message replied by the receiving device will be displayed in the receiving text box on the left.
    • The device to which the data is to be sent and the service to be enabled can be specified based on the IP and port number.

12. Troubleshooting

12.1 When the software starts, it prompts that the xxx.dll library is missing.

The prompt for the lack of a dll library indicates that the computer system lacks Microsoft runtime libraries. Downloading Microsoft VC++ runtime library collectionand installing it can solve the problem.

12.2 The software cannot detect the device

Check whether the network card selection is normal. Be sure to select the network card in the same local area network as the device. Check whether the firewall has blocked the software from connecting to the Internet. Through the firmware upgrade program, check whether the device can be searched. If the firmware upgrade program can search but the software cannot detect it, first check the above two items. Check whether the network port light of the device is flashing. If the network port light is not flashing, first check the hardware.

12.3 The software can detect the device but cannot control it

Check whether the network card selection is correct. Check whether the IP address of the computer and the IP address of the device are in the same local area network. Check whether the computer has set a fixed IP, resulting in the computer and the device not being in the same local area network. Check whether the network is normal. Check "Device Parameters" to see if the running time can be obtained. If the running time cannot be obtained, check the computer network and switch status (you can check for packet loss through the ping command). Sometimes, when a laptop uses a USB network port adapter, there may be problems with poor network connectivity.

12.4 Firmware upgrade fails

Check whether the network card selection is correct. Be sure to select the network card in the same local area network as the device. Check whether the firewall has blocked the software. Check whether the firmware type is consistent with the device type. Check whether the firmware version is correct. If the firewall is enabled, the following programs need to be set to allow network access:

  • DigisynLink3.exe
  • DigisynLink3Upgrade.exe
  • gohttpserver.exe

About this repository

  1. This repository is for storing the SoundNet AES67LINK software package and the user manual. To download AES67LINK, please register at DIGISYNTHETIC DOCS.
  2. For more information, please visit www.digisynthetic.com.

About

SoundNet AES67LINK Controller repo

Resources

Stars

26 stars

Watchers

1 watching

Forks

Releases

Contributors