Table of Contents
Advertisement
Quick Links
Download this manual
See also:
User Manual
Advertisement
Table of Contents
Related Manuals for ACS A1560 SONIC-LF
Summary of Contents for ACS A1560 SONIC-LF
- Page 1 A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT PROGRAMMING MANUAL A1560 SONIC OEM ULTRASONIC PULSER/ RECEIVER FRONT-END UNIT APPLICABLE FOR A1560 SONIC-LF, A1560 SONIC-HF, A1560 SONIC-AIR Acoustic Control Systems – ACS Group Programming manual Saarbrücken, Germany 2019...
- Page 2 A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT Service Address: ACS-Solutions GmbH Science Park 2 66123 Saarbrucken, Germany Phone: +49 (0) 681-96592270 Fax: +49 (0) 681-96592280 Е-mail: info@acs-international.com Website: www.acs-international.com Issue date: 27.06.2019 Programming manual...
-
Page 3: Table Of Contents
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT TABLE OF CONTENTS 1 INTRODUCTION ............................... 6 2 A1560 API DESCRIPTION ............................ 8 2.1 A1560 API METHODS ..................................8 2.1.1 CONNECT(STRING IP) – OPEN NETWORK CONNECTION ..............8 2.1.2 START() – START ACQUISITION ..........................9 2.1.3 STOP() –... - Page 4 A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.2.9 INT TGCOFFSETUS – TIME GAIN COMPENSATION OFFSET ............14 2.2.10 INT GAINDB – CONSTANT GAIN AT INPUT ....................15 2.2.11 INT INPUTFILTERNUMBER – ANALOG HIGH-PASS FILTER ............15 2.2.12 INT DIGITALFILTERHIPASSKHZ– DIGITAL HIGH-PASS FILTER............15 2.2.13 INT DIGITALFILTERLOPASSKHZ–...
- Page 5 A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.4 A1560 API EVENTS ..................................21 2.4.1 DATARECEIVED EVENT ..............................21 2.5 A1560 API EXCEPTIONS ................................22 2.5.1 INVALIDOPERATIONEXCEPTION ..........................22 2.5.2 ARGUMENTOUTOFRANGEEXCEPTION ......................22 2.5.3 ARGUMENTEXCEPTION ..............................22 2.5.4 IOEXCEPTION ..................................22 2.5.5 NOTSUPPORTEDEXCEPTION ..........................22 3 A1560 APPLICATION EXAMPLES ........................23 3.1 C# EXAMPLE .....................................23 3.2 VBA EXAMPLE ....................................25 Programming manual...
-
Page 6: Introduction
The A1560 series is available in the following configurations: TABLE 1. AVAILABLE PRODUCTS Instrument version Frequency Range Transducers To be operated with DPC and regular low-frequency A1560 SONIC-LF 10 kHz – 500 kHz piezo-transducers. Piezo-electric transducers with contact and immersion A1560 SONIC-HF 400 kHz – 15 MHz coupling. - Page 7 A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT The main purpose of the A1560 is system integration and customization for a wide range of measurement and inspection tasks. The user is provided with a software development kit (SDK) for writing their own software applications. The SDK consists of: •...
-
Page 8: A1560 Api Description
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT A1560 API DESCRIPTION When referenced from a managed CLR code, the A1560 API exposes A1560 class. An instance of this class provides the user with the means to connect to the A1560 instrument and control it via A1560 API Methods, change parameters via A1560 API Proper- ties and subscribe to an acquired data via a DataReceived Event. -
Page 9: Start() - Start Acquisition
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.1.2 Start() – Start acquisition Calling the Start() method will start a single acquisition or a sequence of acquisitions, depending on the value of Triggering- Mode property. Exceptions InvalidOperationException, IOException Notes Once started, a sequence of acquisitions will be continued by the instrument, even if a Disconnect is performed. -
Page 10: Disconnect() - Close Network Connection
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.1.5 Disconnect() – Close network connection Exceptions No exceptions are raised by the Disconnect call. Notes Closed connections may be reopened on the same A1560 object. The user can call a Disconnect on an already disconnected object. -
Page 11: A1560 Api Properties
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.2 A1560 API PROPERTIES Acquisition parameters can be read or altered by reading and writing properties of the A1560 object. The current state of an A1560 can be polled with a subset of read-only properties. Please note that data acquisition parameters are stored in the RAM of the A1560. -
Page 12: Int Triggeringintervalus - Periodic Acquisition Interval
– Transmitter burst frequency This property sets or gets the frequency in kilohertz for a pulse burst sent to a transmitting transducer. Acceptable values for A1560 SONIC-LF: 25 – 500 for A1560 SONIC-HF: 500 – 10000 for A1560 SONIC-AIR: 400 – 600... -
Page 13: Int Burstperiodns - Transmitter Burst Period
– Transmitter burst period This property sets or gets the period in nanoseconds for a pulse burst sent to a transmitting transducer. Acceptable values for A1560 SONIC-LF: 2000 – 40000 for A1560 SONIC-HF: 100 – 2000 for A1560 SONIC-AIR: 1660 – 2500... -
Page 14: Int Burstlengthnumber - Transmitter Burst Duration
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.2.6 int BurstLengthNumber – Transmitter burst duration This property sets or gets the number of half-periods in the transmitter burst. Acceptable values 1 - 10 Notes For example, when BurstLengthNumber =2, the pulse duration is one full period (negative and positive half waves), or 1uS BurstFrequencyKhz = 1000. -
Page 15: Int Gaindb - Constant Gain At Input
2.2.11 int InputFilterNumber – Analog high-pass filter This property selects an analog filter at the input of the A1560. Acceptable values Version-specific: Value A1560 SONIC-LF A1560 SONIC-AIR A1560 SONIC-HF 1600 3200 2.2.12 DigitalFilterHiPassKhz– Digital high-pass filter This property gets or sets the digital high-pass filter cut-off frequency in kilohertz. -
Page 16: Int Digitalfilterlopasskhz- Digital Low-Pass Filter
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.2.13 DigitalFilterLoPassKhz– Digital low-pass filter This property gets or sets the digital low-pass filter cut-off frequency in kilohertz. Acceptable values 10 – 20000 Notes This property is not supported in API version 1.0 2.2.14 int SamplingFrequencyMhz –... -
Page 17: Int Averagingfactor - Acquisitions Per Averaged Vector
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.2.16 int AveragingFactor – Acquisitions per averaged vector The A1560 can make several pulses/acquisitions in a row and internally calculate an averaged vector from the results when AveragingFactor > 0. Acceptable values 0-10 Notes Number of acquisitions required to produce one averaged data vector is calculated as 2... -
Page 18: Int Averagingrandomvaluens - Random Averaging Interval
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.2.18 int AveragingRandomValueNs – Random averaging interval This property is defined in nanoseconds and gets or sets a random part of an interval between acquisitions in averaging mode. When the A1560 performs several pulses/acquisitions in a row for the following averaging, a pause will take place after an acquisition is finished. -
Page 19: Int Currentvectorrate - Incoming Vector Rate
This property is used to detect the version of the connected instrument. Possible values 0 – Unknown device 1 – A1560 (unknown version) 2 – A1560 SONIC-LF 3 – A1560 SONIC-AIR 4 – A1560 SONIC-HF Notes This is a read-only property. -
Page 20: A1560 Datatypes
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.3 A1560 DATATYPES 2.3.1 AcquisitionData Class Each acquired data vector is represented by an AcquisitionData object containing an array of samples along with additi- onal information. Public read-only properties: short[] Vector – 12-bit signed samples of an acquired vector. Int Id –... -
Page 21: A1560 Api Events
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.4 A1560 API EVENTS 2.4.1 DataReceived Event Acquired data is provided to the user’s application via the DataReceived event, which bears the AcquisitionData object: public delegate void DataReceivedDelegate(AcquisitionData data); public event DataReceivedDelegate DataReceived; Notes User code should be subscribed to the DataReceived... -
Page 22: A1560 Api Exceptions
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 2.5 A1560 API EXCEPTIONS Upon error, standard exceptions are thrown: 2.5.1 InvalidOperationException Raised when a method is called or a property is changed before opening a connection to the A1560 with the Connect method. -
Page 23: A1560 Application Examples
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT A1560 APPLICATION EXAMPLES 3.1 C# EXAMPLE The code below illustrates essential concepts for working with the A1560 API from a C# application. Exception handling, buffer flushing and other important parts of the code are skipped for brevity. Remember to reference A1560APICOM.dll in the project. - Page 24 A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT A1560.DataReceived += A1560OnDataReceived; //Launch A1560.Start(); //Keep application alive for a moment (so we can see the vector event) Console.ReadKey(); A1560.Disconnect(); private static void A1560OnDataReceived(AcquisitionData data) vector = data.Vector; Console.WriteLine($”Vector received, Length: {vector.Length} samples, CTP={data.Ctp[0]:X08}:{data.Ctp[1]:X08}:{data.Ctp[2]:X08}, maximum sample value = {vector.Max()} “);...
-
Page 25: Vba Example
A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT 3.2 VBA EXAMPLE This example can be run in Microsoft® Excel and presents every acquired vector as a column of values. The ACS A1560 COM API component should be registered in OS and referenced in the VBA script. - Page 26 A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT m_A1560.SamplingFrequencyMhz = 100 m_A1560.GainDb = 0 m_A1560.BurstFrequencyKhz = 10000 m_A1560.BurstLengthNumber = 2 m_A1560.PulseVoltage = 20 m_A1560.TriggeringIntervalUs = 1000000 m_A1560.TriggeringMode = 1 m_A1560.Start End Sub Private Sub CommandButton1_Click() StartAcquisition End Sub Programming manual...
- Page 27 A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT Programming manual...
- Page 28 A1560 SONIC - OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT A1560 SONIC OEM ULTRASONIC PULSER/RECEIVER FRONT-END UNIT PROGRAMMING MANUAL Acoustic Control Systems – ACS Group Saarbrücken, Germany 2019 Programming manual...
Need help?
Do you have a question about the A1560 SONIC-LF and is the answer not in the manual?
Questions and answers