diff --git a/README.md b/README.md index 951ef659..795ec485 100644 --- a/README.md +++ b/README.md @@ -1,164 +1,215 @@ +
+ +OpenTest + # OpenTest -**An open-source platform for acoustic and vibration testing, measurement, and data acquisition** +### Next-generation sound and vibration measurement software -English | [简体中文](README.zh-CN.md) +**Turn a PC and your acquisition hardware into a complete acoustic and vibration test bench.**
+Monitor live, measure to international standards, analyze offline and run production-line sequences,
+then deliver the report — all in one source-available, plugin-based platform from CRYSOUND. -OpenTest turns a PC and a set of acquisition hardware into a complete test bench. Connect a microphone, an accelerometer, or a professional data acquisition (DAQ) device, and you can cover the whole workflow: **device connection, parameter setup, live monitoring, formal measurement, pass/fail judgment, reporting, and data archiving**. R&D engineers can use it for flexible one-off analysis, and production lines can run fixed test sequences to check large batches with one click. +[![Release](https://img.shields.io/github/v/release/crysound/OpenTest?include_prereleases&label=release&color=170057)](https://github.com/crysound/OpenTest/releases) [![Stars](https://img.shields.io/github/stars/crysound/OpenTest?style=flat&color=170057)](https://github.com/crysound/OpenTest/stargazers) [![License](https://img.shields.io/badge/license-OpenTest%20Community%201.0-170057)](LICENSE.md) [![Website](https://img.shields.io/badge/website-opentest.com-170057)](https://www.opentest.com)
+![Windows](https://img.shields.io/badge/Windows%2010%20%7C%2011-x64%20installer-0078D4?logo=windows&logoColor=white) ![macOS](https://img.shields.io/badge/macOS-arm64%20from%20source-000000?logo=apple&logoColor=white) ![Linux](https://img.shields.io/badge/Linux-x64%20from%20source-FCC624?logo=linux&logoColor=black) -OpenTest is initiated and maintained by Hangzhou CRYSOUND Electronics (CRYSOUND) and is source-available under the OpenTest Community License. It is free for personal use, education, research, and in-house R&D and production use within a company. +**[Download](https://www.opentest.com/downloads/)**  ·  **[Docs](https://www.opentest.com/docs/)**  ·  **[Plugins](https://github.com/crysound/OpenTest-Plugins)**  ·  **[Pricing](https://www.opentest.com/pricing/)**  ·  **[Discussions](https://github.com/crysound/OpenTest/discussions)**  ·  **English** · [简体中文](README.zh-CN.md) ---- +
-## What OpenTest can do for you +OpenTest FFT measurement workspace with a live waveform, several spectra and a waterfall chart -| Your scenario | How OpenTest handles it | -| --- | --- | -| **R&D debugging**: quickly see the frequency content of a sound or vibration signal | Open Monitor to view live waveforms and spectra, then switch to FFT, octave, or other measurements for deeper analysis. Save, review, and compare results at any time | -| **Electroacoustic performance**: frequency response, distortion, and sensitivity of speakers, microphones, headphones, and finished products | Sweep measurement drives the output and acquires the input simultaneously, giving frequency response, distortion, and more in one run. Set upper and lower limits to judge pass/fail automatically | -| **Product and environmental noise**: sound level, sound power, sound quality | Sound level meter, sound power, and sound quality measurements organize parameters and measurement points around common engineering methods and report the business metrics directly | -| **Vibration and structural testing** | Vibration measurement reports acceleration, velocity, displacement, and statistics across multiple channels at once | -| **Building and room acoustics** | RT60 reverberation time measurement | -| **Production-line testing**: hundreds or thousands of units per day | Test sequences turn "prepare → excite → acquire → analyze → judge → record" into a fixed flow. Operators just place the unit and press Start. Supports multiple stations, barcode scanning, MES upload, and throughput (UPH) statistics | -| **Calibration** | Built-in sound level calibration workbench and channel sensitivity calibration keep results traceable | -| **Reporting** | Generate reports from measurement records, export to Excel, Word, and raw waveforms, or configure automatic saving and export | +
---- +
-## Key concepts: OpenTest in five minutes +## Is OpenTest for you? -| Concept | In one sentence | -| --- | --- | -| **Project** | The "folder" for a test task. It holds the channels in use, the configuration of each measurement, test sequences, and all test records. A project can be exported and imported as a whole, making it easy to hand over between colleagues and computers. | -| **Devices and channels** | Hardware such as DAQ devices, sound cards, and USB microphones, plus their input and output channels. Physical channels added to a project become **project channels**, where you set sensor sensitivity, units, and names. You can also combine channels with formulas into **math channels**. | -| **Measurement** | One type of measurement task, such as FFT, octave, or sweep. Each has its own parameter panel, run behavior, and results. Measurements are delivered as plugins and installed as needed. | -| **Test record** | The results and raw data saved from each measurement. Reopen records, compare several of them, recalculate, or export without acquiring again. | -| **Test sequence** | Several steps arranged into a repeatable flow with branches, loops, operator confirmation, and automatic judgment. Suited to production lines and standardized tests. | -| **Plugin** | An installation package (`.otplugin`) that extends OpenTest. There are two kinds: **business plugins** provide measurements, and **device plugins** let OpenTest work with new acquisition hardware. | +Acoustic and vibration testing usually means one tool for live monitoring, another for analysis, a script for the production line and a spreadsheet for the report. OpenTest puts the whole chain in one application: ---- +- **See the signal right away.** Connect a microphone, an accelerometer or a professional DAQ, open Monitor and watch waveforms, spectra and levels on every channel. +- **Measure the way the standards ask.** FFT, octave (IEC 61260), sound level meter (IEC 61672), sound power (ISO 3744/3745/3746, GB/T 32524.1, GB/T 28543), sound quality, RT60 and more, each with its own parameter panel and results. +- **Repeat it a thousand times a day.** Sequence mode turns "prepare → excite → acquire → analyze → judge → record" into a one-click flow with limits, barcode scanning, MES upload and UPH statistics. +- **Bring your own hardware.** CRYSOUND SonoDAQ works out of the box; sound cards, USB microphones and third-party DAQs connect through ASIO, WASAPI, openDAQ and NI-DAQmx device plugins. +- **Extend it yourself.** Business and device plugins add measurements and hardware without touching the core, and the AI-assisted OpenTest CLI lets agents drive the desktop. -## How a typical measurement works +It is built for R&D engineers who need flexible analysis, quality teams who need standard-compliant numbers, and production lines that need a fast, repeatable pass/fail verdict. The free Community license covers personal use, education, research, and in-house R&D and production with up to 4 channels. -``` - Connect device ──► New project ──► Add channels to project ──► Choose a measurement and set parameters - │ - View/export report ◄── Save test record ◄── Stop ◄── Start, watch curves live -``` +## Supported platforms and versions + +| Package | Version | Platform | Notes | +| :-- | :-- | :-- | :-- | +| **Official installer** (recommended) | V2.4.0 Beta | Windows 10 / 11, x64 | Installer (≈381 MB) from [opentest.com](https://www.opentest.com/downloads/), includes the full official plugin set. Older builds back to V0.6.1 are on the [previous versions](https://www.opentest.com/opentest-software-previous-versions/?otd_product=opentest) page | +| **Community daily build** | 2.5.0-dev | Windows 10 / 11, x64 | Unsigned build from [GitHub Releases](https://github.com/crysound/OpenTest/releases), produced from `main` by CI. Contains OpenTest plus the public plugins from [OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) (FFT and the SonoDAQ device plugin). Each release lists its SHA-256 | +| **Build from source** | 2.5.0 (`main`) | Windows x64 · macOS arm64 · Linux x64 | Windows produces an NSIS installer, macOS a DMG, Linux a DEB or TAR.GZ. macOS and Linux packages must be built on the target system; see [cross-platform packaging](docs/cross-platform-packaging.md) | -1. **Setup**: connect the hardware, refresh devices in OpenTest, add the input and output channels you need to the project, enter sensor sensitivity and other details, and calibrate first if needed. -2. **Measure**: choose a measurement (for example FFT), set the analysis parameters and the stop method (manual, timed, or triggered), and click Start. Curves and values update live during the run. You can also schedule a start time or run several measurements in sync. -3. **Report**: when you stop, the results are saved automatically as a test record. Select records on the Report page to generate and export a report. +The UI ships in English, Chinese, German, French, Spanish, Russian, Japanese and Korean. Your projects and test data stay in a local folder on your own machine. -For production lines, build the flow in advance in **Sequence** mode. Each run only needs a click on Start, and OpenTest executes the steps and gives a pass/fail verdict. +## Quick start ---- +**1 · Install.** Download the installer from **[opentest.com/downloads](https://www.opentest.com/downloads/)** (or a community build from [Releases](https://github.com/crysound/OpenTest/releases)) and run it. -## Measurement capabilities +The website button always redirects to the latest official build. Community builds are unsigned and have automatic updates turned off; check the published SHA-256 before installing. For your first measurement, any microphone that Windows recognizes is enough. -OpenTest's measurement capabilities come from **built-in features** and **optional plugins**. Install only what you need. +**2 · Sign in and connect.** Sign in with a CRYSOUND cloud account or import an offline (local or USB) license. Plug in your device, refresh **Setup → Hardware**, and add the channels you need to the project with their sensor sensitivity. -### Built-in features +**3 · Measure.** Pick a measurement such as **FFT**, set the analysis parameters and how to stop (manual, timed or triggered), and press **Start**. When you stop, the result is saved as a test record that you can review, compare, recalculate or turn into a report. + +
+Build and run from source +
+ +You need Node.js ≥ 22.14, pnpm ≥ 10.6.5 and < 11, a full JDK 21 with Maven, Python 3.11+, and the platform C++ toolchain (MSVC with the Windows SDK on Windows; Xcode Command Line Tools or a C++17 compiler plus CMake ≥ 3.20 on macOS and Linux). + +```sh +pnpm deps:check # check tool versions without changing anything +pnpm install --frozen-lockfile # install locked dependencies +pnpm prepare:backend-deps # build and install the Java backend modules +pnpm build # SDK, backend, frontend and desktop +pnpm start # launch the built application +pnpm dev # or: hot-reload development mode +pnpm package --platform windows # build an installer (windows | mac | linux) +``` -| Feature | Description | -| --- | --- | -| Monitor | View live waveforms, spectra, and levels on every channel, and record directly | -| Test sequences | Flow design, automatic judgment, operator interaction, variables, multi-station runs, and statistics | -| Signal generator | Excitation signals for amplifiers, speakers, and more | -| Built-in signal analysis | Common analyses on acquired waveforms, without installing business plugins | -| Project, record, and report management | Save, review, compare, export, and migrate projects | +Local license and runtime configuration are described in the [developer guide](docs/development-and-packaging.md) and [framework runtime](docs/framework-runtime.md). -### Business plugins (measurements) +
-| Plugin | Use case | Availability | -| --- | --- | --- | -| FFT spectrum analysis | Frequency content, cross spectrum, transfer function, and more | Open source: [OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) | -| Octave analysis | 1/1, 1/3, and other octave-band spectra | Delivered with the suite | -| Sweep measurement | Frequency response, distortion, and other electroacoustic tests | Delivered with the suite | -| Sound level meter | Sound pressure level, frequency weighting, statistical levels | Delivered with the suite | -| Sound power | Sound power from measurement points | Delivered with the suite | -| Sound quality | Loudness, sharpness, and other psychoacoustic metrics | Delivered with the suite | -| Vibration analysis | Vibration magnitudes and spectra | Delivered with the suite | -| RT60 reverberation time | Room acoustics | Delivered with the suite | -| Sound level calibration workbench | Calibrator management, calibration, and logs | Delivered with the suite | +## Three modes for the complete test workflow -### Device plugins + + + + + + +
Measure mode
Measure
Real-time acquisition and analysis with your DAQ hardware. Analyze while acquiring or after acquiring, for both live monitoring and flexible analysis.
Analysis mode
Analysis
Offline, in-depth analysis of recorded waveforms or data, from cleaning to computation, without connecting any hardware.
Sequence mode
Sequence
Repeatable automated tests for labs and production lines. Connects acquisition, analysis, storage and reporting into one batch flow.
-| Plugin | Description | Availability | -| --- | --- | --- | -| Windows audio (WASAPI / ASIO) | Use the PC sound card, USB microphones, or professional sound cards out of the box | Built in | -| SonoDAQ | Connect to and control CRYSOUND SonoDAQ acquisition devices | Open source: [OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) | +**From signals to test reports:** Connect devices → Configure channels → Set up the test workflow → Measure → Analyze → Report. -> Plugins must match the OpenTest version; the supported range is declared in each plugin's manifest. Installed plugins take effect only after a **full restart** of OpenTest. +## Professional analysis modules ---- + + + + + + + + + + + + + +
FFT analysis with time waveform, FFT, ASD and cross spectra
FFT analysis · baseband, precision baseband and zoom FFT, 19 window functions, auto- and cross-spectrum, frequency response H1/H2/H3, coherence, harmonic and sideband cursors
Octave analysis with 1/n-octave band spectra
Octave / CPB · 1/1, 1/3 and up to 1/24 octave bands, A/B/C/Z weighting, compliant with IEC 61260
Sweep analysis with frequency response, THD and phase
Sweep · continuous, stepped and stepped-level sweeps with synchronous generation and acquisition, impulse response, THD (up to the 100th harmonic) and Rub & Buzz
Sound level meter with level over time and band levels
Sound level meter · IEC 61672 metering with Leq, Lmax, Lmin, Lpeak, Fast/Slow/Impulse time weighting and statistical percentiles (Ln)
Sound power with multichannel waveforms, band spectra and hemisphere microphone layout
Sound power · ISO 3744, 3745 and 3746, GB/T 32524.1 and GB/T 28543 workflows, 3D measurement-point layouts and background noise correction
Sound quality with loudness, sharpness and roughness charts
Sound quality · loudness (Zwicker and Moore), sharpness, roughness, fluctuation strength, tonality and prominence ratio
-## Plugins: extend as you need, build your own +| Module | What it measures | Availability | +| :-- | :-- | :-- | +| **Monitor & generator** | Live waveforms, spectra and levels on every channel; long recordings; tones, multitones and waveform playback | Built in | +| **FFT analysis** | Narrowband spectra, cross spectrum, transfer function | Open source in [OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) | +| **Octave · Sweep · Sound level meter · Sound power · Sound quality** | See the screenshots above | Official package | +| **Vibration analysis** | Acceleration, velocity, displacement and statistics across many channels | Official package | +| **RT60** | Room acoustics: T20, T30, T60 with Schroeder integration and multi-position averaging | Official package | +| **Order analysis** | Tacho processing, order tracking and RPM spectrograms for rotating machinery | Official package | +| **Calibration** | Sound level calibration workbench and channel sensitivity calibration | Official package | -[OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) is the public plugin repository for OpenTest. It contains the full source of the **FFT measurement plugin** and the **SonoDAQ device plugin**, and serves as a reference for building new plugins. +Measurements can run in sync, start on a schedule or a trigger, and use math channels built from formulas. Some modules need a matching feature entitlement; see [editions](#editions-and-licensing). -- **For users**: import a `.otplugin` package under Settings → Plugin Management and restart. Plugins can be enabled, disabled, upgraded, or uninstalled. All changes take effect after a restart and can be undone before then. Disabling or uninstalling a business plugin does not delete existing data; viewing is restored once the plugin is enabled again. -- **For developers**: plugins use the device acquisition, algorithms, data storage, and charting that OpenTest provides, so you can focus on your own measurement logic or device integration. You decide whether your plugin is open source and whether it is paid. Developing and selling independent plugins does **not** require an additional commercial license. +## Built for the production line ---- +Sequence mode turns a test procedure into a flow that an operator runs with one click. Steps include playback and acquisition (synchronous, sequential or asynchronous output groups), sweep and signal analysis, limit lines and automatic judgment, dialogs and variables, IF/ELSE branches and loops, shield-box control, Bluetooth headset and microphone tests, file operations, external programs, MES upload and automatic Excel saving. Multiple stations, barcode scanning, step-by-step debugging, locking and UPH statistics are built in. -## Licensing +## Reports in one step -OpenTest is licensed under the **OpenTest Community License 1.0**. The points below are a summary; the [license agreement](LICENSE.md) is authoritative. +OpenTest report module showing an FFT test report -**Free to use for:** +Select test records on the **Report** page to generate a report from a general-purpose template, then export it to Word, Excel or PDF together with data tables, images and raw waveforms. Reports can be duplicated and archived, and sequences can save and export automatically. -- Personal use, learning, and education; -- Scientific research, software development, and product R&D; -- In-house use within a company, **including production environments**; -- Providing testing, measurement, or other technical services to customers with OpenTest (as long as the software itself is not delivered to the customer). +## Open hardware connectivity -The free license includes **4 simultaneously usable physical input or output channels** per OpenTest system. +CRYSOUND measurement hardware: test station, acoustic camera, sound level meters, microphones and DAQ -**A commercial license is required to:** +Use OpenTest with CRYSOUND measurement devices out of the box, or bring in third-party hardware through audio interfaces, openDAQ and selected DAQ protocols. -- Use more than 4 channels; -- Deliver OpenTest to customers with hardware or other commercial products (OEM, ODM, white label, bundled device software); -- Sell, rent, or repackage and distribute OpenTest or a modified version as commercial software; -- Offer OpenTest's main functions to third parties over a network for a fee (SaaS, cloud, or hosted services). +| Protocol | Verified | Supported | +| :-- | :-- | :-- | +| **openDAQ** | CRYSOUND SonoDAQ Pro · SonoDAQ Go · SonoDAQ LT | Dewesoft SIRIUS XHS · HBK Fusion RX · HBK Fusion MX | +| **ASIO** | CRYSOUND CRY6151B · Echo AIO System · RME Fireface UFX III | | +| **WASAPI** | CRYSOUND CRY2301 noise sensor · miniDSP UMIK-1 · built-in sound cards | | +| **Modbus-TCP** | CRYSOUND CRY2851 sound level meter | | +| **NI-DAQmx** | NI USB-4431 · NI cDAQ-9188 | NI cDAQ-9170 · NI cDAQ-9173 | -In addition, some measurements require the corresponding feature entitlement, obtained online with a cloud account or through a local or USB offline license. Contact CRYSOUND for commercial licenses and feature entitlements. +Hardware support comes from device plugins, so it depends on the package you install. SonoDAQ adds PTP/GPS clock synchronization. Ordinary sound cards are fine for learning and early checks; use calibrated measurement hardware for formal results. The current list lives on the [website](https://www.opentest.com/). ---- +## Plugins and the AI-assisted CLI -## Getting started +**Plugins.** Everything beyond the core comes as an `.otplugin` package: **business plugins** add measurements and **device plugins** add hardware. Import them under **Settings → Plugin Management**, then restart; disabling or uninstalling a plugin never deletes your data. Plugins reuse OpenTest's acquisition, algorithms, storage and charts, so you only write your own measurement logic or device integration. [OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) contains the full source of the FFT and SonoDAQ plugins as templates. You decide whether your plugin is open source or paid; selling independent plugins needs no extra commercial license. -| Who you are | Start here | -| --- | --- | -| An engineer who wants to use it | Download and install the package (Windows x64), sign in with a cloud account or import an offline license, install the plugins you need, and follow "How a typical measurement works" for your first test | -| A contributor or someone building from source | Read the [Developer Guide](docs/development-and-packaging.md) for environment setup, source development, and packaging | -| A plugin developer | Read the development docs in [OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) and use the FFT plugin as a template | -| Looking for more channels or OEM licensing | Contact CRYSOUND | +**OpenTest CLI.** [`opentest-cli`](cli/README.md) lets AI agents and scripts drive OpenTest, either through the running desktop UI or directly through the SDK, so engineers can turn test experience and specialized algorithms into reusable modules. -**System requirements**: Windows 10/11 x64. A microphone recognized by Windows is recommended for your first measurement. +## Editions and licensing ---- +| Edition | Channels | Highlights | +| :-- | :-- | :-- | +| **Community** · free | 4 | Monitor and generator, basic FFT, octave and sweep | +| **Professional** | 8 | Everything in Community, plus algorithm plugins | +| **Advanced** | 24 | Sequence and Analysis modes, recorder, export and reports, optional apps | +| **Enterprise** | Unlimited | All features and optional apps, API/SDK | + +Monthly, yearly and lifetime plans and the full feature matrix are on the [pricing page](https://www.opentest.com/pricing/), which is authoritative for editions. + +The source in this repository is available under the **[OpenTest Community License 1.0](LICENSE.md)**. In short, it is free for personal use, education, research, software and product development, in-house use including production, and for providing test services to customers, with up to **4 simultaneously used physical channels** per system. A commercial license is needed for more channels, for shipping OpenTest with hardware or other products (OEM, ODM, white label), for selling or redistributing it, or for offering it as a paid hosted service. The license text prevails over this summary. + +
+Key concepts in five minutes +
+ +| | | +| :-- | :-- | +| **Project** | The folder for a test task: channels, measurement settings, sequences and every test record. Export and import it as a whole to hand over work | +| **Devices and channels** | DAQ devices, sound cards and USB microphones with their inputs and outputs. Channels added to a project carry sensitivity, unit and name; formulas combine them into math channels | +| **Measurement** | One kind of measurement task, such as FFT, octave or sweep, delivered as a plugin | +| **Test record** | The saved results and raw data of a run. Reopen, compare, recalculate or export without acquiring again | +| **Test sequence** | Steps arranged into a repeatable flow with branches, loops, operator confirmation and automatic judgment | +| **Plugin** | An `.otplugin` package; business plugins add measurements, device plugins add hardware | + +
## FAQ -**How is OpenTest different from instrument vendors' test software?** -OpenTest is source-available and plugin-based. The free tier covers most R&D and in-house production needs, and you buy a license only when you need more channels or commercial delivery. +**How is OpenTest different from instrument vendors' software?** It is source-available and plugin-based, it works with hardware from several vendors, and the free tier already covers most R&D and in-house production work. You pay only for more channels, advanced modules or commercial delivery. + +**Can I start without a professional DAQ?** Yes. PC sound cards and USB microphones connect through Windows audio. They cannot guarantee instrument-grade accuracy, so use calibrated measurement hardware for formal tests. + +**Will uninstalling a plugin lose my data?** No. Data and settings stay; results from that plugin become viewable again once a compatible version is enabled. + +**Where is my data stored?** In the project folder on your own machine. Nothing is uploaded to the cloud. -**Can I use it without a professional DAQ device?** -Yes. PC sound cards and USB microphones connect through Windows audio, which is fine for learning and early validation. Ordinary sound cards cannot guarantee instrument-grade accuracy, so use professional acquisition hardware and calibrate it for formal measurements. +## Documentation -**Will uninstalling a plugin lose my data?** -No. Data and configuration are kept, but that plugin's results cannot be viewed or exported while it is uninstalled or disabled. Installing a compatible version restores access. +| | | +| :-- | :-- | +| **[User manual](https://www.opentest.com/docs/)** | Setup, hardware, channels, measurements and sequences | +| **[Developer guide](docs/development-and-packaging.md)** | Environment, source development and packaging | +| **[Cross-platform packaging](docs/cross-platform-packaging.md)** | Windows, macOS and Linux installers | +| **[Plugin development](docs/plugin-development.md)** | Plugin structure, APIs and delivery | +| **[OpenTest CLI](cli/README.md)** | Driving OpenTest from agents and scripts | +| **[Contributing](CONTRIBUTING.md)** | Branches, reviews and releases | -**Where is my test data stored?** -In the project directory on your own machine; it is not uploaded to the cloud. Projects can be exported as a whole for backup or handover. +## Community ---- +Ask usage questions in [Discussions](https://github.com/crysound/OpenTest/discussions) and report bugs or feature requests in [Issues](https://github.com/crysound/OpenTest/issues). For licenses, OEM cooperation or a demo, write to **info@crysound.com**; for technical support, **support@crysound.com**. Code contributions are welcome; please read [CONTRIBUTING](CONTRIBUTING.md) and the contribution terms in the license first. Security issues go through the [security policy](SECURITY.md). -## Contributing and feedback +If OpenTest is useful to you, **a ⭐ helps other engineers find it.** -Issues, feature requests, and code contributions are welcome. Please read the contribution terms in the license agreement before contributing code. + + + + Star history of crysound/OpenTest + + ## License -OpenTest's own code and components in this repository are licensed under the **OpenTest Community License 1.0**; see the [English](LICENSE.md) and [Chinese](LICENSE.zh-CN.md) versions. If the two versions differ, the Chinese version prevails. Third-party components follow their own licenses. +OpenTest's own code and components in this repository are licensed under the **OpenTest Community License 1.0** ([English](LICENSE.md) · [中文](LICENSE.zh-CN.md)); if the two versions differ, the Chinese version prevails. Third-party components follow their own licenses. OpenTest is developed and maintained by Hangzhou CRYSOUND Electronics Co., Ltd. ([crysound.com](https://www.crysound.com/)). diff --git a/README.zh-CN.md b/README.zh-CN.md index 4f93ed55..b7d0187a 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -1,164 +1,215 @@ +
+ +OpenTest + # OpenTest -**源码开放的声学与振动测试、测量与数据采集平台** +### 新一代声音与振动测量软件 -[English](README.md) | 简体中文 +**一台电脑加上采集硬件,就是一套完整的声学与振动测试台。**
+实时监测、按国际标准测量、离线分析、产线序列测试,最后一键出报告。
+CRYSOUND 出品,源码开放,插件化扩展。 -OpenTest 把一台电脑和一套采集硬件变成一个完整的测试工作台:接上麦克风、加速度计或专业采集卡,就能完成从**设备连接、参数设置、实时监测、正式测量、结果判定,到报告输出和数据归档**的整个过程。它既能让研发工程师灵活地做一次性分析,也能让产线用固定的测试序列一键完成批量检测。 +[![Release](https://img.shields.io/github/v/release/crysound/OpenTest?include_prereleases&label=release&color=170057)](https://github.com/crysound/OpenTest/releases) [![Stars](https://img.shields.io/github/stars/crysound/OpenTest?style=flat&color=170057)](https://github.com/crysound/OpenTest/stargazers) [![License](https://img.shields.io/badge/license-OpenTest%20Community%201.0-170057)](LICENSE.zh-CN.md) [![Website](https://img.shields.io/badge/website-opentest.com-170057)](https://www.opentest.com/zh-hans/)
+![Windows](https://img.shields.io/badge/Windows%2010%20%7C%2011-x64%20installer-0078D4?logo=windows&logoColor=white) ![macOS](https://img.shields.io/badge/macOS-arm64%20from%20source-000000?logo=apple&logoColor=white) ![Linux](https://img.shields.io/badge/Linux-x64%20from%20source-FCC624?logo=linux&logoColor=black) -OpenTest 由杭州兆华电子(CRYSOUND)发起并维护,以 OpenTest 社区许可开放源码。个人、教育、科研以及企业内部的研发和生产使用都可以免费使用。 +**[下载](https://www.opentest.com/zh-hans/%E4%B8%8B%E8%BD%BD-2/)**  ·  **[文档](https://www.opentest.com/zh-hans/%E6%96%87%E6%A1%A3/)**  ·  **[插件](https://github.com/crysound/OpenTest-Plugins)**  ·  **[定价](https://www.opentest.com/zh-hans/%E5%AE%9A%E4%BB%B7/)**  ·  **[讨论区](https://github.com/crysound/OpenTest/discussions)**  ·  [English](README.md) · **简体中文** ---- +
-## 它能帮你做什么 +OpenTest FFT 测量界面,包含实时波形、多张频谱图和瀑布图 -| 你的场景 | OpenTest 的做法 | -| --- | --- | -| **研发调试**:想快速看清一个声音或振动信号的频率构成 | 打开 Monitor 实时查看波形与频谱,切到 FFT、倍频程等测量项做深入分析,结果随时保存、回看和对比 | -| **声学性能测试**:扬声器、麦克风、耳机、整机的频响、失真、灵敏度 | 用扫频测量驱动输出并同步采集,一次得到频响、失真等结果,可设置上下限自动判定合格与否 | -| **环境与产品噪声评估**:声级、声功率、声品质 | 声级计、声功率、声品质测量项按常用工程方法组织参数与测点,直接给出业务指标 | -| **振动与结构测试** | 振动测量项输出加速度、速度、位移等结果和统计量,支持多通道同时分析 | -| **建筑与室内声学** | RT60 混响时间测量 | -| **产线检测**:同一产品每天测成百上千台 | 用测试序列(Sequence)把“准备 → 激励 → 采集 → 分析 → 判定 → 记录”编排成固定流程,操作员只需放好产品、点开始;支持多工位、扫码、上传 MES 和产能(UPH)统计 | -| **设备校准** | 内置声级校准工作台与通道灵敏度校准,保证测量结果可追溯 | -| **出具报告** | 基于测量记录生成报告,可导出 Excel、Word 和原始波形,也可配置自动保存与导出 | +
---- +
-## 核心概念:五分钟看懂 OpenTest +## OpenTest 适合你吗? -| 概念 | 一句话解释 | -| --- | --- | -| **工程(Project)** | 一次测试任务的“文件夹”,保存所用通道、各测量项配置、测试序列和全部测试记录。可整体导出、导入,方便在同事和电脑之间交接。 | -| **设备与通道** | 采集卡、声卡、USB 麦克风等硬件以及它们的输入、输出通道。设备上的物理通道加入工程后成为**工程通道**,可以设置传感器灵敏度、单位和名称;还能用公式组合出**数学通道**。 | -| **测量项** | 一种测量业务,例如 FFT、倍频程、扫频。每种测量项有自己的参数界面、运行方式和结果。测量项以插件的形式提供,按需安装。 | -| **测试记录** | 每次测量保存下来的结果和原始数据。可以重新打开、对比多次记录、重新计算或导出,不需要重新采集。 | -| **测试序列(Sequence)** | 把多个步骤编排成可重复执行的流程,支持分支、循环、人工确认和自动判定,适合产线与标准化测试。 | -| **插件** | 扩展 OpenTest 能力的安装包(`.otplugin`)。分为两类:**业务插件**提供测量项,**设备插件**让 OpenTest 认识新的采集硬件。 | +做声学和振动测试,常常是监测用一个软件,分析换一个软件,产线再写一套脚本,报告最后在表格里手工整理。OpenTest 把整条链路放进一个应用: ---- +- **接上就能看到信号。** 连接麦克风、加速度计或专业采集卡,打开实时监测(Monitor),每个通道的波形、频谱和电平都能实时看到。 +- **按标准要求测量。** FFT、倍频程(IEC 61260)、声级计(IEC 61672)、声功率(ISO 3744/3745/3746、GB/T 32524.1、GB/T 28543)、声品质、RT60 等测量项,各有自己的参数界面和结果。 +- **一天测上千台也不怕。** 序列模式把“准备 → 激励 → 采集 → 分析 → 判定 → 记录”编排成一键执行的流程,支持上下限判定、扫码、上传 MES 和 UPH 统计。 +- **硬件自由选。** CRYSOUND SonoDAQ 开箱即用;声卡、USB 麦克风和第三方采集设备可以通过 ASIO、WASAPI、openDAQ、NI-DAQmx 等设备插件接入。 +- **能力自己扩展。** 业务插件和设备插件可以增加测量项和硬件,不需要改动核心平台;AI 辅助的 OpenTest CLI 还能让智能体直接操作桌面端。 -## 一次典型的测量是怎样完成的 +研发工程师可以用它做灵活的分析,质量团队可以用它拿到符合标准的数据,产线可以用它快速给出可重复的合格判定。免费的社区许可覆盖个人、教育、科研,以及企业内部的研发和生产使用(最多 4 个通道)。 -``` - 连接设备 ──► 新建工程 ──► 把通道加入工程 ──► 选择测量项并设置参数 - │ - 查看/导出报告 ◄── 保存测试记录 ◄── 停止 ◄── 开始测量,实时观察曲线 -``` +## 支持的平台与版本 + +| 安装包 | 版本 | 平台 | 说明 | +| :-- | :-- | :-- | :-- | +| **官网安装包**(推荐) | V2.4.0 Beta | Windows 10 / 11,x64 | 从 [opentest.com](https://www.opentest.com/zh-hans/%E4%B8%8B%E8%BD%BD-2/) 下载,约 381 MB,包含完整的官方插件。V0.6.1 起的历史版本见[历史版本](https://www.opentest.com/opentest-software-previous-versions/?otd_product=opentest)页面 | +| **社区每日构建** | 2.5.0-dev | Windows 10 / 11,x64 | 由 CI 基于 `main` 构建,发布在 [GitHub Releases](https://github.com/crysound/OpenTest/releases),未签名。包含 OpenTest 和 [OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) 中的公开插件(FFT 与 SonoDAQ 设备插件),每个版本附 SHA-256 | +| **源码构建** | 2.5.0(`main`) | Windows x64 · macOS arm64 · Linux x64 | Windows 生成 NSIS 安装包,macOS 生成 DMG,Linux 生成 DEB 或 TAR.GZ。macOS 和 Linux 需在目标系统上构建,见[跨平台打包](docs/cross-platform-packaging_cn.md) | -1. **准备(Setup)**:连接硬件,在 OpenTest 中刷新设备,把要用的输入、输出通道加入工程,填写传感器灵敏度等信息,必要时先做一次校准。 -2. **测量(Measure)**:选择测量项(例如 FFT),设置分析参数和停止方式(手动、定时或触发),点击开始;测量过程中可实时看到曲线和数值。也可以预约在指定时间开始,或几个测量项同步运行。 -3. **报告(Report)**:停止后结果自动保存为测试记录;在报告页选择记录,生成并导出报告。 +界面支持中文、英文、德文、法文、西班牙文、俄文、日文和韩文。工程和测试数据都保存在本机的工程目录中。 -产线场景则在**序列**模式下预先编好流程,每次只需点“开始”,OpenTest 会逐步执行并给出合格/不合格结论。 +## 快速开始 ---- +**1 · 安装。** 从 **[opentest.com 下载页](https://www.opentest.com/zh-hans/%E4%B8%8B%E8%BD%BD-2/)** 下载安装包(或从 [Releases](https://github.com/crysound/OpenTest/releases) 下载社区构建)并运行。 -## 测量能力一览 +官网下载按钮始终指向最新的官方版本。社区构建未签名,已关闭自动更新,安装前请核对发布页给出的 SHA-256。第一次测量时,一支能被 Windows 识别的麦克风就够用。 -OpenTest 的测量能力由**内置功能**和**可选插件**两部分组成,你可以只安装需要的部分。 +**2 · 登录并连接设备。** 用 CRYSOUND 云账号登录,或导入离线授权(本机或 USB)。接好设备,在 **设置 → 硬件** 中刷新,把需要的通道加入工程并填写传感器灵敏度。 -### 内置功能 +**3 · 开始测量。** 选择测量项(例如 **FFT**),设置分析参数和停止方式(手动、定时或触发),点击 **开始**。停止后结果自动保存为测试记录,可以回看、对比、重新计算或生成报告。 + +
+从源码构建和运行 +
+ +需要 Node.js ≥ 22.14、pnpm ≥ 10.6.5 且 < 11、完整的 JDK 21 和 Maven、Python 3.11 及以上版本,以及对应平台的 C++ 工具链(Windows 使用 MSVC 和 Windows SDK;macOS 和 Linux 需要 Xcode 命令行工具或 C++17 编译器,以及 CMake ≥ 3.20)。 + +```sh +pnpm deps:check # 只检查工具版本,不做修改 +pnpm install --frozen-lockfile # 按锁定版本安装依赖 +pnpm prepare:backend-deps # 构建并安装 Java 后端模块 +pnpm build # 构建 SDK、后端、前端和桌面端 +pnpm start # 启动已构建的应用 +pnpm dev # 或者:热更新开发模式 +pnpm package --platform windows # 打安装包(windows | mac | linux) +``` -| 功能 | 说明 | -| --- | --- | -| Monitor 实时监测 | 随时查看各通道的实时波形、频谱与电平,也可直接录制 | -| 测试序列 | 流程编排、自动判定、人工交互、变量、多工位执行与统计 | -| 信号发生器 | 为功放、扬声器等提供激励信号 | -| 宿主信号分析 | 对已采集波形进行常用分析,不依赖安装业务插件 | -| 工程、记录与报告管理 | 数据保存、回看、对比、导出和工程迁移 | +本地授权和运行配置见[开发者指南](docs/development-and-packaging_cn.md)与[框架运行说明](docs/framework-runtime_cn.md)。 -### 业务插件(测量项) +
-| 插件 | 适用场景 | 获取方式 | -| --- | --- | --- | -| FFT 频谱分析 | 频率成分分析、互谱、传递函数等 | 公开源码:[OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) | -| 倍频程分析 | 1/1、1/3 等倍频程频谱 | 套件交付 | -| 扫频测量 | 频响、失真等电声性能测试 | 套件交付 | -| 声级计 | 声压级、计权、统计声级 | 套件交付 | -| 声功率 | 按测点计算声功率 | 套件交付 | -| 声品质 | 响度、尖锐度等心理声学指标 | 套件交付 | -| 振动分析 | 振动量值与频谱 | 套件交付 | -| RT60 混响时间 | 室内声学 | 套件交付 | -| 声级校准工作台 | 校准器管理、校准操作与日志 | 套件交付 | +## 覆盖完整测试流程的三种模式 -### 设备插件 + + + + + + +
测量模式
测量模式
配合采集硬件实时采集和分析。支持边采集边分析和采集后分析,兼顾动态监测和灵活分析。
分析模式
分析模式
离线深度分析已采集的波形或数据,从数据清洗到分析计算全流程完成,无需连接硬件。
序列模式
序列模式
面向重复测试和产线,打通“采集-分析-存储-报告”的完整流程,批量执行。
-| 插件 | 说明 | 获取方式 | -| --- | --- | --- | -| Windows 音频(WASAPI / ASIO) | 使用电脑声卡、USB 麦克风或专业声卡,开箱即用 | 内置 | -| SonoDAQ | 接入 CRYSOUND SonoDAQ 系列采集设备并控制设备 | 公开源码:[OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) | +**从信号到测试报告:** 连接设备 → 配置通道 → 搭建测试流程 → 测量 → 分析 → 报告。 -> 插件需与 OpenTest 版本匹配,兼容范围写在每个插件的清单中。安装后要**完整重启** OpenTest 才会生效。 +## 专业分析模块 ---- + + + + + + + + + + + + + +
FFT 分析:时域波形、FFT、ASD 和互谱
FFT 分析 · 基带、精确基带和细化 FFT,19 种窗函数,自谱与互谱,H1/H2/H3 频响函数,相干函数,谐波与边带光标
倍频程分析:1/n 倍频程频带谱
倍频程 / CPB · 1/1、1/3,最高 1/24 倍频程,A/B/C/Z 计权,符合 IEC 61260
扫频分析:频率响应、THD 和相位
扫频 · 连续扫频、步进扫频和步进幅值扫频,激励与采集同步,脉冲响应、THD(最高 100 次谐波)和异音(Rub & Buzz)分析
声级计:声级时间历程和频带声级
声级计 · 符合 IEC 61672,提供 Leq、Lmax、Lmin、Lpeak,快/慢/脉冲时间计权和统计声级(Ln)
声功率:多通道波形、频带谱和半球面测点布置
声功率 · 支持 ISO 3744、3745、3746 以及 GB/T 32524.1、GB/T 28543,3D 测点布置和背景噪声修正
声品质:响度、尖锐度和粗糙度曲线
声品质 · 响度(Zwicker 和 Moore)、尖锐度、粗糙度、波动强度、音调度和突出比
-## 插件:按需扩展,人人可开发 +| 模块 | 测什么 | 获取方式 | +| :-- | :-- | :-- | +| **实时监测与信号发生器** | 各通道实时波形、频谱和电平;长时间录制;单音、多音和波形文件播放 | 内置 | +| **FFT 分析** | 窄带频谱、互谱、传递函数 | 开源,见 [OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) | +| **倍频程 · 扫频 · 声级计 · 声功率 · 声品质** | 见上方截图 | 官方安装包 | +| **振动分析** | 多通道加速度、速度、位移及统计量 | 官方安装包 | +| **RT60** | 室内声学:T20、T30、T60,Schroeder 积分,多测点平均 | 官方安装包 | +| **阶次分析** | 转速信号处理、阶次跟踪和转速谱图,用于旋转机械诊断 | 官方安装包 | +| **校准** | 声级校准工作台和通道灵敏度校准 | 官方安装包 | -[OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) 是 OpenTest 的公开插件仓库,目前提供 **FFT 测量插件**和 **SonoDAQ 设备插件**的完整源码,同时也是开发新插件的参考范例。 +多个测量项可以同步运行,也可以定时或触发启动,并可使用公式组合出的数学通道。部分模块需要对应的功能权益,见[版本与许可](#版本与许可)。 -- **对使用者**:在“设置 → 插件管理”中导入 `.otplugin` 安装包,重启后即可使用。插件可以启用、禁用、升级或卸载,所有变更都在重启后生效,重启前可撤销。禁用或卸载业务插件不会删除已有数据,重新启用后即可恢复查看。 -- **对开发者**:插件能获得 OpenTest 提供的设备采集、算法、数据存储和图表能力,只需专注于自己的测量业务或设备接入。你可以自由选择插件是否开源、是否收费,开发和销售独立插件**不需要**额外商业许可。 +## 为产线而生 ---- +序列模式把测试规程变成操作员一键执行的流程。可用的步骤包括:播放与采集(输出组可同步、顺序或异步执行)、扫频与信号分析、框线与自动判定、对话框与变量、IF/ELSE 分支与循环、屏蔽箱控制、蓝牙耳机与麦克风测试、文件操作、运行外部程序、上传 MES 和自动保存 Excel。多工位、扫码、单步调试、锁定和 UPH 统计均已内置。 -## 使用授权 +## 一步生成报告 -OpenTest 采用 **OpenTest Community License 1.0**,以下为要点,正式条款以 [许可协议](LICENSE.zh-CN.md) 为准。 +OpenTest 报告模块中的 FFT 测试报告 -**免费即可使用:** +在 **报告** 页面选中测试记录,即可用通用模板生成报告,并连同数据表、图片和原始波形一起导出为 Word、Excel 或 PDF。报告可以复制和归档,序列也可以配置自动保存和导出。 -- 个人用途、学习与教育; -- 科学研究、软件开发与产品研发; -- 企业内部使用,**包括正式生产环境**; -- 用 OpenTest 为客户提供测试、测量等技术服务(软件本身不交付给客户)。 +## 开放硬件连接 -免费许可每套 OpenTest 系统包含 **4 个可同时使用的物理输入或输出通道**。 +CRYSOUND 测量硬件:测试工作站、声学相机、声级计、传声器和采集设备 -**以下情况需要商业许可:** +OpenTest 可以直接配合 CRYSOUND 测量设备使用,也可以通过音频接口、openDAQ 和部分采集卡协议接入第三方硬件。 -- 需要超过 4 个通道; -- 把 OpenTest 随硬件或其他商业产品交付给客户(OEM、ODM、白牌、设备配套软件); -- 把 OpenTest 或其修改版作为商业软件出售、出租或重新包装分发; -- 以收费方式通过网络向第三方提供 OpenTest 的主要功能(SaaS、云服务、托管服务)。 +| 协议 | 已验证 | 已支持 | +| :-- | :-- | :-- | +| **openDAQ** | CRYSOUND SonoDAQ Pro · SonoDAQ Go · SonoDAQ LT | Dewesoft SIRIUS XHS · HBK Fusion RX · HBK Fusion MX | +| **ASIO** | CRYSOUND CRY6151B · Echo AIO System · RME Fireface UFX III | | +| **WASAPI** | CRYSOUND CRY2301 噪声传感器 · miniDSP UMIK-1 · 电脑内置声卡 | | +| **Modbus-TCP** | CRYSOUND CRY2851 声级计 | | +| **NI-DAQmx** | NI USB-4431 · NI cDAQ-9188 | NI cDAQ-9170 · NI cDAQ-9173 | -另外,部分测量功能需要对应的功能权益,可通过云账号在线获取,也可使用本机或 USB 离线授权。商业许可与功能授权请联系 CRYSOUND。 +硬件支持由设备插件提供,实际可用范围取决于你安装的版本。SonoDAQ 额外支持 PTP/GPS 时钟同步。普通声卡适合学习和初步验证,正式测量请使用经过校准的测量硬件。最新列表以[官网](https://www.opentest.com/zh-hans/)为准。 ---- +## 插件与 AI 辅助 CLI -## 开始使用 +**插件。** 核心以外的能力都以 `.otplugin` 安装包提供:**业务插件**增加测量项,**设备插件**接入新硬件。在 **设置 → 插件管理** 中导入并重启即可生效;禁用或卸载插件不会删除已有数据。插件直接复用 OpenTest 的采集、算法、存储和图表,你只需编写自己的测量逻辑或设备对接。[OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) 提供 FFT 和 SonoDAQ 插件的完整源码,可作为模板。插件是否开源、是否收费由你决定;开发和销售独立插件不需要额外的商业许可。 -| 你是谁 | 从这里开始 | -| --- | --- | -| 想直接使用的工程师 | 下载安装包安装(Windows x64),用云账号登录或导入离线授权,安装需要的插件,按“一次典型的测量”完成第一次测试 | -| 想参与开发或自行构建 | 阅读[开发者指南](docs/development-and-packaging_cn.md),了解环境准备、源码运行与打包步骤 | -| 想开发插件 | 阅读 [OpenTest-Plugins](https://github.com/crysound/OpenTest-Plugins) 中的开发说明,以 FFT 插件为模板 | -| 想采购更多通道或 OEM 授权 | 联系 CRYSOUND | +**OpenTest CLI。** [`opentest-cli`](cli/README.md) 让 AI 智能体和脚本既能通过正在运行的桌面界面操作 OpenTest,也能直接调用 SDK,帮助工程师把测试经验和专业算法沉淀成可复用的模块。 -**运行环境**:Windows 10/11 x64;建议准备一支能被 Windows 识别的麦克风,用来完成第一次测量。 +## 版本与许可 ---- +| 版本 | 通道数 | 主要能力 | +| :-- | :-- | :-- | +| **Community 社区版** · 免费 | 4 | 实时监测与信号发生器,基础 FFT、倍频程和扫频 | +| **Professional 专业版** | 8 | 社区版全部能力,外加算法插件 | +| **Advanced 高级版** | 24 | 序列模式、分析模式、录制、导出与报告,可选应用 | +| **Enterprise 企业版** | 不限 | 全部功能与可选应用,API/SDK | + +月付、年付、永久授权以及完整功能对比见[定价页](https://www.opentest.com/zh-hans/%E5%AE%9A%E4%BB%B7/),版本划分以定价页为准。 + +本仓库源码采用 **[OpenTest Community License 1.0](LICENSE.zh-CN.md)**。简单来说:个人使用、教育、科研、软件与产品研发、企业内部使用(包括生产环境),以及用 OpenTest 为客户提供测试服务,都可以免费使用,每套系统最多 **4 个可同时使用的物理通道**。需要更多通道、随硬件或其他产品交付(OEM、ODM、白牌)、出售或再分发,或以收费托管服务形式提供时,需要商业许可。以上为摘要,以协议原文为准。 + +
+五分钟看懂核心概念 +
+ +| | | +| :-- | :-- | +| **工程** | 一次测试任务的“文件夹”,保存通道、测量项配置、测试序列和全部测试记录,可整体导出导入,方便交接 | +| **设备与通道** | 采集卡、声卡、USB 麦克风及其输入输出通道。加入工程的通道可设置灵敏度、单位和名称,也能用公式组合成数学通道 | +| **测量项** | 一种测量业务,例如 FFT、倍频程、扫频,以插件形式提供 | +| **测试记录** | 每次测量保存的结果和原始数据,可重新打开、对比、重新计算或导出,无需重新采集 | +| **测试序列** | 把多个步骤编排成可重复执行的流程,支持分支、循环、人工确认和自动判定 | +| **插件** | `.otplugin` 安装包;业务插件提供测量项,设备插件接入新硬件 | + +
## 常见问题 -**OpenTest 和专业测试仪器软件有什么不同?** -OpenTest 的源码开放、插件化,免费即可满足大多数研发和内部生产需求;需要更多通道或商业交付时再按需购买授权。 +**OpenTest 和仪器厂商的测试软件有什么不同?** OpenTest 源码开放、插件化,能接入多家厂商的硬件,免费版就能满足大多数研发和企业内部生产需求。只有需要更多通道、高级模块或商业交付时才需要付费。 + +**没有专业采集卡能用吗?** 可以。电脑声卡和 USB 麦克风通过 Windows 音频即可接入,但无法保证仪器级精度,正式测试请使用经过校准的测量硬件。 + +**卸载插件会丢数据吗?** 不会。数据和配置都会保留,重新启用兼容版本后即可再次查看该插件的结果。 + +**测试数据存在哪里?** 保存在本机的工程目录中,不会上传到云端。 -**没有专业采集卡能用吗?** -可以。电脑声卡、USB 麦克风通过 Windows 音频即可接入,适合学习和初步验证;但普通声卡无法保证仪器级精度,正式测量建议使用专业采集设备并完成校准。 +## 文档 -**卸载插件会丢数据吗?** -不会。数据和配置会保留,但卸载或禁用期间无法查看和导出该插件的结果,重新安装兼容版本后即可恢复。 +| | | +| :-- | :-- | +| **[使用手册](https://www.opentest.com/zh-hans/%E6%96%87%E6%A1%A3/)** | 安装配置、硬件、通道、测量项和序列 | +| **[开发者指南](docs/development-and-packaging_cn.md)** | 环境准备、源码开发与打包 | +| **[跨平台打包](docs/cross-platform-packaging_cn.md)** | Windows、macOS 和 Linux 安装包 | +| **[插件开发](docs/plugin-development_cn.md)** | 插件结构、接口与交付 | +| **[OpenTest CLI](cli/README.md)** | 用智能体和脚本操作 OpenTest | +| **[参与贡献](CONTRIBUTING.zh-CN.md)** | 分支、审核与发布流程 | -**测试数据存在哪里?** -保存在本机的工程目录中,不会上传到云端。工程可以整体导出,用于备份或交给同事。 +## 社区 ---- +使用问题请到 [Discussions](https://github.com/crysound/OpenTest/discussions) 提问,缺陷和功能建议请提交 [Issues](https://github.com/crysound/OpenTest/issues)。商业许可、OEM 合作或预约演示请联系 **info@crysound.com**,技术支持请联系 **support@crysound.com**。欢迎贡献代码,提交前请阅读[贡献指南](CONTRIBUTING.zh-CN.md)和许可协议中的贡献条款。安全问题请按[安全策略](SECURITY.zh-CN.md)报告。 -## 参与和反馈 +如果 OpenTest 对你有帮助,**点一个 ⭐ 能让更多工程师发现它。** -欢迎提交问题反馈、功能建议和代码贡献。贡献代码前请阅读许可协议中关于贡献的条款。 + + + + crysound/OpenTest 的 Star 增长曲线 + + ## 许可 -本仓库的 OpenTest 自有代码与组件采用 **OpenTest Community License 1.0**,详见[中文协议](LICENSE.zh-CN.md)与[英文协议](LICENSE.md),中英文不一致时以中文为准。第三方组件遵循各自的许可证。 +本仓库中 OpenTest 自有的代码与组件采用 **OpenTest Community License 1.0**([中文](LICENSE.zh-CN.md) · [English](LICENSE.md)),中英文不一致时以中文为准。第三方组件遵循各自的许可证。OpenTest 由杭州兆华电子(CRYSOUND,[crysound.com](https://www.crysound.com/))开发和维护。 diff --git a/docs/assets/brand/opentest-icon.png b/docs/assets/brand/opentest-icon.png new file mode 100644 index 00000000..f1ce28a2 Binary files /dev/null and b/docs/assets/brand/opentest-icon.png differ diff --git a/docs/assets/brand/opentest-social-preview.png b/docs/assets/brand/opentest-social-preview.png new file mode 100644 index 00000000..4f511d21 Binary files /dev/null and b/docs/assets/brand/opentest-social-preview.png differ diff --git a/docs/assets/brand/opentest-wordmark.png b/docs/assets/brand/opentest-wordmark.png new file mode 100644 index 00000000..058bfacc Binary files /dev/null and b/docs/assets/brand/opentest-wordmark.png differ diff --git a/docs/assets/readme/fft-measure-workspace.png b/docs/assets/readme/fft-measure-workspace.png new file mode 100644 index 00000000..3ca036dd Binary files /dev/null and b/docs/assets/readme/fft-measure-workspace.png differ diff --git a/docs/assets/readme/hardware-lineup.jpg b/docs/assets/readme/hardware-lineup.jpg new file mode 100644 index 00000000..2fde95a4 Binary files /dev/null and b/docs/assets/readme/hardware-lineup.jpg differ diff --git a/docs/assets/readme/mode-analysis.png b/docs/assets/readme/mode-analysis.png new file mode 100644 index 00000000..cc57d3a4 Binary files /dev/null and b/docs/assets/readme/mode-analysis.png differ diff --git a/docs/assets/readme/mode-measure.png b/docs/assets/readme/mode-measure.png new file mode 100644 index 00000000..22fd6156 Binary files /dev/null and b/docs/assets/readme/mode-measure.png differ diff --git a/docs/assets/readme/mode-sequence.png b/docs/assets/readme/mode-sequence.png new file mode 100644 index 00000000..7c0a8561 Binary files /dev/null and b/docs/assets/readme/mode-sequence.png differ diff --git a/docs/assets/readme/module-fft.png b/docs/assets/readme/module-fft.png new file mode 100644 index 00000000..dba269f4 Binary files /dev/null and b/docs/assets/readme/module-fft.png differ diff --git a/docs/assets/readme/module-octave.png b/docs/assets/readme/module-octave.png new file mode 100644 index 00000000..159dd35f Binary files /dev/null and b/docs/assets/readme/module-octave.png differ diff --git a/docs/assets/readme/module-sound-level-meter.png b/docs/assets/readme/module-sound-level-meter.png new file mode 100644 index 00000000..8e753713 Binary files /dev/null and b/docs/assets/readme/module-sound-level-meter.png differ diff --git a/docs/assets/readme/module-sound-power.png b/docs/assets/readme/module-sound-power.png new file mode 100644 index 00000000..c5c940a8 Binary files /dev/null and b/docs/assets/readme/module-sound-power.png differ diff --git a/docs/assets/readme/module-sound-quality.png b/docs/assets/readme/module-sound-quality.png new file mode 100644 index 00000000..9d8dd324 Binary files /dev/null and b/docs/assets/readme/module-sound-quality.png differ diff --git a/docs/assets/readme/module-sweep.png b/docs/assets/readme/module-sweep.png new file mode 100644 index 00000000..acbea1bf Binary files /dev/null and b/docs/assets/readme/module-sweep.png differ diff --git a/docs/assets/readme/report-module.png b/docs/assets/readme/report-module.png new file mode 100644 index 00000000..1d4ef2d2 Binary files /dev/null and b/docs/assets/readme/report-module.png differ