sbp-0.52.2: SwiftNav's SBP Library

CopyrightCopyright (C) 2015 Swift Navigation, Inc.
LicenseLGPL-3
MaintainerMark Fine <dev@swiftnav.com>
Stabilityexperimental
Portabilityportable
Safe HaskellNone
LanguageHaskell2010

SwiftNav.SBP.FileIo

Description

Messages for using device's onboard flash filesystem functionality. This allows data to be stored persistently in the device's program flash with wear-levelling using a simple filesystem interface. The file system interface (CFS) defines an abstract API for reading directories and for reading and writing files. Note that some of these messages share the same message type ID for both the host request and the device response.

Synopsis

Documentation

data MsgFileioReadReq Source

SBP class for message MSG_FILEIO_READ_REQ (0x00A8).

The file read message reads a certain length (up to 255 bytes) from a given offset into a file, and returns the data in a MSG_FILEIO_READ_RESP message where the message length field indicates how many bytes were succesfully read.The sequence number in the request will be returned in the response. If the message is invalid, a followup MSG_PRINT message will print "Invalid fileio read message". A device will only respond to this message when it is received from sender ID 0x42.

Constructors

MsgFileioReadReq 

Fields

_msgFileioReadReq_sequence :: Word32

Read sequence number

_msgFileioReadReq_offset :: Word32

File offset

_msgFileioReadReq_chunk_size :: Word8

Chunk size to read

_msgFileioReadReq_filename :: ByteString

Name of the file to read from

data MsgFileioReadResp Source

SBP class for message MSG_FILEIO_READ_RESP (0x00A3).

The file read message reads a certain length (up to 255 bytes) from a given offset into a file, and returns the data in a message where the message length field indicates how many bytes were succesfully read. The sequence number in the response is preserved from the request.

Constructors

MsgFileioReadResp 

Fields

_msgFileioReadResp_sequence :: Word32

Read sequence number

_msgFileioReadResp_contents :: [Word8]

Contents of read file

data MsgFileioReadDirReq Source

SBP class for message MSG_FILEIO_READ_DIR_REQ (0x00A9).

The read directory message lists the files in a directory on the device's onboard flash file system. The offset parameter can be used to skip the first n elements of the file list. Returns a MSG_FILEIO_READ_DIR_RESP message containing the directory listings as a NULL delimited list. The listing is chunked over multiple SBP packets. The sequence number in the request will be returned in the response. If message is invalid, a followup MSG_PRINT message will print "Invalid fileio read message". A device will only respond to this message when it is received from sender ID 0x42.

Constructors

MsgFileioReadDirReq 

Fields

_msgFileioReadDirReq_sequence :: Word32

Read sequence number

_msgFileioReadDirReq_offset :: Word32

The offset to skip the first n elements of the file list

_msgFileioReadDirReq_dirname :: ByteString

Name of the directory to list

data MsgFileioReadDirResp Source

SBP class for message MSG_FILEIO_READ_DIR_RESP (0x00AA).

The read directory message lists the files in a directory on the device's onboard flash file system. Message contains the directory listings as a NULL delimited list. The listing is chunked over multiple SBP packets and the end of the list is identified by an entry containing just the character 0xFF. The sequence number in the response is preserved from the request.

Constructors

MsgFileioReadDirResp 

Fields

_msgFileioReadDirResp_sequence :: Word32

Read sequence number

_msgFileioReadDirResp_contents :: [Word8]

Contents of read directory

data MsgFileioRemove Source

SBP class for message MSG_FILEIO_REMOVE (0x00AC).

The file remove message deletes a file from the file system. If the message is invalid, a followup MSG_PRINT message will print "Invalid fileio remove message". A device will only process this message when it is received from sender ID 0x42.

Constructors

MsgFileioRemove 

Fields

_msgFileioRemove_filename :: ByteString

Name of the file to delete

data MsgFileioWriteReq Source

SBP class for message MSG_FILEIO_WRITE_REQ (0x00AD).

The file write message writes a certain length (up to 255 bytes) of data to a file at a given offset. Returns a copy of the original MSG_FILEIO_WRITE_RESP message to check integrity of the write. The sequence number in the request will be returned in the response. If message is invalid, a followup MSG_PRINT message will print "Invalid fileio write message". A device will only process this message when it is received from sender ID 0x42.

Constructors

MsgFileioWriteReq 

Fields

_msgFileioWriteReq_sequence :: Word32

Write sequence number

_msgFileioWriteReq_offset :: Word32

Offset into the file at which to start writing in bytes

_msgFileioWriteReq_filename :: ByteString

Name of the file to write to

_msgFileioWriteReq_data :: [Word8]

Variable-length array of data to write

data MsgFileioWriteResp Source

SBP class for message MSG_FILEIO_WRITE_RESP (0x00AB).

The file write message writes a certain length (up to 255 bytes) of data to a file at a given offset. The message is a copy of the original MSG_FILEIO_WRITE_REQ message to check integrity of the write. The sequence number in the response is preserved from the request.

Constructors

MsgFileioWriteResp 

Fields

_msgFileioWriteResp_sequence :: Word32

Write sequence number