Repository files navigation

This is the SDK for the Valve Steam Link

The Steam Link hardware is a single core ARMv7 processor using the hard-float ABI,running at1 GHz, with neon instruction support. It has approximately256 MB of availableRAM and1 GB of usable flash storage.

The Steam Link software is custom Linux firmware based onkernel 3.8 andglibc 2.19.

The Steam Link SDK has support for the following major APIs:

• OpenGL ES 2.0
• Qt 5.14.1
• SDL 2.0

The SDL game controller API is recommended for Steam Controller support on the Steam Link.

Examples to demonstrate how to build applications using the SDK. Each application directory has abuild_steamlink.sh script to build and package the example.

Native app icons should be 116x116, and will be scaled to that size if needed.

Source code to 3rd party components of the Steam Link, each directory has abuild_steamlink.sh script to rebuild the component.

Steam Link linux kernel source code

Steam Link root filesystem

Debug symbols for binaries in the latest build are available from:http://media.steampowered.com/steamlink/steamlink-sdk-symbols.tar.xz

GCC toolchain for Steam Link

Script to configure build environment

Steam Link applications are built using this SDK on Linux.

To set up the build environment, source the top levelsetenv.sh.

# source setenv.sh

This is done inside the build script for each example, as needed.

Put the files in a folder with the app name on a FAT32 USB drive under\steamlink\apps, insert it into the Steam Link and power cycle the device.

The app will be copied onto the system at boot and can be launched from the menu.

You may need to enable ssh access to the Steam Link for advanced debugging.You can do this by putting a file calledenable_ssh.txt on a FAT32 USB drive under\steamlink\config\system, inserting it into the Steam Link and power cycle the device.

The root password issteamlink123 and should be changed using thepasswd command the first time you log in.

SSH access will remain enabled until a factory reset.

Recommended way is to rungdbserver on the Steam Link and use a localgdb to connect to it and debug an application.

First, configure environment for SDK:

# source setenv.sh

Second, make sure that the install path of the SDK is on gdb'sauto-load-safe-path by:

# echo "add-auto-load-safe-path $MARVELL_SDK_PATH" >> ~/.gdbinit

Build an example application and transfer it into the steam link:

# cd examples/linux# make# scp example root@10.1.211.126:/mnt/scratch

On the steam link, run the application:

# gdbserver :8080 example

Or you can attach to a running process with:

# gdbserver --attach :8080 $(pidof example)

On the host, create a.gdbinit file for your application and target:

$ ../../scripts/create_gdbinit.sh example 10.1.211.126:8080

On the host, rungdb and attach to the gdbserver:

ubuntu:/valve/marvell/sdk/examples/linux $ armv7a-cros-linux-gnueabi-gdbGNU gdb (Gentoo 7.7.1 p1 e02ddb0f2eea465662e99fee14e9c41f23769624) 7.7.0.20140425-cvsCopyright (C) 2014 Free Software Foundation, Inc.License GPLv3+: GNU GPL version 3 or later<http://gnu.org/licenses/gpl.html>This is free software: you are free to change and redistribute it.There is NO WARRANTY, to the extent permitted by law.  Type"show copying"and"show warranty"for details.This GDB was configured as"--host=x86_64-pc-linux-gnu --target=armv7a-cros-linux-gnueabi".Type"show configuration"for configuration details.For bug reporting instructions, please see:<http://bugs.gentoo.org/>.Find the GDB manual and other documentation resources online at:<http://www.gnu.org/software/gdb/documentation/>.For help,type"help".Type"apropos word" to searchfor commands related to"word".0xb6f6ba00in_start () from /valve/marvell/sdk/rootfs/lib/ld-linux-armhf.so.3(gdb)breakprintfFunction"printf" not defined.Make breakpoint pending on future shared library load? (y or [n]) yBreakpoint 1 (printf) pending.(gdb) cContinuing.Breakpoint 1, __printf (format=0xb6f8c764"Hello world!\n") at printf.c:2828printf.c: No such file or directory.(gdb) where#0  __printf (format=0xb6f8c764 "Hello world!\n") at printf.c:28#1  0xb6f8c704 in main (argc=1, argv=0xbed64e64) at example.c:7

Follow these steps in addition to setting up the build environment as described above.

WARNING: Steam Link devices will only boot with a kernel signed by Valve. If you attempt to replace the kernel with an unsigned binary you will void your warranty and render your Steam Link unbootable.

# export ARCH=arm; export LOCALVERSION="-mrvl"

#  make bg2cd_penguin_mlc_defconfig

# make menuconfig

# make

# make modules