MS2130 grabber. Summary and firmware testing

[awawa-dev]

This topic is a kind of summary of information from the previous topic (#499), which has grown a lot over the past year and it is difficult to find what is most important.

Warning

The most serious problems with ms2130:

• different firmwares with different image quality
• frequent sudden decrease in brightness in the captured stream e.g. when switching HDMI sources
• problem with YUV limited used by e.g. NVidia Shield. Affects both SDR and HDR

It seems that we can remedy this and standardize it by uploading our experimental firmware (with a modified EDID) and at the same time solve the above problems of variable brightness and limited YUV mode.

1. I have & test probably the most popular versions of MS2130 grabbers. Model A is closed and will be rather difficult to open, if at all possible. Model B is barrel-shaped and resembles the older ms2109. Both models I received had the same firmware.
   

2. SDR and HDR quality is excellent, the latency is very low ~50ms depending on the capture settings.
   
   If we use eg. Ezcoo EZ-SP12H2 splitter, it is also possible to capture the Dolby Vision signal, or at least some versions of it. Contrary to the old MS2109, you don't need to modify contrast, brightness or saturation. Just leave it on defaults which means 0 for contrast/brightness/saturation/hue in HyperHDR grabber configuration. If there were other values set before, you need to restart Raspberry Pi/PC afterwards to apply new settings.

3. What you should definitely pay attention to?
   

   Unfortunately, subsequent versions of the firmware have introduced numerous changes, and not necessarily positive ones.
   You cannot use HyperHDR LUTs if you have newer firmware. You need to calibrate your grabber yourself.
   
   You can recognize the old firmware by the modes offered: when connected to USB2.0 → only MJPEG (and NV12 under Windows), USB3.0 → only YUV. It targets FCC coefs. New firmware offers some YUV modes for USB2.0 and MJPEG modes for USB3.0 but at a great price that is definitely not worth it. Also HyperHDR calibration log result will detect Rec.709 for new firmware. It is nothing wrong in Rec.709, as other USB grabbers also target it, but it was changed without notice and at the same time, as a result of other changes, the image quality including contrast and color gradient decreased.
   
   Since the new MS2130 firmware produces a much brighter image, the LED may not turn off in the event of a black image on the TV screen, even if you have disabled the "Minimum Backlight" option in HyperHDR in the processing tab.

4. If you have an older firmware version, you can install the LUT directly from HyperHDR v20
   
   
   
   

5. Is it possible to downgrade the firmware or upload another experimental version?

   In the case of the A and B models I have, this was possible. However, flashing the firmware is always associated with risk, and there is no guarantee that in subsequent revisions of these grabbers, manufacturers will introduce breaking changes that will cause firmware incompatibility: you do it at your own risk and we do not provide any warranty. Read more here: link

6. When using it with the Ezcoo splitter probably due to EDID causing the handshake problem, differences in brightness of the captured non-SDR image were observed. Solution:

   • make sure you turn on the devices using always the same sequence (tv/rpi/splitter/grabber the order is only for example)
   • disconnect and reconnect Ezcoo's USB power supply
   • if you want you can try the experimental firmware which seems to solve this problem (contact me @ email)

7. What about limited YUV modes used e.g. by NVidia Shield?

   You may experience high brightness levels in captured very dark scenes and reduced maximum brightness in captured very bright scenes. Unfortunately the only known way to fix it is to update the ms2130 firmware.

[awawa-dev]

MS2109 & MS2130 Dolby Vision testing. MS2130 brightness issue detected when using Ezcoo splitter.

I finally managed to configure Amazon Firestick 4k so that Nova player can open files via SMB on the network to test Dolby Vision. Tested on promotional materials and trailers provided by @AstaRom (thanks!). I made sure that my LG TV actually recognizes that the signal is Dolby Vision:

Maybe I'll start from the end because it's the most important:
After completing the ms2109 tests and uploading the new LUT, I connected the ms2130 (model A, old firmware) and the image suddenly became much darker. HDR tone mapping was turned off, but it didn't matter because even with tone mapping enabled the image could be too dark. I stopped the USB grabber in the remote tab, connected the MS2130 B model (experimental firmware with custom EDID based on MS2109), turned on the USB grabber in the remote and the image suddenly became brighter again. I repeated this several times, each time the ms2130A captured a much darker image, as several users had previously described. Switched back whole HyperHDR setup to MS2109 and the image was also fine, just like MS2130B with custom firmware.

Switched back to MS2130A: the image is again too dark, power off&on Ezcoo USB power supply and suddenly the image is fine even for MS2130A. The difference in brightness captured in the screenshot:

Below are the test results for Dolby Vision promotional materials using the MS2109 and MS2130, each time with tone mapping turned off and on. Amazon FireStick 4k is connected to Ezcoo EZ-SP12H2 splitter, TV LG C9 is connected to Ezcoo HDMI1, USB grabber is connected to Ezcoo HDMI2, Ezcoo scaller is disabled for HDMI1 and enabled for HDMI2, Ezcoo EDID copy mode is selected.

MS2109:

MS2130B

Not every HDMI splitter will provide correct Dolby Vision capture.

If you count on DV support with MS2130, you should probably avoid Feintach, because this is the image I received in the same setup after replacing Ezcoo EZ-SP12H2 with Feintech VSP01201 (also EDID copy).

[amigthea]

• Dolby Vision content on Amazon FireStick 4k max
• Firestick to HDMI-in (Ezcoo EZ-SP12H2)
• TV LG connected to HDMI-out 1 (Ezcoo EZ-SP12H2)
• MS2130 connected to HDMI-out 2 (Ezcoo EZ-SP12H2)
• The Ezcoo scaler is disabled for HDMI-out 1
• The Ezcoo scaler is enabled for HDMI-out 2
• Ezcoo EDID copy mode is selected.

this is the setup I'm gonna test later today as soon as the splitter arrives. I had the Feintech VSP01201 and can confirm the purpleish tint overlay so I returned it. Why did you replace the ezcoo?

Also, ezcoo amazon page state that:

When output 4K HDR Dolby Vision pls TURN OFF scaler. NOT down-scale HDR Dolby Vision

but in your test it worked out right?

[awawa-dev]

The Dolby Vision LLDV protocol does not appear to be subject to such limitations as it is very similar to HDR. I have both Ezcoo and Feintech, but Feintech cant enforce LLDV on the source (and no grabber can capture other DV protocols correctly => pink image or no image).

[awawa-dev]

Comparing old & new firmware results (SDR)

In order not to be biased, we will test what the result looks like for each firmware when we capture an SDR image not using HyperHDR but the standard Windows Camera application.

For each color, a section from the left: the oldest firmware, 4k2 firmware (from the article on zhihu.com), the latest MS2130 firmware.
Judge for yourself, but the last two firmware are very similar or identical, much brighter, and something strange/wrong happened to the captured text.

[awawa-dev]

How to flash MS2130 firmware

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Firmware

Unofficial experimental firmware for ms2130 grabber. Use it on your own risk. Provided without warranty of any kind.
Extract it before use.

Version F3 (2024/1/16)
Changelog:

• fixed issue with very dark captured video
• fixed issue when video source uses limited YUV color space
• add missing modes e.g. 1080p24, 1080p120... reported to the display
• ms2130 now reports HDR support
• ms2130 now reports LLDV support

Download: link to F3 ms2130 firmware
CRC32: 61DA8DD7

Windows

Windows flasher can be found in many places. Remember that you must first check it with an antivirus program or use Linux and the opensource ms-tools flasher instead.

#499 (reply in thread)
BertoldVdb/ms-tools#11
https://twitter.com/aaaarrrriaaannn/status/1679125963487969282

Example CRC32 (does not mean it is correct!): D919F9DB

Remember to make a backup first.
Manual (Chinese): https://zhuanlan.zhihu.com/p/634052876

Linux

Requires usage of https://github.com/BertoldVdb/ms-tools
First you must install some packages:
sudo apt install git libhidapi-dev libudev-dev

Use our prebuild cli binary or build it yourself

Download prebuilt cli and extract it to /tmp/ms2130: cli_aarch64.zip

Or build cli yourself (recommended). You need go package installed:

https://go.dev/doc/install

For RPi AARCH64 the package is named: go1.21.6.linux-arm64.tar.gz and I assume this in the example below. If you are using different platform or version, it needs to be adjusted. The download link can be found on the mentioned go.dev website.

Install go first:

cd /tmp
wget https://go.dev/dl/go1.21.6.linux-arm64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf ./go1.21.6.linux-arm64.tar.gz
export PATH=$PATH:/usr/local/go/bin
go version

Build cli

cd /tmp && mkdir ms2130 && cd ms2130
git clone https://github.com/BertoldVdb/ms-tools.git tools
cd tools 
go build -o /tmp/ms2130 ./cli
cd ..
./cli

Backup & upload new firmware

Make backup of your ms2130 firmware (wait few minutes till it finishes):
sudo ./cli --log-level=7 read FLASH 0 --filename=/tmp/ms2130/my_backup.bin

Copy the backup (/tmp/ms2130/my_backup.bin) into safe place.
Put new firmware into /tmp/ms2130 directory for example: /tmp/ms2130/backup.bin

Write new ms2130 firmware (wait few minutes till it finishes):
sudo ./cli --log-level=7 write-file --verify FLASH 0 /tmp/ms2130/backup.bin

[awawa-dev]

reserved

[awawa-dev]

reserved