Sena HelloDevice STS Series User manual

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 1/15 -
HelloDevice STS Series
User Customization Guide
Version 1.1.0
2006-07-25

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 2/15 -
Copyright Information
Copyright 1998-2004, Sena Technologies, Inc. All rights reserved.
Sena Technologies reserves the right to make any changes and improvements to its product without providing prior notice.
TrademarkInformation
HelloDevice™is a trademark of Sena Technologies, Inc.
Technical Support
Sena Technologies, Inc.
210 Yangjae-dong, Seocho-gu
Seoul 137-130, Korea
Tel: [phone]
Fax: [phone]
E-Mail:[e-mail]
Website: http://www.sena.com

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 3/15 -
Revision history
Revision Date Name Description
V0.0.1 2003-09-09 H. Yeom Initial Draft
V1.0.0 2003-09-22 H. Yeom Initial Release
V1.1.0 2004-01-12 H. Yeom GDB support and sample filter programs are added

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 4/15 -
Content
1. Overview...............................................................................................................................................................5
2. SDK (Software Development Kit)....................................................................................................................5
3. How to build user programs?...........................................................................................................................6
3.1. Preparing ....................................................6
3.2. Coding .......................................................6
3.3. Uploading Files ..............................................6
3.4. Building and Executing........................................6
4. User Web Customization...................................................................................................................................6
4.1. HTML Files ...................................................6
4.2. CGI files ....................................................7
4.3. Java applets and so on........................................8
5. User Filter Customization..................................................................................................................................8
5.1. Understanding Filter Programs .................................8
5.2. Building Filter Program.......................................9
5.3. Filter Samples ..............................................10
6. Debugging with GDB.......................................................................................................................................11
6.1. Debugging sample filter program with GDB .....................11

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 5/15 -
1. Overview
The HelloDevice STS Series is a serial to Ethernet programmable communication gateway for
RS-232 based serial devices with various customization options.
Sena provides easy to use Software Development Kit (SDK) environment to quickly develop
custom applications that run on the HelloDevice STS Series. Users can customize the web
management interface, and integrate the programmed dynamic web pages to web menu.
In addition, user can manipulate the data stream which routes from serial device to socket and
socket to serial device. The user-defined filter program communicates with other programs that are
reading/writing serial port and socket by using FIFOs, and so user can easily manipulate the serial
data without programming related to serial port and socket. The unit runs the embedded Linux
Operating system and facilitates programming using command-line interface or one of several
prepared scripts, using UNIX / Linux commands.
2. SDK (Software Development Kit)
To make user’s own application code, SDK for STS400/800/1600 is needed. STS400/800/1600
SDK is provided in the form of PC CF card (Please contact Sena Technical Support to get SDK for
STS400/800/1600.). The SDK contains compiler, linker, library files, header files and some sample C
files. The directory structure of the SDK is as follows.
/mnt/flash bin
sample
lib
include
Binary files can be executed.
gcc, ld, ar, as, ...
Header files for STS applications.
Library files for STS application
web
filter
Sample C files for web
customization.
Sample C files for filter
customization.

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 6/15 -
3. How to build user programs?
3.1. Preparing
Follow the below steps to prepare the development environment for customization.
1) Get a SDK for STS400/800/1600 in the form of CF card.
2) Insert the SDK into the PCMCIA(PC card) slot of the STS device.
3) On the configuration menu, probe the PC card and then save and apply it.
3.2. Coding
Write source files in the C language and Makefiles. You can edit the source files on the STS
Series CLI but if it is uncomfortable, you can do it on PC or Linux box. Almost all the Linux libraries
are locatedat /mnt/flash/lib directory.
3.3. Uploading Files
If you edit the files on the STS Series CLI, skip over this section. To compile the source files,
you must have uploaded the files to the STS device. You can upload the files in three ways as
follows.
-SCP
-FTP
-Configuration menu
For more detail information, refer to the User Guide.
3.4. Building and Executing
Compile, link and execute the programs as follows. (Imagine, a program named prog consists of
two C source files proga.c and progb.c).
# gcc –o prog proga.c progb.c
# ./prog
4. User Web Customization
4.1. HTML Files
You may customize the web management interface by adding your own HTML files in STS Series.
All the HTML files must be in the /usr2/usrweb directory. There is a sample HTML file that is named
index.html. Copy the file to /usr2/usrweb, and then you can see the HTML page like below.

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 7/15 -
4.2. CGI files
4.2.1 Building CGI files
Below is the procedure to build CGI files. Sample CGI source file is located at
/mnt/flash/sample/web/cgi/shell.c,
Step 1. Build the CGI file.
# cd /mnt/flash/sample/web/cgi
# make
Step 2. Copy the CGI file.
# cp shell.cgi /usr2/cgi-bin/
Step 3. Execute aWeb browser, connect to the STS400/800/1600, and log in.
Step 4. At the Web browser, go to http://192.168.1.2/cgi-bin/shell.cgi. (Suppose that
the IP address of the STS400/800/1600 is 192.168.1.2)
4.2.2 Using CGI files
The CGI files must be in the /usr2/cgi-bin directory. If there is a CGI file named default, the file can

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 8/15 -
be an entry page of the custompages.
Here is a Makefile to make the shell.c.
CC = gcc
BIN = shell.cgi
OBJS = shell.o util_cgi.o
LDFLAG = -L/mnt/flash/lib
BIN : $(OBJS)
$(CC) -o $(BIN) $(OBJS) $(LDFLAG)
c.o : $(CC) -c $<
all : $(BIN)
clean :
rm -f $(BIN) $(OBJS)
The util_cgi.h and util_cgi.c are attached at the Appendix A. These CGI programs
must be in the /usr2/cgi-bin directory.
4.3. Java applets and so on
JAVA applets are also available. The applet files and all web files except CGI program must be in
the /usr2/usrweb directory.
5. User Filter Customization
5.1. Understanding Filter Programs
STS400/800/1600 uses FIFO method for inter-process communication. User can insert a
program to manipulate the data stream which routes from serial device to socket and socket to serial
device. The user-defined filter program communicates with other programs that are reading/writing
serial port and socket by using FIFOs.

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 9/15 -
Serial port Read/Write App.
Socket Read/Write App.
Filter App.
FIFOs
FIFOs
Remote Hosts
Serial Port
The user-defined filter reads a FIFO that is streaming the serial port data, manipulate the data and
write the manipulated data to a FIFO that is sent to socket. The data stream that goes from socket to
serial port can be manipulated in the same way. It must be satisfactory for following qualifications.
1) Write the data stream going to serial port to FIFO that is named
/tmp/port_fifos/portX_f2s (Xis the port index based on 1 ).
2) Write the data stream going to serial port to FIFO that is named
/tmp/port_fifos/portX_f2e.
3) Read the data stream coming from serial port to FIFO that is named
/tmp/port_fifos/portX_s2f.
4) Read the data stream coming fromsocket to FIFO that is named
/tmp/port_fifos/portX_e2f.
5) Open four FIFOs on being executing and do not close the FIFOs except to be terminated.
6) Have more than one arguments and the first argument must indicate the port number.
7) Record the PID (Process ID) to the file that is named /var/run/portX_filter.pid.
(This PID file is used to terminate the filter application, but it is terminated only in case the
port is disabled.)
8) Be terminated when it receives the SIGTERM signal.
5.2. Building Filter Program
Below is the procedure to build Filter program. The sample programs are located at
/mnt/flash/sample/filter/ directory.
Step 1. Build a filter program.
# cd /mnt/flash/sample/filter
# make

