Onboarding

General Onboarding

• If you haven't done so already fill in the recruitment form by reading here https://github.com/utra-robosoccer/soccerbot/wiki/Recruitment
• Download the discord app on your phone and computer and join the following discord channels All communication will be on discord so if you are not active, then there is no way to communicate with the team
  • Main UTRA Robosoccer discord https://discord.gg/vm3jveS32x
    • Change your nickname to your actual name
  • Robocup discord https://discord.gg/ymGbhwXWEw
    • Change your nickname to Actual Name [UTRA]
  • Webots discord (for webots questions) https://discord.gg/Vf8JrBYcN9
• Click here to book a meeting with Jason to introduce yourself (https://calendar.app.google/sNj6gNuEVXdHZQnj7)
• Read our team history on our website https://utra-robosoccer.github.io/soccerbot/
• Star our main GitHub repository https://github.com/utra-robosoccer/soccerbot (you cannot join the team if you don't!)
• Install mobile apps to communicate with the team
  • Discord mobile app (so we can reach you)
  • Github mobile app (software only) (so that you can see PRs and respond to github review requests)

Software Onboarding

Getting a computer and the right accounts

• Setup your Computer for development
  • Setup AnyDesk (Access each other and UTRA Computer)(Reference: http://deb.anydesk.com/howto.html)

  sudo wget -qO - https://keys.anydesk.com/repos/DEB-GPG-KEY | sudo apt-key add -
  echo "deb http://deb.anydesk.com/ all main" | sudo tee /etc/apt/sources.list.d/anydesk-stable.list
  sudo apt update
  sudo apt install anydesk

For Access to the UTRA Computer, Obtain credentials from https://docs.google.com/document/d/1eJVmYDuQD8JyMIl4DCIleO53GXAQwRqBPCAXFO6W6mQ/edit#

• You need a github account, if not create one, and after that ask your mentor to add you to the utra organization (https://github.com/orgs/utra-robosoccer/teams/utra)
• You need a discord account, after downloading the discord app, log in with that account and keep discord on so we can contact you through discord

Learning and setting up the software

Please doing the tutorials and readings in the following suggested order, in the middle of the tutorials it will show you how to setup the code. If you watch the playlist don't forget to do the readings in between as well. You can skip any videos_ if you already know it (etc git, ros)

• Video Tutorials (Complete playlist https://youtube.com/playlist?list=PLLgA_SIipbdwj_D7oYs_murQf_kxABOB2)
  • Introduction and Welcome - https://youtu.be/rnRYIpMj38o
  • Real World Competition Bangkok 2022 - CITBrains vs Rhoban https://youtu.be/zXyxvgWSAdQ
  • Robot Concepts - Rotations and Quaternions - https://youtu.be/zjMuIxRvygQ
  • Robot Concepts - Transformation matrices in robotics - https://youtu.be/4Y1_y9DI_Hw
  • Ubuntu Basics
    • Ubuntu Basics - Terminal Navigation - https://www.youtube.com/watch?v=vhZLTp6N4XA
    • Ubuntu Basics - Vim - https://www.youtube.com/watch?v=ggSyF1SVFr4
    • Ubuntu Basics - SSH - https://www.youtube.com/watch?v=v45p_kJV9i4
    • Ubuntu Basics - Python packaging https://www.youtube.com/watch?v=aEB_EcgTiQo
    • Ubuntu Basics - Apt https://www.youtube.com/watch?v=ECWKViCaI_A
  • ROS Reading 1 (Read Tutorial 1-2) - http://wiki.ros.org/ROS/Tutorials
  • Pycharm Tutorial 1 - https://youtu.be/56bPIGf4us0
  • Pycharm Tutorial 2 (Debugging) - https://youtu.be/sRGpvbhOhQs
  • Python OOP
    • Python OOP 1 - Intro - https://youtu.be/v_Jp11xqCzg
    • Python OOP 2 - Classes - https://youtu.be/jQiUOV15IRI
    • Python OOP 3 - Inheritance - https://youtu.be/H2SQrZK2nvM
    • Python OOP 4 - Overriding Methods - https://youtu.be/39m3rstTN8w
    • Python OOP 5 - Static Methods and class methods https://youtu.be/MpuOuZKWUWw
  • ROS Reading 2 (Read Tutorial 3-7, 8, 10, 12, 13) - http://wiki.ros.org/ROS/Tutorials
  • ROS Tutorial
    • ROS Tutorial 1 - Practical Intro to ROS Part 1 - URDF, SDF, ROS Nodes https://youtu.be/7rLXC4xvSGw (very long, skim through)
    • ROS Tutorial 2 - Practical Intro to ROS Part 2 - OpenCV and Navigation https://youtu.be/2-Taue1Ue_8 (very long, skim through)
    • Setting up the software 1 - Local setup - https://www.youtube.com/watch?v=N7EU7cwKCAo
    • Setting up the software 2 - Pycharm IDE - https://www.youtube.com/watch?v=w9ikf_1DIro
    • Pycharm Code With Me - https://youtu.be/Lq0fCMCK-Yw
    • Setup the source code using docker - https://youtu.be/QLhW7dL9Ic8
    • ROS Tutorial 3 - ROS Python libraries, Pytest https://youtu.be/JcGnTDql3JU
    • ROS Tutorial 4 - Debugging by attaching to processes https://youtu.be/Saz17Zc9RUs
    • ROS Reading 3 (Read Tutorial 17, 18, 19) - http://wiki.ros.org/ROS/Tutorials
    • ROS Tutorial 5 - Debugging with rosbags https://youtu.be/7zRTeEY8EWM
  • Git Tutorial
    • Git Tutorial 1 - Working with git, pull requests, and Github Action CI https://youtu.be/AAT6e1GbDiw
    • Git Tutorial 2 - Project Management and Issues on GitHub and how to use GitHub effectively https://youtu.be/r4YVn-LnFk0
    • Git Tutorial 3 - Actions, CI and debugging the CI https://youtu.be/gCJ9-mffSYA
    • Git Tutorial 4 - How to deal with submodules [git submodule ...] https://youtu.be/_ZDveRCPKuA
    • Git Tutorial 5 - I fucked up, now what do I do, [git stash, clean, reset, revert] https://youtu.be/Z9gMd4_ADqc
  • Docker
    • Docker Introduction - https://youtu.be/_dfLOzuIg2o
    • Docker Tutorial 1 - Dockerfile, docker images, layer caching, debugging docker builds - https://youtu.be/Txf8Clu2qkY
    • Docker Tutorial 2 - Docker Compose, Docker Compose inheritance - https://youtu.be/RA4xPPruAuE
  • Check out the basic GIT, Docker, ROS reference in the right menubar in this wiki
  • Sample Virtual Competition From last year - Starkit vs MRL-HSL https://youtu.be/_9q26QjDluw
  • Soccerbot Code
    • Read the software architecture - https://docs.google.com/presentation/d/10DKYteySkw8dYXDMqL2Klby-Kq4FlJRnc4XUZyJcKsw/edit?usp=sharing
    • Read the coding conventions - https://github.com/utra-robosoccer/soccerbot/wiki/Coding-Conventions
    • Understanding Soccerbot Code 1 - Webots and Game Controller https://youtu.be/bfsJFwryga4
    • Understanding Soccerbot Code 2 - Computer Vision Pipeline https://youtu.be/pjOoMTzA_8E
    • Understanding Soccerbot Code 3 - Localization Pipeline https://youtu.be/JwFqQIDc-Jc
    • Do a quick skim over the rulebook (https://humanoid.robocup.org/materials/rules/)
    • Understanding Soccerbot Code 4 - Strategy Pipeline https://youtu.be/dp2z-O_6g1s
    • Understanding Soccerbot Code 5 - Control Pipeline https://youtu.be/h_SGoccqtUI
  • Skim through the current list of issues with software https://github.com/orgs/utra-robosoccer/projects/8
  • Embedded only
    • Video Tutorial https://www.youtube.com/watch?v=hyZS2p1tW-g&list=PLEBQazB0HUyRYuzfi4clXsKUSgorErmBv
    • See Tutorials https://github.com/utra-robosoccer/soccerbot/tree/master/soccer_embedded/Tutorials

Mechanical Onboarding

Videos and readings

• Real World Competition Bangkok 2022 - CITBrains vs Rhoban https://youtu.be/zXyxvgWSAdQ
• Go through the documents in https://github.com/utra-robosoccer/soccerbot/wiki/Mechanical
• Do a quick skim over the rulebook (https://humanoid.robocup.org/materials/rules/)
• Look through main mechanical google drive https://drive.google.com/drive/folders/1jEmxCBgA9EnplJdfefU6PDawssxL868T?usp=sharing
• Watch Project Management and Issues on GitHub and how to use GitHub effectively https://youtu.be/r4YVn-LnFk0
• Skim through the current list of hardware issues https://github.com/orgs/utra-robosoccer/projects/10

Learn the basics of Fusion 360

• Download student Fusion 360 with UofT student account for free (https://www.autodesk.com/campaigns/education/fusion-360)
• Accept the invitation link for the Robosoccer folder from the project manager
• (Fusion Tutorial 1) https://www.youtube.com/watch?v=S6OUkn2Cksg
• (Fusion Tutorial 2) https://www.youtube.com/watch?v=j-CKrG_VCl0
• (Fusion Tutorial 3) https://www.youtube.com/watch?v=A5bc9c3S12g
• (Fusion Tutorial 4) https://www.youtube.com/watch?v=HXRMzJWo0-Q
• (Fusion Tutorial 5) https://www.youtube.com/watch?v=zS8dYA_Iluc
• Beginner webinar (Optional) - https://www.youtube.com/watch?v=VbSkwvZyU_0
• Assemblies 1 - https://www.youtube.com/watch?v=HBJMgkzkaas
• Assemblies 2 - https://www.youtube.com/watch?v=t41QmQszcbE

Look at CAD designs from other teams

• https://cad.onshape.com/documents/8c6aa9a8917f764cb7039c2d/w/af71e5083243affec9ac82a8/e/e42d9814ef6f704f62b6758c
• https://cad.onshape.com/documents/41654e89e61a392d020b728c/w/d555ceec170d351622b789de/e/4c9a04a707c36ac7ad2ca0f8
• https://github.com/citbrains/SUSTAINA-OP

Electrical/Embedded Onboarding

Videos for getting started

• (Electrical) PCB Design: https://youtu.be/aVUqaB0IMh4?si=79jVTChR1QIFOPH0, this video will walk you through all the steps to design PCB and get it manufactured
• (Embedded) Getting Started with STM32, you will need an stm32 dev board to follow along: https://youtu.be/dnfuNT1dPiM?si=dR9yZAzIus8Q6j74

Documentation

• Elec/Embedded Design Doc: https://docs.google.com/document/d/1OaDtFmGwTs78EjMmhFbBwc2YWBd2PL8v2DGxp1yrRf0/edit
• Embedded Guide: https://docs.google.com/document/d/1-Lx11kOfISMMCdLiMk1QhmruZnyk7oJTaH6psrwaGK8/edit

Leadership Onboarding

• Read through and go through the list of issues in the tasks and make sure you understand them completely or ask someone who knows about the issues (etc past leads) - https://github.com/utra-robosoccer/soccerbot/projects
  • Issues in the projects are linked to issues on the issue page in github (https://github.com/utra-robosoccer/soccerbot/issues)
• Understand prioritization from Eisenhower matrix - https://www.youtube.com/watch?v=tT89OZ7TNwc
• Scrum - https://www.youtube.com/watch?v=2Vt7Ik8Ublw
• Obtain access to all the passwords document from the previous lead
• Once you obtain the email credentials, add your appointment schedule to the [email protected] google calender and then post the appointment schedule booking link on the home page https://github.com/utra-robosoccer/soccerbot/wiki
• Go through the list of team members, see the Detailed Team Member Information link and know who is in your team. Meet with everyone and get to know each other
  • https://github.com/utra-robosoccer/soccerbot/wiki
  • Inform them about your booking schedule link