Toggle search
Toggle menu
10.3K
13.2K
1.2K
203.4K
GameBrew
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

VolLightbarCtrlWithDS4 Vita: Difference between revisions

From GameBrew
More actions
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{#seo:
{{#seo:
|title=Vita Homebrew Apps (Plugins) - GameBrew!
|title=Vita Homebrew Apps (Plugins) - GameBrew
|title_mode=append
|title_mode=append
|image=vollightbarctrlwithds4vita.jpg
|image=vollightbarctrlwithds4vita2.png
|image_alt=VolLightbarCtrlWithDS4
|image_alt=VolLightbarCtrlWithDS4
}}
}}
{{Infobox Vita Homebrews
{{Infobox Vita Homebrews
|title=VolLightbarCtrlWithDS4
|title=VolLightbarCtrlWithDS4
|image=vollightbarctrlwithds4vita.jpg
|image=vollightbarctrlwithds4vita2.png
|description=Change DS4 lightbar color based on battery level.
|description=Change DS4 lightbar color based on battery level.
|author=CallmeBK
|author=CallmeBK
Line 15: Line 15:
|license=MIT
|license=MIT
|download=https://dlhb.gamebrew.org/vitahomebrews/vollightbarctrlwithds4vita.7z
|download=https://dlhb.gamebrew.org/vitahomebrews/vollightbarctrlwithds4vita.7z
|website=
|website=https://www.reddit.com/r/VitaPiracy/comments/lju28a/vollightbarctrlwithds4_pstv_feedback_needed/
|source=https://github.com/CallmeBK/VolLightbarCtrlWithDS4
|source=https://github.com/CallmeBK/VolLightbarCtrlWithDS4
}}
}}
Kernel plugin for PSVita and PSTV that will make connected DS4 lightbar to change color based on controller battery level.
Kernel plugin for PS Vita and PS TV that will make connected DS4 lightbar to change color based on controller battery level.


Requires [[Minivitatv Vita|MinivitaTV]] plugin to work on a PSVita. It also allows to manage console volume through buttons combination.
Requires [[MiniVitaTV]] plugin to work on a PS Vita. It also allows to manage console volume through buttons combination.


== Preface ==
== Features ==
This was the first project I've ever written in c. Most of my programming experience comes from VBA so I had a lot of help on this project and learned a lot (see credit section at bottom).
*Control volume using DS4 controller.
*DS4 lightbar used as DS4 battery indicator.
*Adjust DS4 lightbar brightness.
*Supports up to 4 connected controllers.


== VolLightbarCtrlWithDS4 ==
== Installation ==
Kernel plugin for PS Vita. Requires vita firmware 3.60, Henkaku Enso, and the Minivitatv plugin to work. Also supports PSTV.
Copy VolLightbarCtrlWithDS4.skprx to ur0:tai/ folder on PS Vita.


== Installation Instructions ==
Enable it under KERNEL section in Config.txt file
# Download zip from latest release
# Copy VolLightbarCtrlWithDS4.skprx to ur0:/tai folder on ps vita
# Put "ur0:/tai/VolLightbarCtrlWithDS4.skprx" (without quotes) under KERNEL section in Config.txt file
# Reboot vita


== What it does ==
*KERNEL
Control volume using DS4 controller.<br />
ur0:tai/VolLightbarCtrlWithDS4.skprx
DS4 lightbar used as DS4 battery indicator.<br />
Adjust DS4 lightbar brightness.<br />
Supports up to 4 connected controllers.


== How to use ==
Reboot Vita.
Press Select and L1 simultaneously to lower volume<br />
Press Select and R1 simultaneously to raise volume<br />
Press Select, L1, and R1 simultaneously to mute volume<br />
Press L1, L2, R1, and R2 simultaneously to toggle DS4 lightbar brightess


Magenta lightbar means DS4 is charging<br />
==User guide==
Turquoise lightbar means DS4 is fully charged<br />
===Lightbar battery indicator===
Green lightbar means DS4 is high charge<br />
*Magenta lightbar means DS4 is charging.
Yellow lightbar means DS4 is medium charge<br />
*Turquoise lightbar means DS4 is fully charged.
Red lightbar means DS4 is low charge<br />
*Green lightbar means DS4 is high charge.
Red pulsing lightbar means DS4 will run out of charge soon
*Yellow lightbar means DS4 is medium charge.
*Red lightbar means DS4 is low charge.
*Red pulsing lightbar means DS4 will run out of charge soon.


