Octavo OSD3358-SM-RED User manual

OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
Introduction
This User Guide (UG) for the OSD3358-SM-RED platform is intended to serve as a resource to
find information regarding design and usage of the hardware and software aspects of the board.
It will cover topics ranging from getting started with the platform to using different sensors and
peripherals that are present on board.
This document will be updated as required to improve or add information. Please make sure to
look for updates and sign up for document change notifications on Octavo Systems website to
get up to date info.
Some relevant resources for support and development are given below:
•OSD3358-SM-RED board design files:
https://octavosystems.com/files/osd3358-sm-red-eagle-files/
•Sign up for OSD3358-SM-RED latest software updates:
https://octavosystems.com/doc-change-signup/
•OSD3358-SM datasheet:
https://octavosystems.com/docs/osd335x-sm-datasheet/
•OSD3358-SM RED platform getting started guide:
https://octavosystems.com/docs/osd3358-sm-red-quick-start-guide/
•OSD3358-SM Application notes:
a. OSD335x-SM layout guide:
https://octavosystems.com/app_notes/osd335x-sm-layout-guide/
b. OSD335x Family Pin Assignments Compared to AM335x:
https://octavosystems.com/app_notes/osd335x-family-pin-assignments/
Notice: The information provided within this document is for informational use only. Octavo
Systems provides no guarantees or warranty to the information contained.

2
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
Revision History
Revision
Details
Date
Author
Initial draft
09-19-2017
Neeraj Dantu

3
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
Contents
1 Powering the OSD3358-SM-RED...................................................................... 6
1.1 Power up procedure............................................................................. 7
2 OSD3358-SM-RED Use Cases......................................................................... 10
2.1 Standalone boot up............................................................................. 10
2.2 Booting as USB client connected to a computer/laptop .................................. 14
2.3 Boot messages through UART ................................................................. 17
2.4 User LEDs ........................................................................................ 21
2.5 Powering down/ power cycling ............................................................... 21
3 Overview of OSD3358-SM-RED ...................................................................... 22
3.1 Specification .................................................................................... 22
3.2 Processor (U1)................................................................................... 25
3.3 PC USB interface (X1) .......................................................................... 26
3.4 Serial debug interface (J3).................................................................... 27
3.5 EMMC (U7) ....................................................................................... 28
3.6 Cape Headers (J5 & J6)........................................................................ 29
3.7 JTAG (J4) ........................................................................................ 30
3.8 Micro-SD card slot (X3)......................................................................... 31
3.9 HDMI interface (X6) ............................................................................ 32
3.10 Gigabit ethernet (X4) .......................................................................... 33
3.11 4 Port USB hub (X4 & X5) ...................................................................... 34
3.12 Inertial Measurement Unit (IMU) (U23) ...................................................... 35
3.13 Temperature sensor hub (U17) ............................................................... 36
3.14 Pressure sensor (U22) .......................................................................... 36
3.15 Trusted Platform Module (TPM) (U16) ....................................................... 37
3.16 NOR flash (U21) ................................................................................. 38
4 Detailed hardware design........................................................................... 39
4.1 Power management ............................................................................ 39
4.2 Additional functions of the PMIC ............................................................. 41
4.3 Input power...................................................................................... 41
4.4 PMIC-AM3358 interface ........................................................................ 43

