Update ReadMe, Include Example, Changes to port and titleid to not mess with original sys-netcheat

Author: olliz0r

.gitignore

@@ -2,4 +2,7 @@
 ._*
 build
 *.kip
-*.elf
+*.elf
+*.nso
+*.nsp
+*.npdm

README.md

@@ -26,5 +26,15 @@ Don't even think of blaming me if anything goes wrong with you using this. It's
 ### screen capture:
 - [ ] capture current screen and send it 
 
+# Installation
+I've only tried this on Atmosphere (0.10.2), so if you are using a different cfw your experience might vary.
+
+Copy the sys-botbase.nsp file to sdmc://atmosphere/contents/430000000000000B and rename it to exefs.nsp.
+Create a new folder in sdmc://atmosphere/contents/430000000000000B names "flags".
+Create a empty file called boot2.flag inside this folder.
+Restart your switch.
+
+The sysmodule opens a socket connection on port 6000. See the python example on how to talk to the sysmodule and what commands are available.
+
 
 # big thank you to jakibaki for a great sysmodule base to learn and work with, as well as being helpful on the Reswitched discord!

example_PokemonSwSh_SurpriseTrade.py

@@ -0,0 +1,77 @@
+#Simple example on how to connect to and send commands to the sys module.
+#The example is for Pokemon Sword/Shield, it reads a .ek8 file from a certain file path, injects it into box1slot1
+#and starts a surprise trade with the given pokemon. It waits a certain amount of time (hoping the trade has completed)
+#before retrieving the new pokemon. Finally it extracts the pokemons .ek8 data from the game and saves it to the hard drive.
+#The script assumes the game is set up in a way that the character is not currently in any menus and that the cursor of the
+#pokebox is on box1slot1.
+
+#The script isn't exactly robust, there are many ways to make it better (for example one could compare the box1slot1 data in
+#RAM with that of the pokemon sent to see if a trade has been found and if not back out of the menu to search for another 10 
+#seconds or so instead of waiting a fixed 45 seconds), but it is rather meant as a showcase of the functionalites of the 
+#sysmodule anyway.
+
+#Commands:
+#make sure to append \r\n to the end of the command string or the switch args parser might not work
+#responses end with a \n (only poke has a response atm)
+
+#click A/B/X/Y/LSTICK/RSTICK/L/R/ZL/ZR/PLUS/MINUS/DLEFT/DUP/DDOWN/DRIGHT/HOME/CAPTURE
+#press A/B/X/Y/LSTICK/RSTICK/L/R/ZL/ZR/PLUS/MINUS/DLEFT/DUP/DDOWN/DRIGHT/HOME/CAPTURE
+#release A/B/X/Y/LSTICK/RSTICK/L/R/ZL/ZR/PLUS/MINUS/DLEFT/DUP/DDOWN/DRIGHT/HOME/CAPTURE
+
+#peek <address in hex, prefaced by 0x> <amount of bytes, dec or hex with 0x>
+#poke <address in hex, prefaced by 0x> <data, if in hex prefaced with 0x>
+
+#setStick LEFT/RIGHT <xVal from -0x8000 to 0x7FFF> <yVal from -0x8000 to 0x7FFF
+
+
+import socket
+import time
+import binascii
+
+
+def sendCommand(s, content):
+    content += '\r\n' #important for the parser on the switch side
+    s.sendall(content.encode())
+
+s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+s.connect(("192.168.178.25", 6000))
+
+fileIn = open("C:/temp/toInject.ek8", "rb")
+pokemonToInject = fileIn.read(344)
+pokemonToInject = str(binascii.hexlify(pokemonToInject), "utf-8")
+
+time.sleep(2)
+while True:
+    sendCommand(s, f"poke 0x4293D8B0 0x{pokemonToInject}") #read pokemon from file and inject it into box1slot1 for trade
+
+
+    sendCommand(s, "click Y")
+    time.sleep(1)
+    sendCommand(s, "click DDOWN")
+    time.sleep(0.5)
+    sendCommand(s, "click A")
+    time.sleep(4)
+    sendCommand(s, "click A")
+    time.sleep(0.7)
+    sendCommand(s, "click A")
+    time.sleep(8)
+
+    sendCommand(s, "click A")
+    time.sleep(0.7)
+    sendCommand(s, "click A")
+    time.sleep(0.7)
+    sendCommand(s, "click A")
+    time.sleep(0.7)
+
+    time.sleep(45) #Time we wait for a trade
+    sendCommand(s, "click Y")
+    time.sleep(0.7)
+    time.sleep(30) #probably needs to be longer for trade evolutions
+
+    sendCommand(s, "peek 0x4293D8B0 344") #get pokemon from box1slot1
+    time.sleep(0.5) #give time to answer
+    pokemonBytes = s.recv(689)
+    pokemonBytes = pokemonBytes[0:-1] #cut off \n at the end
+    fileOut = open("C:/temp/lastReceived.ek8", "wb")
+    fileOut.write(binascii.unhexlify(pokemonBytes))
+    fileOut.close()

source/main.c

@@ -11,7 +11,7 @@
 #include "args.h"
 #include "util.h"
 
-#define TITLE_ID 0x420000000000000F
+#define TITLE_ID 0x430000000000000B
 #define HEAP_SIZE 0x000540000
 
 // we aren't an applet

source/util.c

@@ -16,7 +16,7 @@ int setupServerSocket()
     lissock = socket(AF_INET, SOCK_STREAM, 0);
     server.sin_family = AF_INET;
     server.sin_addr.s_addr = INADDR_ANY;
-    server.sin_port = htons(5555);
+    server.sin_port = htons(6000);
 
     while (bind(lissock, (struct sockaddr *)&server, sizeof(server)) < 0)
     {

sys-botbase.json

@@ -1,8 +1,8 @@
 {
 	"name": "sys-botbase",
-	"title_id": "0x430000000000000A",
-      "title_id_range_min": "0x430000000000000A",
-      "title_id_range_max": "0x430000000000000A",
+	"title_id": "0x430000000000000B",
+      "title_id_range_min": "0x430000000000000B",
+      "title_id_range_max": "0x430000000000000B",
       "main_thread_stack_size": "0x00024000",
       "main_thread_priority": 49,
       "default_cpu_id": 3,