***About Project Carousel USB(The First Thread)***

PROJECT CAROUSEL USB BY SPANNERNICK
<------------------------------------->

HOW TO USE PCU V1.14
<---------------------->

I HAVE NOW ADDED BACK THE OTHER WAY OF CHANING THE CAROUSEL GAMELIST SCREENS, YOU CAN'T HAVE BOTH ENABLED,
YOU CAN ONLY USE THE HOLD 2 BUTTIONS DOWN FOLDER SWICHER OR THE OLD WAY OF CHANGING THEM WITH A UPDATE NOT BOTH.

THE EXTRA GAMES FOR FILE LOADER FOLDER IS WHERE YOU CAN PUT YOUR GAMES THAT DON'T WORK IN THE CAROUSEL AND LOAD THEM USING THE USB FILE LOADER OR MEDIA ACCSESS.
IT TO KEEP EVERYTHING ON THE USB TIDY... SO YOU DON'T HAVE GAMES EVERYWHERE.

HIS WHERE THE OPTIONS ARE IN THE START SCRIPT.
YOU CAN DISABLE FAVORITES IN THIS SCRIPT FROM STARTING UP FIRST, ITS AT THE BOTTOM OF THE SCRIPT "Carousel Gameslist Screen Startup"

THIS PART.. ENABLE FAV OR 0 TO G SCREEM OR HOLD 2 BUTTIONS DOWN FOLDER SWICHER.
#--------------------------------------------------------------------------------------------------------------------------------
#-------------------------------------------------------------------------------------------------------------------------------
# Option - Carousel Gameslist Screen Startup
#------------------------------------------------------------------------------------------------------------------------------
# Enable one line ONLY, if you add (#)hash to one line, the other line has to have it removed for it to work,
# if you get it wroung, no Carousel will load up, look at how its done and mirror it.
#------------------------------------------------------------------------------------------------------------
# Favorties Screen, add hash (#) to disable
/mnt/Carousel_Games/Games/Z_Other_Scripts/bootfav.sh $@
# 0 to G Screen, remove hash (#) to enable
#/mnt/Carousel_Games/Games/Z_Other_Scripts/bootg.sh $@
#-------------------------------------------------------------------------------
# Enable (#) the HOLD 2 Button Folder Swicher ONLY if both lines above are disabled.
# Run game folder switcher in the background.
killall switch-games.sh
#/mnt/Carousel_Games/Games/Z_Other_Scripts/switch-games.sh &
#-------------------------------------------------------------

IF YOU WANT TO HIDE FAVORITIES COMPLETELLY THEN GO INTO S TO Z FOLDER, YOU CAN IN THAT START SCRIPT.

THIS BIT IS FROM PCU V1.13, I HAVE NOW ADDED BACK THE OTHER WAY OF CHANING THE CAROUSEL GAMELIST SCREENS, YOU CAN'T HAVE BOTH ENABLED,
YOU CAN ONLY USE THE HOLD 2 BUTTIONS METHOD OR THE OLD WAY OF CHANGING THEM WITH A UPDATE NOT BOTH.

----------------------------------------------------------------------------------------------------------------------------------------

THIS IS A HELP README FILE AND WILL HELP YOU USE THE NEW BUTTONS TO CHANGE THE CAROUSEL GAMELIST SCREENS AND START XWM(X-WINDOWS MOD).
HELP TO CHANGE THE BUTTONS TOO, IF YOU NEED TO.

YOU CAN NOW CHANGE CAROUSEL GAMELIST SCREEN BY HOLDING DOWN THE RED MENU BUTTON AND PRESSING RED TRIANGLE BUTTON 1(LEFT TR1 BUTTON),
THE MENU BUTTON IS THE 4TH RED BUTTON IN A GROUP OF 4 BUTTONS THAT IS LOCATED AT THE BACK OF THEC64 JOYSTICK, A,B,C, MENU BUTTONS(1,2,3,4 BUTTONS),

IF YOU ARE NOT USING THEC64 JOYSTICK THEN YOU HAVE TO FIND OUT WHAT BUTTONS ARE WHAT ON THE CONTROLLER OR CONTROLPAD YOU ARE USING
OR YOU CAN CHANGE THE BUTTONS, LOOK FUTHER DOWN FOR HELP.

IF YOU WANT TO SKIP A CAROUSEL GAMELIST SCREEN QUICKY, LIKE FAVORITES, YOU CAN BY HOLDING DOWN THE 4TH RED MENU BUTTON
AND PRESSING LEFT TRIANGLE BUTTON 1 WHEN YOU SEE THE WORDS "LOADING" COME UP ON THE SCREEN TO SKIP THAT SCREEN.

YOU CAN NOW LOAD XWM THAT IS NOW INCLUDED WITH PCU, WHEN YOU PRESS ON APPLY TO RUN THE FAKE UPDATE TO START PCU PRESS FIRE BUTTON 1 AND FIRE BUTTON 2
BOTH TOGETHER AND HOLD THEM DOWN UNTIL YOU SEE THE SCREEN GO BLANK(BLACK) THEN RELEASE THE BUTTONS AND XWM SHOULD LOAD UP.

XWM WORKS WITH THEC64 MAXI PI NOW, YOU CAN SEE THE FIRMWARE FROM ITS SD CARD IN A FOLDER ON THE FILE MANAGER AND THEC64 MINI/MAXI FIRMWARE TOO.


HOW TO CHANGE THE BUTTONS
<--------------------------->