==Screenshot==
===Lightbar brightness toggle===
[[image:vollightbarctrlwithds4vita.jpg|600px]]
You can toggle lightbar brightness back and forth between 5% and 100% by pressing L1, L2, R1, and R2 at the same time. Settings are saved for each controller in text files:
 
==Changelog==
'''(v.1.3)'''<br>
You can now toggle lightbar brightness back and forth between 5% and 100% by pressing L1, L2, R1, and R2 at the same time. Settings are saved for each controller in text files:


*ux0:data/vollightbarctrlwds4/p1config.txt
*ux0:data/vollightbarctrlwds4/p1config.txt
Line 69: Line 59:
You can also manually adjust the number in each text file if you want something other than 5% and 100% brightness, but changes will not take effect until you restart the system. If you do set your own value that is not 5% nor 100%, pressing L1, L2, R1, and R2 at the same time will not change the brightness anymore. That functionality will come back after manually changing the value back to either 5% or 100% in the text file and then restarting the system.
You can also manually adjust the number in each text file if you want something other than 5% and 100% brightness, but changes will not take effect until you restart the system. If you do set your own value that is not 5% nor 100%, pressing L1, L2, R1, and R2 at the same time will not change the brightness anymore. That functionality will come back after manually changing the value back to either 5% or 100% in the text file and then restarting the system.


Thank you aliihsanasl for this idea to allow for an extended ds4 batterly life.
==Controls==
Select+L1 - Lower volume
 
Select+R1 - Raise volume
 
Select+L1+R1 - Mute volume


'''(v.1.2)'''
L1+L2+R1+R2 - Toggle DS4 lightbar brightness
 
==Compatibility==
Requires Vita Firmware 3.60, Henkaku Enso, and the [[MiniVitaTV]] plugin to work. Also supports PS TV.
 
==Changelog==
'''v1.3'''
*You can now toggle lightbar brightness back and forth between 5% and 100% by pressing L1, L2, R1, and R2 at the same time. Settings are saved for each controller in text files:
**ux0:data/vollightbarctrlwds4/p1config.txt
**ux0:data/vollightbarctrlwds4/p2config.txt
**ux0:data/vollightbarctrlwds4/p3config.txt
**ux0:data/vollightbarctrlwds4/p4config.txt
*The number within each file indicates the brightness percentage that that controller's lightbar will have. The files will be created automatically after replacing v1.2 skprx with v1.3 skprx and then restarting the system.
*You can also manually adjust the number in each text file if you want something other than 5% and 100% brightness, but changes will not take effect until you restart the system. If you do set your own value that is not 5% nor 100%, pressing L1, L2, R1, and R2 at the same time will not change the brightness anymore. That functionality will come back after manually changing the value back to either 5% or 100% in the text file and then restarting the system.
*Thank you aliihsanasl for this idea to allow for an extended ds4 batterly life.
 
'''v1.2'''
*When using hotkeys Select + L1 or Select + R1 on PSTV, volume indicator would appear showing a volume level of zero and the volume would not change.
*When using hotkeys Select + L1 or Select + R1 on PSTV, volume indicator would appear showing a volume level of zero and the volume would not change.
*(PSTV Only) As of this release, the volume now changes with Select + L1/R1 hotkeys and I've drawn my own on-screen volume indicator to show the current volume level. Now this plugin is fully functional for both PS Vita and PSTV.
*(PSTV Only) As of this release, the volume now changes with Select + L1/R1 hotkeys and I've drawn my own on-screen volume indicator to show the current volume level. Now this plugin is fully functional for both PS Vita and PSTV.


'''(v.1.1)'''
'''v1.1'''
*Cleaned up code. Added for loop to cycle through controller ports and minimize if statements.
*Cleaned up code. Added for loop to cycle through controller ports and minimize if statements.


'''(v.1.0)'''
'''v1.0'''
* Initial release. Supports 4 DS4 controllers.
* Initial release. Supports 4 DS4 controllers.


== Credits ==
== Credits ==
xerpi<br />
xerpi, marburg, SKGleba, davee, Bythos, NOTxCorra, teakhanirons, Princess of Sleeping, Mer1e, Orangelampshade, Rinnegatamante, cuevavirus, aliihsanasl.
*for directing me to the discord henkaku server
 
marburg<br />
*for providing lightbar mod example code<br />
*letting me know to use SceLibKernel_stub in my cmakelists.txt<br />
*for letting me know that a function in my user thread could be interrupting the reboot sequence
 
