diff --git a/source/images/overview.png b/source/images/overview.png new file mode 100644 index 0000000..bb28118 Binary files /dev/null and b/source/images/overview.png differ diff --git a/source/images/vsix.png b/source/images/vsix.png new file mode 100644 index 0000000..9ebbbb7 Binary files /dev/null and b/source/images/vsix.png differ diff --git a/source/startinstall.rst b/source/startinstall.rst index 5f37467..a4b929e 100644 --- a/source/startinstall.rst +++ b/source/startinstall.rst @@ -1,56 +1,67 @@ +.. warning:: + + None + - *** + - *** + Installation =================== -.. note:: - - -Overview ------------------------------------------------------------ -.. todo:: - Generic overview + +This page shows how you prepare your computer and the EV3 brick for writing and running Python programs. The final configuration is shown in the figure below. + + +.. image:: images/overview.png What do you need? -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - - -.. todo:: - - - A micro SD card and card reader - - - Specs - - Windows 10 or Mac OS computer - - Mini-USB cable - -What is the SD card for? -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Installing Python for EV3 ----------------------------------------------------------- +To get started writing Python programs for your robot, you need the following items: + +- a Windows 10 or Mac OS computer +- a micro SD card and card reader +- a mini-USB cable (comes with the EV3 kit) + +You'll need internet access to complete the steps on this page. While programming your robots afterwards, internet access is not required. + + Preparing your computer -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +----------------------------------------------------------- -.. todo:: +.. note:: - - A micro SD card and card reader + - - Specs - - Windows 10 or Mac OS computer - - Mini-USB cable +You will be writing your Python programs using Visual Studio Code. You can download, install, and configure this program using the steps below. + +1. Download, install, and open `Visual Studio Code `_. +2. Download the `Pybricks extension `_. Follow the steps in the diagram below to install it. +3. Download the `EV3 Python extension `_. Follow the steps in the diagram below to install it. +4. Close Visual Studio Code and open it again to activate the extensions. + +.. image:: images/vsix.png Preparing the SD Card -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +----------------------------------------------------------- + +You will now follow a series of steps to download and install the EV3 Python firmware onto your micro SD card. + + +1. Download the `EV3 Python firmware `_ and save it in a convenient location. +2. Download and install `Etcher `_. This is the program for installing the firmware file on your micro SD card. +3. Insert the micro SD card into your computer or card reader. +4. Launch the etcher program and follow the steps on your screen to install the firmware you have just downloaded. Do not remove the card until the installation process is complete. +5. Put the micro SD card in the SD card slot of the EV3 brick. + .. todo:: - - A micro SD card and card reader - - - Specs - - Windows 10 or Mac OS computer - - Mini-USB cable + - images of the etcher process + - image of inserting an SD card into the brick + - write the following sections Using the EV3 brick