beautypg.com

3 listfiles command – Campbell Scientific CR1000 Measurement and Control System User Manual

Page 394

background image

Section 8. Operation

394 

 

 

FileControl Response

All output formats contain the following parameters. Any

action

(for example, 9)

that performs a reset, the response is returned before the effects of the command
are complete.

Table 103. FileControl API Command Response

outcome

A response of zero indicates success. Non-zero indicates failure.

holdoff

Specifies the number of seconds that the web client should wait
before attempting more communication with the station. A value
of zero will indicate that communication can resume
immediately. This parameter is needed because many of the
commands will cause the CR1000 to perform a reset. In the case
of sending an operating system, it can take tens of seconds for
the datalogger to copy the image from memory into flash and to
perform the checking required for loading a new operating
system. While this reset is under way, the CR1000 will be
unresponsive.

description

Detail concerning the outcome code.

Example:

192.168.24.106/?command=FileControl&action=4&file=cpu:davetest.c
r1

Response: delete the file davetest.cr1 from the host CR1000 
CPU: drive. 

When

html

is entered in the FileControl

format

parameter, the response will be

HTML. Following is an example response.

8.6.3.7.3 ListFiles Command

ListFiles allows a web client to obtain a listing of directories and files in the host
CR1000. ListFiles takes the form:

http://ip_address/drive/?command=ListFiles

ListFiles requires a minimum .csipasswd access level of 3 (read only).

Table 104. ListFiles API Command Parameters

format

Specifies the format of the response. The values html, json, and
xml are valid. If this parameter is omitted, or if the value is
html, empty, or invalid, the response is HTML.

uri

If this parameter is excluded, or if it is set to "datalogger"
(uri=dl) or an empty string (uri=), the file system will be sent
from the host CR1000.

1

1

Optionally specifies the URI to a LoggerNet datalogger station from which the file list will be

retrieved.