RL-ARM User's Guide

Technical Support

On-Line Manuals

RL-ARM User's Guide

RL-RTX RL-FlashFS RL-TCPnet TCP Socket Opening TCP Connection TCP Active Open TCP Passive Open Sending TCP Data Example for Sending Data Multiple TCP Connections UDP Socket Opening UDP Connection Sending UDP Data When DHCP Enabled When ARP Cache Empty Example for Sending Data IP Multicasting Multiple UDP Connections Configuring RL-TCPnet Static Configuration System Definitions Ethernet Network Interface PPP Network Interface SLIP Network Interface UDP Socket TCP Socket BSD Socket HTTP Server Telnet Server TFTP Server TFTP Client FTP Server FTP Client DNS Client SMTP Client SNMP Agent SNTP Client Error Function Runtime Configuration Library Files Using RL-TCPnet Stand Alone With RTX Kernel Event Driven Operation IP Address Assignment Ethernet Interface PPP Interface SLIP Interface Localhost Applications HTTP Server Script Language CGI Functions Ajax Support Using XML XML Example How it works SOAP Support SOAP Interface Large POST Messages Web Pages Default Page Error Pages Web on SD Card Web Update File System Interface Http Caching How it works Internal Web External Web Multi-user Authentication Using RAM File System FCARM File Converter PRINT Directive NOPRINT Directive PAGEWIDTH Directive PAGELENGTH Directive ROOT Directive Telnet Server Command Line Interface Multi-user Authentication Sending Reply Message Short Reply Long Reply Continuous Screen Update TFTP Server File System Interface TFTP Client File System Interface FTP Server File System Interface Multi-user Authentication Supported Commands FTP Client File System Interface SMTP Client SNMP Agent MIB Database MIB Interface MIB Entry MIB Table DNS Resolver Starting DNS Device Drivers Ethernet Driver Interrupt Mode Modem Driver Serial Driver Using Serial Link Cable Connection Modem Connection Windows Dial-up Add Direct Serial Link New Dial-up Connection Configure PPP Dial-up Configure SLIP Dial-up Debugging Enabling Debug Debug Level Redirecting Output Function Overview BSD Routines CGI Routines Ethernet Routines FTP Routines HTTP Routines IGMP Routines Miscellaneous Routines Modem Routines PPP Routines Serial Routines SLIP Routines SMTP Routines SNMP Routines System Functions TCP Routines Telnet Routines TFTP Routines UDP Routines RL-CAN RL-USB Example Programs Library Reference Appendix

FCARM File Converter

This file converter reformats all the web files into a single C-file, which is then included and compiled into the project. All the files are stored in the Virtual ROM File System.

The FCARM file converter has integrated also a file optimization algorithm to compress the html, java script and cgi script files. This allows you to create more compact and smaller executable images.

The FCARM command line syntax is:

FCARM <{>inputlist<}> <{> TO outputfile<}> <{>directives<}>

or

FCARM @commandfile

Where

inputlist is a comma-separated list of web files for the file converter to include in the output file.

The inputlist uses the following general format:
filename <{> , ... <}>

Where

filename is the name of an html, script or image file. The filename must be specified with a file extension, but without the path information.
outputfile is the name of the output C-file containing converted web files.
directives are commands and parameters that control the operation of the file converter.
commandfile is the name of a command file that can contain an inputlist, outputfile, and directives.

File Converter Directives

The following table describes all FCARM Converter directives.

Directive Description
PRINT Specifies the name of the listing file.
NOPRINT Disables generation of the listing (LST) file.
PAGEWIDTH Specifies the number of characters on a line in the listing file.
PAGELENGTH Specifies the number of lines on a page in the listing file.
ROOT Specifies the root path where web files are located relative to the project directory path.

Disabling Optimization

To disable the FCARM optimization for a web content file, you have to add the tilde prefix (~) to the file name. For example, to disable optimization for jquerry.js, specify this file in a list as ~jquerry.js.

This allows you to selectively disable optimization for a file of interest. For example if you want to debug java script file, it is very hard to trace the code that is compacted to a single line with no spaces, no comments and no line feed separators.

Examples

The following command line example invokes FCARM, specifies the web file index.htm. The output C-file is index.c which the file converter creates.

FCARM index.htm

The following command line example invokes FCARM, specifies the web files index.htm, keil.gif, llblue.jpg, system.cgi, and specifies the C-file web.c which the file converter creates.

FCARM index.htm, keil.gif, llblue.jpg, system.cgi to web.c

The following command line example invokes FCARM, specifies the web files index.htm, keil.gif, llblue.jpg, system.cgi, specifies the C-file web.c, and disables generation of the listing file. The web files are located in subfolder Web_Files.

FCARM index.htm, keil.gif, llblue.jpg, system.cgi to web.c nopr root(Web_Files)