4
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
4.5 Clamping circuit ................................................................................ 46
4.6 Clock inputs to the processor ................................................................. 47
4.6.1 OSC0:........................................................................................ 47
4.6.2 OSC1:........................................................................................ 47
4.7 Boot configuration.............................................................................. 49
4.8 UART0 interface ................................................................................ 51
4.9 eMMC ............................................................................................. 52
4.10 MicroSD card slot ............................................................................... 53
4.11 JTAG.............................................................................................. 54
4.12 ADC ............................................................................................... 55
4.13 Evaluation board USB client................................................................... 56
4.14 4 port Evaluation board USB host ............................................................ 57
4.15 Ethernet.......................................................................................... 58
4.16 HDMI interface .................................................................................. 59
4.17 9-Axis IMU........................................................................................ 60
4.18 Temperature sensor hub....................................................................... 61
4.19 Barometer ....................................................................................... 61
4.20 Trusted Platform Module (TPM) .............................................................. 62
4.21 EEPROM .......................................................................................... 63
4.22 Header descriptions ............................................................................ 63
4.23 On board connectors and jumpers ........................................................... 64
4.24 Test points....................................................................................... 65
5 Board images and software features .............................................................. 66
5.1 Boot up........................................................................................... 66
5.2 Device tree ...................................................................................... 66
5.2.1 Device Tree Overlays ..................................................................... 67
5.3 Onboard sensor interfacing ................................................................... 67
5.3.1 Accessing peripherals using shell terminal ............................................ 69
5.3.2 Using peripheral library to write applications ........................................ 73
6 Cape support.......................................................................................... 73
7 Mechanicals ........................................................................................... 74
8 Support and Troubleshooting....................................................................... 76

5
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
9 Reference Documents ............................................................................... 76

6
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
1Powering the OSD3358-SM-RED
Figure 1 shows the OSD3358-SM-RED and its power inputs. The board can be powered
through any of three inputs:
1. Micro-USB cable connected to the micro-USB port
2. 5V AC adapter connected to the barrel jack
3. Single cell Li-Ion or Li-Polymer battery connected to the battery header
Figure 1: Picture of RED board highlighting power inputs

7
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
1.1 Power up procedure
The following steps describe the power up sequence of the board when powered via USB, AC
Adapter or battery inputs.
1. Connect your preferred power source:
a. USB:
i. Connect the micro-USB side of the USB cable to the micro-USB port X1
ii. Connect the USB side to one of the USB ports on a laptop/computer or
other USB power source.
Figure 2: Powering the board using a USB cable

8
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
b. AC adapter:
i. Plug in the 5V AC adapter with 2.5 mm x 5.5 mm barrel into the power
connector X2.
Figure 3: Powering the RED board using an AC-DC adapter
c. Battery input terminals:
i. Connect the battery input terminals to the battery terminals as shown
below.
Figure 4: OSD3358-SM-RED battery connections (back-side of board)

9
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
2. LED D1 will turn on immediately after power is applied to the board.
Figure 5: RED board boot up - LED D1 ON
3. LEDs D4 –D7 turn on in the sequence indicated below indicating Linux is booting.
Figure 6: RED board boot up - LEDs D4 - D7 turn ON
NOTE: Notes on connecting the PMIC_TS input of the SiP can be found in "Battery pack
temperature monitoring" section of the TPS65217C PMIC datasheet. If the battery does
not have a temperature output, the battery temperature monitoring mechanism of the PMIC
can be bypassed by connecting a 10KOhm resister between PMIC_TS (TP7) of the board
and GND.

10
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
2OSD3358-SM-RED Use Cases
The OSD3358-SM-RED Platform can be used in 3 different modes. A description of each mode
and instructions on how to set up each mode is described below.
2.1 Standalone boot up
The board can be used as a standalone platform for software development. To boot it up as a
standalone system, the following components will be needed.
1. 5V AC adapter
2. HDMI/DVI-D monitor
3. Micro HDMI to HDMI cable and/or HDMI to DVI-D adapter
4. Wired/wireless USB keyboard and mouse
5. Ethernet cable or WiFi USB adapter connected to a network for internet access
The following steps describe the procedure to setup the board as a standalone software
development tool.
1. Connect the micro HDMI connector of the HDMI cable to X6 connector on board.
2. Connect the HDMI connector of the HDMI cable into the monitor. HDMI to DVI-D
convertor may be necessary if the monitor only has a DVI-D input.
Figure 7: Connecting OSD3358-SM-RED to a monitor via HDMI cable

