debian is the recommend distribution now. (not ubuntu, not angstrom, not others, even though they probably work, too.) yet, I found the official debian 7.5 standard releases to be too finicky. I always got something different and weird. half the time it would just blink to tell me that it would access both uSD and eMMC, half the time it would stop with all four LEDs black. sometimes it got stuck at its hdmi conversation. once or twice, I got a red-letter X screen telling me that it was flashing, but it never got far even then. in contrast, when I tried the new console flasher release, debian 7.7, I had instant success on both rev B and rev C boards. so, let me highly recommend 7.7.
I recommend the lxde image, which you can find when you search for its md5sum, f93a8cdaec59a06198fbc9095320cc2d . in future month, just look for BBW/BBB (All Revs), Flasher: lxde: (xyzMb Free on 2GB eMMC).
* on your linux laptop computer: download your chosen img.xz file, check the md5sum on the .img.xz file, use unxz on the image file, make sure that it is not mounted, and then "burn-dd" it. I recommend downloading the file into its own directory.:
# umount /dev/mmcblk0p1 ## if it is mounted
# unxz *.img.xz ## assuming it is the only such file in the directory
# dd bs=1M if=*.img of=/dev/mmcblk0
# sync
(where /dev/mmcblk0 is the flashable port to your uSD device location on your desktop or notebook).
the dd should report that you copied about 1.8GB. on a $10 uSD premium 32gb card (300x), this takes about 90 seconds. then sync (just to make sure) before you remove it.
I usually then remove and reinsert the disk to make sure that at least one linux partition shows up. if you do this, umount or eject it cleanly right after. on the bbb console images, there is only one partition, called rootfs, which is an ext4. on the lxde images, there are two partitions. again, make sure you umount these after your quick-test.
* unpower your BBB. insert your burned uSD card in the BBB. you may need to hold the button near the card slot (though my BBBs seem to want to boot from the uSD slot by default), and power up the BBB. if the BBB does not power up, try pressing the power-on button and/or reset buttons where the four LEDs are. (after the flash, you may need to do this again, too, as power-insert by itself may not always start it.)
* the USB power supply on a dual-head USB cable may or may not be enough. Robert recommends a 2A power supply. I have had luck with 1A. for flashing, I usually also remove the hdmi display and keyboard/mouse (and of course ethernet) to conserve power. I just have one cable, the power, to the BBB.
* the display is active during the flash and can be connected to see the progress. it seems to work, even if you only have USB power to the BBB, but you have been warned that this is taking chances with power provision.
* with a fast sdhc card, flashing the uSD image to the eMMC can take as little as 5-15 minutes.
* during the flashing, the LEDs blink in a very succinct pattern back and forth. at the end, four solid LEDs means you succeeded. four black LEDs mean you failed. on the HDMI console, it will state when it has halted.
* make sure to remove your uSD card NOW. otherwise, you may be reflashing again!
* if you reboot, for the console images, you should see a nice penguin at the top left of the display. the boot should take about one minute in total. the default username (debian) and password (temppwd) are displayed on the hdmi login screen. however, root (without password) also works.
NOTES
* the USB gadget works out of the box on the lxde image 2014-11-19 (md5= f93a8cdae...). the USB gadget port comes alive pretty far towards the end of the boot. this means that when you boot up the BBB, on a connected PC, the BBB will show up as a 1d6b:0104 linux foundation multifunction composite gadget, which means that your connected PC will try to mount it like an external USB drive. also, the lxde image supports network connections into 192.168.7.2. all of this is without configuration and effort.
* the USB gadget "magic" is not in the console images, as of nov 2014. as far as I can tell, the difference is that the lxde kernel loads g_multi and libcomposite, while the console image does not. however, the console still gives you a full computer with display output and keyboard support. if the tcp/ip ethernet cable network is connected during reboot, it will come up. this means you can then run "apt-get upgrade" and "apt-get update".
* unlike the ubuntu 14.04 images, I found the hdmi display output on the debian to be rock-solid, though the descender of the font is a little cut off at the bottom on my monitor. in any case, be aware that ubuntu screen flickering is because of beaglebone black resolution limitations (1280x1024), fallback display resolution, and how your specific monitor works. it's not that debian is intrinsically better than ubuntu. nevertheless, given that debian is now the official, I would stick to it first.
* if you want to drive the HDMI display, preferably boot with it connected and make sure your monitor is not asleep. the BBB hdmi port has multiple purposes, and during the boot up tries to configure itself. you may get stuck with flickery no-screen output on your hdmi monitor otherwise.
* some time during the boot process seems dedicated to the BBB trying to figure out whether its (ethernet) network connection is live and possibly whether it finds various internet gateways and name servers. it boots faster when ethernet is plugged in.
* you should do an "apt-get update" and then "apt-get upgrade" as soon as you have a live network connection.
* reboot works, but "shutdown now" does not. as an old linux hack, the idea of pulling a plug without warning scares me.
* lxde disk: on my 4GB BBB Rev C, the rootfs is 1.4G, with 1.9G available. by default, there seems to be a second partition on /dev/mmcblk0p1, which is the FAT16 partition which I am guessing is used at boot time. "ioping -c 10 ." on the eMMC tells me that I have about 910 iops, with a typical latency of about 1ms. for comparison, this is about twice as fast as what I get from my 32GB Premium 300x Transcend card on the BBB. for comparison, a Macbook Pro with internal SSD, costing only about 30 times as much, has a performance is about 40,000 iops.
* lxde ram: of my 512MB, running lxde, about 335MB remain free.
hope this helps others. again, thank robert nelson for the hard work.
/iaw