TLAB-PBCAPE

System Reference Manual Jason Kridner edited this page on Jan 15 · 118 revisions PocketBeagle System Reference Manual (SRM) Revision A.x (on-line wiki edition) December 6, 2017 Maintaining author: Jason Kridner jkridner@beagleboard.org Contributing Editor: Cathy Wicks cathy@beagleboard.org THIS DOCUMENT Terms These design materials are *NOT SUPPORTED* and *DO NOT* constitute a reference design. Only “community” support is allowed via resources at BeagleBoard.org/discuss. THERE IS NO WARRANTY FOR THE DESIGN MATERIALS, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE DESIGN MATERIALS “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE DESIGN MATERIALS IS WITH YOU. SHOULD THE DESIGN MATERIALS PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. In other words, you may use the design materials as you choose and there is no license with regards to usage in the manufacturing process. We mean it, these design materials may be totally unsuitable for any purposes. Don't blame us! As a general rule, we don't encourage use of this or other off-the-shelf single board computers in commercial products without engaging with a manufacturer to create a supplier agreement and make sure that you can get material as your business demands. Further, we do update the design on occasions where we find it necessary and won't guarantee a supply of older revisions, though we do seek periodic manufacturing of all of our boards for a period of roughly 10 years and will make design changes to replace obsolete parts and that may impact your usage. If you do opt to use it in a product, you take full responsibility for that product. Do not use the BeagleBoard.org logo or trademarks (such as BeagleBoard, BeagleBone and PocketBeagle) on your products without a logo license from the BeagleBoard.org Foundation, but feel free to reference BeagleBoard.org. See the LICENSE file regarding the copyright of these materials. Table of Contents • 1.0 Introduction ▪ • • Figure 1. PocketBeagle Home Page 2.0 Change History ▪ 2.1 Document Change History ▪ Table 1. Change History ▪ 2.2 Board Changes ▪ Table 2. Board History ▪ 2.2.1 PocketBone ▪ 2.2.2 Rev A1 ▪ 2.2.3 Rev A2 3.0 Connecting Up PocketBeagle ▪ 3.1 What’s In the Package ▪ Figure 2. PocketBeagle Package ▪ Figure 3. PocketBeagle Package Insert ▪ 3.2 Connecting the board ▪ 3.3 Tethered to a PC using Debian Images ▪ Figure 4. Tethered Configuration ▪ 3.3.1 Getting Started ▪ Figure 5. Getting Started Page ▪ Figure 6. Download Latest Software Image ▪ Figure 7. Download Etcher SD Card Utility ▪ Figure 8. Select the PocketBeagle Image ▪ Figure 9. Burn the Image to the SD Card ▪ Figure 10. Insert the microSD Card into PocketBeagle ▪ Figure 11. Insert the micro USB Connector into PocketBeagle ▪ Figure 12. Insert the USB connector into PC ▪ Figure 13. Board Power LED ▪ Figure 14. User LEDs ▪ 3.3.2 Accessing the Board and Getting Started with Coding ▪ Figure 15. Interactive Quick Start Guide Launch ▪ • • • Figure 16. Enable a Network Connection ▪ Figure 17. Launch Cloud9 IDE ▪ 3.3.3 Powering Down ▪ Figure 20. Power Button ▪ 3.4 Other ways to Connect up to your PocketBeagle 4.0 PocketBeagle Overview ▪ 4.1 PocketBeagle Features and Specification ▪ Table 3. PocketBeagle Features ▪ 4.1.1 OSD3358-512M-BSM System in Package ▪ 4.2 Board Component Locations ▪ Figure 21. Key Board Component Locations 5.0 PocketBeagle High Level Specification ▪ 5.1 Block Diagram ▪ Figure 22. PocketBeagle Key Components ▪ 5.2 System in Package (SiP) ▪ Figure 23. OSD335x SIP Block Diagram ▪ 5.3 Connectivity ▪ 5.3.1 Expansion Headers ▪ Figure 24. PocketBeagle Expansion Headers ▪ 5.3.2 microSD Connector ▪ Figure 25. microSD Connector ▪ 5.3.3 USB 2.0 Connector ▪ Figure 26. USB 2.0 Connector ▪ 5.3.4 Boot Modes ▪ Table 4. UART Pins on Expansion Headers for Serial Boot ▪ 5.4 Power ▪ Table 5. Power Inputs Available on Expansion Headers ▪ Table 6. Power Outputs Available on Expansion Headers ▪ Table 5. Ground Pins Available on Expansion Headers ▪ 5.5 JTAG Pads ▪ Figure 27. JTAG Pad Connections ▪ 5.6 Serial Debug Port ▪ Figure 28. Serial Debug Connections 6.0 Detailed Hardware Design ▪ 6.1 OSD3358-SM SiP Design ▪ 6.1.1 SiP A OSD3358 SiP System and Power Signals ▪ Figure 29. SiP A OSD3358 SiP System and Power Signals ▪ 6.1.2 SiP B OSD3358 SiP JTAG, USB & Analog Signals ▪ Figure 30. SiP B OSD3358 SiP JTAG, USB & Analog Signals ▪ 6.1.3 SiP C OSD3358 SiP Peripheral Signals ▪ Figure 31. SiP C OSD3358 SiP Peripheral Signals ▪ 6.1.4 SiP D OSD3358 SiP System Boot Configuration ▪ Figure 32. SiP D OSD3358 SiP System Boot Configuration ▪ 6.1.5 SiP E OSD3358 SiP Power Signals ▪ Figure 33. SiP E OSD3358 SiP Power Signals ▪ 6.1.6 SiP F OSD3358 SiP Power Signals ▪ Figure 34. SiP F OSD3358 SiP Power Signals ▪ 6.2 MicroSD Connection ▪ ▪ 6.3 USB Connector ▪ • • • • • Figure 35. microSD Connections Figure 36. USB Connection ▪ 6.4 Power Button Design ▪ Figure 37. Power Button ▪ 6.5 User LEDs ▪ Figure 38. User LEDs ▪ Table 6. User LED Control Signals/Pins ▪ 6.6 JTAG Pads ▪ Figure 39. JTAG Pads Design ▪ 6.7 PRU-ICSS ▪ 6.7.1 PRU-ICSS Features ▪ 6.7.2 PRU-ICSS Block Diagram ▪ Figure 40. PRU-ICSS Block Diagram ▪ 6.7.3 PRU-ICSS Pin Access ▪ Table 6. PRU0 and PRU1 Access 7.0 Connectors ▪ 7.1 Expansion Header Connectors ▪ Figure 41. Expansion Headers for PocketBeagle ▪ Figure 42. Expansion Header Popular Functions - Color Coded ▪ 7.1.1 P1 Header ▪ Figure 43 P1 Header ▪ Table 7. P1 Header Pinout ▪ 7.1.2 P2 Header ▪ Figure 44. P2 Header ▪ Table 8. P2 Header Pinout ▪ 7.2 mikroBUS socket connections ▪ Figure 45. mikroBUS ▪ Figure 46. PocketBeagle Both Headers ▪ 7.3 Setting up an additional USB Connection 8.0 PocketCape Support 9.0 PocketBeagle Mechanical ▪ 9.1 Dimensions and Weight 10.0 Additional Pictures ▪ Figure 47. PocketBeagle Front BW ▪ Figure 48. PocketBeagle Back BW 11.0 Support Information ▪ 11.1 Hardware Design ▪ 11.2 Software Updates ▪ 11.5 Export Information ▪ 11.4 RMA Support ▪ 11.5 Getting Help 1.0 Introduction This document is the System Reference Manual for PocketBeagle and covers its use and design. PocketBeagle is an ultra-tiny-yet-complete Linux-enabled, community-supported, open-source USB-key-fobcomputer. PocketBeagle features an incredible low cost, slick design and simple usage, making it the ideal development board for beginners and professionals alike. Simply develop directly in a web browser providing you with a playground for programming and electronics. Exploring is made easy with several available libraries and tutorials with many more coming. PocketBeagle will boot directly from a microSD card. Load a Linux distribution onto your card, plug your board into your computer and get started. PocketBeagle runs GNU.Linux, so you can leverage many different high-level programming languages and a large body of drivers that prevent you from needing to write a lot of your own software. This design will keep improving as the product matures based on feedback and experience. Software updates will be frequent and will be independent of the hardware revisions and as such not result in a change in the revision number of the board. A great place to find out the latest news and projects for PocketBeagle is on the home page beagleboard.org/pocket Figure 1. PocketBeagle Home Page Make sure you check the support Wiki frequently for the most up to date information.github.com/beagleboard/pocketbeagle/wiki 2.0 Change History This section describes the change history of this document and board. Document changes are not always a result of a board change. A board change will always result in a document change. 2.1 Document Change History Table 1. Change History Rev A.x Changes Production Document Date By December 7, 2017 JK 2.2 Board Changes Table 2. Board History Rev Changes Date By A1 Preliminary February 14, 2017 JK A2 Production. Fixed mikroBUS Click reset pins (made GPIO). September 22, 2017 JK 2.2.1 PocketBone Upon the creation of the first, 27mm-by-27mm, Octavo Systems OSD3358 SIP, Jason did a hack two-layer board in EAGLE called “PocketBone” to drop the Beagle name as this was a totally unofficial effort not geared at being a BeagleBoard.org Foundation project. The board never worked because the 32kHz and 24MHz crystals were backwards and Michael Welling decided to pick it up and redo the design in KiCad as a fourlayer board. Jason paid for some prototypes and this resulted in the first successful “PocketBone”, a fullyopen-source 1-GHz Linux computer in a fitting into a mini-mint tin. 2.2.2 Rev A1 The Rev A1 of PocketBeagle was a prototype not released to production. A few lines were wrong to be able to control mikroBUS Click add-on board reset lines and they were adjusted. 2.2.3 Rev A2 The Rev A2 of PocketBeagle was released to production and at World MakerFaire 2017. Known issues in rev A2: Issue GPIO44 is incorrectly labelled as GPIO48 Link github.com/beagleboard/pocketbeagle/issues/4 3.0 Connecting Up PocketBeagle This section provides instructions on how to hook up your board. The most common scenario is tethering PocketBeagle to your PC for local development. 3.1 What’s In the Package In the package you will find two items as shown in Figures 2 and 3. • PocketBeagle • Getting Started instruction card with link to the support URL. Figure 2. PocketBeagle Package Figure 3. PocketBeagle Package Insert 3.2 Connecting the board This section will describe how to connect to the board. Information can also be found on the Quick Start Guide that came in the box. Detailed information is also available at beagleboard.org/getting-started The board can be configured in several different ways, but we will discuss the most common scenario. Future revisions of this document may include additional configurations. 3.3 Tethered to a PC using Debian Images In this configuration, you will need the following additional items: • microUSB to USB Type A Cable • microSD card (>=4GB and