Uploading¶

Data can be uploaded to instruments through a serial connection, by simply sending the file data line by line. Most instruments, that support data uploads through serial, accept coordinate data in CSV format. Some instruments also support their own specialized database record formats.

Requirements¶

Instrument capable of serial ASCII data transfer

Caution

Currently only ASCII encodable files can be uploaded. Older instruments do not accept special code pages like windows-1252 and other extended ASCII sets (especially not modern unicode), so accented characters have to be avoided.

Usage¶

iman upload data¶

Upload ASCII data to the instrument.

This command can be used to send ASCII data line by line to an instrument, that supports serial data transfer. Such data can be a CSV formatted coordinate list, or an instrument specific format type (e.g. Leica GSI, Sokkia SDR).

To ensure the successful reception of the data, it is recommended to use 1200 baud. At higher speeds the instrument might not be able to process the data quickly enough, leading to the receiving buffer filling up, which will result in loss of data.

The instrument should be set to receiving mode before starting the upload.

iman upload data [OPTIONS] PORT FILE

Options

-b, --baud <baud>¶

Serial speed

Options:¶: 1200 | 2400 | 4800 | 9600 | 19200 | 38400 | 56000 | 57600 | 115200 | 230400 | 921600

-t, --timeout <timeout>¶: Serial timeout

-s, --skip <skip>¶: Number of header rows to skip

Arguments

PORT¶

Required argument

Serial port that the instrument is connected to (must be a valid identifier like COM1 or /dev/usbtty0)

FILE¶

Required argument

Data file to upload