VIA Technologies SOM-9X50-STK User manual

QUICK START GUIDE
VIA SOM-9X50-STK
Amazon KVS
1.00-09032023

Copyright
Copyright © 2023 VIA Technologies Incorporated. All rights reserved.
No part of this document may be reproduced, transmied, transcribed, stored in a retrieval system, or translated into any language, in any
form or by any means, electronic, mechanical, magnec, opcal, chemical, manual or otherwise without the prior wrien permission of
VIA Technologies, Incorporated.
Trademarks
All brands, product names, company names, trademarks and service marks are the property of their respecve holders.
Disclaimer
VIA Technologies makes no warranes, implied or otherwise, in regard to this document and to the products described in this document.
The informaon provided in this document is believed to be accurate and reliable as of the publicaon date of this document. However,
VIA Technologies assumes no responsibility for the use or misuse of the informaon (including use or connecon of extra device/
equipment/add-on card) in this document and for any patent infringements that may arise from the use of this document. The informaon
and product specicaons within this document are subject to change at any me, without noce and without obligaon to nofy any
person of such change.
VIA Technologies, Inc. reserves the right the make changes to the products described in this manual at any me without prior noce.
ii

iii
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
Revision History
Version Date Remarks
1.00 09/03/2023 Inial release

iv
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
Table of Contents
1. Introducon.................................................................................................................................................... 1
1.1 Direcng Data from a VIA SOM-9X50-STK Device to an AWS Portal..................................................... 1
1.2 VIA SOM-9X50-STK Device.................................................................................................................... 1
2. Connecng to Amazon KVS ............................................................................................................................ 2
2.1 Introducon .......................................................................................................................................... 2
2.2 Acquiring an AWS Access Key for Amazon KVS..................................................................................... 2
2.3 Set up the VIA SOM-9X50-STK Device................................................................................................... 7
2.4 Connecng to Amazon KVS with the Yocto EVK.................................................................................... 8
2.5 Connecng to Amazon KVS with the Android EVK.............................................................................. 10
2.6 Debugging........................................................................................................................................... 12
2.7 Troubleshoong .................................................................................................................................. 12

1
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
1. Introducon
This document provides instrucons on how to set up Amazon Kinesis Video Streams (Amazon KVS) to connect
with VIA SOM-9X50-STK devices.
Note:
The VIA SOM-9X50-STK includes the VIA SOM-9X50 module and the VIA VAB-950 reference carrier board.
1.1 Direcng Data from a VIA SOM-9X50-STK Device
to an AWS Portal
To direct data from VIA SOM-9X50-STK devices to your AWS cloud implementaon, an Amazon KVS service
must be set up and congured to receive data from the devices. An AWS access key is required for Amazon KVS
to connect a device to the AWS backend.
Follow the steps listed in secon 2.2 to acquire an AWS access key for Amazon KVS. The access key (*.csv) for
the desired user ID will be created as described in Step 8.
1.2 VIA SOM-9X50-STK Device
The datasheet and user manual of the VIA SOM-9X50-STK device can be found on the VIA SOM-9X50-STK
product page.

2
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
2. Connecng to Amazon KVS
2.1 Introducon
This secon provides instrucons on how to establish a connecon between a VIA SOM-9X50-STK device and
Amazon KVS service, including how to acquire an AWS access key for Amazon KVS, set up the VIA SOM-9X50-
STK device, and connect the device to the Amazon KVS using the VIA SOM-9X50-STK Yocto or Android EVK.
2.2 Acquiring an AWS Access Key for Amazon KVS
Step 1
Refer to instrucons in the following secons on webpage hps://docs.aws.amazon.com/kinesisvideostreams/
latest/dg/gs-account.html to set up an AWS Account:
• Sign up for an AWS account
• Create an Administrator IAM User
• Create an AWS Access Key
Pay special aenon to the Notes on the webpage.

3
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
Step 2
Click on ‘Services’ in the top menu panel and click on ‘IAM’ under the ‘Security, Identy, & Compliance’
category.
1
3
2
Step 3
Click on ‘Access management/Users’ and then click on the ‘Add users’ buon in the right panel.
1
2
3

4
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
Step 4
To add a user, enter a preferred name in the ‘User name’ eld, select ‘Programmac access’ in the ‘Select AWS
access type’ secon and click on the ‘Next: Permissions’ buon to proceed to set permissions.
1
2
3
Step 5
To set permissions, click on ‘Aach exisng policies directly’, click on the policy name
‘AmazonKinesisVideoStreamsFullAccess’ and click on the ‘Next: Tags’ buon to proceed to add tags.
1
2
3

5
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
Step 6
To add tags, enter relevant user informaon (e.g., email address, job tle) or name only in the ‘Key’ eld and
click on the ‘Next: Review’ buon to review your choices.
1
2
Step 7
This page displays all the sengs to be reviewed, including the User name, AWS access type and permissions
boundary. To nish creang the user ID, click on the ‘Create user’ buon.

6
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
Step 8
Once the user ID has been created, a ‘Success’ message will be displayed. Click on the URL in the message for
more informaon on AWS management console access. The User name, Access key ID and the Secret access
key are shown below the message. Download the Secret access key (*.csv) le and click ‘Close’ to nish.
Comprehensive documentaon is provided by Amazon Web Services. Follow the AWS development guide to
add Kinesis Video Streams with dierent sengs on Amazon Web Services. For more informaon, please visit:
hps://docs.aws.amazon.com/kinesisvideostreams/latest/dg/what-is-kinesis-video.html.

