Difference between revisions of "APPA Multimeters"
(Features-Section added) |
|||
| (10 intermediate revisions by one other user not shown) | |||
| Line 7: | Line 7: | ||
}} | }} | ||
Hand multimeters, bench versameters | Hand multimeters, bench versameters, current clamps and lcr meters with optical serial (USB) and BLE interface supported by the "'''appa-dmm'''" driver. | ||
The driver supporting these APPA-based devices ("appa-dmm" in sigrok) has been created and will be included in mainline sigrok once it passes acception (see developement repository [https://github.com/Cymaphore/libsigrok github.com/Cymaphore/libsigrok branch appa-dmm]). | The driver supporting these APPA-based devices ("appa-dmm" in sigrok) has been created and will be included in mainline sigrok once it passes acception (see developement repository [https://github.com/Cymaphore/libsigrok github.com/Cymaphore/libsigrok branch appa-dmm]). | ||
| Line 20: | Line 20: | ||
! Bluetooth LE | ! Bluetooth LE | ||
! Comments | ! Comments | ||
|- | |||
| [[APPA 100 Series]] | |||
| Handheld Multimeter | |||
| X | |||
| | |||
| experimental | |||
|- | |- | ||
| Line 36: | Line 43: | ||
|- | |- | ||
| [[ | | [[APPA 200 Series]] | ||
| Bench Multimeter | | Bench Multimeter | ||
| X | | X | ||
| X* | | X* | ||
| | | | ||
|- | |||
| [[APPA 300 Series]] | |||
| Handheld Multimeter | |||
| X | |||
| | |||
| experimental | |||
|- | |- | ||
| Line 48: | Line 62: | ||
| X* | | X* | ||
| | | | ||
|- | |||
| [[APPA 700 Series]] | |||
| Handheld LCR Meters | |||
| X | |||
| | |||
| maybe limited support, unknown | |||
|- | |- | ||
| Line 77: | Line 98: | ||
== Device detection and identification == | == Device detection and identification == | ||
The driver automatically detects the device and | The driver automatically detects the device and its capabilities on connection. If a specific feature, for example data logging, is not supported by a specific device, it is for compatibility reasons visible in the driver but will return an empty result. Data acquisition can happen continuous or limited by time, sample count or frame count. | ||
If the model supports it, vendor and model information as well as the serial number are read from the device and can be accessed in sigrok. | If the model supports it, vendor and model information as well as the serial number are read from the device and can be accessed in sigrok. In case this fails, sigrok will report the device under its OEM designation. | ||
== Data sources == | == Data sources == | ||
| Line 95: | Line 116: | ||
=== MEM (hold / auto-hold memory) === | === MEM (hold / auto-hold memory) === | ||
Some | Some of the models have an internal memory for single display readings based on auto hold or manual save features. These are individual records not related to each other without any sample rate. This data can be acquired / downloaded from the device using sigrok. | ||
The primary channel holds the reading, the secondary channel holds the ID of the record as stored in the device. The data can be exported as CSV-File using sigrok-cli. | The primary channel holds the reading, the secondary channel holds the ID of the record as stored in the device. The data can be exported as CSV-File using sigrok-cli. | ||
| Line 101: | Line 122: | ||
=== LOG (data logging memory) === | === LOG (data logging memory) === | ||
Many | Many of the models have an internal memory to perform standalone data logging at a configurable sample rate. This data can be acquired / downloaded from the device using sigrok. | ||
The primary channel holds the reading, the secondary channel holds the ID of the record as stored in the device. The sample interval is obtained from the device, but it depends upon the sigrok-client to actually interpret it. The data can be exported as CSV-File using sigrok-cli. | The primary channel holds the reading, the secondary channel holds the ID of the record as stored in the device. The sample interval is obtained from the device, but it depends upon the sigrok-client to actually interpret it. The data can be exported as CSV-File using sigrok-cli. | ||
Latest revision as of 12:59, 30 September 2024
| Status | in progress |
|---|---|
| Source code | appa-dmm |
| Connectivity | Infrared (USB), Bluetooth LE |
| Website | appatech.com |
Hand multimeters, bench versameters, current clamps and lcr meters with optical serial (USB) and BLE interface supported by the "appa-dmm" driver.
The driver supporting these APPA-based devices ("appa-dmm" in sigrok) has been created and will be included in mainline sigrok once it passes acception (see developement repository github.com/Cymaphore/libsigrok branch appa-dmm).
Supported Series
| Series | Type | Optical RS232/USB | Bluetooth LE | Comments |
|---|---|---|---|---|
| APPA 100 Series | Handheld Multimeter | X | experimental | |
| APPA 150B Series | Clamp Multimeter | X | ||
| APPA 170 Series | Clamp Multimeter | X | ||
| APPA 200 Series | Bench Multimeter | X | X* | |
| APPA 300 Series | Handheld Multimeter | X | experimental | |
| APPA 500 Series | Handheld Multimeter | X | X* | |
| APPA 700 Series | Handheld LCR Meters | X | maybe limited support, unknown | |
| APPA A Series | Clamp Multimeter | X | ||
| APPA S Series | Handheld Multimeter | X | ||
| APPA sFlex Series | Clamp Multimeter | X |
Note: * BLE-Support on individual models
Features
Device detection and identification
The driver automatically detects the device and its capabilities on connection. If a specific feature, for example data logging, is not supported by a specific device, it is for compatibility reasons visible in the driver but will return an empty result. Data acquisition can happen continuous or limited by time, sample count or frame count.
If the model supports it, vendor and model information as well as the serial number are read from the device and can be accessed in sigrok. In case this fails, sigrok will report the device under its OEM designation.
Data sources
Live (display readings)
This data source provides the display readings of a device. If a reading is currently unavailable or disabled, inf or OL are reported. This is also the case for the Secondary Display for devices that don't have this feature.
Live readings usually contain all the information available via the APPA protocol that can be mapped to corresponding sigrok-values. If a meaning can not be mapped, it is ignored. Display text is decoded and will result in a warning-message containing the text. Menu operations are decoded as well and will also result in warning-messages. The driver is prepared to incorporate these message into sigrok-readings, in case sigrok ever supports this.
Error messages from the device (Probe-Errors, Fuse-Errors, etc.) are reported using error messages.
The sample rate of the readings depends on the connectivity used. By default, data as acquired from the device at 10 Hz and the polling is aligned with the clock of the host machine. If the connection method (for example BLE on some devices) doesn't permit that rate, it is lowered and the polling timer will not be aligned with the host to still allow the highest possible data rate. The actual sample rate of the acquired readings depends on the capabilities of the device and the function in question.
MEM (hold / auto-hold memory)
Some of the models have an internal memory for single display readings based on auto hold or manual save features. These are individual records not related to each other without any sample rate. This data can be acquired / downloaded from the device using sigrok.
The primary channel holds the reading, the secondary channel holds the ID of the record as stored in the device. The data can be exported as CSV-File using sigrok-cli.
LOG (data logging memory)
Many of the models have an internal memory to perform standalone data logging at a configurable sample rate. This data can be acquired / downloaded from the device using sigrok.
The primary channel holds the reading, the secondary channel holds the ID of the record as stored in the device. The sample interval is obtained from the device, but it depends upon the sigrok-client to actually interpret it. The data can be exported as CSV-File using sigrok-cli.
Connectivity
- Optical serial (USB cable, for example IC-300U)
- Optical serial (RS232 cable, for example IC-300)
- Bluetooth LE
The available connection method depends on the individual model.
Examples: Establish data connection between sigrok and MM 12 (APPA 506B)
Important: Driver is not (yet) part of mainline sigrok - see this repository in github if you want to use it already.
Serial/USB
Assuming the meter is turned on, plugged in and the usb-serial driver is loadad and up (should happen automatically). /dev/ttyUSB0 is used as an example.
List devices, if unsure what the serial port is:
# sigrok-cli --list-serial /dev/ttyUSB0 CP2102 USB to UART Bridge Controller - 2020y000231
Scan for MM 12 with USB/Serial connection:
$ sigrok-cli -d benning-dmm:conn=/dev/ttyUSB0 --scan
Show readings from connected meter:
$ sigrok-cli -d benning-dmm:conn=/dev/ttyUSB0 --continuous
Open in SmuView:
$ smuview --driver benning-dmm:conn=/dev/ttyUSB0
Bluetooth LE
Assuming the meter is turned on and bluetooth activated on the meter and the PC. Important: Your Bluetooth-Controller must support BLE.
Scan for BLE devices:
# sudo sigrok-cli --list-serial bt/appa-dmm/18-7A-93-BF-47-62 BENNING MM12 (BLE)
If your OS / UI supports it, you can also use the Bluetooth scanning capability from the system tray and pick the MAC address from the details there.
"18:7A:93:BF:47:62" acts as an example for the device address you will find. For sigrok the ":" must be replaced by "-" for now. That device address is used for the following examples, just replace it by the address of your own meter.
The full connection string then would look like this, as seen in the scanning result: bt/appa-dmm/18-7A-93-BF-47-62
Scan for MM 12 with BLE connection:
$ sigrok-cli -d benning-dmm:conn=bt/appa-dmm/18-7A-93-BF-47-62 --scan
Show readings from connected meter:
$ sigrok-cli -d benning-dmm:conn=bt/appa-dmm/18-7A-93-BF-47-62 --continuous
Open in SmuView:
$ smuview --driver benning-dmm:conn=bt/appa-dmm/18-7A-93-BF-47-62