IF YOU WANT TO CHANGE THE BUTTONS AT ALL BECAUSE YOU ARE NOT USING THEC64 JOYSTICK YOU CAN, THERE IS A TXT FILE CALLED "THEC64 Joystick buttons.txt"
THAT ON THE ROOT OF THE USB DRIVE/STICK THAT HAS WHAT THE BUTTONS ARE CALLED, YOU WILL NEED IT TO EDIT THE START.SH FILE ON THE ROOT OF THE USB STICK,
ALL YOU NEED TO DO IS CHANGE THE NAME OF THE 2 BUTTONS IN THE FILE TO THE ONES YOU WANT BUT THE NAME OF THE BUTTON MIGHT BE A CLUE OF
WHAT BUTTON IT REALLY IS MAP TO.

THIS PART IS FOR STARTING X-WINDOWS MOD AT STARTUP.

WHERE IS SAYS "BTN_TRIGGER"(IS FIRE BUTTON 1) AND "BTN_THUMB"(IS FIRE BUTTON 2)... RENAME ALL 4 LINES, JUST CHANGE THE "BTN_TRIGGER" OR "BTN_THUMB"
NAME ONLY, LOOK FOR THE NAME OF THE BUTTON YOU WANT TO USE FROM THE "THEC64 Joystick buttons.txt" FILE, ONLY THE BUTTON NAME THAT STARTS WITH
"BTN" IN THAT FILE, JUST COPY IT OVER THE ONES YOU WANT TO CHANGE IN THE START.SH... THEN ONCE YOU HAVE FINISH, SAVE THE FILE, THERE ARE 4 LINES
TO CHANGE.

THIS PART OF THE CODE IS IN THE START.SH FILE(BELOW) ITS ON THE ROOT OF THE USB STICK..

/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event1 EV_KEY BTN_TRIGGER
JOY1_BT1=$?
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event1 EV_KEY BTN_THUMB
JOY1_BT2=$?
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event2 EV_KEY BTN_TRIGGER
JOY2_BT1=$?
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event2 EV_KEY BTN_THUMB
JOY2_BT2=$?

THIS PART IS FOR CHANGING THE CAROUSEL GAMELIST SCREEN WITH 2 BUTTONS.

DO THE SAME THING AS ABOVE IF YOU WANT TO CHANGE THE BUTTONS THAT CHANGE THE CAROUSEL GAMELIST SCREENS TO THE NEXT ONE BUT THE SCRIPT(.SH) FILE IS IN...
"/Carousel_Games/Games/Z_Other_Scripts/switch-games.sh" AND LOOK FOR THE SAME CODE ABOVE BUT THERE IS 2 SETS OF THEM, YOU HAVE TO CHANGE,
(ONE SET IS FOR PUSHING DOWN THE BUTTON AND THE OTHER IS FOR RELEASING THE BUTTON) SO THERE IS 8 LINES TO CHANGE.
REMEMBER ONLY CHANGE THE NAME OF THE BUTTON, IT START WITH "BTN..."

THE CODE LOOKS LIKE THIS..

# Wait for either joystick 1 or joystick 2 for menu button 4 and triange 1 both to be pressed
until [ "$JOY1_BT1$JOY1_BT2" = "1010" -o "$JOY2_BT1$JOY2_BT2" = "1010" ]
do
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event1 EV_KEY BTN_THUMB2
JOY1_BT1=$?
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event1 EV_KEY BTN_BASE2
JOY1_BT2=$?
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event2 EV_KEY BTN_THUMB2
JOY2_BT1=$?
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event2 EV_KEY BTN_BASE2
JOY2_BT2=$?
printf "\0337\033[H\033[0;32m--> Using directory $GAMESDIR - Waiting for joystick buttons to be pressed (J1: $JOY1_BT1$JOY1_BT2 - J2: $JOY2_BT1$JOY2_BT2) \r\033[m\0338" >/dev/ttyS0
done

echo "--> Buttons pressed, stopping Carousel" >/dev/ttyS0
# Stop the Carousel
until [ `ps | grep -e the64 | wc -l` -eq 1 ]
do
killall the64
done

# Wait for either joystick 1 or joystick 2 both menu button 4 and triange 1 both to be released again
# To prevent skipping directories
while [ "$JOY1_BT1$JOY1_BT2" = "1010" -o "$JOY2_BT1$JOY2_BT2" = "1010" ]
do
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event1 EV_KEY BTN_THUMB2
JOY1_BT1=$?
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event1 EV_KEY BTN_BASE2
JOY1_BT2=$?
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event2 EV_KEY BTN_THUMB2
JOY2_BT1=$?
/mnt/Carousel_Games/Games/Z_Other_Scripts/bin/evtest --query /dev/input/event2 EV_KEY BTN_BASE2
JOY2_BT2=$?


DO THE SAME THING AS BEFORE AND THEN SAVE IT..
DONE..
NOW THE BUTTONS SHOULD BE CHANGED TO WHAT BUTTONS YOU WANT TO USE.

IF THE BUTTON YOU WANT TO USE IN NOT THERE IN "THEC64 Joystick buttons.txt" THEN YOU WILL HAVE TO RUN EVTEST FROM XWM VIA SHELL AND
FIND THE NAME OF THE BUTTON FROM THAT AND PICKING THE DEIVCE FROM THE LIST TO WANT TO LOOK AT AND THEN PRESSING THE BUTTONS YOU NEED SO IT SHOWS
THEM IN THE TERMNAL WINDOW. YOU CAN SEE ME FIGGERING IT OUT ON THE THRED POSTS.
<---------------------------------------------------------------------------------------------------------------------------------------------->


THANKS GOES TO JEMOME(jj0) FOR HELPING AND PROVIDING THE CODE FOR THE BUTTONS AND GAMES BUTTON SWITCHER, THIS WOULD NOT BE POSSABLE WITHOUT IT.

HOPE YOU ENJOY THIS RELEASE(PCU V1.14) WE GOT THERE NOW I HOPE..

ANY PROBLEMS POST IN THREAD..

SPANNER.