tivars.flash.TIFlashHeader

class documentation

class TIFlashHeader(TIComponent): (source)

Known subclasses: tivars.types.flash.TIApp, tivars.types.flash.TICertificate, tivars.types.flash.TILicense, tivars.types.flash.TIOperatingSystem

Constructor: TIFlashHeader(init, magic, revision, binary_format, ...)

View In Hierarchy

Parser for flash headers

A flash file can contain up to three headers, though usually only one.

Class	`Raw`	No class docstring; 3/3 properties, 0/1 class variable, 1/1 method documented
Class Method	`get_extension`	Determines the header's file extension given a targeted model
Class Method	`get_type`	Gets the subclass corresponding to a type ID, type name, or file extension if one is registered
Class Method	`open`	Creates a new header from a file given a filename
Static Method	`next_header_length`	Helper function to determine the length of the next flash header in a bytestream
Method	`__init__`	Creates an empty flash header with specified meta and data values
Method	`__len__`	No summary
Method	`binary_flag`	Whether this flash header's data is in binary (0x00) or Intel (0x01) format
Method	`bytes`	No summary
Method	`calc_data`	The data stored in the flash header
Method	`data`	The data stored in the flash header as either raw binary or Intel blocks
Method	`date`	The date attached to the flash header as a 3-tuple
Method	`device_type`	The (first) device targeted by the flash header
Method	`devices`	The devices targeted by the flash header
Method	`export`	Exports this header to a `TIFlashFile` with a specified name
Method	`load_bytes`	Loads a byte string or bytestream into this header
Method	`load_from_file`	Loads this header from a file given a file pointer and offset
Method	`magic`	The file magic for the flash header
Method	`name`	The name or basecode attached to the flash header
Method	`object_type`	The object type of the flash header
Method	`product_id`	The product ID for the header
Method	`revision`	The revision of the flash header
Method	`save`	Saves this header to the current directory given a filename and targeted model
Method	`summary`	No summary
Method	`type_id`	The (first) type ID of the flash header
Class Variable	`extensions`	The file extension used for this header per-model
Instance Variable	`raw`	Undocumented
Property	`calc_data_size`	The length of the data stored in the flash header, measured in chars
Property	`checksum`	The checksum for the flash header
Property	`name_length`	The length of the name or basecode attached to the flash header
Method	`__init_subclass__`	Undocumented
Class Variable	`_type_ids`	Undocumented
Instance Variable	`_has_checksum`	Undocumented

Inherited from TIComponent:

Class Method	`get`	Converts `bytes` -> `TIComponent`
Class Method	`register`	Registers a subtype with this class for coercion
Class Method	`set`	Converts `TIComponent` -> `bytes`
Method	`__bool__`	No summary
Method	`__bytes__`	No summary
Method	`__copy__`	No summary
Method	`__eq__`	Determines if two components are the same type and have the same bytes
Method	`__format__`	Undocumented
Method	`__str__`	No summary
Method	`clear`	Clears this component's data
Method	`coerce`	Coerces this component to a subclass if possible using the component's type ID
Method	`dict`	No summary
Method	`json`	No summary
Method	`load_dict`	Loads this component from a JSON dictionary representation
Method	`load_json`	Loads this component from a JSON dictionary representation
Method	`load_string`	Loads this component from a string representation
Method	`string`	No summary
Method	`update`	Updates this component's metadata
Property	`is_empty`	Whether this component's data is empty
Class Variable	`_type_id`	Undocumented

Inherited from Dock (via TIComponent):

Method	`load`	Loads data into an instance by delegating to `Loader` methods based on the input's type
Class Variable	`loaders`	Undocumented

@classmethod

def get_extension(cls, model: TIModel = TI_84PCE) -> str: (source) ¶

overrides tivars.file.TIComponent.get_extension

Determines the header's file extension given a targeted model

Parameters
model:`TIModel`	A model to target (defaults to `TI_84PCE`)

Returns
`str`	The header's file extension for that model

@classmethod

def get_type(cls, *, type_id: int = None, name: str = None, extension: str = None) -> type[Self] | None: (source) ¶

overrides tivars.file.TIComponent.get_type

Gets the subclass corresponding to a type ID, type name, or file extension if one is registered

Parameters
type_id:`int`	The type ID to search by, or
name:`str`	The type name to search by, or
extension:`str`	The file extension to search by

Returns
`type[Self] \| None`	A subclass of this component with corresponding type ID or extension, or `None`

@classmethod

def open(cls, filename: str) -> Self: (source) ¶

overrides tivars.file.TIComponent.open

Creates a new header from a file given a filename

