File transfer fields

The filetransfer fields are used for reading and writing static content to and from the hardware. It is used for both the media pool and the macro pool.

Lock management

class pyatem.field.LockStateField(raw)

Data from the LKST. This updates the state of the locks.

Offset	Size	Type	Descriptions
0	2	u16	Store id
2	1	bool	State
3	1	?	unknown

After parsing: :ivar store: Store index :ivar state: True if a lock is held

class pyatem.field.LockObtainedField(raw)

Data from the LKOB. This signals that a datastore lock has been successfully obtained for a specific datastore index. Used for data transfers.

Offset	Size	Type	Descriptions
0	2	u16	Store id
2	2	?	Unknown

After parsing: :ivar store: Store index

Data transfer

class pyatem.field.FileTransferDataField(raw)

Data from the FTDa. This is an incoming chunk of data for a running file transfer.

Offset	Size	Type	Descriptions
0	2	u16	Transfer id
2	2	u16	Data length
?	?	bytes	The rest of the packet contains [Data length] bytes of data

After parsing: :ivar transfer: Transfer index :ivar size: Length of the transfer chunk :ivar data: Contents of the transfer chunk

class pyatem.field.FileTransferDataCompleteField(raw)

Data from the FTDC. Sent after pushing a file.

Offset	Size	Type	Descriptions
0	2	u16	Transfer id
2	1	u8	? (always 1)
3	1	u8	? (always 2 or 6)

After parsing: :ivar transfer: Transfer index that has completed

class pyatem.field.FileTransferErrorField(raw)

Data from the FTDE. Something went wrong with a file transfer and it has been aborted.

Offset	Size	Type	Descriptions
0	2	u16	Transfer id
2	1	u8	Error code
3	1	?	unknown

Error code	Description
1	try-again, Try the transfer again
2	not-found, The requested store/slot index doesn’t contain data
5	no-lock, You didn’t obtain the lock before doing the transfer

After parsing: :ivar transfer: Transfer index :ivar status: Status id from the enum above

class pyatem.field.FileTransferContinueDataField(raw)

Data from the FTCD. This is an field telling the client what chunk size to use to continue the upload of data to the hardware.

Offset	Size	Type	Descriptions
0	2	u16	Transfer id
2	4	?	unknown
6	2	u16	Chunk size
8	2	u16	Chunk count
10	2	?	unknown

After parsing: :ivar transfer: Transfer index :ivar size: Length of the transfer chunk :ivar count: Contents of the transfer chunk

Pool settings

class pyatem.field.MediaplayerFileInfoField(raw)

Data from the MPfe. This is the metadata about a single frame slot in the mediaplayer

Offset	Size	Type	Description
0	1	u8	type
1	1	?	unknown
2	2	u16	index
4	1	bool	is used
5	16	char[]	hash
21	2	?	unknown
23	?	string	name of the slot, first byte is number of characters

After parsing:

Variables:

• index – Slot index

• type – Slot type, 0=still

• is_used – Slot contains data

• hash – 16-byte md5 hash of the slot data

• name – Name of the content in the slot

class pyatem.field.MacroPropertiesField(raw)

Data from the MPrp. This is the metadata about a stored macro

Offset	Size	Type	Description
0	2	u16	Macro slot index
2	1	bool	is used
3	1	bool	has invalid commands
4	2	u16	Name length
6	2	u16	Description length
8	?	char[]	Name
?	?	char[]	Description

After parsing:

Variables:

• index – Macro slot index

• is_used – Slot contains data

• is_invalid – Slot contains invalid data

• name – Name of the macro

• description – Description of the macro