Status Monitor Overlay Switch

Status Monitor Overlay
File:Statusmonitoroverlayswitch.png
General
Author	masagrator
Type	System Tools
Version	0.8.2
License	GPL-2.0
Last Updated	2023/04/01
Links
Download
Website
Source

The Status Monitor Overlay is a homebrew application designed for the Nintendo Switch that enables you to monitor your hardware in real-time. To utilize this feature, it is necessary to have the Tesla environment installed.

With six different modes to choose from, each explained in detail, you can easily switch between them. If you wish to exit a particular mode, press and hold both the Left Stick and Right Stick buttons simultaneously. Pressing B will return you to the main menu.

Please note that if you encounter any issues when using the dock, it is recommended that you first start the Status Monitor and then place your Nintendo Switch in the dock for optimal performance.

Features

• CPU Usage for each core (Cores #0-#2 are used by apps/games, Core #3 is used by OS, background processes and also Tesla overlays)
• GPU Load
• CPU, GPU & RAM actual frequency
• Used RAM categorized to: (not supported by FWs <5.0.0)
  • Total
  • Application
  • Applet
  • System
  • System Unsafe
• SoC, PCB & Skin temperatures (Skin temperature not supported by FWs <5.0.0)
• Fan Rotation Level
• PFPS and FPS (with help of NX-FPS 0.4+, more info in repo. Not installing it results in not showing FPS counters on overlay)
• Battery temperature, raw charge, age, and average voltage
• Charger type, max voltage, and max current
• DSP usage
• NVDEC clock rate
• Network type + Wi-fi password

Requirements

• From 0.4.1 you need Tesla Menu >=1.0.2.

Modes

Status Monitor Overlay from 0.8 release contains six modes to choose from Main Menu.

Full

This mode you can know from older releases of Status Monitor. It contains all informations properly described and supported with high precision.

Category	Format	Explanation
CPU Usage	Frequency: %.1f Core #0: %.2f Core #1: %.2f Core #2: %.2f Core #3: %.2f	Clockrate of all CPU cores in MHz Load of CPU Core #0 calculated from IdleTickCount to percent value Load of CPU Core #1 calculated from IdleTickCount to percent value Load of CPU Core #2 calculated from IdleTickCount to percent value Load of CPU Core #3 calculated from IdleTickCount to percent value
GPU Usage	Frequency: %.1f Load: %.1f	Clockrate of GPU in MHz GPU Load provided by PMU in percent
RAM Usage	Frequency: %.1f %s: %.2f/%.2f	Clockrate of EMC in MHz %s memory used/%s memory available in MB (not working with FW <5.0.0)
Thermal	SoC: %.2f (FW 14.0.0+: %2d) PCB: %.2f (FW 14.0.0+: %2d) Skin: %.2f Fan: %.2f	SoC temperature in Celsius degrees PCB temperature in Celsius degrees Skin temperature in Celsius degrees' Fan rotation level in percent

'Explanation provided at the end of file

Optional (shows only when NX-FPS plugin is installed)

Category	Format	Explanation
PFPS	%u	Pushed Frames Per Second - how many frames were displayed in last second
FPS	%.2f	Frames Per Second - value calculated by averaging frametime

Works only in 1 and 5 Hz + vsync signal. You can change that with ZR + R + D-Pad Up/Down

Mini

Contains most of supported informations with lower precision.

Category	Format	Explanation
CPU	[%.0f,%.0f,%.0f,%.0f]@%.1f	Core #0 usage, Core #1 usage, Core #2 usage, Core #3 usage@CPU frequency
GPU	%.1f@%.1f	Load@GPU Frequency
RAM	%.0f/%.0f@%.1f	Total RAM used/Total RAM available@EMC frequency
TEMP	%2.1f/%2.1f/%2.1f (FW 14.0.0+: %2d/%2d/%2.1f)	SoC temperature/PCB temperature/Skin temperature'
FAN	%2.2f	Fan rotation level

'Explanation provided at the end of file

Optional (shows only when NX-FPS plugin is installed)

Category	Format	Explanation
PFPS	%u	Pushed Frames Per Second
FPS	%.2f	Frames Per Second

Works only in 1 or 5 Hz + vsync signal. You can change that with ZR + R + D-Pad Up/Down

Micro

Contains most of supported information with lower precision in one line.

It shows only if you didn't change filename of overlay file (So it should be "Status-Monitor-Overlay.ovl"). This is because we need to reload overlay to change framebuffer dimensions without taking more RAM, and Tesla Menu (and libtesla with it) doesn't provide info about filename of overlay that was loaded.

Category	Format	Explanation
CPU	[%.0f,%.0f,%.0f,%.0f]@%.1f	Core #0 usage, Core #1 usage, Core #2 usage, Core #3 usage@CPU frequency
GPU	%.1f@%.1f	Load@GPU Frequency
RAM	%.0f/%.0f@%.1f	Total RAM used/Total RAM available@EMC frequency
TEMP	%2.1f/%2.1f/%2.1f (FW 14.0.0+: %2d/%2d/%2.1f)	SoC temperature/PCB temperature/Skin temperature'
FAN	%2.2f	Fan rotation level

' Explenation provided at the end of file

Optional (shows only when NX-FPS plugin is installed)

Category	Format	Explanation
FPS	%.1f	Frames Per Second

Works only in 1 or 5 Hz + vsync signal. You can change that with ZR + R + D-Pad Up/Down

FPS Counter

It shows only FPS value in 31Hz + vsync signal.

If game is not launched, it will show always 254.0 value.

Mode available only with SaltyNX installed.

Battery

Category	Format	Explanation
Battery Temperature	%.2f	Battery temperature in Celsius
Battery Raw Charge	%.2f	Raw battery charged capacity in percent
Battery Voltage (45s avg)	%.2f	Battery average voltage in mV
Charger Type	%u	Connected charger type, more in Battery.hpp "BatteryChargeInfoFieldsChargerType"

Shows only if charger type is other than 0:

Category	Format	Explanation
Charger Max Voltage	%u	Charger and external device voltage limit in mV
Charger Max Current	%u	Charger and external device current limit in mA

Miscellaneous

Category	Format	Explanation
DSP Usage	%u	In percent
NVDEC clock rate	%.2f	NVDEC frequency in MHz
Network Type	%s	It shows if Switch is connected to internet, and if it's using Ethernet or Wi-Fi

If Network Type is "Wi-Fi", you can press Y to show password. Since max password length is 64 characters, it may show in up to 3 lines.

Additional Info

What is Skin temperature (tskin)?

This is temperature calculated from SoC and PCB temperatures that is mainly used to prevent Switch from overheating. Reading it is not supported on FWs <5.0.0.

Explanation provided by CTCaer

Temperature (tskin) calculation.

Console and Handheld:

tsoc >= 84°C - Immediate sleep. No questions asked.

tpcb >= 84°C - Immediate sleep. No questions asked.

Console only:

tskin < 63°C - Clears both timers.

tskin >= 63°C - Immediate sleep. No questions asked.

Handheld only:

tskin < 58°C - Clears both timers.

58°C <= tskin < 61°C - Starts 60s timer and clears 10s timer.

61°C <= tskin < 63°C - Starts 10s timer.

tskin >= 63°C - Immediate sleep. No questions asked.

The two timers are separate. If 61°C is reached, the 10s timer is immediatly started.

If a timer ends and the temperature is not dropped, goes into sleep.

tskin is the specific calculation below:

soc_adj = (temps.iir_filter_gain_soc * (temps.soc - temps.soc_adj_prev)) + temps.soc_adj_prev;
pcb_adj = (temps.iir_filter_gain_pcb * (temps.pcb - temps.pcb_adj_prev)) + temps.pcb_adj_prev;
temps.soc_adj_prev = soc_adj;
temps.pcb_adj_prev = pcb_adj;

if (soc_adj >= 38000)
{
    if (temps.handheld)
        soc_adj = (temps.tskin_soc_coeff_handheld[0] * soc_adj) + (1000 * temps.tskin_soc_coeff_handheld[1]);
    else
        soc_adj = (temps.tskin_soc_coeff_console[0] * soc_adj) + (1000 * temps.tskin_soc_coeff_console[1]);
    soc_adj = (soc_adj / 10000) + 500;
}

if (pcb_adj >= 38000)
{
    if (temps.handheld)
        pcb_adj = (temps.tskin_pcb_coeff_handheld[0] * pcb_adj) + (1000 * temps.tskin_pcb_coeff_handheld[1]);
    else
        pcb_adj = (temps.tskin_pcb_coeff_console[0] * soc_adj) + (1000 * temps.tskin_pcb_coeff_console[1]);
    pcb_adj = (pcb_adj / 10000) + 500;
}

skin_adj = MAX(soc_adj, pcb_adj); //tskin

Media

Resident Evil 5 (Nintendo Switch) - Status Monitor Overlay and NX-FPS - (Marek)

FAQ

Q: This homebrew has any impact on games?
A: Negligible, you won't see any difference. Almost everything is done on Core #3, other cores usage is below 0.001%.

Troubleshooting

Q: When opening Full or Mini mode, overlay is showing that Core #3 usage is at 100% while everything else is showing 0, eventually leading to crash. Why this happens?
A: There are few possible explanations:

1. You're using nifm services connection test patches (in short nifm ctest patches) that are included in various packs. Those patches allow to connect to network that has no internet connection. But they cause nifm to randomly rampage when connected to network. Find any folder in atmosphere/exefs_patches that has in folder name nifm, nfim and/or ctest, delete this folder and restart Switch. If you must use it, only solution is to use this overlay only in airplane mode.
2. You're using some untested custom sysmodule that has no proper thread sleeping implemented. Find out in atmosphere/contents any sysmodule that you don't need, delete it and restart Switch.
3. Your Switch is using sigpatches, is not a primary device, is using linked account, and is connected to network. Delete sigpatches, change your Switch to primary device, unlink account, or disable Wi-Fi.

Changelog

v.0.8.2

• Fix conditional handle leak
• Fix memory leak
• Workaround race condition causing random crashes in docked mode

v.0.8.1

• Move reading FPS from dmnt:cht to SharedMemory. This fixes any stutterings, thread desyncing and cracking sounds you may have encountered when using NX-FPS in games.
• Requires NX-FPS 0.4+ and SaltyNX 0.5.0+ to read FPS.

v.0.8.0

• Add new mode - Micro.
• To access it YOU MUST NOT rename file, otherwise it will not show.
• Edit: Fixed GPU Load in Micro mode.

v.0.7.1

• It adds support for 16.0.0.

v.0.7

• New 2 tabs were added:
  • Battery/Charger
  • Miscellaneous
• You can now check Battery temperature, max supported charger voltage and current, connected Wi-Fi password and few others.

v.0.6.4

• Added support for 14.0.0 FW.
  • HOS removed function for reading SoC and PCB temperatures in milli Celsius. Status Monitor 0.6.3 was outputting 0.0C because of that. Now it reads temperature in Celsius without decimals on FW 14.0.0+.
• Fixed slow boot time by reimplementing fix from Breeze repository.

v.0.6.3

• Fixed button combo.

v.0.6.2

• Adapted c7cefce commit from main libtesla to my fork. Thanks to that Status Monitor is now showed on screenshots by default and also in videos.

v.0.6.1

• Fix issue related to always forcing opening cheat process with dmnt:cht that sometimes resulted in conflicts with other tools.
• Now it's checking first if cheat process is opened already.

v.0.6.0

• If dmnt:cht is not detected, it's using svc calls to read FPS values for NX-FPS (now only if SaltyNX check failed, FPS Counter won't show).
• Be aware that not using Atmosphere's dmnt:cht may introduce conflicts with other cheat engines, resulting in crashes or hangs.