SKGleba<br />
*for confirming that the basic difference between user and kernel is privilege.<br />
*for teaching me that *ALL in config.txt includes *main<br />
*for teaching me that the format for checking if titleid string belongs to main --&gt; titleid[0]=='\0'<br />
*for informing me of ksceDebugPrintf (kernel printf function)<br />
*for giving me the idea to use db.yml to find required stubs<br />
*for informing me that I need to have taimoduleutils_stub for module_get_offset to work in kernel plugin<br />
*for suggesting to reverse engineer sceAVConfigGetSystemVol, sceAVConfigSetSystemVol, sceAVConfigMuteOn functions<br />
*for suggesting tools/programs to use for reverse engineering functions<br />
*for informing me that bootimage is just a bunch of elfs appended to each other and then encrypted to one self
 
davee<br />
*for teaching me that you should choose user over kernel everytime you get the option because with less privileges, you're less likely to cause system crashes if something goes wrong.<br />
*for teaching me what &quot;nostdlib&quot; link flag does in cmakelists.txt<br />
*for teaching me that plugins are injected into whatever process is described in the config.txt. It's lifetime is determined by whatever process it lives in.<br />
*for teaching me that *ALL in config.txt includes *main<br />
*for teaching me that adding a delay in an infinite loop provides cooperative scheduling to prevent my plugin from hogging the cpu<br />
*for informing me that using sceKernelDelayThread in a hook is bad form
 
