User Manual
Contents
1. are no settings for this product that can be configured during normal usage To change robot ID l SOOS ON OY ee a Power off the system Power off robots Remove backup battery Remove protective PCB covering Change DIP switches Replace PCB covering Replace backup battery Power on robots and place on field Power up the field https engineering purdue edu ece477 Page 11 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 5 0 Troubleshooting Instructions If you have any problems or questions that are not covered in this document please contact our help line at 765 555 1337 or find the contact information of our team at https engineering purdue edu 477grp 1 Problem The robot is not connected to the network Solution Power off the grid turn off the robot power remove the backup battery Replace battery turn on robot power power grid back on For the other working robots leave in place The backup battery should keep settings consistent Problem The irc_bot rake task will not connect to twitch IE No commands coming in Solution The twitch credentials are old 1 Update twitch passwords 2 Update the env file with the new oath password acquired from twitch apps http twitchapps com tmi 3 Close and restart all webserver applications 4 Iftwitch continues to fail to connect make sure all irc channels listed in the source described in the configuration section are lower case start2. ECE 477 Digital Systems Senior Design Project User Manual Year 2015 Semester Spring Team 1 Creation Date April 15 2015 Member 1 Nathan Tornquist Member 2 Mark Harlan Member 3 TJ Root Member 4 Joshua Hannan https engineering purdue edu ece477 v 1 0 Project Twitch Plays ECE477 Last Modified April 22 2015 Email ntornqui purdue edu Email harlanm purdue edu Email roott purdue edu Email hannan purdue edu Page 1 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 1 0 Product Description A highly scalable educational tool for students and enthusiasts of all ages Twitch Plays Robot Soccer is a game that everyone can enjoy All you need is an internet connection a power outlet and at least 2 players with computers to enjoy this collaborative robotics experience In Twitch Plays Robot Soccer participants connect to a robot stream via Twitch tv a live video streaming website to observe and control the robots as they play a game of soccer They do this by typing pre defined commands into the chat window which are received and executed by the robots The best part is that there is no limit on the amount of players that can play as long as each one has a device that can access the internet This product is great for exercises in teamwork or simply as entertainment The beauty of the design is that robots can be easily added or removed with ease allowing the game to quickly scale In addition to the flex
3. f 12 ECE 477 Digital Systems Senior Design Project v 1 0 2 2 Enclosure Figure 2 2 1 This is the assembled playing field There is aluminum mesh attached to the top of the plastic enclosure and stainless steel sheet attached to a piece of wood on the bottom to serve as the ground There is an opaque covering on the enclosure to prevent dust The lid which includes the top and the side walls is removable Figure 2 1 2 This is the diagram of the playing field with the goals attached The specific score display attached to the physical game depends on the model ordered The base model does not include a physical display and instead requires the user to attach their own display to the included HDMI port if a display is desired Score can be found live at any time through the associated Twitch feed https engineering purdue edu ece477 Page 5 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 2 3 Twitch Stream ece477group1 Enjoying the show Follow this channel to get notifications when it goes live g Bot 1 ECE477Group1 playing Purdue Robot Soccer OFFLINE You can now follow your favorite games Find out more Share BE 40 3 Figure 2 3 1 This is a screenshot of the Twitch stream for the robot with id 1 This was taken from http www twitch tv ece477group1 The stream for robot 2 can be found at http www twitch tv ece477group1 2 In the center there is a screen that wi
4. ibility provided by the robots the field packaged with the product is a base model 4 x 4 Any field with a grounded floor plane and 12v VDD plane roughly 12 above the ground plane will work This means that you can start with the base design or create your own A more complicated field layout could turn a soccer game into a racetrack or more with ease https engineering purdue edu ece477 Page 2 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 2 0 Product Illustrations 2 1 Robot Drawings Figure 2 1 1 These are CAD illustrations of the assembled robot isometric left and rear right The circuit board is nested and there is an antenna projecting from the top that maintains contact with the aluminum mesh on the lid to receive power Figure 2 1 2 This is the front view of both robots with circuit boards attached The gold robot has its paddle and the servo that runs it clearly visible The black robot has both wheel motors clearly visible inside the chassis https engineering purdue edu ece477 Page 3 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 Figure 2 1 3 This is the assembled robot with a game ball for scale This photograph shows the motor connectors and the individual components on the PCB The final product will have a covering for the circuit board that has the antenna attached as mentioned in the description of Figure 2 1 1 https engineering purdue edu ece477 Page 4 o
5. ing with a 5 Iftwitch continues to fail to connect make sure the site is online 6 If problems continue contact the distributor of Twitch Plays Robot Soccer Problem Unable to stream twitch channel Solution Update twitch channel key from twitch tv and retry Update streaming software Problem Cannot connect to webserver Solution Make sure the webserver is given the ip address 192 168 1 7 and that the rails server is running with the flag b 192 168 1 7 Problem Feed frozen on web feed Solution Refresh the feed web page locally If the problem persists restart the field raspberry pi and refresh the page again Remember restarting the field requires reopening the score display Problem The robot or enclosure breaks under normal usage Solution This product is covered by a 1 year 1000 mile limited warranty Please contact our help line at 765 555 1337 to receive information about returning or repairing your product https engineering purdue edu ece477 Page 12 of 12
6. ll display video feeds from the arena and a score box On the right users can input chat messages that will be sent as commands to the robot The specific URL of the Twitch page that your product uses will be based on the settings that are selected during the installation See Section 3 2 https engineering purdue edu ece477 Page 6 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 3 0 0 Setup Instructions Follow the order shown in section 3 0b Each step is further explained below Step 1 is shown in 3 1 step 2 in 3 2 and so on Please consult the end of this document for troubleshooting assistance 3 0 1 Setup Order 1 SON es Configure Router Install Configure Webserver Setup Enclosure Configure Robots Configure Twitch Streams Announce Active Game Attach Score Display Optional 3 1 Configure Router Currently the robots and field look for a local WiFi network with the following information ssid steelmesh pass wittytrain security wpa2 It is essential that that connection information is used as the robots and field all search for that network You cannot configure an alternative network at this time as this system depends on dedicated IP addresses and they need to be available 3 2 Install Configure Webserver l toe pee 7 8 9 Install ruby 2 1 2 Download Twitch Plays Robot Soccer application from github com Tornquist steelmesh Run bundle install from the application di
7. n with the username pi and password raspberry Open the included internet browser Navigate to 192 168 1 7 3000 scores https engineering purdue edu ece477 Page 9 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 4 0 Usage Instructions 4 1 Normal Usage 1 Type commands into the Twitch chat stream 2 Each robot will get the next command from the queue and execute it 4 2 Gameplay Commands These commands can be entered in the Twitch TV chat feed associated with each robot Each organization needs to set it s own Twitch login and channel name On the chat feed for a given channel the following commands will be sent to the robot Everything else said will be displayed to other users online but will not be sent to the robot Use the paddle to kick the ball 4 3 Updating the Webserver Software 1 Close the rails server Close the irc_bot Close the redis server Run git pull from the main application directory Run bundle update Start the irc_bot Start the webserver and bind to 192 1681 7 Start redis Refresh all webpages used for streaming SO So Se ee https engineering purdue edu ece477 Page 10 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 4 4 Scoring The score for each team will update when a ball goes into the goal and hits the button The score resets to zero when it hits ten To reset the score press the button on the enclosure labeled Reset Score 4 5 Changing Settings There
8. rectory Install redis Create a file called env in the root application folder with the following contents TWITCH_USER TWITCH USER NAME HERE TWITCH_PW TWITCH_OATH ID Change line 16 of lib tasks steelmesh rake to the desired list of channels to monitor on Twitch May require creating a Twitch account for each robot stream Change line 33 of lib tasks twitch_helper rb to include the desired channel of bot 1 Acquire the local ip 192 168 1 7 Start the redis server redis server 10 Start the twitch irc bot rake steelmesh irc_bot 11 Start the rails server with rails s b 192 168 1 7 https engineering purdue edu ece477 Page 7 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 3 3 Setup Enclosure 1 a ad E ad 8 9 Plug in a keyboard and mouse to the exposed usb ports Connect local display screen with exposed hdmi plug Connect all three plugs to 120v wall power Log in on the screen with user pi and pass raspberry Open up a gui with startx Open a terminal Navigate to the pi user folder and start the field monitoring with sudo python score_monitor py Open up an internet browser Navigate to 192 168 1 7 3000 scores 10 Resize window to display in an acceptable manner 3 4 Configure Robots l i 3 4 Set the on chip DIP switches to the appropriate device ID Consult the previous section for the acceptable IDs for each paddle type Place the robot on
9. the field Adjust power wiring to make sure there is firm contact with the ground and power plane Turn robot on 3 5 Configure Twitch Streams l E Oe a Use the accounts created for the channels the webserver was configured for Obtain the stream keys for each account Install a broadcasting software for your webserver OS OBS is recommended for OSX Open 192 168 1 7 3000 streams field in a browser Open 192 1681 7 3000 scores in a browser Configure the software to share the webcam streams and the score data to each appropriate twitch feed 3 6 Validate System 2 With all systems running type a command in twitch irc feed commands listed below Watch rake logs for the irc bot to identify the command If successful the irc_bot is working Watch server logs for request for command If successful the robot WiFi is working properly Monitor the robot If successful the robot is working Press each score button and validate that the score changes Press the reset score button https engineering purdue edu ece477 Page 8 of 12 ECE 477 Digital Systems Senior Design Project v 1 0 3 6 Announce Active Game Post the links to the Twitch pages on your company website so that users can interact with the Twitch system 3 7 Attach Score Display Optional l ON a a Connect a monitor to the field using the available HDMI port Connect a keyboard and mouse to the available USB ports Restart the field Log i
Download Pdf Manuals
Related Search