Quick update regarding BeagleBone Blue documentation

GoogleGroups
1

I’m still not making that much headway in the Blue documentation at the moment, but I figure I can at least make an FAQ to help some new users.

https://github.com/beagleboard/beaglebone-blue/wiki/Frequently-Asked-Questions-(FAQ

The big thing to point out, however, is that a ton of good documentation is already at http://www.strawsondesign.com/#!manual-install.

I think the big thing missing right now is a good guide for the connector pinouts that avoid needing to reference the schematic.

For my work-in-progress update on the getting-started page, see http://jadonk.github.io/beaglebone-getting-started/START.htm.

Patches welcome.

2

I have pinouts listed in the individual manual pages for encoders, i2c, uart, etc. Diagrams would be better but the info is here.

http://strawsondesign.com/#!manual-encoders

http://strawsondesign.com/#!manual-i2c

http://strawsondesign.com/#!manual-spi

http://strawsondesign.com/#!manual-uart

http://strawsondesign.com/#!manual-adc

3

I think I’ve completed the getting-started portion and now need to move to updating bone101.

Everyone please look at http://jadonk.github.io/beaglebone-getting-started/START.htm and let me know if anything needs further adjustment on that page itself.

4

Jason,

I’ve been reading/lurking aka not running one.

Trouble shooting says ssh uses root and blank. I thought that was different now.

Ok, maybe that section is not in getting started. But check it.

Clark

5

Jason,

I’ve been reading/lurking aka not running one.

Trouble shooting says ssh uses root and blank. I thought that was different now.

Ok, maybe that section is not in getting started. But check it.

6

Jason:
Looks good. Could you also add some “Quick Links” at the top. I can think of two that would be handy (but there may be others):
192.168.7.2 main page
192.168.7.2:3000 Cloud9 IDE

I’m thinking of a workshop setting where they could be told to open START.html and use the quick link to Cloud9.

–Mark

7

I’ve added quick links to http://jadonk.github.io/beaglebone-getting-started/START.htm if a connection is found. Please try it out.

8

As a noob using BeagleBone Blue this page is not making clear what to look for on your board. The image shown is an old BeagleBone Black I assume, and the reference to buttons and other details that are NOT present on your own board leads you to conclude you are in the wrong place.

I am still not understanding why there is a SD-boot button as I have never used it, but the instructions refer to it, and I am suggesting to clean up that text.

I see 4 grey images with unhappy faces (image does not exist) in the books section.

Based on my overall experience from using the the BeagleBone Blue I would stress the fact that this is a community effort, with great variation in maturity and finish. This is actually the most difficult part, I am still looking for a mature python library and it does not seem to exist. Beginner guidance on this part would help.

9

"mature", sorry wrong "verb".. The blue just came out a few months back.

Your one of the first users, it's those uses that usually write the
first python libraries..

Regards,

10

“mature”, sorry wrong “verb”… The blue just came out a few months back.

Your one of the first users, it’s those uses that usually write the
first python libraries…

Yeah, and thats exactly the point that I think would make sense to let people know.

11

btw check out:

"Python bindings for roboticscape"

https://github.com/mcdeoliveira/rcpy

still early, he has a few changes to the base libroboticscape library.

Regards,

12

Jason:

The quick links look nice. Here’s what I see:

Web server: doesn’t render right. Looks like a css is missing.

Cloud9 IDE: Looks great!

SSH server: Didn’t do anything. I’m using Chrome

Node-RED: Looks good, but Beagle IO is missing.

–Mark

13

All, I’ve merged updates to http://beagleboard.org/getting-started now as it seems to be an overall improvement to what was there.

As a noob using BeagleBone Blue this page is not making clear what to look for on your board. The image shown is an old BeagleBone Black I assume, and the reference to buttons and other details that are NOT present on your own board leads you to conclude you are in the wrong place.

I’ll add a picture for BeagleBone Blue—hopefully later today. Black Wireless should look very much like Black. I’m hopeful BeagleBoard-* users don’t need pictures to find the LEDs. For the “compatible” boards, I simply can’t add pictures for all of them.

I am still not understanding why there is a SD-boot button as I have never used it, but the instructions refer to it, and I am suggesting to clean up that text.

I’ll add a note to the updating section. It simply forces boot to bypass the on-board eMMC flash in case it has some “bad” content. If it had “no” content, it would be bypassed anyway.

I see 4 grey images with unhappy faces (image does not exist) in the books section.

Should be fixed now.

Based on my overall experience from using the the BeagleBone Blue I would stress the fact that this is a community effort, with great variation in maturity and finish. This is actually the most difficult part, I am still looking for a mature python library and it does not seem to exist. Beginner guidance on this part would help.

Thanks Robert for sharing the Python library link elsewhere on this thread. I also added a link to the github repo for forking the getting started to emphasize the community aspect.

14

Jason:

The quick links look nice. Here’s what I see:

Web server: doesn’t render right. Looks like a css is missing.

Screenshot?

Cloud9 IDE: Looks great!

SSH server: Didn’t do anything. I’m using Chrome

This really depends on what you have registered for “ssh:” on your system. On a Mac, it should open Terminal.app.

Node-RED: Looks good, but Beagle IO is missing.

Robert, do you know what happened to the Beagle I/O? Of course, for Blue this needs updating. I don’t think octalbonescript comprehends Blue yet either.

15

yeah, Beagle I/O/octalbonescript needs to know what to do with the Blue.

Regards,