OSD3358 Developers' Guide

Last modified September 19, 2016

The OSD3358 products are powerful and low cost devices running full-featured Linux technology based on Octavo Systems's OSD335x family of System-in-Packages (SiP) running Texas Instruments's powerful Sitara™ AM335x line of processors.

Getting Started

The OSD3358 SiP is based on the same hardware as the BeagleBoard.org Foundation's BeagleBone Black. That means that the same software and images you may have already been using with a BeagleBone Black will run on the OSD3358 SiP. To get started with the OSD3358 TH, OSD3358 Dev Board, or OSD3358 SoM, connect the board to your PC using a USB cable and follow the BeagleBoard getting started guide to get up and running with Linux. Since the onboard eMMC comes preprogrammed with an official BeagleBone image, you do not need to follow the "Update board with latest software" step.

To reflash your eMMC or create an SD boot image, you can follow the "Update board with latest software" in the above getting started guide. The current image that we have tested and verified to work is Debian 8.5 2016-05-13 4GB SD LXQT image with SHA256 hash "28d67e877497fb9e52fe605f2cbefdbaedaff23e9fa82e9ed2076ae375aa777f".

If you want to reflash the EEPROM, make sure to connect the EEPROM Write Protect pad on the board to ground. Make sure you have the correct EEPROM data because the above eMMC flasher does not include all of the EEPROM data needed and the board will not boot without it.

To communicate with the board, you can connect over USB to the virtual serial port or to the IP of 192.168.7.2 with username root and no password using an SSH program. This will allow you to copy files to the board from your PC. Alternatively, you can connect a USB to serial converter to UART0 on the board and your PC (the OSD3358 Development Board already has one included on the board). This will allow you to see early boot messages.

Detailed information and pin functionality can be found in the Texas Instruments and Octavo Systems documentation for the underlying products.

Displays

Displays do not work out of the box on our OSD3358 boards. To use a display, you must provide Linux with a device tree overlay that describes the display and its configuration. Not every display is the same so a different overlay file may be required.

We have created a device tree overlay for the Newhaven 5" capacitive touch display that comes on the OSD3358 Development Board and for the 4.3" capacitive, 4.3" resistive, and 7" capacitive Newhaven touch displays that are supported by the Display NHVN. You can connect the Display NHVN to the OSD3358 TH using the GXP headers (the GXP Gadgeteer Bridge is not supported). Make sure you add the needed pull-up resistors for I2C if using touch.

Each of the provided overlays has only been tested with the BeagleBone image that comes with the board. While other displays should work, we have not tested any and you must provide your own device tree overlay.

Make sure your board has enough power to run the display. External power is often required because USB often cannot provide enough. See the OSD3358 TH notes section on this page for information on powering the OSD3358 TH.

Available display overlays:

To configure the display, follow these steps:

Networking

To access the internet from your board, you have a few options. The OSD3358 Development Board includes an onboard Ethernet connector. You may also add external Wi-Fi yourself.

All OSD3358 boards also support internet over USB when connected to your PC and using the provided BeagleBone Black image. To enable your board to use internet over USB, follow the below steps:

On your Windows PC:

On the board:

Make sure to provide your own DNS server settings in place of [DNS server 1] and [DNS server 2]. You can find this information from the network adapter information on your PC.

Unfortunately, the board settings do not persist across reboots. You must re-do them whenever you turn on the board. You may have to redo the Windows steps from time to time as Windows turns off sharing after a period of time. Parts of the steps may be able to be automated with a script.

OSD3358 TH

The OSD3358 SiP used on the OSD3358 TH includes power management hardware internally, so unlike our other TH boards, the OSD3358 TH can be powered over USB.

The GXP header does not take 3.3 V or 5 V from the SoM. It requires an external 5 V power supply connected to the "5V GXP" pin. 3.3 V on the GXP header is provided from an onboard regulator (part number AP2112K-3.3TRG1) connected to "5V GXP".

The 5V OUT pin comes from the SiP itself. Its current and voltage limits are dependent on the underlying power source used. In some cases it may be less than 5 V. See the SiP documentation for details.

Pins 24, 26, 28, and 30 on the GXP header are analog only. They do not support GPIO like the GXP specification requires. Keep in mind that the analog pins on the OSD3358 SiP are not 3.3 V tolerant.

Preview Known Issues

Leave feedback about this document.
Let us know if the information presented here was accurate, helpful and if you have any suggestions.
Leave feedback about this document.
Let us know if the information presented here was accurate, helpful and if you have any suggestions.

* Indicates required fields.
This form is only for feedback not support.
Review our how to find information guide on locating helpful resources.