ev3-ev3dev-jessie-2015-05-20-release

dlech · dlech · commit bf1d7b2f1c4d · 2015-05-20T21:13:58.000-05:00
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -7,24 +7,21 @@ categories: docs getting-started
 {:toc}
 
 So you are ready to try out ev3dev. Great!. Here are step-by-step instructions
-to get ev3dev up and running on your EV3.
+to get ev3dev up and running on your EV3 or Raspberry Pi.
 
 First, here are the things you need before starting:
 
-* A LEGO MINDSTORMS EV3 Intelligent Brick (obviously).
-* A [microSD] or [microSDHC] card (2GB - 32GB). [microSDXC] is not supported (you
-  might be able to get it to work, but it will operate at reduced speed).
-  Cards larger than 32GB will not work!
-  Also look at the [speed class rating]. Class 10 is the fastest, but
-  slower speeds will work just fine. Ultra High Speed (UHS) classes are not
-  supported (again, they should work, but not at the rated speed).
+* A LEGO MINDSTORMS EV3 Intelligent Brick or Raspberry Pi (any model).
+* A [microSD] or [microSDHC] card (2GB or larger). [microSDXC] is not supported
+  on the EV3. **All cards larger than 32GB will not work with the EV3!**
 * A computer with an adapter for the SD card. You will need administrator user
   permissions on this computer.
-* A way to communicate with the EV3. This can be one of the following:
+* A way to communicate. For the EV3, this can be one of the following:
     * USB cable (the one that comes with the EV3)
     * USB WiFi dongle
     * USB Ethernet (wired) dongle
     * Bluetooth
+  For Raspberry Pi you will need to use the wired Ethernet connection first.
 
 ---
 
@@ -36,7 +33,11 @@ First, here are the things you need before starting:
 ## Step 1: Download the latest ev3dev image file
 
 Releases are posted [on GitHub][releases]. Follow the link and download the latest
-**Test Release** image file. Downloading the `.zip` file is recommended for
+**Test Release** image file for your hardware. Releases for LEGO MINDSTORMS EV3
+start with `ev3-`, Raspberry Pi starts with `rpi-` and Raspberry Pi 2 starts
+with `rpi2-`.
+
+Downloading the `.zip` file is recommended for
 Windows/Mac and the `.xz` file is recommended for Linux. The `.xz` is smaller,
 but it requires that you have additional software installed on Windows/Mac to
 decompress it (such as [7-Zip] on Windows).
@@ -69,19 +70,28 @@ of the information there is applicable to ev3dev.
 
 Put the SD Card in your EV3 and power it on. At first, you will see the
 MINDSTORMS boot splash and the red LEDs will be on. This is immediately
-followed by the ev3dev boot splash and the LEDs changing to orange. The left
-LED indicates CPU activity and the right LED indicates disk (SD card) activity.
+followed by the ev3dev boot splash and the LEDs changing to orange. The
+LEDs indicate disk (SD card) activity.
+
+Note: If you are using Raspberry Pi hardware without a screen, just wait for
+the Activity LED to stop flashing, then go to the next step.
 
-The first boot will take a little longer than subsequent boots because the EV3
+After one or two minutes, the screen will go blank. This happens on the first boot
+only. The first boot takes a little longer than subsequent boots because the EV3
 has to create a unique SSH host ids and take care of a few other housekeeping
-items.
+items. After another minute or two, you will see the *brickman loading...* screen.
 
 When the boot is complete, the LEDs will turn green and you will see something
 like this on the screen:
 
 {% include screenshot.html source="/images/brickman/main-menu.png" %}
 
-You will notice the number in the battery in the upper right corner. This displays the remaining voltage of the power supply. It is not possible to calculate an accurate percent value of the remaining energy, so this value is choosen. If the voltage drops below 5V the brick will turn off. All not saved data may be lost. Keep in mind, that is may take a much longer time from 8V to 6.5V than from 6.5V down to 5V!
+You will notice the number in the battery in the upper right corner. This
+displays the remaining voltage of the power supply. It is not possible to
+calculate an accurate percent value of the remaining energy, so this value is
+chosen. If the voltage drops below 5V the brick will turn off. All not saved
+data may be lost. Keep in mind, that is may take a much longer time from 8V to
+6.5V than from 6.5V down to 5V!
 
 **Troubleshooting tips if your EV3 won't boot:**
 
@@ -108,15 +118,14 @@ you want to use and on the OS of your host computer, so pick the one that applie
        after you power on Bluetooth.
     * [Connecting to the Internet](../tutorials/connecting-to-the-internet-via-bluetooth) tutorial
 