Sena Technologies, Inc.
__________________________________________________________________________
__________________________________________________________________________________________-
- 10/15 -
Step 2. Copy one of sample filter programs to user space.
# cp data_conversion /usr2/sample_filter
Step 3. Configure the filter application settings as follows:
5.3. Filter Samples
All sample programs are composed of three threads, one main thread, one reading on serial port
thread and one reading on socket thread. The main thread creates the other threads, and then waits
until SIGTERM signal is received. If main thread receives SIGTERM signal, it cancels the other
threads. The readings on serial port/socket threads are modified to its purpose.
- empty.c
This sample filter connects the serial port read/write application and socket read/write application
with FIFOs. It does not manipulate the data.
- periodic_command.c
This sample filter connects the serial port read/write application and socket read/write application
with FIFOs and writes a command to serial port periodically.
- data_conversion.c
This sample filter is an example for protocol conversion.
- data_calibration.c
This sample filter is an example that calculates the average of periodically incoming serial port
data (e.g. thermometer data, hygrometer data) and sends it.
- data_storing.c
This sample filter is an example that watches serial port data (e.g. thermometer data, hygrometer
data) and saves it to RAM disk.(under /tmp directory)
- data_event_handling.c
This sample filter is an example that watches serial port data (e.g. thermometer data, hygrometer
data) and sends SNMP traps.