11
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
3. Connect the wired/wireless USB keyboard and mouse inputs to any of the four USB
ports available on X4 and X5 connectors of the board.
Figure 8: Wireless adapter for keyboard and mouse plugged in to RED board
4. If internet connectivity is required:
a. a WiFi-USB adapter can be plugged into one of the available USB ports on X4 or
X5 connector. A list of compatible adapters can be found Compatible WiFi
adapters: http://www.elinux.org/Beagleboard:BeagleBoneBlack#WIFI_Adapters.
OR
b. An ethernet cable can be plugged into the ethernet connector receptacle on X4.
Figure 9: Ethernet cable/Wi-Fi dongle plugged in to the RED board

12
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
5. Plug the 5V AC adapter into the power connector X2.
Figure 10: AC-DC adapter plugged in to RED board
6. The board will go through the default boot up process
7. After the board boots up, the monitor screen should show a Linux desktop environment
as shown below.
Figure 11: OSD3358-SM-RED desktop environment

13
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
8. Click on the Start>System Tools>Q Terminal to open up a command terminal.
Figure 12: Shell command terminal on booted desktop

14
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
2.2 Booting as USB client connected to a computer/laptop
The OSD3358-SM-RED platform can also be powered using a computer/laptop’s USB port. The
micro-USB to USB cable provided in the box can be used to connect the RED board to a
computer/laptop. Unlike the standalone mode, this setup does not require additional hardware.
The following steps describe the procedure to power the board as a USB slave and set up the
development environment.
1. Connect the micro-USB side of the USB cable to the micro-USB port X1
2. Connect the USB side to one of the USB ports on a laptop/computer.
Figure 13: Powering RED board using a USB cable

15
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
3. Wait for the board to show up as a mass storage device on the computer/laptop
Figure 14: OSD3358-SM-RED USB mass storage filesystem window

16
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
4. Open a browser (Firefox/Chrome) and access the url: http://192.168.7.2. The webpage
hosted on the webserver of the board should indicate that the board is connected as
shown below.
Figure 15: OSD3358-SM-RED home webpage indicating a connection to the board
5. Access the cloud9 IDE through the url: http://192.168.7.2:3000/. Cloud9 IDE is an
opensource web based development environment supporting several languages. The
environment should look like the following Figure with workspace containing examples
that can be executed. Cloud9 also loads a shell terminal that can be seen at the bottom of
the following figure.
Figure 16: Cloud9 IDE environment

17
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
2.3 Boot messages through UART
The processor on the OSD3358-SM-RED platform (RED board) sends boot messages through
the UART0 port, J3. This is useful in embedded Linux development or if there are boot problems
to verify proper initialization of all components on the board. After boot, the UART0 port will
function as a Linux terminal. Accessing this requires a serial connection to a host device with a
serial port. A USB-UART serial adapter can also be used for host devices with a USB port. A
terminal program, such as Putty is required for communication.
The following steps describe the procedure to access the boot messages during boot and the
terminal through UART0 port using a standard computer/laptop as a host device (Note: Given
the computer/laptop has no native serial ports, a USB-UART serial adapter must be used):
1. Connect the UART side of the adapter to header J3 of the RED board. Make sure to
check for proper orientation of the cable to connect Tx and Rx signals of the UART0 port
appropriately to the adapter’s signals.
Figure 17: UART adapter cable plugged in to RED board

18
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
2. Connect the USB side of the adapter to the computer/laptop
Figure 18: UART-USB adapter plugged in to the computer
3. Check which COM port of the computer/laptop the adapter is connected to using the
device manager.
Figure 19: UART adapter detected as COM port 16

19
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
4. Open a serial console (opensource applications like Putty come with one). Select the
serial communication option and specify the port and speed of the protocol as shown
below and click on open.
Figure 20: PUTTY configuration for serial communication

20
OSD3358-SM-RED –User Guide
Rev. 1.0 9/19/2017
Octavo Systems LLC
Copyright 2017
5. After a new serial console is open, connect the board to a power supply through one of
the three power inputs of the board. The boot messages should begin to scroll on the
console. After boot, the console will ask for secure shell login. You can login to the shell
using the credentials –debian:temppwd .
Figure 21: Debian Linux terminal after boot