-## Step 4.5: Make sure the firstboot script ran correctly
-
-Recently, some users have reported problems that are related to the firstboot script not running correctly.
-Please verify that the items in [this list](https://github.com/ev3dev/ev3dev/issues/267#issuecomment-73917167)
-are correct. If not, leave a comment to help us figure out what is going wrong.
+Note: For Raspberry Pi you must use the wired Ethernet port to connect for the
+first time. The default host name is `ev3dev-rpi` or `ev3dev-rpi2` depending
+on which model you have. You can setup additional connections using the
+`connmanctl` command.
 
 ## Step 5: First things to do with ev3dev
 
-Here are some suggestions of some things you should do to get your EV3 setup.
+Here are some suggestions of some things you should do to get ev3dev setup.
 
 ### Change your root password
 
@@ -225,7 +234,5 @@ button from any screen in brickman. This will open a dialog where you can select
 [microSD]: https://en.wikipedia.org/wiki/Secure_Digital#SD
 [microSDHC]: https://en.wikipedia.org/wiki/Secure_Digital#SDHC
 [microSDXC]: https://en.wikipedia.org/wiki/Secure_Digital#SDXC
-[speed class rating]: https://en.wikipedia.org/wiki/Secure_Digital#Speed_class_rating
 [releases]:https://github.com/mindboards/ev3dev/releases
 [7-Zip]: http://www.7-zip.org/
-[Getting Started v2]: https://github.com/ev3dev/ev3dev/wiki/Getting-started-v2
diff --git a/news/_posts/2015-05-20-ev3-ev3dev-jessie-2015-05-20-release.md b/news/_posts/2015-05-20-ev3-ev3dev-jessie-2015-05-20-release.md
@@ -0,0 +1,86 @@
+---
+author: "@dlech"
+title: "Image release ev3-ev3dev-jessie-2015-05-20"
+---
+
+This image release contains updated packages and some fixes from the previous
+ev3dev-jessie-2015-05-01 release. For starters, we are tacking on `ev3-` on to
+the front of the release name so that you know this is for LEGO MINDSTORMS EV3
+hardware. This way you can tell it apart from the `rpi-` and `rpi2-` releases
+that are for Raspberry Pi hardware.
+
+[Download] and [release notes].
+
+Note: If you have already installed the ev3dev-jessie-2015-05-01 release, you
+don't need to install this new release. `apt-get update; apt-get upgrade; apt-get dist-upgrade`
+is (hopefully) sufficient to get all of the changes.
+
+# Kernel release v3.16.7-ckt11-5-ev3dev-ev3
+
+There are a couple of breaking changes in this kernel release:
+
+* The `inverted` state of the motor `polarity` properties has been changed to
+`inversed` to match the mainline kernel PWM drivers.
+* The names of the LEDs have been changed. They now look like `ev3-left0:red:ev3dev`.
+
+Another interesting change is that we have changed the kernel timer frequency
+(CONFIG_HZ) from 100Hz to 1000Hz. This may improve some low-latency applications.
+Let us know if you notice a change.
+
+Also, there is now [BrickPi] support. "But I thought BrickPi was just for Raspberry Pi?",
+you might say? Well, not anymore! It is possible to attach the BrickPi to an EV3
+either using a USB serial adapter cable or via one of the input ports. You just
+have to make your own cable and you can use the BrickPi as IO expansion for your
+EV3! BrickPi of course also works with ev3dev on Raspberry Pis as well.
+
+The latest stable upstream patches from the Canonical Kernel Team are included as well.
+
+See the [ev3dev changelog] and the upstream [ckt11 changelog] for more info.
+
+# Other Packages
+
+
+## brickman 0.6.1
+
+Updated to use the changes in the LED names. Also changed Wi-Fi connection timeout
+from 2 minutes to 5 minutes.
+
+## flash-kernel 3.35ev3dev3
+
+EV3 board definitions have been included in the `flash-kernel` package instead
+of the separate `ev3dev-flash-kernel` package.
+
+## ev3dev-base 10.0
+
+This package is now obsolete and is not included in the ev3-ev3dev-jessie-2015-05-20
+release. It is a meta package that depended on lots of `ev3dev-*` packages. These
+have been consolidated into new packages: `ev3-config`, `ev3-systemd` `ev3dev-rules`
+`firmware-ev3` and `fonts-tom-thumb`.
+
+## ev3-config 1
+
+Contains some configuration files related to serial port debugging and disabling
+console blanking.
+
+## ev3-systemd 2
+
+Provides systemd unit files and udev rules needed to make some of the EV3 hardware work.
+
+## ev3dev-rules 1
+
+Provides platform independent udev rules for ev3dev drivers.
+
+## firmware-ev3 1
+
+Contains the firmware files needed to make Bluetooth and two of the UART ports work.
+
+## fonts-tom-thumb 1
+
+A tiny 4x6 font for cramming as much as possible on the EV3 screen.
+
+
+[Download]: https://github.com/ev3dev/ev3dev/releases/tag/ev3-ev3dev-jessie-2015-05-20
+[release notes]: https://github.com/ev3dev/ev3dev/blob/master/release-notes/ev3-ev3dev-jessie-2015-05-20.img-release-notes.md
+[ev3dev changelog]: https://github.com/ev3dev/ev3dev-kpkg/blob/ev3dev-jessie/ev3dev-ev3/changelog
+[ckt11 changelog]: https://lists.ubuntu.com/archives/kernel-team/2015-May/057147.html
+[BrickPi]: http://www.dexterindustries.com/BrickPi/