Parameters
filename:`str`	A filename to open

Returns
`Self`	The (first) header stored in the file

@staticmethod

def next_header_length(stream: BinaryIO) -> int: (source) ¶

Helper function to determine the length of the next flash header in a bytestream

Parameters
stream:`BinaryIO`	A bytestream

Returns
`int`	The length of the next header in the bytestream

def __init__(self, init=None, *, magic: str = '**TIFL**', revision: str = '0.0', binary_format: bool = False, object_type: int = 136, date: tuple[int, int, int] = (0, 0, 0), name: str = 'UNNAMED', device_type: int | DeviceType = DeviceType.TI_83P, product_id: int = 0, data: bytes = b':00000001FF'): (source) ¶

overrides tivars.file.TIComponent.__init__

Creates an empty flash header with specified meta and data values

Parameters
init	Values to initialize the header's data (defaults to `None`)
magic:`str`	File magic at the start of the header (defaults to `TIFL`)
revision:`str`	The header's revision number (defaults to `0.0`)
binary_format:`bool`	Whether the header's data is stored in binary format (defaults to `False`)
object_type:`int`	The header's object type (defaults to `$88`)
date:`tuple[int, int, int]`	The header's stored date as a tuple (dd, mm, yyyy) (defaults to null)
name:`str`	The name of the headers (defaults to `UNNAMED`)
device_type:`int \| DeviceType`	The device type of the header (defaults to `$73`, the 83+ series)
product_id:`int`	The targeted model's product ID (defaults to `$00`)
data:`bytes`	The header's data (defaults to empty)

def __len__(self) -> int: (source) ¶

overrides tivars.file.TIComponent.__len__

Returns
`int`	The total length of this header's bytes

@Section(1, Bits[:])

def binary_flag(self) -> int: (source) ¶

Whether this flash header's data is in binary (0x00) or Intel (0x01) format

def bytes(self) -> bytes: (source) ¶

overrides tivars.file.TIComponent.bytes

Returns
`bytes`	The bytes contained in this header

@Section()

def calc_data(self) -> bytearray: (source) ¶

overrides tivars.file.TIComponent.calc_data

overridden in tivars.types.flash.TILicense

The data stored in the flash header

@View(calc_data, FlashData)[:]

def data(self) -> bytes | list[TIFlashBlock]: (source) ¶

overrides tivars.file.TIComponent.data

The data stored in the flash header as either raw binary or Intel blocks

If binary_flag == $01, the data is returned as list[TIFlashBlock]. Otherwise, the data is returned as bytes.

@Section(4, BCDDate)

def date(self) -> tuple[int, int, int]: (source) ¶

The date attached to the flash header as a 3-tuple

@View(devices, DeviceType)[0:1]

def device_type(self) -> DeviceType: (source) ¶

The (first) device targeted by the flash header

@Section(None, FlashDevices)

def devices(self) -> list[tuple[DeviceType, int]]: (source) ¶

The devices targeted by the flash header

Each device is a (device_type, type_id) tuple. The type_id should be constant throughout. Only licenses may be expected to have more than one device.

def export(self, *, name: str = None) -> TIFlashFile: (source) ¶

Exports this header to a TIFlashFile with a specified name

Parameters
name:`str`	The name of the flash file (defaults to this header's name)

Returns
`TIFlashFile`	A `TIFlashFile` containing this header

@Loader[bytes, bytearray, memoryview, BytesIO]

def load_bytes(self, data: bytes | BytesIO): (source) ¶

overrides tivars.file.TIComponent.load_bytes

Loads a byte string or bytestream into this header

Parameters
data:`bytes \| BytesIO`	The bytes to load

@Loader[BinaryIO]

def load_from_file(self, file: BinaryIO, *, offset: int = 0): (source) ¶

overrides tivars.file.TIComponent.load_from_file

Loads this header from a file given a file pointer and offset

Parameters
file:`BinaryIO`	A binary file to read from
offset:`int`	The offset of the header to read

@Section(8, String)

def magic(self) -> str: (source) ¶

The file magic for the flash header

@Section(8, String)

def name(self) -> str: (source) ¶

overrides tivars.file.TIComponent.name

The name or basecode attached to the flash header

@Section(1, Bits[:])

def object_type(self) -> int: (source) ¶

The object type of the flash header

@Section(1, Bits[:])

def product_id(self) -> int: (source) ¶

The product ID for the header

While used to identify the model the var was created on, it has no actual functional ramifications. Furthermore, it does not constitute a 1-to-1 mapping to distinct models.

@Section(2, BCDRevision)

def revision(self) -> int: (source) ¶

The revision of the flash header