7
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
2.3 Set up the VIA SOM-9X50-STK Device
The rst step is to connect a host machine and the VIA SOM-9X50-STK through the onboard COM connector
labeled as "COM".
Use a serial port communicaon program such as PuTTY or Tera Term to connect the debug console. Set the
console Baud Rate to "921600".

8
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
2.4 Connecng to Amazon KVS with the Yocto EVK
The VIA SOM-9X50-STK Yocto EVK includes a "kvs_demo.sh" applicaon to help establish a connecon between
the VIA SOM-9X50-STK device and the Amazon KVS service.
This secon guides developers on how to enable and run the "kvs_demo.sh" applicaon.
Step 1
Copy the Secret access key (*.csv) le downloaded in Step 8 of secon 2.2 to the "/data" locaon.
Step 2
Check the AWS Web console for the Region.
Step 3
Run the "kvs_demo.sh" script as shown below:
root@aiv8385-linux:~# kvs_demo.sh /data/ sh-sw-app1_accessKeys.csv "ap-northeast-1"

9
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
If there are no errors, there will be one KVS stream available. To view the stream, click on ‘Services’ in the top
menu panel and click on ‘Kinesis Video Streams’ under the ‘Media Services’ category.
1
2
3
Step 4
Next, click on 'View video streams' in the right panel.
The names, status, retenon (in hours) and creaon me of the KVS stream will be displayed.
Comprehensive documentaon is provided by Amazon Web Services. Follow the AWS development guide to
add Kinesis Video Streams with dierent sengs on Amazon Web Services. For more informaon, please visit:
hps://docs.aws.amazon.com/kinesisvideostreams/latest/dg/what-is-kinesis-video.html.

10
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
2.5 Connecng to Amazon KVS with the Android EVK
The VIA SOM-9X50-STK Android EVK includes an "AmazonKinesisVideoDemoApp" applicaon to help establish
a connecon between the VIA SOM-9X50-STK device and the Amazon KVS service.
This secon guides developers on how to enable and run the "AmazonKinesisVideoDemoApp" applicaon.
Step 1
Download the "AmazonKinesisVideoDemoApp" sample code from webpage hps://github.com/awslabs/aws-
sdk-android-samples/tree/main/AmazonKinesisVideoDemoApp.
Step 2
Follow the instrucons on the following webpages:
• hps://github.com/awslabs/aws-sdk-android-samples/blob/main/AmazonKinesisVideoDemoApp/
README.md to run the sample code.
• hps://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producersdk-android-downloadcode.
html to download and congure the Android Producer Library Code.
Step 3
Change the "KINESIS_VIDEO_REGION" eld value to your AWS Web console's Region in the sample code le
"KinesisVideoDemoApp.java" at locaon "/src/main/java/com/amazonaws/kinesisvideo/demoapp".
Step 4
The default framerate is 20 and the default bitrate is 384 kbps. Change the "FRAMERATE_20" and
BITRATE_384_KBPS" eld values to your video streams' frame rate and bitrate in the sample code le
"StreamConguraonFragment.java" at locaon "/src/main/java/com/amazonaws/kinesisvideo/demoapp/
fragment".

11
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
Step 5
Sign in to the "AmazonKinesisVideoDemoApp" applicaon. The "Stream Conguraon" screen will be
displayed.
Step 6
Fill in the Stream Name, select the Resoluon as "1280x720", scroll to the boom and click the "Stream"
buon.

12
VIA SOM-9X50-STK Amazon KVS Quick Start Guide
2.6 Debugging
Open a console (e.g. Puy) and congure as described in secon 2.3. The boot up messages will be presented
with a command line interface as well as debug output. Use busybox commands "in /bin" to set up and debug
the VIA SOM-9X50-STK device.
For Android
$ ls /bin
For Yocto
$ ls /bin
2.7 Troubleshoong
Check the table below for troubleshoong common Amazon KVS issues that may arise during development:
Issue Soluon
Device does not connect to the Internet
Conrm that the SIM card is inserted properly.
Conrm that the SIM card is acvated by the service provider.
Verify the APN sengs.
Device does not connect to AWS
Conrm that the date and me is synchronized.
Verify that the appropriate access keys and region are congured
on the VIA SOM-9X50-STK device.
Verify the user policies or role set on AWS IAM.
Frame rate is too low Try adding light if the lighng is too dim.

1F, 531 Zhong-zheng Road,
Xindian Dist., New Taipei City 231
Taiwan
Tel: [phone]
Fax: [phone]
Email: [email protected]om.tw
940 Mission Court
Fremont, CA 94539,
USA
Tel: [phone]
Fax: [phone]
Email: [e-mail]
Email: [e-mail]
Taiwan Headquarters
USA
Europe
Tsinghua Science Park Bldg. 7
No. 1 Zongguancun East Road,
Haidian Dist., Beijing, 100084
China
Tel: [phone]
Fax: [phone]
Email: [e-mail]
3-15-7 Ebisu MT Bldg. 6F,
Higashi, Shibuya-ku
Tokyo 150-0011
Japan
Tel: [phone]
Fax: [phone]
Email: [e-mail]
China
Japan