UEIPAC Linux Software Development Kit User Manual 5.0 December 2020 Edition © Copyright 2020 United Electronic Industries, Inc. All rights reserved No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form by any means, electronic, mechanical, by photocopying, recording, or otherwise without prior written permission. UEIPAC SDK User Manual Table of contents 1 Introduction............................................................................................1 1.1 Kernel Options.....................................................................................................3 2 Setting up a development system..........................................................4 2.1 Windows host......................................................................................................4 2.2 Linux host............................................................................................................6 2.2.1 Preparing your 64-bit Linux host.....................................................................6 2.2.2 Installing UEIPAC software on your Linux host............................................6 2.3 SDK directory layout...........................................................................................7 3 Configuring the UEIPAC......................................................................8 3.1 Connecting through the serial port......................................................................8 3.2 Root filesystem..................................................................................................13 3.2.1 Booting from an SD card...............................................................................14 3.2.2 Booting from an SSD drive...........................................................................16 3.2.3 Booting from an MTD partition (Flash)........................................................18 3.2.4 Booting from a RAM disk.............................................................................19 3.2.5 Booting from an NFS share...........................................................................24 3.2.6 Revert to booting from an SD card................................................................25 3.3 Configuring the Network...................................................................................26 3.3.1 Configuring a static IP address......................................................................26 3.3.2 Changing the default packet size (MTU).......................................................27 3.3.3 Configuring dynamic IP address (using a DHCP server)..............................28 3.3.4 Name resolution.............................................................................................29 3.3.5 Connecting through Telnet............................................................................29 3.3.6 Connecting through SSH...............................................................................29 3.3.7 Configuring DHCP server.............................................................................30 3.4 Configuring date and time.................................................................................30 3.4.1 Changing the date..........................................................................................30 3.4.2 Changing the time zone.................................................................................30 3.4.3 Connecting to an NTP server.........................................................................31 3.5 Changing the password......................................................................................31 3.6 Configuring the web server...............................................................................31 3.7 System logger....................................................................................................31 © Copyright 2019 www.ueidaq.com United Electronic Industries, Inc. i 508.921.4600 UEIPAC SDK User Manual 4 Transferring files..................................................................................33 4.1 NFS....................................................................................................................33 4.2 FTP Client..........................................................................................................33 4.3 FTP Server.........................................................................................................33 4.4 SSH....................................................................................................................33 4.5 TFTP Client.......................................................................................................34 4.6 Windows shared directory.................................................................................34 5 Connecting USB devices......................................................................35 5.1 USB mass storage..............................................................................................35 5.2 Wifi network interface.......................................................................................36 5.2.1 Load kernel modules......................................................................................37 5.2.2 Connection to an open access point...............................................................37 5.2.3 Connection to an access point with WEP security........................................38 5.2.4 Connection to an access point with WPA/WPA2 security............................38 5.2.5 Direct connection to another computer in ad-hoc mode................................40 5.3 UMTS/GSM modem.........................................................................................40 5.3.1 Prerequisite....................................................................................................40 5.3.2 Manual configuration.....................................................................................41 5.3.3 Automatic startup...........................................................................................44 5.4 Serial Port..........................................................................................................44 5.4.1 Load kernel modules......................................................................................44 5.4.2 Automatic startup...........................................................................................45 5.5 LibUSB..............................................................................................................45 5.5.1 Prerequisite....................................................................................................45 5.5.2 Write a program using libusb........................................................................45 6 Serial Port.............................................................................................46 6.1 UEI Serial Server...............................................................................................46 6.2 Using the CPU layer’s serial port for general purpose......................................48 7 Testing the I/O layers...........................................................................49 7.1 devtbl.................................................................................................................49 7.2 Run examples.....................................................................................................49 7.3 PowerDNA server..............................................................................................50 © Copyright 2019 www.ueidaq.com United Electronic Industries, Inc. ii 508.921.4600 UEIPAC SDK User Manual 8 Application development.....................................................................51 8.1 Prerequisites.......................................................................................................51 8.2 Compiling and running Hello World.................................................................51 8.3 Debugging Hello World....................................................................................52 8.4 PowerDNA Library...........................................................................................54 8.4.1 PowerDNA API.............................................................................................56 8.4.2 Building and running the examples...............................................................66 8.4.3 Building your own program...........................................................................66 8.5 Synchronization.................................................................................................67 8.5.1 PTP Synchronization.....................................................................................67 8.5.2 External PPS Synchronization.......................................................................68 8.6 Real-Time Programming...................................................................................68 8.6.1 Programming with Real-Time Linux.............................................................68 8.6.2 Programming with Xenomai Real-Time framework.....................................70 8.7 Running a program automatically after boot.....................................................72 8.8 Running a program periodically........................................................................73 9 Firmware installation and upgrade....................................................74 9.1 Installing or