v.0.5.5

• Now if dmnt:cht initializing didn't success or SaltyNX check failed, FPS Counter option won't show.
• Fixed issue with SaltyNX check returning false positive.

v.0.5.4

• Fix issue with CPU Core usage stuck at last value when core usage is at peak.

v.0.5.3

• Updated to libnx 3.2.0, which helps with very rare case of crashing overlay if pl sessions are depleted.
• Fixed wrong version inside overlay.

v.0.5.2

• Added version info for Tesla menu.
• Added support for SX OS (FPS Counter is not available).

v.0.5.1

• Fixed wrong parsing temperatures for PCB and SoC.

v.0.5

• Main menu from which you can now choose 3 modes, all explained here.
• Auto-switching input detection, so home button trick is now obsolete.

v.0.4.2

• Repaired bug that was requiring in 0.4.1 only Right Stick to be pressed to exit.

v.0.4.1

• Ported to new libtesla. Now requires Tesla menu >=1.0.2 to work correctly.

v.0.4

• Added support for SaltyNX plugin - NX-FPS.

v.0.3

• Added
  • Switching refresh rate between 1 and 5 FPS (More FPS results in higher Core #3 usage)
• GPU
  • Load
• Changes/fixes:
  • Fixed critical bug that was shutting down Switch if FW was lower than 7.0.0 (thx to Behemoth for providing correct magic to IController)
  • Renamed 'Temperatures' to 'Thermal'
  • Renamed 'Fan Rotation' to 'Fan'
  • Repositioned Thermal category
  • Added checks that prevents from using functions if services are not initialized. This helps with FWs <5.0.0 which doesn't support showing Memory used and Skin temperature.
  • Buttons are now checked outside of FPS limitations, so detecting input and exiting is now smoother

v.0.2

• Added
  • CPU:
    • Actual frequency
  • GPU
    • Actual frequency
  • RAM
    • Actual frequency
    • Used memory categorized to: Total, Application, Applet, System, System Unsafe
  • Temperatures
  • SoC temperature
  • PCB temperature
  • Skin temperature
  • Fan rotation level
• Changes/fixes:
  • Changed interval for everything to 1s
  • Changed refresh rate to 1 FPS, which reduced homebrew usage of Core #3 from 26 percent points to 1 percent point
  • Core Usage now always starts at 0%

v.0.11

• Code was changed to make each CPU core independent, so they will not block each other in case of heavy load.
• Changed exit button from holding Left Stick to pressing Left Stick + Right Stick.

v.0.1

• First Release.

Thanks To

• RetroNX channel for helping with coding stuff
• SunTheCourier for sys-clk-Overlay from which I learned how to make my own Tesla homebrew
• Herbaciarz for providing screenshots from HDMI Grabber

External links

• Gbatemp - https://gbatemp.net/threads/status-monitor-overlay-tesla-overlay-to-monitor-your-hardware.558505/
• Github - https://github.com/masagrator/Status-Monitor-Overlay