Merge pull request #370 from srobo/kjk/wifi

Update WiFi docs

Author: raccube

_data/sidebar_tree.yaml

@@ -30,6 +30,8 @@ tree:
       title: Servo Board
     - url: /kit/safety-regulations
       title: Safety Regulations
+    - url: /kit/wifi
+      title: WiFi
   - url: /programming/
     title: Programming
     tree:

images/content/kit/remote-interface/logs-screen.png

@@ -6,69 +6,56 @@ title: WiFi
 WiFi
 ====
 
-The WiFi dongles provided with your kit allow you to interface with and debug your robot.
+The Raspberry Pi that makes up your kit's brain board contains a WiFi radio which allows you to interface with and debug your robot.
 You can connect to your robot using any WiFi capable device (laptop, tablet, phone, etc.)
 
 Connecting to Your Robot
 ------------------------
 
-First, ensure that the WiFi dongles supplied with your kit are plugged into your robot.
-Once you have the WiFi dongles connected, plug in a USB memory stick and turn your robot on.
-
-During the boot process you should notice a green LED begin to flash on one of the WiFi dongles.
-Your robot has now set up its very own WiFi network! It'll be called `robot-XXX`, where `XXX` is
-your team's TLA.
+During the boot process you should notice the green LED on the KCH (the board on top of the Pi) labelled "WiFi" turn on.
+Your robot has now set up its very own WiFi network! It will initially have a name starting with `robot-ZZZ` followed by some random numbers.
 
 You can now connect to your robot in the same way you normally connect to a WiFi network.
-You will need a WiFi key to be able to connect and you can find this inside any robot.zip
-that you have exported from the IDE. Just unzip the robot.zip and have a look inside `wifi.yaml`.
+You will need a WiFi key to be able to connect and you can find this inside `robot-settings.toml` on the USB drive containing your code.
 
-Note that, because the information for your robot's WiFi network is stored inside the robot.zip,
-the WiFi network will disappear when you unplug the USB memory stick. It will reappear a few moments
-after you plug the USB memory stick into your robot.
+These details can also be printed using:
+~~~~ python
+R.print_wifi_details()
+~~~~
 
-If you are having any problems connecting to your robot, just head on over to the [forum]({{ site.url }}/forum)
+If you are having any problems connecting to your robot, just head on over to the Discord
 and ask for help.
 
-Interacting With Your Robot
----------------------------
+Using the robot interface
+-------------------------
 
-Once you have a WiFi connection, visit `http://robot.sr` in a web browser to see the robot interface.
+Once you have a WiFi connection, visit `http://robot.lan` in a web browser to see the robot interface.
 
 The robot interface gives you the ability to remotely start the code on your robot,
 as well as view the logs.
 
-<div class="info" markdown="1">
-The stop button that appears after starting your code is currently not functional.
-</div>
+![The robot interface on desktop]({{ site.baseurl }}/images/content/kit/wifi_interface.png)
 
-### Setting up the Robot's Environment
+### Viewing logs
 
-![The robot interface's set up screen]({{ site.baseurl }}/images/content/kit/remote-interface/set-up-screen.png)
+The robot interface allows you to see all messages from your code sent by `print(...)`
+statements (and anything else that outputs to standard output or standard
+error). It will also show messages from the initialisation of the robot's
+hardware, as well as any errors that occurred when running your code.
 
-When you first navigate to the robot interface you are presented with the Set up page.
-This page allows you to select the starting zone of your robot, as well as
-whether it is running in development mode or competition mode. Changing the
-starting zone allows you to test how your robot handles being started in a
+You can also see your robot's logs on the USB stick, in a file called
+`log.txt`.
+
+### Setting up the Robot's Environment
+
+The toolbar present at the top of the page, or bottom of the page on mobile, allows you to change the robot's starting zone and mode.
+Changing the starting zone allows you to test how your robot handles being started in a
 different zone.
 
+The WiFi interface will only be fully accessible when your robot is started in dev mode and will be restricted in competition mode.
+
 Changing to competition mode causes the development markers to be unreadable,
 and instead reads the competition markers, which are different. Therefore, you
 should keep your robot in development mode.
 
-You cannot use this screen when code is running.
-
-### Logs Screen
-
-![The robot interface's logs screen]({{ site.baseurl }}/images/content/kit/remote-interface/logs-screen.png)
-
-This screen allows you to see all messages from your code sent by `print(...)`
-statements (and anything else that outputs to standard output or standard
-error). It will also show messages from the initialisation of the robot's
-hardware, as well as any errors that occurred when running your code.
-
-You can press the "Jump to bottom" button to scroll right to the bottom of the
-logs, to see the most recent entries in a long file.
-
-You can also see your robot's logs on the USB stick, in a file called
-`log.txt`.
+Changing this applies from the next time your code runs.

images/content/kit/remote-interface/set-up-screen.png

@@ -337,7 +337,7 @@
             ]
         },
         "motor-programming": {
-            "question": "Please test the Motor with the <a href=\"ROOT_URL/kit/wifi\" target=\"_blank\">WiFi</a> interface. Does the Motor respond to the interface?",
+            "question": "Please try replacing your code with sample code from the <a href=\"ROOT_URL/kit/motor_board\" target=\"_blank\">Motor Board documentation</a>. Does the motor respond?",
             "answers": [
                 {
                     "answer": "Yes",
@@ -408,7 +408,7 @@
             ]
         },
         "servo-programming": {
-            "question": "Please test the Servo with the <a href=\"ROOT_URL/kit/wifi\" target=\"_blank\">WiFi</a> interface. Does the Servo respond to the robot interface?",
+            "question": "Please try replacing your code with sample code from the <a href=\"ROOT_URL/kit/servo_board\" target=\"_blank\">Servo Board documentation</a>. Does the servo respond?",
             "answers": [
                 {
                     "answer": "Yes",