{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"As shown below, there are 3 main components of an Audio Weaver system that require communication in order to tune an audio system. The Designer GUI will generate text based tuning commands (AWS) based on the layout and any user tuning commands. These commands are sent to AWE Server, which in turn compiles the AWS commands into binary commands (AWB) that can be sent to the target running the AWE Core. The target processes the AWB commands and then generates a reply message that is sent back to the AWE Server.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"__fileSize":105165,"__fileMimeType":"image/png","width":1027,"id":"3178111f-d408-4a90-9770-8f5da8670a15","collection":"contentId-2629304440","type":"file","__fileName":"image-20221229-192811.png","height":359}}]},{"type":"paragraph","content":[{"text":"The text-based commands may also be generated by external tools and scripts rather than by Designer. An example script, written in python, that connects to the AWE Server at port 15001 and reads and writes a module’s variable in an active layout in real-time is shown below. The remainder of this document describes the full set of tuning commands and arguments.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"python"},"content":[{"text":"import socket\nimport time\n\nTCP_IP = 'localhost'\nTCP_PORT = 15001\nBUFFER_SIZE = 1024\n\n# Open a TCP socket\ns = socket.socket(socket.AF_INET, socket.SOCK_STREAM)\ns.connect((TCP_IP, TCP_PORT))\n\n# Read the value of the scaler\ns.send('get_value,ScalerDB1.gainDB\\n')\ndata = s.recv(BUFFER_SIZE)\nprint data\n\n# Attenuate channel 1\ns.send('set_value,ScalerDB1.gainDB\\n,-40\\n')\ndata = s.recv(BUFFER_SIZE)\nprint data","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"INI file settings","type":"text"}]},{"type":"paragraph","content":[{"text":"Colors may be customized in the INI file as follows:","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"[InspectorColors]","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"TileEdge ","type":"text","marks":[{"type":"strong"}]},{"text":"— default 180,180,180, the color the edges of meter and slider controls are drawn.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"DrawSides ","type":"text","marks":[{"type":"strong"}]},{"text":"— default 1, when set boxes are drawn around meter and slider controls using TileEdge color","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"InspectorFace ","type":"text","marks":[{"type":"strong"}]},{"text":"— default 230,230,230, the color dialog faces (other than the server dialog) are drawn","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"DropList ","type":"text","marks":[{"type":"strong"}]},{"text":"— default 240,240,255, the color drop list backgrounds are drawn","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"TextColor ","type":"text","marks":[{"type":"strong"}]},{"text":"— default 0,0,0, the color static text controls are drawn","type":"text"}]},{"type":"paragraph","content":[{"text":"By default none are specified in the INI file, so the given defaults are used.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Commands","type":"text"}]},{"type":"paragraph","content":[{"text":"All commands are sent by TCP/IP. All commands are of the form:","type":"text"}]},{"type":"paragraph","content":[{"text":"[coreID,] command_key_word [, argN]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"in other words, a CSV string. White space is not significant in commands unless within a string value. Any value containing commas (generally only file names) must be quoted with double quotes. Arguments may be redundantly double-quoted.","type":"text"}]},{"type":"paragraph","content":[{"text":"If present, the numeric coreID specifies the core for which the command is intended. Multicore systems have cores with IDs starting at zero. If no ID is specified, zero is assumed. Single core systems have only one core with ID zero. In the following sections, core IDs are not shown in command descriptions.","type":"text"}]},{"type":"paragraph","content":[{"text":"Multicore systems have 2 or more cores. On SMP systems (Windows and Linux) you can specify how many cores you want to use. Embedded systems have a fixed number of cores. In both cases, each core is an independent AWE instance sharing system I/O with all other cores. Up to 16 cores may be bound to an input (source) pin, and IPC pins are provided to pass data between cores.","type":"text"}]},{"type":"paragraph","content":[{"text":"Some commands such as destroy, audio_pump, audio_stop and so on are commands to the system (or BSP), not to any specific core/ Such commands may have a core ID prefix, but it is ignored. These commands are considered to be BSP commands, and are noted as such in the detailed description.","type":"text"}]},{"type":"paragraph","content":[{"text":"Commands are received on one of 6 sockets:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"15001 - for Designer use","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"15003 - for Designer GUI use","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"15005 - for special use (advanced)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"15007 - general purpose","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"15009 - general purpose","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"15011 - general purpose","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"When using command line server in a user system avoid using the first three sockets so Designer has sockets available for tuning and control. The general purpose sockets are for user use.","type":"text"}]},{"type":"paragraph","content":[{"text":"Commands marked below as GUI only act only in Windows AWE Server. Those commands report success and are ignored on command line versions.","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply from all commands is either:","type":"text"}]},{"type":"paragraph","content":[{"text":"success [, args ...]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"or","type":"text"}]},{"type":"paragraph","content":[{"text":"failed, reason","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The command keyword is not case sensitive.","type":"text"}]},{"type":"paragraph","content":[{"text":"All commands may fail for reasons not to do with the command. If the target crashes, or the link goes down, you may get a reply failed,reason explaining what failed. Most commonly, these will be:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,heap allocation request too large\t(ran out of heap in any command)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,bad packet received\t(target probably crashed)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,message too long\t(target BSP configuration error likely)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,bad heap pointer\t\t(target probably crashed)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,CRC error\t(link corruption or BSP memory corruption)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,communications error\t(link corruption or BSP memory corruption)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,message timed out\t(link failed or target crashed)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,linked list corrupted\t(target memory corrupted)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Details of all possible target errors are in Errors.h. Most are specifically due to errors in the command. However, obscure cases can arise with any command that can cause any message in Errors.h. All command replies should be tested for failed and appropriate action taken. Never ignore command replies.","type":"text"}]},{"type":"paragraph","content":[{"text":"The commands are summarized as follows (expand to view table):","type":"text"}]},{"type":"expand","attrs":{"title":"Click to expand"},"marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"type":"table","attrs":{"layout":"default","localId":"edf5e376-50fe-463f-ac74-387da51a42b0"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"Command","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"add_module","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#add_module"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Adds one or more modules to a given layout.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"add_symbol_id","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#add_symbol_id"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Defines a new entry in the symbol table based on the unique ID of the object.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"audio_pump","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#audio_pump-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Run the layout using either WAV/MP3 files, or audio line input as the source (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"audio_stop","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#audio_stop-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Stop the audio pump if running (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"bind_wire","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#bind_wire"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Binds a named wire to an input or output pin","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"close_input","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#close_input-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Close an audio device used for combined input, giving zero samples in its place","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"close_output","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#close_output-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Close an audio device used for combined output","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"cmd","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#cmd"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Generic command handler (advanced).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"compile","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#compile-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Compiles an AWS script file to AWB binary form (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"connect","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#connect-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Initiates a connection from a client (backward compatibility, ignored, BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"clear_credentials","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#clear_credentials-(Windows)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Removes credentials from the INI file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"clear_symbols","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#clear_symbols-(Windows%2C-Linux)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Empty the server symbol table. (Windows, Linux)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_active","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_active-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a control to display 4 radio buttons of module state (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_bitmap","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_bitmap-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates an image control on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_button","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_button-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a button on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_checkbox","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_checkbox-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a checkbox on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_dialog","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_dialog-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a named dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_droplist","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_droplist-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a drop list control on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_awslist","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_awslist-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a drop list control specifying AWS script files allowing the user to select and run presets from the list (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_edit","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_edit-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates an edit box control on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_filelist","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_filelist-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a file list control on a dialog. Used for streaming files to the target (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_graph","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_graph-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a graph control that represents array elements as bar graphs (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_grid","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_grid-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a grid control operating as as small spreadsheet for manipulating one or two dimensional arrays (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_layout","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_layout"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a layout with the specified properties","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_led","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_led-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates an LED style control on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_lookup","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_lookup"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates an O(1) ID lookup table","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_meter","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_meter-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a meter control on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_module","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_module"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a module with the specified properties","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_slider","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_slider-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a slider or knob control on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_spline","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_spline-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates an X-Y spline control on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_text","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_text-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a static text control on a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"create_wire","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#create_wire"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a wire with specified properties","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"deferred_process","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#deferred_process"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Cause deferred commands to be executed.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"delete_file","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#delete_file-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Deletes a file (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"destroy","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#destroy-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Unconditionally destroys all created objects (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"destroy_dialog","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#destroy_dialog-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Destroys a dialog (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"dialog_state","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#dialog_state-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Toggles between normal and expanded views (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"end_binary","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#end_binary-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Stops logging of binary commands sent to the target (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"erase_all","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#erase_all-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Erases all files in the target file system (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"exists_dialog","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#exists_dialog-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Checks if a dialog with a specified name exists (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"exit","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#exit-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Causes the server to exit (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"fast_audio_pump","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_audio_pump-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Run a layout using only files at the greatest possible speed. Intended for test (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"fast_read","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_read-(Matlab)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Reads float arrays of binary data (Matlab)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"fast_read_int","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_read_int-(Matlab)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Reads integer arrays of binary data (Matlab)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"fast_write","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_write-(Matlab)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Writes arrays of binary float data (Matlab)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"fast_write_int","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_write_int-(Matlab)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Writes arrays of binary integer data (Matlab)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"fast_write_partial","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_write_partial-(Matlab)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Writes arrays of binary float data without performing a set call (Matlab)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"fast_write_int_partial","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_write_int_partial-(Matlab)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Writes arrays of binary integer data without performing a set call (Matlab)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"file_exists","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#file_exists-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Report if a specified file exists (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"file_logging","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#file_logging-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies whether to log commands and replies to a file (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"file_to_pin","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#file_to_pin-(BSP)--NOT-IMPLEMENTED"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Bind a WAV file to an input pin as a file player (BSP)","type":"text"},{"type":"hardBreak"},{"text":"THE COMMAND IS NOT IMPLEMENTED.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"foreground","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#foreground-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Brings all Audio Weaver windows to the foreground thus making them visible (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"framework","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#framework-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Change the connected target (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"getini","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#getini"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns an entry from the AWE_Server.ini file (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_call","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_call"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Calls the get_call function of a module","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_cores","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_cores-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the number of cores or instances.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_core_list","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_core_list-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the number of cores or instances, and their IDs.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_executable_dir","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_executable_dir-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the directory containing the AWE_Server.exe executable (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_extended_info","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_extended_info"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the target’s extended info.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_filesystem_info","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_filesystem_info-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns information about the target file system (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_first_core","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_first_core-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Return info on the first (and possibly only) core (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_first_file","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_first_file-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the properties of the first file (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_first_io","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_first_io"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the properties of the first I/O object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_first_object","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_first_object"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the properties of the first object instance","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_heap_count","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_heap_count"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the number of framework heaps","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_heap_size","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_heap_size"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the free space and sizes of the heaps","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_instance_table","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_instance_table-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the number of cores or instances and their IDs.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_moduleclass_count","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_moduleclass_count"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the number of module classes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_moduleclass_info","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_moduleclass_info"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns information about the specified module class","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_module_state","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_module_state"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the muted etc. state of the given module","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_next_core","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_next_core-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Return info on cores after the first (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_next_file","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_next_file-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the properties of the next file, or fails if no more (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_next_io","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_next_io"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the properties of the next I/O object, or fails of no more","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_next_object","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_next_object"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the properties of the next object, or fails if no more objects","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_object_byname","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_object_byname"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the properties of the named object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_rate","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_rate"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the properties of an audio file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_schema","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_schema-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the schema for a class (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_target_info","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_target_info"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the detailed info for an AWE instance.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_type","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_type-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Report the type of an expression (int, float, ...) (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_value","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_value"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the value of a symbolically specified location","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"get_version","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_version-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the current version number of Audio Weaver (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"gui_logging","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#gui_logging-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Controls whether commands and replies are logged on the server control panel (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"kill_pump","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#kill_pump-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Cause the audio pump to die","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"make_binary","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#make_binary-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Starts logging of binary target commands to a named file (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"open_web_page","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#open_web_page-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Launches a browser and displayed a specified page (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"pin_to_file","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#pin_to_file---(NOT-IMPLEMENTED)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Bind a file writer to an output pin","type":"text"},{"type":"hardBreak"},{"text":"THE COMMAND IS NOT IMPLEMENTED.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"pump","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#pump"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Pump the entire framework once","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"pump_layout","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#pump_layout"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Pumps the given layout once","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"pump_module","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#pump_module"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Executes the pump function of the given module","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"query_pin","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#query_pin"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Queries a named pin for its properties","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"query_pump","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#query_pump-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Test if the audio pump is running","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"query_wire","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#query_wire"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Queries a named wire for its properties","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"read_file","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#read_file-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Reads from a file (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"read_float_array","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#read_float_array"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Reads values from an array as floats","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"read_fract_array","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#read_fract_array"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Reads values from an array as fracts reported is floating values","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"read_int_array","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#read_int_array"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Reads values from an array as integers","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"reboot_target","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#reboot_target-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Cause an embedded target to reboot. Ignored by Windows and Linux","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"rename_pin","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#rename_pin-(BSP)----(NOT-IMPLEMENTED)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Change the name of a pin","type":"text"},{"type":"hardBreak"},{"text":"THE COMMAND IS NOT IMPLEMENTED.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"reopen_input","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#reopen_input-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Reopen an input device previously closed with close_input","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"reopen_output","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#reopen_output-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Reopen an output device previously closed with close_output","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"script","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#script-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Executes a script file containing commands (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"select_core","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#select_core-(BSP%2C-Windows)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Choose which core to report on (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"setini","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#setini-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Writes a specified INI file entry with a value (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"set_call","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_call"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Calls the set_call function of a module","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"set_core_description","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_core_description-(BSP%2C-Windows%2C-Linux)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Sets a description file used for target emulation","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"set_cores","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_cores-(BSP%2C-Windows%2C-Linux)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"For multicore SMP systems you can specify how many cores to use (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"set_instance_id","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_instance_id"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Change the ID of some module to the specified ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"set_module_state","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_module_state"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Sets a given module to muted, activated, bypass, or disabled","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"set_path","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_path-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Set the path to search for audio files used by audio_pump","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"set_pointer","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_pointer"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Assigns a symbolically specified location a pointer value","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"set_value","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_value"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Assigns a symbolically specified location a value","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"show","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#show-(BSP%2C-GUI-only)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Allows the server dialog to be hidden while child dialogs are up (BSP, GUI only)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"target_execute","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#target_execute-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Cause an embedded target to run an AWB file from its local file system","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"trace","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#trace-(BSP%2C-Linux)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Cause a target to echo a message to stdout.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"update_lookup","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#update_lookup"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Updates the O(1) ID lookup table after IDs have been changed by assignment (legacy support only, ignored)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"write_file","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#write_file-(BSP)"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Write to a target file system file (BSP)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"write_float_array","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#write_float_array"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Writes values to a float array","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"write_float_array_partial","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#write_float_aray_partial"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"As write_float_array, but no set call.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"write_fract_array","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#write_fract_array"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Writes values to a fract array","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"write_fract_array_partial","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#write_fract_array_partial"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"As write_fract_array, but no set call.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"write_int_array","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#write_int_array"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Writes values to an integer array","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"write_int_array_partial","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#write_int_array_partial"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"As write_int_array, but no set call.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[256.0]},"content":[{"type":"paragraph","content":[{"text":"write_pump_read","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#write_pump_read"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[753.0]},"content":[{"type":"paragraph","content":[{"text":"Write input wire, pump, layout, read output wire. Intended for test","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"add_module","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"add_module,layout_instance_name,offset,module1, ... ,moduleN","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"layout_instance_name","type":"text","marks":[{"type":"em"}]},{"text":" – identifier for a previously allocated layout,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"offset","type":"text","marks":[{"type":"em"}]},{"text":" – must be an integer >= 0,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"each ","type":"text"},{"text":"moduleI","type":"text","marks":[{"type":"em"}]},{"text":" must be the name of a module created by ","type":"text"},{"text":"create_module","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This call adds the specified modules to the layout. The layout and modules must already have been allocated by previous server calls. The layout internally contains an array of module pointers. This function sets the module pointers starting at the zero-based offset within the array. Call this function multiple times to populate all modules within the layout. ","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"add_symbol_id","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"add_symbol_id,name,className,ID","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Adds an entry to the symbol table based on its ID within the linked list of objects. Arguments:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"name ","type":"text","marks":[{"type":"em"}]},{"text":"- name of the object. Must be unique.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"className","type":"text","marks":[{"type":"em"}]},{"text":" - class name of the object. (Module class, wire class, etc.)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"ID ","type":"text","marks":[{"type":"em"}]},{"text":"– unique ID assigned to the object at instantiation time.","type":"text"}]},{"type":"paragraph","content":[{"text":"If successful, an object of the specified ","type":"text"},{"text":"className ","type":"text","marks":[{"type":"em"}]},{"text":"will be added to the symbol table. This command is typically used to attach to a running layout.","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply is one of:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,name=0x%08x","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed, argument count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed, ID invalid","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed, no such class as className","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed, instance name already defined","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"audio_pump (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"audio_pump [, file_name [,record=record_file] ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"file_name","type":"text","marks":[{"type":"em"}]},{"text":" is given, creates a WAV/MP3 file reader at the rate of the file, otherwise creates a sound card reader. It then creates an output device, and calls the framework pump at a rate suitable to pump samples.","type":"text"}]},{"type":"paragraph","content":[{"text":"If there are no wires bound to input or output pins, the code directly connects the input to the output, making a simple player. This capability is for testing.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the second argument starts with 'record=' then a file is specified to capture output. This file will be a WAV file with as many channels as the output and at the same rate. Warning: this file will grow without bound, and should be used only for limited test purposes.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the layout specified rate does not match the rates supported in hardware, the nearest supported rate is used.","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply is one of:","type":"text"}]},{"type":"paragraph","content":[{"text":"Success, sample rate","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed, open sound card for input returned an error","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed, player create returned 0x%08x","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed, renderer create returned 0x%08x","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where the value is the error code from the sound subsystem.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the server is connected to a target, the ","type":"text"},{"text":"file_name","type":"text","marks":[{"type":"em"}]},{"text":" argument is not permitted. If the file is not found as specified, and does not have an absolute path, it is searched for in the audio path. See ","type":"text"},{"text":"set_path","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_path-(BSP)"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"audio_stop (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax","type":"text"}]},{"type":"paragraph","content":[{"text":"audio_stop","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Unconditionally terminates the audio pump if running. The reply is always:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"If the server is connected to a target, the target DMA and rendering is halted.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"bind_wire","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax","type":"text"}]},{"type":"paragraph","content":[{"text":"bind_wire,wireName,pinName","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Causes ","type":"text"},{"text":"wireName ","type":"text","marks":[{"type":"em"}]},{"text":"to be bound to the ","type":"text"},{"text":"pinName","type":"text","marks":[{"type":"em"}]},{"text":". It is an error for an output I/O pin to be bound more than once. Input or Output are the default I/O pins. All wire binding is released by destroy.","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,heap1,heap2,heap3","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"clear_credentials (Windows)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"clear_credentials","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Unconditionally removes the user credentials and if it exists the off-line license from the INI file. The command has effect on Windows only and does not involve the target in any way.","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"clear_symbols (Windows, Linux)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"clear_symbols","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Empties the server symbol table. This does not involve the target in any way.","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"close_input (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"close_input,devIndex","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"When several device are merged for audio input (numbered 0 - N-1) close one of these devices by its index, causing zero samples to be generated in its place. This command is a specialized command for users that need to disconnect from a device that is about to be reconfigured. See ","type":"text"},{"text":"reopen_input","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#reopen_input-(BSP)"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"close_output (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"close_output,devIndex","type":"text"}]},{"type":"paragraph","content":[{"text":"When several device are merged for audio output (numbered 0 - N-1) close one of these devices by its index. Samples being written to that device are discarded. This command is a specialized command for users that need to disconnect from a device that is about to be reconfigured. See ","type":"text"},{"text":"reopen_output","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#reopen_output-(BSP)"}}]},{"text":",","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"cmd","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"cmd,opcode [,arg1, ... ,argN]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This is a backdoor command, which allows an arbitrary command packet to be sent to the target. Where","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"opcode ","type":"text","marks":[{"type":"em"}]},{"text":"– 8-bit command opcode (see ProxyIDs.h)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"arg1, … , argN","type":"text","marks":[{"type":"em"}]},{"text":" – packet payload. No CRC; this is automatic.","type":"text"}]},{"type":"paragraph","content":[{"text":"Some commands do not take any arguments. For example, a call to destroy the target would look like","type":"text"}]},{"type":"paragraph","content":[{"text":"cmd,12","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Another example is a call to Create Module. It calls ClassModule_Constructor(), and its arguments are:","type":"text"}]},{"type":"paragraph","content":[{"text":"cmd,15,1,,,,,...,,,...,","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where the number of wires J is encoded in the nIO bitfield. The command has one result - the module address.","type":"text"}]},{"type":"paragraph","content":[{"text":"The return is either:","type":"text"}]},{"type":"paragraph","content":[{"text":"success [, ... ,]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"or a normal failure code.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"compile (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"compile,flags,source_file,destination_file [, target_buffer_size ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Instructs the server to compile ","type":"text"},{"text":"source_file ","type":"text","marks":[{"type":"em"}]},{"text":"which must be a file containing valid commands from this document (generally an AWS file created by Designer) into ","type":"text"},{"text":"destination_file ","type":"text","marks":[{"type":"em"}]},{"text":"in AWB binary format.","type":"text"}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"target_buffer_size ","type":"text","marks":[{"type":"em"}]},{"text":"is not specified, then 264 is assumed. Commands will be compiled so as to fit in the specified command buffer. It is important when compiling for a target with a non-default buffer size to specify the buffer size to use. Note that current AWE builds have a buffer size of 4105. The command will fail if the buffer size specified is outside the range 16-4105.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"flags ","type":"text","marks":[{"type":"em"}]},{"text":"argument is no longer used. It is retained for backwarsd compatability, supply zero.","type":"text"}]},{"type":"paragraph","content":[{"text":"The command fails if ","type":"text"},{"text":"source_file ","type":"text","marks":[{"type":"em"}]},{"text":"contains a ","type":"text"},{"text":"make_binary ","type":"text","marks":[{"type":"strong"}]},{"text":"command.","type":"text"}]},{"type":"paragraph","content":[{"text":"The command silently strips any command that tries to read a value in any way, or to operate in any way on a GUI object (inspector dialogs) from the output bit stream.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success, the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"otherwise ","type":"text"}]},{"type":"paragraph","content":[{"text":"failed,reason","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"There are many possible reasons for failure.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"connect (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"connect,client_name,port","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Instructs the server to reply to client_name on the given port. client_name must be the name of the PC running the client. The reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,client_name,port","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"On receipt of this reply, the client knows it is connected.","type":"text"}]},{"type":"paragraph","content":[{"text":"This command is for legacy purposes only, and does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_active (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_active,dialog,left,top,moduleName [, bgnd_color [, text_color]]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog – ","type":"text","marks":[{"type":"em"}]},{"text":"must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,","type":"text","marks":[{"type":"em"}]},{"text":" – describes a position on the dialog surface","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"moduleName – ","type":"text","marks":[{"type":"em"}]},{"text":"a dot-expression that evaluates to the name of a module, optionally multiple expressions separated by semicolons may be used","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"bgnd_color","type":"text","marks":[{"type":"em"}]},{"text":" – will be the dialog background color, default from [InspectorColors] InspectorFace=230,230,230","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"text_color","type":"text","marks":[{"type":"em"}]},{"text":" – will be the text color of text controls, default [InspectorColors] TextColor=0,0,0","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a small control comprising 4 radio buttons in the order Active, Muted, Bypassed, Inactive. The control initializes its state from the specified module (or first module if there are several semicolon separated names). At 5Hz, it reads the module state (or first module if there are several semicolon separated names), causing the display to update if the module state changes.","type":"text"}]},{"type":"paragraph","content":[{"text":"On choosing a radio button, all modules (if there are several semicolon separated names) will be set to the new state.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_bitmap (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_bitmap,dialog,left,top,width,height,fileName","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog","type":"text","marks":[{"type":"em"}]},{"text":" – must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes a rectangle on the dialog surface","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"fileName – ","type":"text","marks":[{"type":"em"}]},{"text":"is the name of an image file (BMP only) to display","type":"text"}]},{"type":"paragraph","content":[{"text":"Causes the specified image to be rendered on the dialog in the specified rectangle. Images are rendered beneath any controls the dialog may have, and, if more than one is specified, are drawn in order – that is the most recently specified bitmap appears above all earlier ones.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the height or width are negative (usefully –1), then only the [top,left] position is used – the size of the rectangle is obtained from the image; otherwise the image is stretched or shrunk as needed in both axes to fit the rectangle specified.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_button (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_button,dialog,left,top,width,height,caption,script_file","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog","type":"text","marks":[{"type":"em"}]},{"text":" – must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes a rectangle on the dialog surface","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"caption ","type":"text","marks":[{"type":"em"}]},{"text":"– the text to appear on the button face","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"script_file","type":"text","marks":[{"type":"em"}]},{"text":" – names a file of commands to be executed when the button is clicked","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a button control on the dialog of the specified size. On clicking the button ,the commands in the scrip file are executed.","type":"text"}]},{"type":"paragraph","content":[{"text":"ScriptFile may be commands instead of a filename, those commands are:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"RemoveControls ","type":"text","marks":[{"type":"em"}]},{"text":"– deletes all the controls on a dialog","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"RemoveBitmaps ","type":"text","marks":[{"type":"em"}]},{"text":"– deletes all the images created by create_bitmap.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_checkbox (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_checkbox,dialog,left,top,width,height,legend,attributes,dot-expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog – ","type":"text","marks":[{"type":"em"}]},{"text":"must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes a rectangle on the dialog surface","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"legend – ","type":"text","marks":[{"type":"em"}]},{"text":"the text to appear to the right of the checkbox","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"attributes – ","type":"text","marks":[{"type":"em"}]},{"text":"a string of attribute controlling the appearance of the check box control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dot-expression","type":"text","marks":[{"type":"em"}]},{"text":" – an expression to assign the value of the checkbox (0=not checked, 1=checked) each time the state of the checkbox changes","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes string must be a space separated string consisting of one or more of the following. If items are repeated, the right-most one is the one that takes effect.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"readonly=val","type":"text","marks":[{"type":"em"}]},{"text":" – 0 or 1, default 0; – when set prevents the user changing the selection","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a checkbox control on the dialog of the specified size. On clicking the checkbox (causing its state to toggle) the new check state is assigned to the dot-expression. As with all assignments, the Set() function of the appropriate module is called after the assignment. At a rate of 5Hz, the expression is examined: if it changes the check mark is updated.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_dialog (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_dialog,dialogName,left,top,width,height,width2,height2,caption[ ,bgnd_color [, combo_color [, text_color]]]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialogName","type":"text","marks":[{"type":"em"}]},{"text":" – must be a an identifier not in use by any object","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes the size and position of the dialog surface","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"width2,height2","type":"text","marks":[{"type":"em"}]},{"text":" – describes the alternate width and height of the dialog – zero values mean there is no alternate size.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"caption – ","type":"text","marks":[{"type":"em"}]},{"text":"will be the dialog caption","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"bgnd_color","type":"text","marks":[{"type":"em"}]},{"text":" – will be the dialog background color, default from [InspectorColors] InspectorFace=230,230,230","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"combo_colo","type":"text","marks":[{"type":"em"}]},{"text":"r – will be the color of drop list backgrounds, default from [InspectorColors] DropList=240,240,255","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"text_color","type":"text","marks":[{"type":"em"}]},{"text":" – will be the text color of text controls, default [InspectorColors] TextColor=0,0,0","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a new dialog with the given name and caption. Dialogs and all their child controls are destroyed either by ","type":"text"},{"text":"destroy ","type":"text","marks":[{"type":"strong"}]},{"text":"or specifically by ","type":"text"},{"text":"destroy_dialog","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_droplist (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_droplist, dialog,left,top,width,height,nameValueList,caption,attributes,dot-expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog – ","type":"text","marks":[{"type":"em"}]},{"text":"must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes the position and width of the drop list control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nameValueList ","type":"text","marks":[{"type":"em"}]},{"text":"of the form “string=value ….” – used to populate the list and specify the value associated with each item","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"caption – ","type":"text","marks":[{"type":"em"}]},{"text":"specifies the caption to appear above the drop list control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"attributes","type":"text","marks":[{"type":"em"}]},{"text":" – a string of attribute controlling the appearance of the combo box control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dot-expression","type":"text","marks":[{"type":"em"}]},{"text":" – an expression to assign the value of the selection each time the selection changes","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes string must be a space separated string consisting of one or more of the following. If items are repeated, the right-most one is the one that takes effect.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"readonly=val","type":"text","marks":[{"type":"em"}]},{"text":" – 0 or 1, default 0; when set prevents the user changing the selection","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a droplist control on the dialog of the specified size. On selecting an item in the droplist associated value is assigned to the dot-expression. As with all assignments, the Set() function of the appropriate module is called after the assignment. At a rate of 5Hz, the variable is examined: if it has changed, the selection is updated.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_awslist (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_awslist, dialog,left,top,width,height,nameValueList,caption,attributes","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog – ","type":"text","marks":[{"type":"em"}]},{"text":"must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" describes the position and width of the drop list control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nameValueList ","type":"text","marks":[{"type":"em"}]},{"text":"of the form “string=filename ….” – used to populate the list and specify the file name associated with each item","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"caption – ","type":"text","marks":[{"type":"em"}]},{"text":"specifies the caption to appear above the drop list control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"attributes – ","type":"text","marks":[{"type":"em"}]},{"text":"a string of attribute controlling the appearance of the combo box control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dot-expression","type":"text","marks":[{"type":"em"}]},{"text":" – an expression to assign the value of the selection each time the selection changes","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes string must be a space separated string consisting of one or more of the following. If items are repeated, the right-most one is the one that takes effect.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"readonly=val","type":"text","marks":[{"type":"em"}]},{"text":" – 0 or 1, default 0; when set prevents the user changing the selection","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a droplist control on the dialog of the specified size. On selecting an item in the droplist the associated file is executed as an AWS script file.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_edit (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_edit,dialog,caption,left,top,attributes,caption,dot-expression [,in-expression]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog – ","type":"text","marks":[{"type":"em"}]},{"text":"must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top","type":"text","marks":[{"type":"em"}]},{"text":" – describes the position and width of the drop list control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"attributes – ","type":"text","marks":[{"type":"em"}]},{"text":"a string of attribute controlling the appearance of the edit control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"caption","type":"text","marks":[{"type":"em"}]},{"text":" – specifies the caption to appear above the edit control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dot-expression","type":"text","marks":[{"type":"em"}]},{"text":" – an expression to assign the value of the edit box","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"in-expression","type":"text","marks":[{"type":"em"}]},{"text":" – if present is checked at 5Hz, and updates the edit control when it changes","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates an edit control with a caption above in a box 69 wide by 42 high.","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes string must be a space separated string consisting of one or more of the following. If items are repeated, the right-most one is the one that takes effect.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"format=format_specifier","type":"text","marks":[{"type":"em"}]},{"text":" – a printf style format to use when formatting values, default %.2f","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"stepsize=step","type":"text","marks":[{"type":"em"}]},{"text":" – default 0, the amount by which displayed values will be quantized","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"min=val","type":"text","marks":[{"type":"em"}]},{"text":" – default -100, the minimum displayable value on the meter","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"max=val","type":"text","marks":[{"type":"em"}]},{"text":" – default 0, the maximum displayable value on the meter","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"readonly ","type":"text","marks":[{"type":"em"}]},{"text":"– 0 or 1, default 0; when set prevents the user editing the value","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_filelist (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_filelist,dialog,name,left,top,height,buffer_expression,buffer_size_expression,async_expression, type_expression[,filepath[,rate]]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog","type":"text","marks":[{"type":"em"}]},{"text":" – must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"name – ","type":"text","marks":[{"type":"em"}]},{"text":"specifies the caption to appear above the control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes the position and height of the control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"buffer_expression","type":"text","marks":[{"type":"em"}]},{"text":" – expression specifying the start address of the buffer used to transfer data to the target","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"buffer_size_expression – ","type":"text","marks":[{"type":"em"}]},{"text":"expression specifying the size of the transfer buffer.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"async_expression","type":"text","marks":[{"type":"em"}]},{"text":" – expression specifying where the PC should write asynchronous notifications.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"type_expression – ","type":"text","marks":[{"type":"em"}]},{"text":"expression specifying where the PC should a 32-bit integer containing the first 4 characters of the file extension.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"filepath","type":"text","marks":[{"type":"em"}]},{"text":" – optional list of files to populate dialog with at startup","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"rate ","type":"text","marks":[{"type":"em"}]},{"text":"– rate in Hz at which to poll and fill the transfer buffer.","type":"text"}]},{"type":"paragraph","content":[{"text":"The file list control is used to stream data from a file to the target. The transfer buffer holds a total of buffer_size + 1 32-bit words. The final word in the transfer buffer, buffer[buffer_size] is the handshaking word. At a 10 Hz rate, the control checks whether","type":"text"}]},{"type":"paragraph","content":[{"text":"buffer[buffer_size] == 0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"If non-zero, nothing happens. If equal to zero, the control opens the current file, seeks to the current seek position, reads buffer_size*4 bytes from it (if possible), fills buffer with the actual bytes read, and closes the file. The low 24 bits of the handshaking word at buffer[buffer_size] is set to the number of bytes reads. The high 8 bits are set to one of the following notifications:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"FIOS_NewStream – Indicates that we are at the start of a new file","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"FIOS_NextBlock – Set for the second block onward until the next to last block","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"FIOS_LastBlock – Indicates that this is the last block of data in a file.","type":"text"}]},{"type":"paragraph","content":[{"text":"(These are defined in Framework.h).","type":"text"}]},{"type":"paragraph","content":[{"text":"Typically, a single write to the target of length buffer_size+1 words occurs. Only at the end of the file are two separate write performed; the data followed by the handshaking word.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the end of file is reached and there are no more files to play, the writing of data stops. Otherwise, the next file is opened and playback continues.","type":"text"}]},{"type":"paragraph","content":[{"text":"The asynchronous handshaking word notifies of other conditions.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"FIOS_Stopped - generated by Stop only","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"FIOS_Paused - generated by Pause only","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"FIOS_Error - generated by a file I/O error when reading the current file, no data is sent","type":"text"}]},{"type":"paragraph","content":[{"text":"The type_expression indicates the extension of the file being played to the target processor. type_expression is updated whenever the first block of a new file is played. The file extension is converted to upper case, zero-padded or truncated, and packed into a 32-bit integer. The value written is in little-endian format and the least significant byte of the word holds the first character. For example,","type":"text"}]},{"type":"codeBlock","content":[{"text":"mp3\t\t0x00 \t0x33 \t0x50 \t0x4D\n\t\t\t\t'3'\t 'P'\t 'M'","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_graph (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_graph,dialog,left,top,width,height,attributes,dot-expression,count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog ","type":"text","marks":[{"type":"em"}]},{"text":"– must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes the position and size of the graph","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"attributes ","type":"text","marks":[{"type":"em"}]},{"text":"– a string of attribute controlling the appearance of the meter","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dot-expression","type":"text","marks":[{"type":"em"}]},{"text":" – describes an element taken to be the first in an array","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"count ","type":"text","marks":[{"type":"em"}]},{"text":"– the number of elements to use","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes string must be a space separated string consisting of one or more of the following. If items are repeated, the right-most one is the one that takes effect.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"format=format_specifier – a printf style format to use when formatting values, default %.2f","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"mapping=[db20|undb20|lin[ear]] – default db20. The value is displayed according to the mapping.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"stepsize=step – default 0, the amount by which displayed values will be quantized","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"meteroffset=offs – default 0, an amount to be added to values before use","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"min=val – default -100, the minimum displayable value on the meter","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"max=val – default 0, the maximum displayable value on the meter","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"numbers – default 0, when non-zero specifies that numbers should be drawn above each element","type":"text"}]},{"type":"paragraph","content":[{"text":"This command creates a graph object of the specified size. The width of the object is divided by count to give the width of each stripe. 10 times a second, the target array is queried for ","type":"text"},{"text":"count ","type":"text","marks":[{"type":"em"}]},{"text":"values, and those values used to display the graph stripes. If numbers is set, then the top 16 pixels of the graph is used to display the numeric value of each element according to the format specified. The width of each strip needs to be 25 or more when displaying numbers to avoid truncation of the text.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_grid (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_grid,dialog,left,top,width,height,attributes,dot-expression,count1[,count2]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog ","type":"text","marks":[{"type":"em"}]},{"text":"– must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes the position and size of the grid control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"attributes ","type":"text","marks":[{"type":"em"}]},{"text":"– a string of attribute controlling the appearance of the grid control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dot-expression","type":"text","marks":[{"type":"em"}]},{"text":" – describes an element taken to be the first in an array","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"count1 ","type":"text","marks":[{"type":"em"}]},{"text":"– the size of the first dimension","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"count2 ","type":"text","marks":[{"type":"em"}]},{"text":"– if present is the size of the second dimension","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes string must be a space separated string consisting of one or more of the following. If items are repeated, the right-most one is the one that takes effect.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"format=format_specifier – a printf style format to use when formatting values, default %g","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"min=val – default –1e10, the minimum displayable value on the grid","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"max=val – default 1e10, the maximum displayable value on the grid","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"colwidth – default 50, value must be >= 50, width of column in pixels","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"sidewidth – default 30, value must be >= 30, width of first column in pixels","type":"text"}]},{"type":"paragraph","content":[{"text":"The command creates a grid control of the specified size. If count2 is given, the control as count2+1 columns, the first being the index, otherwise the control has 2 columns, the first being the index. The control operates as a very simple spreadsheet. On changing the value of any cell, the underlying array element is assigned, and the corresponding module’s set member is called. At 5Hz intervals, the grid will repaint itself if any element has changed value.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_layout","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_layout,layout_instance_name,divider,nModules","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"layout_instance_name ","type":"text","marks":[{"type":"em"}]},{"text":"– must be an identifier not currently defined,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"divider ","type":"text","marks":[{"type":"em"}]},{"text":"– must be an integer >= 1,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nModules ","type":"text","marks":[{"type":"em"}]},{"text":"– must be an integer >= 1","type":"text"}]},{"type":"paragraph","content":[{"text":"This creates a layout object named ","type":"text"},{"text":"layout_instance_name ","type":"text","marks":[{"type":"em"}]},{"text":"that can hold a total of ","type":"text"},{"text":"nModules ","type":"text","marks":[{"type":"em"}]},{"text":"with the given ","type":"text"},{"text":"divider","type":"text","marks":[{"type":"em"}]},{"text":". A layout is a collection of modules that are all pumped together at the given division rate. Only memory for the layout is allocated and a few internal fields of the layout structure set; no modules have been added. Modules must be subsequently added by calls to ","type":"text"},{"text":"add_module","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success, heap1,heap2,heap3,layout_instance_name=instanceID","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_led (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_led, dialog,left,top,width,height legend,dot-expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog ","type":"text","marks":[{"type":"em"}]},{"text":"– must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes the top-left corner of the LED control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"legend ","type":"text","marks":[{"type":"em"}]},{"text":"– the text to appear to the right of the LED image","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dot-expression ","type":"text","marks":[{"type":"em"}]},{"text":"– an expression to evaluate at 5Hz – if non zero the LED is shown lit","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates an LED control. If the value described by dot-expression is non-zero, the LED is shown bright green, otherwise dark green. The expression is evaluated every 200mSec.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_lookup","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_lookup, maxId","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"maxID ","type":"text","marks":[{"type":"em"}]},{"text":"– must be a non-zero integer","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a lookup table that handles IDs in the range 1..maxID by providing a fast O(1) lookup table. If no table is specified, lookups are O(N/2).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"update_lookup","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"update_lookup","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command is for legacy purposes, and does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_meter (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_meter, dialog,left,top,attributes,dot-expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog ","type":"text","marks":[{"type":"em"}]},{"text":"– must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top","type":"text","marks":[{"type":"em"}]},{"text":" – describes the top-left corner of the LED control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"attributes ","type":"text","marks":[{"type":"em"}]},{"text":"– a string of attribute controlling the appearance of the meter","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dot-expression ","type":"text","marks":[{"type":"em"}]},{"text":"– an expression to evaluate at 5Hz – if non zero the LED is shown lit","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a meter control. The value described by dot-expression is evaluated every 200mSec, and used to update the appearance of the meter.","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes string must be a space separated string consisting of one or more of the following. If items are repeated, the right-most one is the one that takes effect.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"format=format_specifier – a printf style format to use when formatting values, default %.2f","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"units=units_name – no default, used to name the units, for example dB","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"mapping=[db20|undb20|lin[ear]] – default db20. The value is displayed according to the mapping.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"ticks=nTicks – default is 2, range is 2-32, this is the number of tick marks to display","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"useticks=[0|1] – default is 0, when 1 tickmarks are drawn","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"tickmarks=”v1, … , vN” – a list of labels to apply to tickmarks up to a maximum of 8 values, no default","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"stepsize=step – default 0, the amount by which displayed values will be quantized","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"meteroffset=offs – default 0, an amount to be added to values before use","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"min=val – default -100, the minimum displayable value on the meter","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"max=val – default 0, the maximum displayable value on the meter","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"height=val – default is natural control height, values larger than default stretch the control vertically downwards","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_module","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_module,module_instance_name,className,nInputs,nOutputs,nScratch,[wires],args...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"module_instance_name ","type":"text","marks":[{"type":"em"}]},{"text":"– must be an identifier not currently defined,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"className ","type":"text","marks":[{"type":"em"}]},{"text":"– must be the name of a Module Class,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nInputs ","type":"text","marks":[{"type":"em"}]},{"text":"– the nuber of module inputs required,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nOutputs ","type":"text","marks":[{"type":"em"}]},{"text":"– the number of modules required,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nScratch ","type":"text","marks":[{"type":"em"}]},{"text":"– the number of scratch wires required,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"[wires]","type":"text","marks":[{"type":"em"}]},{"text":" – a list of wire names obtained from ","type":"text"},{"text":"create_wire","type":"text","marks":[{"type":"strong"}]},{"text":", of which there are exactly ","type":"text"},{"text":"nInputs+nOutputs+nScratch","type":"text","marks":[{"type":"em"}]},{"text":" names,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"args…","type":"text","marks":[{"type":"em"}]},{"text":" – a set of arguments to initialize the module – the number of arguments is that required by the module","type":"text"}]},{"type":"paragraph","content":[{"text":"This creates a module object named ","type":"text"},{"text":"module_instance_name ","type":"text","marks":[{"type":"em"}]},{"text":"with the given properties. Modules are only useful when part of a layout constructed using ","type":"text"},{"text":"create_layout","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success, heap1,heap2,heap3,module_instance_name=instanceID","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_slider (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_slider, dialog,left,top,attributes,dot-expression[,read-expression]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog ","type":"text","marks":[{"type":"em"}]},{"text":"– must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top","type":"text","marks":[{"type":"em"}]},{"text":" – describes the top-left corner of the LED control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"attributes ","type":"text","marks":[{"type":"em"}]},{"text":"– a string of attribute controlling the appearance of the meter","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dot-expression","type":"text","marks":[{"type":"em"}]},{"text":" – an expression to assign the position of the slider to when its position changes. Multiple assignments may be specified by separating expressions with semicolon.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"read-expression","type":"text","marks":[{"type":"em"}]},{"text":" – if present is a location to watch at 5Hz – if it changes, the slider position is changed to match.","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a slider or knob control. The value described by dot-expression is assigned the slider value when it changes.","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes string must be a space separated string consisting of one or more of the following. If items are repeated, the right-most one is the one that takes effect.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"min=val – default 0, the minimum value of the slider","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"max=val – default 1, the maximum value of the slider","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"value=val – default 0, the initial position of the slider","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"format=format_specifier – a printf style format to use when formatting values, default %.2f","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"units=units_name – no defult, used to name the units, for example dB","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"mapping=[log|lin[ear]|db20|undb20] – default linear. The value is displayed according to the mapping. Log is not possible unless min > 0.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"ticks=nTicks – default is 2, range is 2-32, this is the number of tick marks to display","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"useticks=[0|1] – default is 0, when 1 tickmarks are drawn","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"fixedticks=nFixedTicks – default is 2, range is 2-32, this is the number of fixed ticks to display","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"tickmarks=v1, … , vN – a list of labels to apply to tickmarks up to a maximum of 8 values, no default","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"stepsize=step – default 0, the amount by which displayed values will be quantized","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"control=[knob|slider] – default slider. If knob, a rotary knob control is shown instead of a slider.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"height=val – default is natural control height, values larger than default stretch the control vertically downwards. If control=knob, this value is ignored.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"continuous=[0|1] – default 1, when 1 all changes are assigned as they happen, otherwise changes are sent only when the user releases the mouse","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"muteonmin=[0|1] – default 0, when 1 the underlying variable is set to 0 when the knob is turned to its minimum value. This is useful for dB controls which should mute when turned all the way down.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_spline (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_spline, dialog,left,top,width,height,attributes,instanceName","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog","type":"text","marks":[{"type":"em"}]},{"text":" – must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes the control position and size","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"attributes ","type":"text","marks":[{"type":"em"}]},{"text":"– a string of attribute controlling the appearance of the control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"instanceName ","type":"text","marks":[{"type":"em"}]},{"text":"– a base dot expression within which members of fixed names will be accessed","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes string must be a space separated string consisting of one or more of the following. If items are repeated, the right-most one is the one that takes effect.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"minx=val – default 0, the minimum X value","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"maxx=val – default 9, the maximum X value","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"miny=val – default 0, the minimum Y value","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"maxy=val – default 3, the maximum Y value","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"order=val – default 2, for testing only","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"mapping=[log|lin[ear]] – default linear. The value is displayed according to the mapping. Log is not possible unless miny > 0.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"ticks=nTicks – default is 2, range is 2-32, this is the number of tick marks to display","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"useticks=[0|1] – default is 1, when 1 tickmarks are drawn","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"fixedticks=nFixedTicks – default is 2, range is 2-32, this is the number of fixed ticks to display","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"tickmarks=v1, … , vN – a list of labels to apply to tickmarks up to a maximum of 8 values, no default","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"stepsize=step – default 0, the amount by which displayed values will be quantized","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"control=[knob|slider] – default slider. If knob, a rotary knob control is shown instead of a slider.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"maxpoints=val – default 10, for testing only","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"points=val – default 10, for testing only","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a spline control. This control displays points XY points on a graph. If order==2, the points are joined by straight lines. If order==4, the points are connected by a natural spline. The curve is drawn in green. The points are drawn as small blue boxes. You can drag the boxes around, causing the curve to be redrawn, and the DSP to be updated. On first creation, the control is populated from the DSP.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the ","type":"text"},{"text":"instanceName ","type":"text","marks":[{"type":"em"}]},{"text":"is empty, the control is stand-alone with 10 points y=sqrt(x), x=0..9 and not connected to the DSP. In this mode, the operation of the spline control may be tested.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_text (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_text, dialog,left,top,widh,height,legend","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"dialog ","type":"text","marks":[{"type":"em"}]},{"text":"– must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"left,top,width,height","type":"text","marks":[{"type":"em"}]},{"text":" – describes size of the control","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"legend ","type":"text","marks":[{"type":"em"}]},{"text":"– the text to appear","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a static text control of the specified size, and sets its text to legend. Any occurrence of ‘\\n’ in the legend will cause the legend to wrap.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"create_wire","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"create_wire,wireName,sampleRate,nChannels,blockSize,complex,maxBlockSize","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"wireName ","type":"text","marks":[{"type":"em"}]},{"text":"– must be an identifier not currently defined,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"sampleRate ","type":"text","marks":[{"type":"em"}]},{"text":"– the effective sample rate of the wire","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nChannels ","type":"text","marks":[{"type":"em"}]},{"text":"– the number of wire channels","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"blockSize ","type":"text","marks":[{"type":"em"}]},{"text":"– the number of samples in the wire","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"complex ","type":"text","marks":[{"type":"em"}]},{"text":"– non-zero if the wire samples are complex","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"maxBlockSize ","type":"text","marks":[{"type":"em"}]},{"text":"– must be the same as blockSize","type":"text"}]},{"type":"paragraph","content":[{"text":"This creates a wire object named ","type":"text"},{"text":"wireName ","type":"text","marks":[{"type":"em"}]},{"text":"with the properties specified.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success, the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success, heap1,heap2,heap3,wire_instance_name=instanceID","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"deferred_process","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"deferred_process","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"During operation, a number of audio modules may set up actions to be performed later. These are referred to as delayed actions. This command causes one pass through the object list executing these actions. It is only needed for test since normal audio pumping calls this on every pump cycle.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"delete_file (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"delete_file,filename","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command deletes the specified file from the file system if it exists, in which case it reports success. There are many possible failures, including file not found, and file system not implemented.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that deleting a FLASH file only marks its directory entry deleted, it does not release the storage used by the file or its directory entry. Repeated creating and deleting FLASH files will consume all storage eventually. You can return the file system to its initial state with ","type":"text"},{"text":"erase_all","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"destroy (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"destroy","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command unconditionally destroys all objects. On success, the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,heap1,heap2,heap3","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"destroy_dialog (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"destroy_dialog,dialog","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","content":[{"text":"\t","type":"text"},{"text":"dialog","type":"text","marks":[{"type":"code"}]},{"text":" must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","content":[{"text":"This command destroys the named dialog.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"dialog_state (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"dialog_state,dialog,state","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","content":[{"text":"\t","type":"text"},{"text":"dialog","type":"text","marks":[{"type":"em"}]},{"text":" must be a dialog created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"paragraph","content":[{"text":"\t","type":"text"},{"text":"state","type":"text","marks":[{"type":"em"}]},{"text":" must be 0 or 1","type":"text"}]},{"type":"paragraph","content":[{"text":"This command sets the given dialog to its initial size if zero, otherwise to its alternate size. If the alternate size dimensions given to ","type":"text"},{"text":"create_dialog ","type":"text","marks":[{"type":"strong"}]},{"text":"were zero or the same as the initial size, the command has no effect.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success, the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"erase_all (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"erase_all","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command erases all files on the target file system, restoring it to the initial empty state. It fails if the target does not have a file system.","type":"text"}]},{"type":"paragraph","content":[{"text":"Erasing a large FLASH chip can take some time.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"end_binary (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"end_binary","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Terminates logging of binary commands and writes the file. This command works in conjunction with ","type":"text"},{"text":"make_binary","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"exists_dialog (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"exists_dialog,name","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Checks if a dialog with the specified name already exists. The function returns either:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"success,0\t\t(Dialog does not exist)","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"success,1\t\t(Dialog does exist)","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"failed, argument count\t(Incorrect number of arguments to the function)","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"exit (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"exit","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command destroys the server.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"fast_audio_pump (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"fast_audio_pump,input_file [ ,record_file ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Plays the input file through the layout as fast as possible, optionally recording the layout output in a WAV file. The output file will be at whatever rate the layout specifies, and has as many channels as the output wire.","type":"text"}]},{"type":"paragraph","content":[{"text":"The command does not complete until all input samples have been processed. With long files, this may take a while.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"fast_read (Matlab)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"fast_read,expression,count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Reads the specified number of float elements in an array of data and returns the result as binary data rather than as text. This command is only supported through the MATLAB AWEClient.dll and is not for general use. The format of the binary reply packet is described in ","type":"text"},{"text":"Internal Binary Packets","type":"text","marks":[{"type":"link","attrs":{"href":"#InternalBinaryPackets"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"fast_read_int (Matlab)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"fast_read_int,expression,count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Reads the specified number of integer elements in an array of data and returns the result as binary data rather than as text. This command is only supported through the MATLAB AWEClient.dll and is not for general use. The format of the binary reply packet is described in ","type":"text"},{"text":"Internal Binary Packets","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#Internal-Binary-Packets%5BinlineExtension%5D"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"fast_write (Matlab)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"fast_write,expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Writes the float array passed by Matlab to the target layout starting at the address given. This command is only supported through the MATLAB AWEClient.dll and is not for general use. It causes the AWE server to receive a binary packet containing the Matlab array values as documented in ","type":"text"},{"text":"Internal Binary Packets","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#Internal-Binary-Packets%5BinlineExtension%5D"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"fast_write_int (Matlab)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"fast_write_int,expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Writes the integer array passed by Matlab to the target layout starting at the address given. This command is only supported through the MATLAB AWEClient.dll and is not for general use. It causes the AWE server to receive a binary packet containing the Matlab array values as documented in ","type":"text"},{"text":"Internal Binary Packets","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#Internal-Binary-Packets%5BinlineExtension%5D"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"fast_write_partial (Matlab)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"fast_write_partial,expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Writes the float array passed by Matlab to the target layout starting at the address given. This command is only supported through the MATLAB AWEClient.dll and is not for general use. It causes the AWE server to receive a binary packet containing the Matlab array values as documented in ","type":"text"},{"text":"Internal Binary Packets","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#Internal-Binary-Packets%5BinlineExtension%5D"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The final set call performed by fast_write is suppressed.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"fast_write_int_partial (Matlab)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"fast_write_int_partial,expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Writes the integer array passed by Matlab to the target layout starting at the address given. This command is only supported through the MATLAB AWEClient.dll and is not for general use. It causes the AWE server to receive a binary packet containing the Matlab array values as documented in ","type":"text"},{"text":"Internal Binary Packets","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#Internal-Binary-Packets%5BinlineExtension%5D"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The final set call performed by ","type":"text"},{"text":"fast_write_int ","type":"text","marks":[{"type":"strong"}]},{"text":"is suppressed.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"file_exists (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"file_exists,file","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Tests to see if the specified file or directory can be found.","type":"text"}]},{"type":"paragraph","content":[{"text":"This command either succeeds or fails. The possible failures are:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"failed,argument count // command takes only one argument","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"failed,no target // command requires a connected target","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"If it succeeds the possible replies:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"success,0, // name not found in path","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"success,1,full_path // found this file in the path","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"success,2,full_path // found this directory in the path","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"If found, the full_path will be in the convention of the OS on which the server is running. The only supported OSs are Windows and Linux.","type":"text"}]},{"type":"paragraph","content":[{"text":"If a server is connected to a target such as a SHARC, the search takes place in the server file system.","type":"text"}]},{"type":"paragraph","content":[{"text":"The path to search is specified in the server INI file. The implied '.' (server working directory - always the directory containing the server executable binary) is always searched first. Due to this if files are placed there, the search path need not be specified.","type":"text"}]},{"type":"paragraph","content":[{"text":"The search order is that specified by the search path always looking in '.' first. If there are multiple hits, the first match is reported.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"file_logging (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"file_logging,full, filename","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"file_logging,half, filename","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"file_logging,end, filename","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The first form starts logging all commands and replies by appending them to the given filename. The second form starts logging all replies to the given filename. The last form turns of logging to file. The path to filename is specified in the server INI file. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The form of received message log items is:","type":"text"}]},{"type":"paragraph","content":[{"text":"\tYYYY/MM/DD HH:MM:SS.mmm: << ","type":"text"},{"text":"message","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The form of sent message log items is:","type":"text"}]},{"type":"paragraph","content":[{"text":"\tYYYY/MM/DD HH:MM:SS.mmm: >> ","type":"text"},{"text":"message","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"In each case, ","type":"text"},{"text":"mmm ","type":"text","marks":[{"type":"em"}]},{"text":"is the milliseconds past the second.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success, the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"file_to_pin (BSP) NOT IMPLEMENTED","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"File_to_pin,pin_name,file_path","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Binds a file to an input pin to act as a fake audio device. Only possible with non-DMA pins not otherwise in use.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success, the reply is: ","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Following are the possible failure replies: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, argument count \t// needs 2 arguments","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, no target \t\t// must be connected","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, duplicate pin name \t// can't bind the same pin more than once","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, name undefined \t// pin name not defined","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, not a pin \t\t// pin named is not a pin","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, can't be Input \t\t// can't bind to pin Input","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, not an input pin \t\t// pin must be an input","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,' not in core %d \t\t// pin name not in the core","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,' not a public pin \t// only public pins can be bound","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"foreground (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"foreground","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Brings Audio Weaver Server window to the foreground (top most in Z-order). Make the window visible if it were behind other windows.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success, the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"framework (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"framework,proxyIndex","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Changes the proxy the server uses to that specified by the index. If no target can be found on that proxy, switches back to prior proxy. The target previously connected remains in the state it was in when the connection changes. Various INI file settings for proxies are used - there are no arguments to specify for example the IP address of an Ethernet target.","type":"text"}]},{"type":"paragraph","content":[{"text":"The available proxies are:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"0 - Native","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"1 - RS232","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"2 - USB","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"3 - Ethernet","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"4 - SPI","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"8 - FTDI","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"9 - TotalPhaseSPI","type":"text"}]},{"type":"paragraph","content":[{"text":"Only those proxies enabled in the INI file can be specified. Linux supports only the Ethernet proxy. The default proxy is Native, and is always available.","type":"text"}]},{"type":"paragraph","content":[{"text":"Replies:","type":"text"}]},{"type":"paragraph","content":[{"text":"failed,framework %d is current framework","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed,no such framework as %d","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed,can't create framework %d: old connection %d restored","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"getini","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"getini,section,key","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Reads the AWE server INI file.","type":"text"}]},{"type":"paragraph","content":[{"text":"Replies:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,section=section_name,key=key_name,value=key_value","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"A return value of '0,no such key' indicates the INI file does not contain the specified key.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_call","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_call,module_name,mask","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Performs a get call on the specified module with the given mask. See module documentation for specifics. If the module has no get function, does nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"Replies:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,module_name=instanceID","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_filesystem_info (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_filesystem_info","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command queries the target file system properties. On success it returns:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,type,size,available,overhead,deleted,inuse,free,sizes","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"type ","type":"text","marks":[{"type":"em"}]},{"text":"is 1 for Native, or 2 for FLASH.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"size ","type":"text","marks":[{"type":"em"}]},{"text":"is the target device size in words – note that the implementation may only use a portion of the total FLASH storage for the file system.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"available ","type":"text","marks":[{"type":"em"}]},{"text":"is the number of available storage words.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"overhead ","type":"text","marks":[{"type":"em"}]},{"text":"is number of words used for internal data structures","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"deleted ","type":"text","marks":[{"type":"em"}]},{"text":"is the number of words used by deleted files","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"inuse ","type":"text","marks":[{"type":"em"}]},{"text":"is the number of words used for all purposes","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"sizes","type":"text","marks":[{"type":"em"}]},{"text":" is (block size in words << 16) | max filename length","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that the file system does not release storage from deleted files – that storage is lost. Repeatedly creating and deleting files will consume all storage. The file system can be restored to its initial empty state with ","type":"text"},{"text":"erase_all","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_first_core (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_first_core","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Returns the target info for the first core in the system which should have ID zero. See ","type":"text"},{"text":"get_target_info","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_target_info"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_next_core (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_next_core,prevCoreID","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Returns the target info for the core following prevCoreID in the system. If there is no successor core, it fails. See ","type":"text"},{"text":"get_target_info","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_target_info"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_cores (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_cores","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Returns the number of cores (or instances) defined by the target.","type":"text"}]},{"type":"paragraph","content":[{"text":"success,numberOfCores","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_core_list (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_core_list","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Returns the number of cores (or instances) defined by the target, and all their IDs. See also ","type":"text"},{"text":"get_instance_table","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_instance_table-(BSP)"}}]},{"text":" below which is an alias.","type":"text"}]},{"type":"paragraph","content":[{"text":"success,number of cores, ","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_instance_table (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_instance_table","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Returns the number of cores (or instances) defined by the target, and all their IDs. This is an alias for get_core_list above.","type":"text"}]},{"type":"paragraph","content":[{"text":"\tsuccess,number of cores, ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_first_file (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_first_file","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command gets information about the first file in the target file system. On success the reply is either:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,1,attributes,filename","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"if there are any files, or","type":"text"}]},{"type":"paragraph","content":[{"text":"success,0,,","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"if the file system is empty.","type":"text"}]},{"type":"paragraph","content":[{"text":"Several failures are possible, including failures due to the target not having a file system.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_next_file (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_next_file","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command may only be used after first having used get_first_file. It returns information about successive files. On success the reply is either:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,1,attributes,filename","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"if there are any files, or","type":"text"}]},{"type":"paragraph","content":[{"text":"success,0,,","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"if there are no more files. Call this as many times as needed to enumerate all files on the target.","type":"text"}]},{"type":"paragraph","content":[{"text":"Several failures are possible, including failures due to the target not having a file system.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"read_file (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"read_file,filename","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command reads the specified file from the target file system, and writes the file as AWE_directory/","type":"text"},{"text":"filename ","type":"text","marks":[{"type":"em"}]},{"text":"to your hard drive, in which case it reports success. There are many possible failures including file not found and the target not having a file system.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"reopen_input (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"reopen_input,devIndex","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Reopens a device previously closed by close_input. The same parameters are used as when the device was originally opened when audio started. It is an error to reopen an already open device, or use an index that does not exist.","type":"text"}]},{"type":"paragraph","content":[{"text":"This command is intended for rare cases where a device has to be reconfigured but can't be while AWE has an open handle on it.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"reopen_output (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"reopen_output,devIndex","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Reopens a device previously closed by ","type":"text"},{"text":"close_output","type":"text","marks":[{"type":"strong"}]},{"text":". The same parameters are used as when the device was originally opened when audio started. It is an error to reopen an already open device, or use an index that does not exist.","type":"text"}]},{"type":"paragraph","content":[{"text":"This command is intended for rare cases where a device has to be reconfigured, but can't be while AWE has an open handle on it.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"write_file (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"write_file,filename,attribute","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command writes the specified local hard disk file to the target file system with the file ","type":"text"},{"text":"attribute ","type":"text","marks":[{"type":"em"}]},{"text":"specified. If a file of that name exists on the target, it is first deleted (see ","type":"text"},{"text":"delete_file","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#delete_file-(BSP)"}}]},{"text":"). There are many possible failures including file not found on your hard disk, not enough space on the target, and the target not having a file system.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"attribute ","type":"text","marks":[{"type":"em"}]},{"text":"value may be any 7 bit value constructed by orring the following together expressed as decimal:","type":"text"}]},{"type":"codeBlock","content":[{"text":"#define LOAD_IMAGE\t\t\t0x01\n#define STARTUP_FILE\t\t\t0x02\n#define DATA_FILE\t\t\t0x04\t// Any file of type \"Other\"\n#define COMPILED_SCRIPT\t\t0x08\n#define COMMAND_SCRIPT\t\t0x10\n#define PRESET_SCRIPT\t\t0x20\n#define COMPILED_PRESET_SCRIPT\t0x28\n#define LOADER_FILE\t\t\t0x40","type":"text"}]},{"type":"paragraph","content":[{"text":"Common useful values are 0x18 (= decimal 24) for a compiled AWB file, and 0x1a (= decimal 26) for a bootable compiled AWB file. Other possible attribute combinations are generally not useful.","type":"text"}]},{"type":"paragraph","content":[{"text":"Targets that have a file system will locate the first file with the 0x1a attribute and execute as an AWB compiled script during boot. There should be only one file with this attribute in the file system – it is indeterminate which will be executed if there is more than one.","type":"text"}]},{"type":"paragraph","content":[{"text":"A useful set of commands to compile a script file, and load it into a file system is:","type":"text"}]},{"type":"paragraph","content":[{"text":"erase_all","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"compile,1,source_file.aws, destination_file.awb","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"write_file, destination_file.awb,26","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"When you next reset the target, the layout should be running. Note that the AWS and AWB extensions are convention only, you can use anything you like.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_extended_info","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_extended_info","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command returns user version followed by 12 undefined words","type":"text"}]},{"type":"paragraph","content":[{"text":"success,user_version,<12 undefined words>","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_first_io","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_first_io","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command returns the first I/O object, as in this example:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,Input,1,1,48000,1074003968,256,4194304,","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The format is","type":"text"}]},{"type":"paragraph","content":[{"text":"success,instance_name,instanceID,boundID,sampleRate,info1,info2,info3,","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"boundID – ","type":"text","marks":[{"type":"em"}]},{"text":"zero if the pin is not bound, othereise the ID of the bound wire.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"info1 – ","type":"text","marks":[{"type":"em"}]},{"text":"a packed bitfield of 10 bit channels | 17 bits blockSize | 4 bit sample size bytes | 1 bit complex","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"info2 – ","type":"text","marks":[{"type":"em"}]},{"text":"a packed bitfield of 17 bits blockSize | 6 bits data type","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"info3 – ","type":"text","marks":[{"type":"em"}]},{"text":"a packed bitfield of 10 bits rows | 10 bits cols | 1 bit isIPC | 1 bit isPrivate | 1 bit clock master | 1 bit special","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information on these fields see Framework.h.","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"get_next_io","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_next_io"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_first_object","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_first_object","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"get_first_object,1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command returns the first created object. The first form of the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,instanceName=instanceID,Class=className","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The second form reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,instanceName=instanceID,Class=className,members...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where each member is formatted as:","type":"text"}]},{"type":"paragraph","content":[{"text":"member_name=member_type:value","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The layout of all classes is given in the schema file, where each member is named and its type given: className will be found in the schema file. The value is displayed appropriately for the type: ","type":"text"},{"text":"float ","type":"text","marks":[{"type":"strong"}]},{"text":"values are displayed using %g, all other values are displayed as decimal unsigned integers.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the member is an array of fixed bounds in the schema, then each element of the array is displayed in the form:","type":"text"}]},{"type":"paragraph","content":[{"text":"member_name[subscript]=type:value","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where the subscript ranges from 0 to N-1.","type":"text"}]},{"type":"paragraph","content":[{"text":"Where members are inherited from a base class, each inherited member is listed.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_heap_count","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_heap_count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command returns:","type":"text"}]},{"type":"paragraph","content":[{"text":"success, number_of_heaps","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Currently this value is always 3.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_heap_size","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_heap_size","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success, free1,free2,free3,size1,size2,size3","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"freeN ","type":"text","marks":[{"type":"em"}]},{"text":"– the number words available in heap N.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"sizeN ","type":"text","marks":[{"type":"em"}]},{"text":"– the total size of heap N","type":"text"}]},{"type":"paragraph","content":[{"text":"All sizes are in 32-bit words.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_executable_dir (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_executable_dir","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Returns the directory containing the current AWE_Server.exe executable.","type":"text"}]},{"type":"paragraph","content":[{"text":"Reply:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,c:\\Program Files\\DSP Concepts\\Audio Weaver Designer\\Bin","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_module_state","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_module_state,module_instance_name","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","content":[{"text":"module_instance_name is the name of a module created by create_module, or a dot-expression describing a member of some object that is a module","type":"text"}]},{"type":"paragraph","content":[{"text":"On success, the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success, module_instance_name=instanceID,state","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","content":[{"text":"module_instance_name is the argument of the command,","type":"text"}]},{"type":"paragraph","content":[{"text":"instanceID is the ID of the module,","type":"text"}]},{"type":"paragraph","content":[{"text":"state is a decimal value, and one of","type":"text"}]},{"type":"paragraph","content":[{"text":"\t0: active","type":"text"}]},{"type":"paragraph","content":[{"text":"\t1: bypass","type":"text"}]},{"type":"paragraph","content":[{"text":"\t2: mute","type":"text"}]},{"type":"paragraph","content":[{"text":"\t3: inactive","type":"text"}]},{"type":"paragraph","content":[{"text":"When first created, modules are active. See ","type":"text"},{"text":"set_module_state","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#set_module_state"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_moduleclass_count","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_moduleclass_count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command returns:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,module_class_count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","content":[{"text":"module_class_count is the number of module classes in the framework.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_moduleclass_info","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_moduleclass_info,module_class_index","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"module_class_index ","type":"text","marks":[{"type":"em"}]},{"text":"must be in the range 0 to one less than the value returned by ","type":"text"},{"text":"get_moduleclass_count","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"On success, the return value is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,className,classID,nParams,DLLName","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"className ","type":"text","marks":[{"type":"em"}]},{"text":"– the name of the class as it appears in the schema file,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"classID – ","type":"text","marks":[{"type":"em"}]},{"text":"the numeric value of the class id,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nParams","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"– the number of public and private parameters an instance of the module may take. The values are packed as separate 16 bit numbers into a 32 bit value. The high 16 bits represent the number of private words; the lower 16 bits represent the number of public words.","type":"text"}]},{"type":"paragraph","content":[{"text":"DLLname is the library the module is found in.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_next_io","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_next_io","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Returns the next I/O object in the form described in ","type":"text"},{"text":"get_first_io","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_first_io"}}]},{"text":", or:","type":"text"}]},{"type":"paragraph","content":[{"text":"failed, no more I/O pins","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"if there are no more I/O objects to enumerate.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_next_object","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_next_object","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"get_next_object,1","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns the next object in the forms described in ","type":"text"},{"text":"get_first_object","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_first_object"}}]},{"text":", or:","type":"text"}]},{"type":"paragraph","content":[{"text":"failed, no more objects","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"if there are no more objects to enumerate.","type":"text"}]},{"type":"paragraph","content":[{"text":"if there are no more objects to enumerate.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_object_byname","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_object_byname,instanceName","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"instanceName ","type":"text","marks":[{"type":"em"}]},{"text":"is some identifier","type":"text"}]},{"type":"paragraph","content":[{"text":"The command looks up instanceName in the object symbol table. If found, the reply value is as described in ","type":"text"},{"text":"get_first_object","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_first_object"}}]},{"text":", otherwise it is:","type":"text"}]},{"type":"paragraph","content":[{"text":"failed, 'instanceName' is undefined","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_rate","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_rate,filename","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command opens an audio file and returns its rate, channels, and duration. On Windows it can open any file type for which a codec is installed in the OS (as a minimum always supports MP3). On Linux it supports only WAV files. The file is closed after reading its properties.","type":"text"}]},{"type":"paragraph","content":[{"text":"The file is searched for in the audio path unless an absolute path is specified.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,rate,channels,duration","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The command fails if the file can’t be found or if the format is not a supported audio file. The reported duration is in seconds as floating point.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_schema (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_schema,className","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"className ","type":"text","marks":[{"type":"em"}]},{"text":"is some identifier","type":"text"}]},{"type":"paragraph","content":[{"text":"The command looks up className in the schema symbol table. If found, the reply value is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,Class=className,ClassID=id,member,...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"className ","type":"text","marks":[{"type":"em"}]},{"text":"is the argument to the command,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"id ","type":"text","marks":[{"type":"em"}]},{"text":"is the numeric id of the class,","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"each ","type":"text"},{"text":"member ","type":"text","marks":[{"type":"em"}]},{"text":"is formatted as:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"\t","type":"text"},{"text":"member_name=type","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"otherwise, the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"failed, class 'className' is undefined","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Note that unlike get_first_object/get_next_object, the inherited members from base classes are not displayed.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_target_info","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_target_info","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Reply:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,sampleRate,profileFreq,packetBufLen,nCores,nThreads,nInputs,nOutputs,baseBlockSize,packedInfo,version,CpuType,targetName,proxyName,CpuFreq,instanceID,isSMP,nInputPins,nOutputPins,featureBits","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"sampleRate ","type":"text","marks":[{"type":"em"}]},{"text":"- target sample rate in Hz","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"profileFreq ","type":"text","marks":[{"type":"em"}]},{"text":"- target profiling clock frequency in Hz","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"packetBufferLen ","type":"text","marks":[{"type":"em"}]},{"text":"- the size in words of the target's packet buffer","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nCores ","type":"text","marks":[{"type":"em"}]},{"text":"- the number of cores the target currently has. For SMP targets the default 2. nCores can be changed using the set_cores command.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"isSMP ","type":"text","marks":[{"type":"em"}]},{"text":"– flag indicating if core supports SMP","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nInputPins","type":"text","marks":[{"type":"em"}]},{"text":" – number of input pins","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nOutputPins","type":"text","marks":[{"type":"em"}]},{"text":" – number of output pins","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"baseBlockSize","type":"text","marks":[{"type":"em"}]},{"text":" - the base block size for audio. Layouts must use an integer multiple of this nThreads - the number of concurrent threads per core. Typically 2 for embedded targets and 4 for SMP targets.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nInputs ","type":"text","marks":[{"type":"em"}]},{"text":"- the number of input channels","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"nOutputs","type":"text","marks":[{"type":"em"}]},{"text":" - the number of output channels","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"packedInfo ","type":"text","marks":[{"type":"em"}]},{"text":"– 7 bits CPU type | 8 bits output channels | 8 bits input channels | 1 bit floating point | 1 bit file system | 4 bits sizeof(int)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"version ","type":"text","marks":[{"type":"em"}]},{"text":"- 32 bit version number usually expressed as w.x.y.z where each field is a byte of the word most significant first","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"targetName","type":"text","marks":[{"type":"em"}]},{"text":" - an up to 8 character name for the target","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"CpuFreq","type":"text","marks":[{"type":"em"}]},{"text":" - the frequency of the target clock in Hz","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"instanceID","type":"text","marks":[{"type":"em"}]},{"text":" - the ID of this core in the range ((0…15) * 16) i.e. (0, 16, 32, …, 240)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"isSMP ","type":"text","marks":[{"type":"em"}]},{"text":"- 1 if the core is SMP (Windows or Linux)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"featureBits ","type":"text","marks":[{"type":"em"}]},{"text":"- usually 0, reserved for DSP Concepts internal use","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_type (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_type,expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Evaluates the type of expression and returns the type as an integer if the expression is legal. The possible reported values are:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"0 - integer","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"1 - unsigned integer","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"2 - float","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"3 - fract","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"4 - object","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"5 - pointer to integer","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"6 - pointer to unsigned integer","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"7 - pointer to float","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"8 - pointer to fract","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"9 - pointer to object","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_value","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_value,expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where expression is formed as follows:","type":"text"}]},{"type":"paragraph","content":[{"text":"instanceName [. memberName]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"InstanceName ","type":"text","marks":[{"type":"em"}]},{"text":"must be the name of some object. The first ","type":"text"},{"text":"memberName ","type":"text","marks":[{"type":"em"}]},{"text":"must name a member of the class of which ","type":"text"},{"text":"instanceName ","type":"text","marks":[{"type":"em"}]},{"text":"is an instance. Subsequent terms depend on the type of the member as follows:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"55e58e83-545c-4806-b616-d19356daaf51"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"Member Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"Followed by","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"int","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"nothing, reply is success,","type":"text"},{"text":"address","type":"text","marks":[{"type":"em"}]},{"text":",int,","type":"text"},{"text":"intvalue","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"float","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"nothing, reply is success,","type":"text"},{"text":"address","type":"text","marks":[{"type":"em"}]},{"text":",float,","type":"text"},{"text":"floatvalue","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"[N]int","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"[","type":"text"},{"text":"0 : N-1","type":"text","marks":[{"type":"em"}]},{"text":"], reply is success,","type":"text"},{"text":"address","type":"text","marks":[{"type":"em"}]},{"text":",int,","type":"text"},{"text":"intvalue","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"[N]float","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"[","type":"text"},{"text":"0 : N-1","type":"text","marks":[{"type":"em"}]},{"text":"], reply is success,","type":"text"},{"text":"address","type":"text","marks":[{"type":"em"}]},{"text":",float,","type":"text"},{"text":"floatvalue","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"*","type":"text"},{"text":"className","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":".member","type":"text","marks":[{"type":"strong"}]},{"text":" belonging to ","type":"text"},{"text":"className","type":"text","marks":[{"type":"em"}]},{"text":" (follows pointer)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"**className","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"[","type":"text","marks":[{"type":"strong"}]},{"text":"subscript","type":"text","marks":[{"type":"em"}]},{"text":"].member","type":"text","marks":[{"type":"strong"}]},{"text":" belonging to ","type":"text"},{"text":"className","type":"text","marks":[{"type":"em"}]},{"text":" (follows subscripted pointer)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"className","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":".member","type":"text","marks":[{"type":"strong"}]},{"text":" belonging to ","type":"text"},{"text":"className","type":"text","marks":[{"type":"em"}]},{"text":" (accesses member)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Note that the final three type name members: if the types of those members are not one of the first 4 scalar forms, then more members must be named to complete the expression. This continues iteratively until the expression reaches one of the first 4 scalar forms.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the expression is not legal according to these rules, one of the following may be returned:","type":"text"}]},{"type":"paragraph","content":[{"text":"failed, 'string' is not an identifier","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed, 'name' requires dot expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed, no such member of 'class' as 'string'","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"get_version (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"get_version","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Returns version information about the currently connected server. The reply is of the form:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,,Jul 12 2017 14:10:34","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where the first value is empty, and the rest of the string is the build date and time.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"gui_logging (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"gui_logging,0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"gui_logging,1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"gui_logging,off","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"gui_logging,on","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The second and fourth forms cause sent and received messages to be displayed in the server control panel, the remaining forms turn this display off.","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,bool_value","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where the value is 1 if display is enabled, otherwise 0.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"kill_pump (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"kill_pump","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command is only supported on Windows and Linux server in Native. It causes the audio pump thread to terminate. The error message “Server response: \"failed,not playing\" will appear if audio pump thread doesn’t exist. Otherwise it will report success. It is intended only for test.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"make_binary (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"make_binary,filename","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Begins logging of binary commands sent from the Server to the target. The commands are buffered in internal memory on the PC. When complete, call ","type":"text"},{"text":"end_binary ","type":"text","marks":[{"type":"strong"}]},{"text":"to write the commands to the specified file filename.","type":"text"}]},{"type":"paragraph","content":[{"text":"make_binary ","type":"text","marks":[{"type":"strong"}]},{"text":"is used to create compiled scripts on the target. Only a subset of commands are stored – only those needed to actually instantiate the system and begin processing. The commands logged are:","type":"text"}]},{"type":"paragraph","content":[{"text":"bind_wire","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"audio_pump","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"create_layout","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"create_module","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"create_wire","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"destroy","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"set_module_state","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"set_value","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"write_float_array","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"write_fract_array","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"write_int_array","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"open_web_page (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"open_web_page,URL","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Displays a web page in a browser. URL is a string specifying the address of the page to display. If URL starts with \"http://\", \"file://\", or \"www.\", the URL is used as-is. Otherwise, the program determines if a script is currently running, and URL is a relative path, in which case the file to open is taken relative to the script path, otherwise if no script is running and the URL is a relative path, the file is taken relative to the executable (AWE_Server.exe) path. Only file names ending in \".htm\" or \".html\" are considered candidates for relative pathing, otherwise the URL is used as-is.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pin_to_file (NOT IMPLEMENTED)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"pin_to_file,pin_name,file_name","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Binds a file to an output pin to act as a fake audio device. Only possible with non-DMA pins not otherwise in use. Arranges that samples written to pin_name will be written to the file. The file will have the rate and number of channels of the pin - which really means of the wire connected to the pin. The file will be created each time audio starts.","type":"text"}]},{"type":"paragraph","content":[{"text":"The command will fail if the pin is not an output pin, if the special pin Output is used, or if a file is already bound to the pin.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, argument count \t\t// needs 2 arguments","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, no target \t\t\t// must be connected","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, duplicate pin name \t\t// can't bind the same pin more than once","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, name undefined \t\t// pin name not defined","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, not a pin \t\t\t// pin named is not a pin","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, can't be Output \t\t// can't bind to pin Output","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, not an output pin \t\t// pin must be an output","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, not in core %d \t\t// pin name not in the core","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, not a public pin \t\t// only public pins can be bound","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pump","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"pump","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command causes all current layouts to be pumped. Layouts that have dividers of 1 are pumped on every call, layouts with larger values are pumped on every Nth call.","type":"text"}]},{"type":"paragraph","content":[{"text":"If there are no layouts to pump, the error message is:","type":"text"}]},{"type":"paragraph","content":[{"text":"Server response: \"failed,no layout(s) to pump\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"If server is not connected to the target, the error message is:","type":"text"}]},{"type":"paragraph","content":[{"text":"Server response: \"failed,not connected to the target\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"otherwise the replay is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success, cycles, cycles interval","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This call is intended to be used with the command ","type":"text"},{"text":"write_pump_read ","type":"text","marks":[{"type":"strong"}]},{"text":"for testing. See also ","type":"text"},{"text":"fast_write","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_write-(Matlab)"}}]},{"text":" and ","type":"text"},{"text":"fast_read","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_read-(Matlab)"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pump_layout","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"pump_layout,layout_instance_name [,pump cycles]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where layout_instance_name must be an object created by create_layout.","type":"text"}]},{"type":"paragraph","content":[{"text":"This command pumps a single layout as though by ","type":"text"},{"text":"pump ","type":"text","marks":[{"type":"strong"}]},{"text":"above. It is intended to be used with writing an input wire and reading an output wire for testing. See also ","type":"text"},{"text":"fast_write","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_write-(Matlab)"}}]},{"text":" and ","type":"text"},{"text":"fast_read","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_read-(Matlab)"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the reply is ","type":"text"}]},{"type":"paragraph","content":[{"text":"success, instance_name=instanceID [, pump cycles]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Possible replies from server in case of failure:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,argument count // must be one [or two] arguments only","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,no target // must be connected to target","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,instance name not identifier // must be identifier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,name undefined // layout name must be defined","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"pump_module","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"pump_module,module_instance_name","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where ","type":"text"},{"text":"module_instance_name ","type":"text","marks":[{"type":"em"}]},{"text":"must be an object created by ","type":"text"},{"text":"create_module","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"This command pumps a single module as though by pump_layout above. It is intended to be used with writing an input wire and reading an output wire for testing. See also ","type":"text"},{"text":"fast_write","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_write-(Matlab)"}}]},{"text":" and ","type":"text"},{"text":"fast_read","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#fast_read-(Matlab)"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the reply is ","type":"text"}]},{"type":"paragraph","content":[{"text":"success,Name=instanceID","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Possible replies from server in case of failure:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,argument count; // must be only one argument","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,no target; // must be connected to target","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,instance name not identifier; // must be identifier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,name undefined; // module name must be defined","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"query_pin ","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"query_pin,pin_name","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where pin_name is any of the pins on the target.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success, the reply is as described in ","type":"text"},{"text":"get_first_io","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_first_io"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"query_pump (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"query_pump","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command reports the audio pump status as an integer. The possible values are:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"0 - target has no layout, not pumping","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"1 - target has a layout, not pumping","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"2 - target has no layout, pumping","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"3 - target has a layout, pumping","type":"text"}]},{"type":"paragraph","content":[{"text":"This command is intended for use by an external monitoring process which watches for the pump dying by transitioning from 3 to 1, which usually indicates an I/O error on audio hardware which can only happen on Linux systems.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"query_wire ","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax: ","type":"text"}]},{"type":"paragraph","content":[{"text":"query_wire,wireNname","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where wireName must be an object created by ","type":"text"},{"text":"create_wire","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the reply is ","type":"text"}]},{"type":"paragraph","content":[{"text":"success,wireName=objectID,sampleRate,info1,info2","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Possible replies from server in case of failure:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,argument count \t\t\t // must have 1 argument","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,no target \t\t\t\t // must be connected to a target","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,instance name not identifier \t // name must be identifier","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,instance name undefined \t\t // name must be defined","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed,instance name is not a wire \t // must name a wire","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"\t","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"read_float_array","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"read_float_array,expression,count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"expression ","type":"text","marks":[{"type":"em"}]},{"text":"is an expression that evaluates to an array element, so must be subscripted","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"count ","type":"text","marks":[{"type":"em"}]},{"text":"is the number of values to read starting at that element","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply is ","type":"text"}]},{"type":"paragraph","content":[{"text":"success,val[0], ..., val[count-1]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where each value is formatted using %g.","type":"text"}]},{"type":"paragraph","content":[{"text":"There is no bounds checking - elements past the end of the array will report junk.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"read_fract_array","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"read_fract_array,expression,count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"expression","type":"text","marks":[{"type":"em"}]},{"text":" is an expression that evaluates to an array element, so must be subscripted","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"count","type":"text","marks":[{"type":"em"}]},{"text":" is the number of values to read","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply is ","type":"text"}]},{"type":"paragraph","content":[{"text":"success,val[0], ..., val[count-1]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where each value is reported as float interpreting each value as fract32, and so constrained to report a value in the range -1 to 1.","type":"text"}]},{"type":"paragraph","content":[{"text":"There is no bounds checking - elements past the end of the array will report junk.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"read_int_array","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"read_int_array,expression,count","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"expression ","type":"text","marks":[{"type":"em"}]},{"text":"is an expression that evaluates to an array element, so must be subscripted","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"count","type":"text","marks":[{"type":"em"}]},{"text":" is the number of values to read","type":"text"}]},{"type":"paragraph","content":[{"text":"The reply is ","type":"text"}]},{"type":"paragraph","content":[{"text":"success,val[0], ..., val[count-1]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where each value is formatted using %d.","type":"text"}]},{"type":"paragraph","content":[{"text":"There is no bounds checking - elements past the end of the array will report junk.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"reboot_target (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"reboot_target","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Causes an embedded target to reboot as though by reset or power cycle. Not implemented for Windows or Linux server.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"rename_pin (BSP) (NOT IMPLEMENTED)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"rename_pin,oldPinName,newPinName","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command renames a pin that only has a default name. You can't rename Input or Output (the default I/O pins), or any pin that was given a specific name by a BSP.","type":"text"}]},{"type":"paragraph","content":[{"text":"Reply: ","type":"text"}]},{"type":"paragraph","content":[{"text":"success,","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Following are the possible failures:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, argument count \t\t// needs 2 arguments","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, no target \t\t\t// must be connected","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, too long \t\t\t// new names must be <= 8 characters long","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, name already used \t\t// new name is already defined","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, name undefined \t\t// old name must be defined","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, not a pin \t\t\t// old name is not a pin","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, not a public pin \t\t// old name is not public","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"failed, pin is not IPC \t\t// can't rename DMA pins","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"After renaming, you must refer to the pin by its new name.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"script (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"script,fileName","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command executes the commands stored in ","type":"text"},{"text":"fileName","type":"text","marks":[{"type":"em"}]},{"text":". Generally, these files have an AWS extension, and are generated by Designer.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"setini (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"setini,section,key,value","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Assigns to or creates in the INI file an item of the form:","type":"text"}]},{"type":"codeBlock","content":[{"text":"[section]\nkey=value","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"set_call","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"set_call,module_name,mask","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command calls the set function of a module. If the module has no set function, nothing happens, See module documentation for specific details. On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,module_name=address","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"select_core (BSP, Windows)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"select_core,N","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"For Windows only, cause the server GUI to display the data for the specified core. The allowed range of N is 1 through cores where cores is as reported by get_cores.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"set_core_description (BSP, Windows, Linux)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"set_core_description,file","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"File may be one of:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SMP","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"smp","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"none","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"in which case it forces the PC to be SMP Native. Otherwise, it is a text file containing the description of the target to emulate. If so, the current system is completely destroyed, an emulation is created specified by the file, and the server UI is updated to show the emulation details. The emulation will not support set_cores,","type":"text"}]},{"type":"paragraph","content":[{"text":"If the description file has errors, the offending error is reported by ","type":"text"},{"text":"failed,parse error","type":"text","marks":[{"type":"code"}]},{"text":", and the detailed error will be in awelog.txt. It is outside the scope of this document to describe the description file format and the possible parse errors which are legion. On error, the existing system is unchanged.","type":"text"}]},{"type":"paragraph","content":[{"text":"Any attempt to set the description file currently in use reports ","type":"text"},{"text":"success,no change","type":"text","marks":[{"type":"code"}]},{"text":". If the command succeeded in loading a new file (or reverting to SMP) the reply is ","type":"text"},{"text":"success","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"set_cores (BSP, Windows, Linux)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"set_cores,N","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"For SMP targets only, destroys all existing core objects, and creates N new ones. The allowed range is 1-16. The number of cores on server start is 2. The current number of cores can be found using get_cores. Embedded targets with multiple cores have a fixed number of physical cares and do not implement this command.","type":"text"}]},{"type":"paragraph","content":[{"text":"Warming: it is possible to create more core instances than the target has. Be aware that cores are simulated in the BSP by threads, and spawning more threads than physical core count - 1 can exceed the CPU bandwidth of the machine. Also be aware that Intel HyperThreading reports twice as many cores as physical cores, but the actual CPU bandwidth is not that high - you can end up with less computation than this number would lead you to expect.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"set_instance_id","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"set_instance_id,object_name,id","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"As objects are created, they are assigned IDs starting at 1. If a layout needs to assign a new ID, it must be >= 30000, and not in use by another object. The ","type":"text"},{"text":"object_name ","type":"text","marks":[{"type":"em"}]},{"text":"must be that of an existing object.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"set_module_state","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"set_module_state,module_instance_name,state","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"module_instance_name ","type":"text","marks":[{"type":"em"}]},{"text":"is the name of a module created with create_module, or is a dot-expression naming a member of an object that is a module","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"state ","type":"text","marks":[{"type":"em"}]},{"text":"is a decimal value, and one of","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"\t0: active","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"\t1: bypass","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"\t2: mute","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"\t3: inactive","type":"text"}]},{"type":"paragraph","content":[{"text":"This command sets the state of the module. On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success, module_instance_name=instanceID","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"See also ","type":"text"},{"text":"get_module_state","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_module_state"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"set_path (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"set_path,path_item1 [, path_item2 ... ,path_itemN ]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command takes any number of arguments, each of which is a file system path. It is used to set the search path for audio files specified to ","type":"text"},{"text":"audio_pump","type":"text","marks":[{"type":"strong"}]},{"text":". The paths are persisted in the server INI file as:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{AudioPath]\nPath=item1| ... |itemN","type":"text"}]},{"type":"paragraph","content":[{"text":"When ","type":"text"},{"text":"audio_pump","type":"text","marks":[{"type":"strong"}]},{"text":" is searching for a file, it works through this list in order, and uses the first match found.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"set_pointer","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"set_pointer,destination_expression,pointer_expression","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command assigns the address of the pointer_expression to the location destination_expression which must be a pointer value. On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"set_timeout (Matlab)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"set_timeout,N","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","content":[{"text":"N is the time out in milliseconds","type":"text"}]},{"type":"paragraph","content":[{"text":"Sets the communication time out between Matlab and the server. By default, the value is 4000, or 4 seconds. (This command is useful to prevent issues when you issue a command, such as ","type":"text"},{"text":"erase_all","type":"text","marks":[{"type":"strong"}]},{"text":", which may take a long time to execute.)","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"set_value","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"set_value,expression,value [, expression,value]*","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"expression ","type":"text","marks":[{"type":"em"}]},{"text":"is as described in ","type":"text"},{"text":"get_value","type":"text","marks":[{"type":"link","attrs":{"href":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2629304440/Audio+Weaver+Tuning+Command+Syntax#get_value"}}]},{"text":",","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"value ","type":"text","marks":[{"type":"em"}]},{"text":"is a number to be assigned to the location described by expression","type":"text"}]},{"type":"paragraph","content":[{"text":"There may be any number of ","type":"text"},{"text":"[expression,value]","type":"text","marks":[{"type":"em"}]},{"text":" pairs given to the command. On completion of the last assignment, the set function of each unique module instance (if any) referenced by any of the ","type":"text"},{"text":"expressions ","type":"text","marks":[{"type":"em"}]},{"text":"are called.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the reply is:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,instanceID,type,value [,instanceID,type,value]*","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"show (BSP, GUI only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"show,[0|1]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"If the server has any dialogs created by ","type":"text"},{"text":"create_dialog","type":"text","marks":[{"type":"strong"}]},{"text":", then ","type":"text"},{"text":"show,0","type":"text","marks":[{"type":"em"}]},{"text":" causes the server dialog to be hidden. The dialog is un-hidden by ","type":"text"},{"text":"destroy","type":"text","marks":[{"type":"strong"}]},{"text":", using ","type":"text"},{"text":"destroy_dialog ","type":"text","marks":[{"type":"strong"}]},{"text":"to destroy the last child dialog, or by ","type":"text"},{"text":"show,1","type":"text","marks":[{"type":"em"}]},{"text":". The ","type":"text"},{"text":"show,0","type":"text","marks":[{"type":"em"}]},{"text":" command does nothing if there are no child dialogs.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"target_execute (BSP)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"target_execute,file","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Causes an embedded target to load the specified file from the local file system which must be in AWB format. An AWB file contains a sequence of binary commands which are usually those for constructing a layout. The command is not implemented on Windows or Linux server - see binary and script commands for server specific file loading from native file systems.","type":"text"}]},{"type":"paragraph","content":[{"text":"The command will only work on those targets that have a local file system (such as flash) implemented by AWE into which AWB files have been stored. Targets with no local file system do not implement the command. Do not confuse local file systems implemented by AWE with native file systems such as Windows or Linux implemented by an operating system.","type":"text"}]},{"type":"paragraph","content":[{"text":"Loading may fail for a large number of reasons even if the file exists. Causes may range from the AWB file referring to cores the target does not have, to the file referring to audio modules not present in the target code, to lack of storage for the layout.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"trace (BSP, Linux)","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"trace,message","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Causes a Linux target to write to stdout the message. The message must be double quoted if it contains space or comma. The reply is always:","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"on all targets.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"write_float_array","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"write_float_array,expression,val0,....,valN-1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"expression","type":"text","marks":[{"type":"em"}]},{"text":" is an expression that evaluates to an array element, and so must be subscripted","type":"text"}]},{"type":"paragraph","content":[{"text":"This command writes the values to each successive element location starting at expression. The reply is","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Misuse of the command can corrupt storage, because there is no bounds checking for arrays.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"write_float_aray_partial","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"write_float_array_partial,expression,val0,....,valN-1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"As ","type":"text"},{"text":"write_float_aray ","type":"text","marks":[{"type":"strong"}]},{"text":"except the final set call is suppressed.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"write_fract_array","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"write_fract_array,expression,val0,....,valN-1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"expression ","type":"text","marks":[{"type":"em"}]},{"text":"is an expression that evaluates to an array element, and so must be subscripted","type":"text"}]},{"type":"paragraph","content":[{"text":"This command writes the values to each successive element location starting at ","type":"text"},{"text":"expression","type":"text","marks":[{"type":"em"}]},{"text":". The reply is","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Misuse of the command can corrupt storage, because there is no bounds checking for arrays.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"write_fract_array_partial","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"write_fract_array_partial,expression,val0,....,valN-1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"As ","type":"text"},{"text":"write_fract_aray ","type":"text","marks":[{"type":"strong"}]},{"text":"except the final set call is suppressed.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"write_int_array","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"write_int_array,expression,val0,...,valN-1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"where:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"expression ","type":"text","marks":[{"type":"em"}]},{"text":"is an expression that evaluates to an array element, and must be subscripted","type":"text"}]},{"type":"paragraph","content":[{"text":"This command writes the values to each successive int location starting at ","type":"text"},{"text":"expression","type":"text","marks":[{"type":"em"}]},{"text":". The reply is","type":"text"}]},{"type":"paragraph","content":[{"text":"success","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Misuse of the command can corrupt storage, because there is no bounds checking for arrays.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"write_int_array_partial","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"write_int_array_partial,expression,val0,...,valN-1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"As ","type":"text"},{"text":"write_int_aray ","type":"text","marks":[{"type":"strong"}]},{"text":"except the final set call is suppressed.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"write_pump_read","type":"text"}]},{"type":"paragraph","content":[{"text":"Syntax:","type":"text"}]},{"type":"paragraph","content":[{"text":"write_pump_read,layout,inputWire,outputWire,val1, ... ,valN","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This command writes the val","type":"text"},{"text":"i","type":"text","marks":[{"type":"em"}]},{"text":" to ","type":"text"},{"text":"inputWire","type":"text","marks":[{"type":"em"}]},{"text":", then pumps the layout, then reads ","type":"text"},{"text":"outputWire ","type":"text","marks":[{"type":"em"}]},{"text":"and replies:","type":"text"}]},{"type":"paragraph","content":[{"text":"success,cycles,val1, ... ,valN","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Layout may be either the index of a layout (zero based), or a layout name.","type":"text"}]},{"type":"paragraph","content":[{"text":"Cycles is the number of profile cycles the pump call took.","type":"text"}]},{"type":"paragraph","content":[{"text":"The input and output samples are raw values on the wire. The number provided should be the same as channels*blockSize. For example, if the wire is stereo 32 long, then 64 values must be provided in interleaved form. The assumption is input and output wire are the same, and so the number of output samples is the same as the number of input samples.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Error Messages","type":"text"}]},{"type":"paragraph","content":[{"text":"Commands can produce error messages from the following table:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"250b8a87-6c6a-4237-94e4-c06f26ae1963"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, heap type index range","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A heap index was not in the range of heaps","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, awe_fwMalloc no more storage","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The given heap does not have enough storage to satisfy the requested size","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, awe_fwMallocScratch no more storage","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The scratch heap does not have enough storage to satisfy the requested size","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, constructor argument count","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A create_xx call has an incorrect number of arguments","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, class index out of range","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The given class index is not in the range of classes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, class not found","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The named class was not found in the symbol table","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, module already owned","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt was made to give a module to a layout when it is already in another layout","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, address outside heap","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt was made to assign to a location not in any heap","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, not a wire","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A wire argument to create_module is not actually a wire","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, number of inputs and outputs must match","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Some modules require that the number of inputs and outputs are the same","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, input pin types must be the same","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Some modules require that the types of input and output pins be the same","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, module needs at least one input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Many modules require at least one input","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, module needs at least one output","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Many modules require at least one output","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, inputs must match corresponding outputs","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Some module require that each ","type":"text"},{"text":"i","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"th input have the same type as each ","type":"text"},{"text":"i","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"th output","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, not a module","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt was made to give an object not a module instance to add_module","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, I/O count error","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The input/output count is not acceptable","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, parameter error","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A parameter given to create_module is wrong for the specified module class","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, no more objects","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"There are no more objects for get_next_object to display","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, not object pointer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An expression expected to be of pointer type is not","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, not input pin","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The pin must be an input pin.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, I/O pin in use","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt was made to bind an I/O pin that was already bound with bind_wire","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, pin types not compatible","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt was made using bind_wire to bind a wire incompatible with the I/O pin","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, pin sizes not compatible","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt was made using bind_wire to bind a wire not an integer multiple of the I/O pin size","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, not output pin","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The pin must be an output pin.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, no more I/O pins","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"There are no more pin objects for get_next_io to display","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, no layouts to pump","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"'pump' was called when no layouts exist","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, module must have only one output","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Many modules require only one output","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, output wire must have only one sample","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Some modules require that an output have only a single sample","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, incompatible block sizes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"All contained modules must have the same block size","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, wire index out of range","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A container wire vector indexed a wire out of range","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, unknown error %d","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An unknown error occurred","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, argument count","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A command had an invalid number of arguments","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, not implemented on target","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The target does not implement the command","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, instance name '%s' not identifier","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The argument must be an identifier","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, instance name '%s' is already used","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The instance name has already been defined","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, class name '%s' is not defined","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt was made to use an undefined class name","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, class name '%s' has different classID than created instance","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An object was created, but then found to have a different class than it should have","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, instance name '%s' is not a pin type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The argument must be a pin type","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, name '%s' undefined","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A name was seen that has not been defined","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, expression error","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The expression given to get_value or set_value had an error","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, wire name '%s' undefined","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A supposed wire name given to create_module is not defined","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, wire name '%s' is not a Wire","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A supposed wire name given to create_module is not of type Wire","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, module name '%s' undefined","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A supposed module name given to add_module is undefined","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, '%s' is not a module","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A supposed module name given to add_module is not a module","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, unknown argument","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A command that takes a symbolic argument had an unknown string argument","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, open sound card for input returned an error","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"'audio_pump' could not open the sound card for input","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, player create returned 0x%08x","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"'audio_pump' could not open the sound card for output","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, renderer create returned 0x%08x","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"'audio_pump' could not create output object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, empty filename","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A required filename was empty","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, unknown command '%s'","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The command keyword is unknown","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, empty command","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The command was empty","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, can't find instance class","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt to lookup the class of an instance failed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, can't find instance","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt to lookup an instance failed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, '%s' requires subscript","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An expression requires a subscript","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, '%s' syntax error: missing ']'","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Malformed subscript","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, '%s' subscript %d out of range","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A subscript is outside the array bounds (static arrays only, very rare)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, '%s' requires dot expression","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An expression stopped early","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, no such member of '%s' as '%s'","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"The member name given is not a member","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): empty class name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Empty class name in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): syntax error in alias of class '%s'","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Error while aliasing one class to another in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): unknown base class'%s' in alias of class '%s'","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Reference to unknown base class while aliasing one class to another in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): comma expected in class '%s'","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Missing comma in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): syntax error in derivation of class '%s'","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Syntax error parsing derived class in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): unknown base class '%s' in alias of class '%s'","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Attempt to derive a class from an unknown base in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): unexpected '{' in body of class %s","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"There can only be one level of bracing in schema files","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): empty member name in class %s","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Member name is empty in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): non-numeric dimension in class %s","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Array dimension has non-numeric subscript in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): expected ']' to close dimension in class %s","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Missing close bracket in array dimension in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): empty type name in class %s","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A type name is empty in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): unknown type name '%s' in class %s","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A type name is undefined in schema file.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, %s(%d): unexpected end of file in class %s","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"Unexpected end of file in schema file","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, no such core","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"A core ID was specified that the target does not have.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"failed, too many bound wires","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[400.0]},"content":[{"type":"paragraph","content":[{"text":"An attempt was made to bind more than 17 times to an input pin","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Schema Files","type":"text"}]},{"type":"paragraph","content":[{"text":"Schema files provide a means for describing the layout of DSP storage that is compact and has a simple grammar, and does not need the complexity of the C/C++ type system.","type":"text"}]},{"type":"paragraph","content":[{"text":"The server has a file ","type":"text"},{"text":"Schemas.sch","type":"text","marks":[{"type":"strong"}]},{"text":" that defines all the classes in the DSP. Each schema corresponds to a structure in the code. Class names and member names must be identifiers in the C/C++ sense. Schema files support C++ comments only.","type":"text"}]},{"type":"paragraph","content":[{"text":"The form of a schema is:","type":"text"}]},{"type":"paragraph","content":[{"text":" is the simplest form, and directly maps to a C ","type":"text"},{"text":"struct","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":"ClassName\n{\n\tmember1\t\ttype\n\t….\n\tmemberN\t\ttype\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The supported types are as follows:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"0be89ec6-6d64-406b-ab6b-ad9ed5320e75"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"int","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"32 bit integer","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"float","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"32 bit IEEE float","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"[N]int","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"array of integer with N elements","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"[N]float","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"array of floats with N elements","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"*int","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"pointer to array of integer with unknown number of elements","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"*float","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"pointer to array of float with an unknown number of elements","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"*className","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"pointer to a class instance","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"**className","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"pointer to an array of pointers to class instance with unknown number of elements","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[132.0]},"content":[{"type":"paragraph","content":[{"text":"className","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[626.0]},"content":[{"type":"paragraph","content":[{"text":"a nested structure","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"To support mapping to DSP code, class names may have an associated class ID like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"className value\n{\n\t….\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"If value is not present, the value zero (unknown ID) is used. The value may be in hex or decimal.","type":"text"}]},{"type":"paragraph","content":[{"text":"Classes may derive from other classes like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"A\n{\n\t….\n}\n\nB, A\n{\n\t….\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The meaning is the same as public derivation in C++. In the example above, ","type":"text"},{"text":"B","type":"text","marks":[{"type":"strong"}]},{"text":" inherits all the members of ","type":"text"},{"text":"A","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The use of a class ID may be combined with inheritance like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"className value, baseClass\n{\n\t….\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"As expected, the new class gets the given class ID, and also inherits all the members of the base class. There is no limit to inheritance depth.","type":"text"}]},{"type":"paragraph","content":[{"text":"All type names must be declared before use. This means that a circular definition such as:","type":"text"}]},{"type":"codeBlock","content":[{"text":"A\n{\n\tm *B\n}\nB\n{\n\tm *A\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"can't be written, since an attempt is made to refer to B before it is declared.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Internal Binary Packets","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"InternalBinaryPackets"},"legacyAnchorId":{"value":"AudioWeaverTuningCommandSyntax-InternalBinaryPackets"},"_parentId":{"value":"2629304440"}},"macroMetadata":{"macroId":{"value":"321b98dd49092c8818fa0a96f439f850"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"160a57c6-4a5c-461e-9ec6-331a8eb56707"}}]},{"type":"paragraph","content":[{"text":"There are occasions when text commands are too burdensome on bandwidth. These cases permit pumping raw audio samples into a layout for regression test, or for cases where the data is not coming from or going to a real audio device.","type":"text"}]},{"type":"paragraph","content":[{"text":"If a command starts with the 4-byte sequence \\x03 \\x00 \\xff \\x07 (0x07ff0003) a sequence that is not possible for text, it announces that what follows is a binary array of 32 bit values preceded by a header, of which this sequence is the first word.","type":"text"}]},{"type":"paragraph","content":[{"text":"The packet header looks like this:","type":"text"}]},{"type":"paragraph","content":[{"text":"struct SBinaryPacket","type":"text"}]},{"type":"codeBlock","content":[{"text":"struct SBinaryPacket\n{\n\t/** Magic packet header value. */\n\tunsigned int m_magic;\n\n\t/** Length of data in bytes. */\n\tunsigned int m_len;\n\n\t/** Length of data in floats. */\n\tunsigned int m_nFloats;\n\n\t/** Command opcode. */\n\tunsigned int m_opcode;\n};","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"m_magic – contains 0x07ff0003","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"m_len – total packet size in bytes","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"m_nFloats – payload size in words – note that payload data is not constrained to floats","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"m_opcode – command opcode, always 30 to server, always 29 from server","type":"text"}]},{"type":"paragraph","content":[{"text":"It is always required that string data is also sent with a command to the server to specify a destination address as an expression. This data follows the last payload word. Let us assume a payload of 32 words, and string value containing 10 characters including the terminating NULL. Then the length values will be:","type":"text"}]},{"type":"paragraph","content":[{"text":"\tm_nFloats = 32","type":"text"}]},{"type":"paragraph","content":[{"text":"\tm_len = sizeof(SbinaryPacket) + 32 * sizeof(float) + 10","type":"text"}]},{"type":"paragraph","content":[{"text":"The server handles incoming binary packets specially by:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"verifying the opcode is 30","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"decoding the string expression to a target address","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"copying the payload data to that address","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Any binary message with an opcode other than 30 causes a server assertion failure, since binary messages are intended for internal AWE use only, and would be a serious error with other opcodes. The reply to this message will be ","type":"text"},{"text":"success","type":"text","marks":[{"type":"strong"}]},{"text":" or ","type":"text"},{"text":"failed,","type":"text","marks":[{"type":"strong"}]},{"text":", as with other messages. This command is sent to the AWE server by the Maltalb DLL when it processes ","type":"text"},{"text":"fast_write","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The text command documented earlier ","type":"text"},{"text":"fast_read ","type":"text","marks":[{"type":"strong"}]},{"text":"generates a binary reply with payload of the number of words requested, and with no string part ","type":"text"},{"text":"or","type":"text","marks":[{"type":"em"}]},{"text":" a string message ","type":"text"},{"text":"failed,.","type":"text","marks":[{"type":"strong"}]},{"text":" For that message, we have:","type":"text"}]},{"type":"paragraph","content":[{"text":"\tm_nFloats = ","type":"text"}]},{"type":"paragraph","content":[{"text":"\tm_len = sizeof((SbinaryPacket) +m_nFloats * sizeof(float)","type":"text"}]},{"type":"paragraph","content":[{"text":"\tm_opcode = 29","type":"text"}]},{"type":"paragraph","content":[{"text":"Currently, the only code that expects this reply is the MATLAB plugin DLL.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Supported Messages and External Binary Packets","type":"text"}]},{"type":"paragraph","content":[{"text":"The default target packet buffer is 4105 words - enough for the largest command header plus 4096 argument values. Targets are free to define the packet buffer as small as 16 words with a greatly increased transport overhead. A compromise used on many targets is 264 words - enough for the largest command header plus 256 argument values.","type":"text"}]},{"type":"paragraph","content":[{"text":"Binary packets have the form:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"word 0: 16 bit length | 8 bit core ID | 8 bit opcode","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"word 1 - N-2 command payload","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"word N-1: XOR sum of all preceding words","type":"text"}]},{"type":"paragraph","content":[{"text":"Reply packets have the form:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"word 0: 16 bit length in words | 16 bit zero","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"word 1 - N-2 reply payload","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"word N-1: XOR sum of all preceding words","type":"text"}]},{"type":"paragraph","content":[{"text":"Commands may have no payload. Replies always have at least one payload word, and for almost all of them word 1 is the return value - frequently the error code. Many replies only have this one payload word.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more about binary packets, including a detailed list of available commands, see ","type":"text"},{"type":"inlineCard","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"AWE Core Tuning Command Syntax and Protocol (Archived)","versionAtSave":"6"},"url":"https://dspconcepts.atlassian.net/wiki/spaces/DOCTEST/pages/2717712475"}},{"text":" .","type":"text"}]}],"version":1}