Difference between revisions of "ETommens eTM-xxxxP Series"
m (→Resources) |
|||
(7 intermediate revisions by 2 users not shown) | |||
Line 2: | Line 2: | ||
| image = [[File:Sigrok_logo_no_text_transparent_512.png|180px]] | | image = [[File:Sigrok_logo_no_text_transparent_512.png|180px]] | ||
| name = eTommens eTM-xxxxP | | name = eTommens eTM-xxxxP | ||
| status = | | status = in progress | ||
| source_code_dir = etommens-etm-xxxxp | | source_code_dir = etommens-etm-xxxxp | ||
| channels = 1 | | channels = 1 | ||
Line 16: | Line 16: | ||
The '''eTommens eTM-xxxxP''' series are 1 channel switch-mode programmable DC power supplies with both USB/serial and RS232 connectivity. | The '''eTommens eTM-xxxxP''' series are 1 channel switch-mode programmable DC power supplies with both USB/serial and RS232 connectivity. | ||
The devices are also sold as rebranded versions by e.g. Hanmatek and Rockseed. | The devices are also sold as rebranded versions by e.g. [[Hanmatek_HM305P|Hanmatek]] and Rockseed. | ||
== Devices == | == Devices == | ||
Line 27: | Line 27: | ||
!Current range | !Current range | ||
!Power | !Power | ||
!Resolution | |||
!Port Class, Model | !Port Class, Model | ||
Line 35: | Line 36: | ||
| style="text-align:center" | 0-5 A | | style="text-align:center" | 0-5 A | ||
| 150 W | | 150 W | ||
| 10mv | |||
| 0x4B50, 305 | | 0x4B50, 305 | ||
Line 40: | Line 42: | ||
|- | |- | ||
| [http://www.etommens.com/products-258560-258566-0.html#bodycontent eTommens eTM3010P] | | [http://www.etommens.com/products-258560-258566-0.html#bodycontent eTommens eTM3010P] | ||
| Hanmatek HM310P, | | Hanmatek HM310P, [[RockSeed RS310P]] | ||
| style="text-align:center" | 0-30 V | | style="text-align:center" | 0-30 V | ||
| style="text-align:center" | 0-10 A | | style="text-align:center" | 0-10 A | ||
| 300 W | | 300 W | ||
| 10mv | |||
| 0x4B50, 3010 | | 0x4B50, 3010 | ||
Line 52: | Line 55: | ||
| style="text-align:center" | 0-3 A | | style="text-align:center" | 0-3 A | ||
| 300 W | | 300 W | ||
| 10mv | |||
| — | | — | ||
Line 60: | Line 64: | ||
| style="text-align:center" | 0-20 A | | style="text-align:center" | 0-20 A | ||
| 300 W | | 300 W | ||
| 10mv | |||
| — | | — | ||
Line 68: | Line 73: | ||
| style="text-align:center" | 0-5 A | | style="text-align:center" | 0-5 A | ||
| 300 W | | 300 W | ||
| 10mv | |||
| — | | — | ||
Line 76: | Line 82: | ||
| style="text-align:center" | 0-2 A | | style="text-align:center" | 0-2 A | ||
| 300 W | | 300 W | ||
| 10mv | |||
| — | | — | ||
Line 85: | Line 92: | ||
== Protocol == | == Protocol == | ||
Modbus RTU only function codes 0x03 and 0x06 are supported (according to the pdf that came with the device).([https://en.wikipedia.org/wiki/Modbus#Frame_formats Wikipedia]). Baudrate defaults to 9600, 1 start bit, 8 data bits, no checkbits and 1 stop bit. Registers are 16bits, bigendian. | |||
{| border="0" style="width: 30em;" class="alternategrey sigroktable" | |||
|- | |||
! style="width: 10em; text-align: left;" | Name | |||
! style="width: 5em; text-align: left;" | Register Address | |||
! style="width: 4em; text-align: left;" | Access | |||
|- | |||
| Output State | |||
| 0x0001 | |||
| RW | |||
|- | |||
| Protection State | |||
| 0x0002 | |||
| R | |||
|- | |||
| Model ID | |||
| 0x0004 | |||
| R | |||
|- | |||
| Output Voltage | |||
| 0x0010 | |||
| R | |||
|- | |||
| Output Current | |||
| 0x0011 | |||
| R | |||
|- | |||
| Output Power high bits | |||
| 0x0012 | |||
| R | |||
|- | |||
| Output Power low bits | |||
| 0x0013 | |||
| R | |||
|- | |||
| Voltage Target | |||
| 0x0030 | |||
| RW | |||
|- | |||
| Current Limit | |||
| 0x0031 | |||
| RW | |||
|- | |||
| OVP Value | |||
| 0x0020 | |||
| RW | |||
|- | |||
| OCP Value | |||
| 0x0021 | |||
| RW | |||
|- | |||
| OPP Value high bits | |||
| 0x0022 | |||
| RW | |||
|- | |||
| OPP Value low bits | |||
| 0x0023 | |||
| RW | |||
|- | |||
| Decimals | |||
| 0x0005 | |||
| R | |||
|} | |||
1. There is actually no OPP button on the power supply, but the protocol documentation lists, the address for it. Not relevant at the moment for a driver, since sigrok seems to have no OPP support anyway. | |||
2. In the protocol documentation there is no mention of how to set the presets M1 to M6. But it seems they start at address 0x1000. This needs to be researched still, but I currently do not know how to handle presets in sigrok, so I need to find that out too. | |||
Also there is some other addresses listed in config files that are with the software provided, these need to be researched too. | |||
3. The Protection State registers contains looks as follow and the designated bit goes high if the protection state is active: | |||
{| border="0" style="width: 30em;" class="alternategrey sigroktable" | |||
|- | |||
! style="width: 5em; text-align: left;" | Bit | |||
! style="width: 6em; text-align: left;" | Designation | |||
! style="width: 19em; text-align: left;" | Description | |||
|- | |||
| 0 | |||
| OVP | |||
| Over Voltage Protection | |||
|- | |||
| 1 | |||
| OCP | |||
| Over Current Protection | |||
|- | |||
| 2 | |||
| OPP | |||
| Over Power Protection | |||
|- | |||
| 3 | |||
| OTP | |||
| Over Temperature Protection | |||
|- | |||
| 4 | |||
| SCP | |||
| Short Circuit Protection | |||
|- | |||
| 5 | |||
| | |||
| | |||
|- | |||
| 6 | |||
| | |||
| | |||
|- | |||
| 7 | |||
| | |||
| | |||
|- | |||
| 8 | |||
| | |||
| | |||
|} | |||
the 2nd byte does not give any information, and seems to always be 0. | |||
4. The decimals registers contains the the decimal information for Voltage, Current and Power. The lower 12 bits are used with 4bits for each value. If the register content is 0x0321, it means Voltage has 3 decimals, Current 2 and Power 1. | |||
Researched Registers: | |||
{| border="0" style="width: 100em;" class="alternategrey sigroktable" | |||
|- | |||
! style="width: 10em; text-align: left;" | Name | |||
! style="width: 5em; text-align: left;" | Register Address | |||
! style="width: 5em; text-align: left;" | Access | |||
! style="width: 80em; text-align: left;" | Notes | |||
|- | |||
| Voltage upper Limit (UH) | |||
| 0xC11E | |||
| R | |||
| 4 bytes long, contains high voltage limit (like the limit you get when turning the knob on the device), did not even try to write to it, values are same as current in format so divide int value by 10^digits | |||
|- | |||
| Current upper Limit (IH) | |||
| 0xC12E | |||
| R | |||
| 4 bytes long, contains high current limit (like the limit you get when turning the knob on the device), did not even try to write to it, values are same as current in format so divide int value by 10^digits | |||
|- | |||
| Voltage lower Limit? (UL) | |||
| 0xC110 | |||
| R | |||
| 4 bytes long, not sure what this is, it contains the value 10. But my supply outputs at 1 already. | |||
|- | |||
| Current lower Limit? (IL) | |||
| 0xC120 | |||
| R | |||
| 4 bytes long, not sure what this is, it contains the value 21. And my power supply actually only starts outputting when set to 21mA or above. | |||
|- | |||
| Buzzer | |||
| 0x8804 | |||
| RW | |||
| 2 bytes long, you can enable (write 0x0001) or disable (write 0x0000) the buzzer. It beeps on every single click (and on startup ) so probably no one wants to enable this ever. | |||
|- | |||
| defaultshow | |||
| 0x8802 | |||
| ? | |||
| 2 bytes long, no idea what it is about | |||
|- | |||
| powerstat | |||
| 0x8801 | |||
| ? | |||
| 2 bytes long, no idea what it is about | |||
|- | |||
| scp | |||
| 0x8803 | |||
| R | |||
| 2 bytes long, no idea what it is about, i can't write to it, maybe my model just has no scp support? | |||
|- | |||
| sdtime | |||
| 0xCCCC | |||
| ? | |||
| 2 bytes long, no idea what it is about | |||
|- | |||
| settimespan | |||
| 0x0032 | |||
| ? | |||
| 2 bytes long, timespan till it auto disables output, but only if you use the preset list function. Don't see how this is useful for anything since the value only matters per preset. | |||
|- | |||
| preset voltage | |||
| 0x1000+(0 to 5)*10 | |||
| RW | |||
| 2 bytes long, registers for presets M1 to M6 | |||
|- | |||
| preset current | |||
| 0x1001+(0 to 5)*10 | |||
| RW | |||
| 2 bytes long, registers for presets M1 to M6 | |||
|- | |||
| preset timespan | |||
| 0x1002+(0 to 5)*10 | |||
| RW | |||
| 2 bytes long, registers for presets M1 to M6, max value 9999 (this is seconds, so max is about 2,78h) | |||
|- | |||
| preset enabled (included in list) | |||
| 0x1003+(0 to 5)*10 | |||
| RW | |||
| 2 bytes long, registers for presets M1 to M6 | |||
|} | |||
== Resources == | == Resources == | ||
* [https://www.eevblog.com/forum/testgear/power-supply-ripe-for-the-picking/ EEVblog forum thread] | * [https://www.eevblog.com/forum/testgear/power-supply-ripe-for-the-picking/ EEVblog forum thread] | ||
* [https://github.com/markrages/py_test_interface GitHub - Python control script] | * [https://github.com/markrages/py_test_interface GitHub - Basic Python control script] | ||
* [https://github.com/JackDoan/hm305_ctrl GitHub - Python control script with proper CLI, SCPI support and more] | |||
* [https://github.com/hobbyquaker/hanmatek-hm310p GitHub - Electron based application, offers Charts and CSV Export] | * [https://github.com/hobbyquaker/hanmatek-hm310p GitHub - Electron based application, offers Charts and CSV Export] |
Latest revision as of 16:23, 6 June 2021
Status | in progress |
---|---|
Source code | etommens-etm-xxxxp |
Channels | 1 |
Voltage/current (CH1) | various |
Connectivity | USB/serial, RS232 |
Features | programmable presets, over voltage protection, over current protection, output on/off |
Website | etommens.com |
The eTommens eTM-xxxxP series are 1 channel switch-mode programmable DC power supplies with both USB/serial and RS232 connectivity.
The devices are also sold as rebranded versions by e.g. Hanmatek and Rockseed.
Devices
Device | OEM/Rebranded | Voltage range | Current range | Power | Resolution | Port Class, Model |
---|---|---|---|---|---|---|
eTommens eTM305P | Hanmatek HM305P, Rockseed RS305P | 0-30 V | 0-5 A | 150 W | 10mv | 0x4B50, 305
|
eTommens eTM3010P | Hanmatek HM310P, RockSeed RS310P | 0-30 V | 0-10 A | 300 W | 10mv | 0x4B50, 3010 |
eTommens eTM1003P | — | 0-100 V | 0-3 A | 300 W | 10mv | — |
eTommens eTM1520P | — | 0-15 V | 0-20 A | 300 W | 10mv | — |
eTommens eTM605P | Rockseed RS605P | 0-60 V | 0-5 A | 300 W | 10mv | — |
eTommens eTM1502P | — | 0-150 V | 0-2 A | 300 W | 10mv | — |
Note: libsigrok support for these devices is pending the merge of this PR - https://github.com/sigrokproject/libsigrok/pull/100
Note: The libsigrok driver needs to know about the device's class and model, retrievable with hm305.py please let us know.
Protocol
Modbus RTU only function codes 0x03 and 0x06 are supported (according to the pdf that came with the device).(Wikipedia). Baudrate defaults to 9600, 1 start bit, 8 data bits, no checkbits and 1 stop bit. Registers are 16bits, bigendian.
Name | Register Address | Access |
---|---|---|
Output State | 0x0001 | RW |
Protection State | 0x0002 | R |
Model ID | 0x0004 | R |
Output Voltage | 0x0010 | R |
Output Current | 0x0011 | R |
Output Power high bits | 0x0012 | R |
Output Power low bits | 0x0013 | R |
Voltage Target | 0x0030 | RW |
Current Limit | 0x0031 | RW |
OVP Value | 0x0020 | RW |
OCP Value | 0x0021 | RW |
OPP Value high bits | 0x0022 | RW |
OPP Value low bits | 0x0023 | RW |
Decimals | 0x0005 | R |
1. There is actually no OPP button on the power supply, but the protocol documentation lists, the address for it. Not relevant at the moment for a driver, since sigrok seems to have no OPP support anyway. 2. In the protocol documentation there is no mention of how to set the presets M1 to M6. But it seems they start at address 0x1000. This needs to be researched still, but I currently do not know how to handle presets in sigrok, so I need to find that out too. Also there is some other addresses listed in config files that are with the software provided, these need to be researched too.
3. The Protection State registers contains looks as follow and the designated bit goes high if the protection state is active:
Bit | Designation | Description |
---|---|---|
0 | OVP | Over Voltage Protection |
1 | OCP | Over Current Protection |
2 | OPP | Over Power Protection |
3 | OTP | Over Temperature Protection |
4 | SCP | Short Circuit Protection |
5 | ||
6 | ||
7 | ||
8 |
the 2nd byte does not give any information, and seems to always be 0.
4. The decimals registers contains the the decimal information for Voltage, Current and Power. The lower 12 bits are used with 4bits for each value. If the register content is 0x0321, it means Voltage has 3 decimals, Current 2 and Power 1.
Researched Registers:
Name | Register Address | Access | Notes |
---|---|---|---|
Voltage upper Limit (UH) | 0xC11E | R | 4 bytes long, contains high voltage limit (like the limit you get when turning the knob on the device), did not even try to write to it, values are same as current in format so divide int value by 10^digits |
Current upper Limit (IH) | 0xC12E | R | 4 bytes long, contains high current limit (like the limit you get when turning the knob on the device), did not even try to write to it, values are same as current in format so divide int value by 10^digits |
Voltage lower Limit? (UL) | 0xC110 | R | 4 bytes long, not sure what this is, it contains the value 10. But my supply outputs at 1 already. |
Current lower Limit? (IL) | 0xC120 | R | 4 bytes long, not sure what this is, it contains the value 21. And my power supply actually only starts outputting when set to 21mA or above. |
Buzzer | 0x8804 | RW | 2 bytes long, you can enable (write 0x0001) or disable (write 0x0000) the buzzer. It beeps on every single click (and on startup ) so probably no one wants to enable this ever. |
defaultshow | 0x8802 | ? | 2 bytes long, no idea what it is about |
powerstat | 0x8801 | ? | 2 bytes long, no idea what it is about |
scp | 0x8803 | R | 2 bytes long, no idea what it is about, i can't write to it, maybe my model just has no scp support? |
sdtime | 0xCCCC | ? | 2 bytes long, no idea what it is about |
settimespan | 0x0032 | ? | 2 bytes long, timespan till it auto disables output, but only if you use the preset list function. Don't see how this is useful for anything since the value only matters per preset. |
preset voltage | 0x1000+(0 to 5)*10 | RW | 2 bytes long, registers for presets M1 to M6 |
preset current | 0x1001+(0 to 5)*10 | RW | 2 bytes long, registers for presets M1 to M6 |
preset timespan | 0x1002+(0 to 5)*10 | RW | 2 bytes long, registers for presets M1 to M6, max value 9999 (this is seconds, so max is about 2,78h) |
preset enabled (included in list) | 0x1003+(0 to 5)*10 | RW | 2 bytes long, registers for presets M1 to M6 |