Bythos<br />
*for letting me know minivitatv plugin supports lightbar and DS4vita doesn't<br />
*for supplying me with the user function used to print to PrincessLog and how to use it<br />
*for helping me setup PrincessLog and getting it to work<br />
*for the suggestion of using |= instead of = to assign volume buttons to pad_data-&gt;buttons<br />
*for suggesting that I need to hook sceCtrlPeekBufferPositive2 for LiveArea to recognize my inputs because SceShell imports sceCtrlPeekBufferPositive2<br />
*for suggesting one can use userspace functions in kernel if they get the address of the module in memory and use offsets. Then hook the function offsets (taihen).<br />
*for suggesting how to simplify my if statements in the sceCtrlPeekBufferPositive2 hook function<br />
*for informing me that all functions in same module have same base address<br />
*for informing me that known kernel functions in db.yml can be hooked by export and don't require offset. All libraries in db.yml that have kernel set to true, have the named functions exported from the kernel.<br />
*for informing me that hooking imports requires NID hooking<br />
*for informing me that the kernel exports functions so that other apps can import them. So when you hook a function export, the code gets run every single time an application uses that same function as an import.<br />
*for informing me that Module = ELF on vita<br />
*for informing me that dynamic libraries and SceShell export functions. Applications and dynamic libraries import functions. Executables are modules.<br />
*for informing me that plugins are basically dynamic libraries that usually don't export functions<br />
*for informing me that SceShell calls sceCtrlPeekBufferPositive2. Different apps use different control functions.<br />
*for informing me that SceShell is always running in the background<br />
*for informing me to use module_get_offset to use kernel function equivalents to user functions that aren't exported by the kernel (in other words, user functions that aren't listed in the kernel header)<br />
*for informing me that module_get_offset gets the base address of the module and adds the offset of the function to the base address. This result is the address of the function you want to use and you would call it using a function pointer.<br />
*for giving me an example of declaring a function pointer in c. int (''ksceCtrlPeekBufferPositve2)(int, SceCtrlData'', int) = NULL; Pass it to module_get_offset last argument as &amp;ksceCtrlPeekBufferPositive2<br />
*for informing me that sceKernelDelayThread works in function hooks too (but it's bad form and could hurt a tight loop)<br />
*for informing me that segidx argument in module_get_offset is the index of the segment in which the function I'm looking for is. There are 4 segments and usually functions are found in segment 0<br />
*for teaching me how to use callback functions<br />
*for informing me that putting the vita to sleep mode does not run module_stop function<br />
*for informing me that event flags are set by my own code<br />
*for supplying me with sceAVConfigGetSystemVol, sceAVConfigSetSystemVol, sceAVConfigMuteOn offsets<br />
*for directing me to KuromeSan github page for psvita-elfs<br />
*for informing me that AVConfig elf is in bootimage<br />
*for informing me that a module can have multiple stubs<br />
*for teaching me how to understand the code that is decompiled by Ghidra<br />
*for introducing me to a function that determines if the current device is VITA or PSTV<br />
*for informing me that kernel exports and user space syscalls are exported from the same module for most kernel space stuff<br />
*for teaching me about what the segidx parameter is for in module_get_offset function. Functions are put into segment 0. Global variables are put into segment 1.<br />
*for informing me that kernel space and user space share the same global variables<br />
*for informing me that arguments from the function call map linearly in Ghidra<br />
*for informing me that to get SceShell module info for Kernel, you have to wait until SceShell is loaded before calling taiGetModuleInfoForKernel<br />
*for informing me that a function that exists in a stub, but is not in any headers can be declared and used all the same. Stubs are not incomplete and are not missing functions from modules.
 
NOTxCorra<br />
*for informing me of header/stub needed for sceClibPrintf function<br />
*for letting me know that caps actually matter<br />
*for helping me setup PrincessLog and getting it to work<br />
*for teaching me that shell/main title id can be referred to as \0<br />
*for teaching me that adding a sceKernelDelayThread in my infinite loop is good practice<br />
*for teaching me that arrays are pointers<br />
*for teaching me to call TAI_CONTINUE first inside function hooks<br />
*for informing me that function export is exported from module. Function import is imported from module. Offset is from base address.
 
teakhanirons<br />
*for pointing me to PrincessLog debugging solution<br />
*for teaching me that *ALL in config.txt includes *main<br />
*for teaching me that headers in psp2 are user and psp2kern are kernel<br />
*for pointing me to documentation on thread priority<br />
*for pointing me to examples of kernel and user forms of blit to print to the screen as an overlay<br />
*for confirming that one can use userspace functions in kernel if they get the address of the module in memory and use offsets<br />
*for providing the offset for sceCtrlPeekBufferPositive2 and providing an example using taiHookFunctionOffsetForKernel<br />
*for helping Mer1e with hooking the function offset for sceCtrlPeekBufferPositive2<br />
*for informing me that SceShell calls sceCtrlPeekBufferPositive2<br />
*for suggesting to use a for loop to cycle through each controller in the lightbar_thread code
 
Princess of Sleeping<br />
*for teaching me that shell/main title id is referred to as \0, main, or NPXS19999<br />
*for correcting the offsets that Mer1e supplied for sceCtrlGetBatteryInfo and sceCtrlSetLightBar. ghidra returns even addresses when thumb functions are odd so you need to increase the ghidra offset by one byte for thumb functions.<br />
*for informing me that if ksceKernelExitThread is called and then vita goes to sleep, waking from sleep does not auto start threads again. You need to call the startthread function.<br />
*for informing me about waiting with event flags and giving me an example of how it is done
 
Mer1e<br />
*for the idea to hook a ksceCtrl function and add SCE_CTRL_VOLUP and SCE_CTRL_VOLDOWN to pad_data-&gt;buttons<br />
*for letting me know I needed SceDebugForDriver_stub and sysmem.h header to call ksceDebugPrintf<br />
*for informing me to always call TAI_CONTINUE before any returns<br />
*for informing me to check that TAI_CONTINUE returns a value between 1 and 64 before any code runs inside the hook function<br />
*for providing a working sample of of hooking the function offset for sceCtrlPeekBufferPositive2<br />
*for supplying me with the offsets for sceCtrlGetBatteryInfo and sceCtrlSetLightBar<br />
*for informing me that Kernel plugins are only loaded in one instance by the kernel. User plugins under *MAIN are loaded in one instance under SceShell process. User plugins under ''ALL are loaded in separated instances for each of the processes running.<br />
*for informing me that the last argument in module_get_offset should be passed in the form of (uintptr_t'')&amp;ksceCtrlPeekBufferPositive2
 
Orangelampshade<br />
*for testing PSTV compatibility
 
Rinnegatamante<br />
*for AnalogsEnhancer plugin. I used this as reference for how to open, read, and write to a text file for storing configuration settings.
 
cuevavirus<br />
*for Quick Menu Plus plugin. I used this as reference for converting a char array to an integer data type.
 
aliihsanasl<br />
*for the idea to give this plugin the ability to change lightbar brightness.


== External links ==
== External links ==
* Github - https://github.com/CallmeBK/VolLightbarCtrlWithDS4
* Github - https://github.com/CallmeBK/VolLightbarCtrlWithDS4
* VitaDB - https://vitadb.rinnegatamante.it/#/info/582
* VitaDB - https://vitadb.rinnegatamante.it/#/info/582

Latest revision as of 08:35, 11 Ocak 2023

VolLightbarCtrlWithDS4
Vollightbarctrlwithds4vita2.png
General
AuthorCallmeBK
TypePlugins
Version1.3
LicenseMIT License
Last Updated2021/05/28
Links
Download
Website
Source

Kernel plugin for PS Vita and PS TV that will make connected DS4 lightbar to change color based on controller battery level.

Requires MiniVitaTV plugin to work on a PS Vita. It also allows to manage console volume through buttons combination.

Features

  • Control volume using DS4 controller.
  • DS4 lightbar used as DS4 battery indicator.
  • Adjust DS4 lightbar brightness.
  • Supports up to 4 connected controllers.

Installation

Copy VolLightbarCtrlWithDS4.skprx to ur0:tai/ folder on PS Vita.

Enable it under KERNEL section in Config.txt file 

*KERNEL
ur0:tai/VolLightbarCtrlWithDS4.skprx

Reboot Vita.

User guide

Lightbar battery indicator

  • Magenta lightbar means DS4 is charging.
  • Turquoise lightbar means DS4 is fully charged.
  • Green lightbar means DS4 is high charge.
  • Yellow lightbar means DS4 is medium charge.
  • Red lightbar means DS4 is low charge.
  • Red pulsing lightbar means DS4 will run out of charge soon.

Lightbar brightness toggle

You can toggle lightbar brightness back and forth between 5% and 100% by pressing L1, L2, R1, and R2 at the same time. Settings are saved for each controller in text files:

  • ux0:data/vollightbarctrlwds4/p1config.txt
  • ux0:data/vollightbarctrlwds4/p2config.txt
  • ux0:data/vollightbarctrlwds4/p3config.txt
  • ux0:data/vollightbarctrlwds4/p4config.txt

The number within each file indicates the brightness percentage that that controller's lightbar will have. The files will be created automatically after replacing v1.2 skprx with v1.3 skprx and then restarting the system.

You can also manually adjust the number in each text file if you want something other than 5% and 100% brightness, but changes will not take effect until you restart the system. If you do set your own value that is not 5% nor 100%, pressing L1, L2, R1, and R2 at the same time will not change the brightness anymore. That functionality will come back after manually changing the value back to either 5% or 100% in the text file and then restarting the system.

Controls

Select+L1 - Lower volume

Select+R1 - Raise volume

Select+L1+R1 - Mute volume

L1+L2+R1+R2 - Toggle DS4 lightbar brightness

Compatibility

Requires Vita Firmware 3.60, Henkaku Enso, and the MiniVitaTV plugin to work. Also supports PS TV.

Changelog

v1.3

  • You can now toggle lightbar brightness back and forth between 5% and 100% by pressing L1, L2, R1, and R2 at the same time. Settings are saved for each controller in text files:
    • ux0:data/vollightbarctrlwds4/p1config.txt
    • ux0:data/vollightbarctrlwds4/p2config.txt
    • ux0:data/vollightbarctrlwds4/p3config.txt
    • ux0:data/vollightbarctrlwds4/p4config.txt
  • The number within each file indicates the brightness percentage that that controller's lightbar will have. The files will be created automatically after replacing v1.2 skprx with v1.3 skprx and then restarting the system.
  • You can also manually adjust the number in each text file if you want something other than 5% and 100% brightness, but changes will not take effect until you restart the system. If you do set your own value that is not 5% nor 100%, pressing L1, L2, R1, and R2 at the same time will not change the brightness anymore. That functionality will come back after manually changing the value back to either 5% or 100% in the text file and then restarting the system.
  • Thank you aliihsanasl for this idea to allow for an extended ds4 batterly life.

v1.2

  • When using hotkeys Select + L1 or Select + R1 on PSTV, volume indicator would appear showing a volume level of zero and the volume would not change.
  • (PSTV Only) As of this release, the volume now changes with Select + L1/R1 hotkeys and I've drawn my own on-screen volume indicator to show the current volume level. Now this plugin is fully functional for both PS Vita and PSTV.

v1.1

  • Cleaned up code. Added for loop to cycle through controller ports and minimize if statements.

v1.0

  • Initial release. Supports 4 DS4 controllers.

Credits

xerpi, marburg, SKGleba, davee, Bythos, NOTxCorra, teakhanirons, Princess of Sleeping, Mer1e, Orangelampshade, Rinnegatamante, cuevavirus, aliihsanasl.

External links

Retrieved from ‘https://www.gamebrew.org/index.php?title=VolLightbarCtrlWithDS4_Vita&oldid=106152’

Advertising: