Annotate which APIs are not available in the simulator

Author: PeterJCLaw

programming/arduino/custom_firmware.md

@@ -12,6 +12,10 @@ On this page we talk specifically about Arduinos.
 However this page is applicable to opening any device that shows up as a serial port.
 </div>
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 
 ## Ignoring a device
 

programming/arduino/extended_sr_firmware.md

@@ -5,6 +5,10 @@ title: Arduino extended firmware
 
 # Arduino with extended SR firmware
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 You may wish to extend the SR firmware with additional functionality.
 This will allow you to continue using the commands already provided by the SR firmware (e.g. `digital_read()`),
 which means any existing robot code you have won't need modifying very much.

programming/cheat_sheet.md

@@ -124,6 +124,10 @@ robot.motor_board.motors[1].power = -1
 
 ### Special motor values
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 Setting a motor to `BRAKE` is equivalent to power level `0`.
 
 ~~~~~ python
@@ -153,6 +157,10 @@ You can also set the position to `0`, which is the approximate centre.
 
 ### Taking a photo
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 It can sometimes be useful to save a photo of what markers the robot can see:
 
 ~~~~~ python
@@ -161,6 +169,10 @@ robot.camera.save("my-photo.jpg")  # Save my-photo.jpg to the USB drive
 
 ### Capturing an openCV array
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 Take a photo using the webcam, and return the image data as an OpenCV array:
 
 ~~~~~ python
@@ -183,6 +195,7 @@ for marker in markers:
     marker.id  # The ID of the marker
     marker.size  # Physical size of the marker in mm.
 
+    # Position of the marker on the image (physical kits only)
     marker.pixel_centre  # The co-ordinates of the centre of the marker
     marker.pixel_corners  # A list of corners of the marker
 

programming/leds.md

@@ -8,6 +8,10 @@ title: Brain Board LED API
 Brain Board LED API
 ===================
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 The KCH board provides diagnostic information about the state of your robot through a collection of preconfigured and user-controllable LEDs.
 It is part of the [Brain Board](/docs/kit/brain_board) assembly and will be found attached to the top of the Raspberry Pi.
 

programming/motors.md

@@ -124,6 +124,10 @@ print(robot.motor_boards["srABC1"].motors[0].power)
 Special Values
 --------------
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 In addition to the numeric values, there are two special constants that can be used:
 - `BRAKE`
 - `COAST`
@@ -151,6 +155,10 @@ robot.motor_boards["srABC1"].motors[0].power = COAST
 Motor currents
 --------------
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 The Motor Board can also measure the current being drawn by each of the ports on the board.
 This value is measured in amps.
 

programming/servos.md

@@ -58,6 +58,10 @@ print(robot.servo_board.servos[1].position)
 Disabling servo outputs
 -----------------------
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 Setting a position to `None` will disable an output.
 This is the state all the servo outputs are in when the board turns on, where no servo pulses are being sent to the outputs.
 
@@ -70,6 +74,10 @@ robot.servo_board.servos[5].position = None
 Extended servo range
 --------------------
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 For an RC servo the angle of rotation is determined by the width of an electrical pulse on the control wire.
 A typical servo expects to see a pulse every 20ms, with a pulse width between 1ms and 2ms.
 Our API will take the position provided (between -1 and 1) and map it to the correct pulse width.

programming/vision/index.md

@@ -49,6 +49,9 @@ Try pausing movement while taking an image.
 
 save
 :   Take a photo using the webcam, draw a box around the detected markers and save it to the provided location.
+    <div class="info">
+      This function is only available on the physical robot kits.
+    </div>
 
 ~~~~~ python
 from sr.robot3 import *
@@ -60,6 +63,9 @@ robot.camera.save(robot.usbkey / "initial-view.jpg")
 
 capture
 :   Take a photo using the webcam, and return the image data as an OpenCV array.
+    <div class="info">
+      This function is only available on the physical robot kits.
+    </div>
 
 ~~~~~ python
 import cv2
@@ -108,9 +114,15 @@ size
 
 pixel_centre
 :   A [`PixelCoordinates`](#pixel-coordinates) object describing the position of the centre of the marker in the image.
+    <div class="info">
+      This attribute is only available on the physical robot kits.
+    </div>
 
 pixel_corners
 :   A list of 4 [`PixelCoordinates`](#pixel-coordinates) objects, each representing the position of a corner of the marker in the image.
+    <div class="info">
+      This attribute is only available on the physical robot kits.
+    </div>
 
 position
 :   A `Position` object describing the position of the marker.
@@ -151,6 +163,10 @@ orientation
 
 ### Pixel Coordinates
 
+<div class="info">
+  This documentation refers to a feature which is only available on the physical robot kits.
+</div>
+
 A named tuple of `x` and `y` coordinates for the point, in pixels relative to the top left of the image.
 
 ~~~~~ python