Package com.pnfsoftware.jeb.core.units.code.simatic

Interface IS7Unit

All Superinterfaces:

IBinaryUnit, ICodeObjectUnit, IEventSource, IS7BlocksManager, IUnit, IUnitCreator, IUserDataSupport

public interface IS7Unit
extends ICodeObjectUnit, IS7BlocksManager

S7 container unit. Provide mapping support for blocks and MC7 execution environment artifacts into a VM managed by the native code analysis pipeline.

Method Summary

Modifier and Type	Method	Description
long	getAddressOfCode(S7.BlockType type, int number)	Retrieve the mapping address of a logic block's code.
long	getAddressOfCounters()	Retrieve the mapping address of the counters area.
long	getAddressOfData(S7.BlockType type, int number)	Retrieve the mapping address of a data block's data area.
long	getAddressOfDigitalInputs()	Retrieve the mapping address of the digital inputs area.
long	getAddressOfDigitalOutputs()	Retrieve the mapping address of the digital outputs area.
long	getAddressOfGlobals()	Retrieve the mapping address of the global memory area.
long	getAddressOfRawBytes(IS7Block blk)	Retrieve the mapping address of the raw (uninterpreted) bytes of a block.
long	getAddressOfTimers()	Retrieve the mapping address of the timers area.
IS7Block	getBlockAt(long address)	Retrieve the block whose data (if the block is a data block) or code (if the block is a logic block) is mapped at the provided address.
IS7Block	getBlockContaining(long address)	Retrieve the block whose data (if the block is a data block) or code (if the block is a logic block) whose mapping contains the provided address.

Methods inherited from interface com.pnfsoftware.jeb.core.units.IBinaryUnit

getInput, getMimeType

Methods inherited from interface com.pnfsoftware.jeb.core.units.codeobject.ICodeObjectUnit

convertFileOffsetToRelativeAddress, convertRelativeAddressToFileOffset, getExportedSymbols, getImportedSymbols, getLoaderInformation, getRawMemoryMappedImage, getSection, getSectionCount, getSections, getSections, getSegment, getSegmentCount, getSegments, getSegments, getSymbols, getSymbols, getValidSections, getValidSegments, map

Methods inherited from interface com.pnfsoftware.jeb.util.events.IEventSource

addListener, countListeners, getListeners, getParentSource, insertListener, notifyListeners, removeListener, setParentSource

Methods inherited from interface com.pnfsoftware.jeb.core.units.code.simatic.IS7BlocksManager

findBlock, getBlockEntryName, getBlocks

Methods inherited from interface com.pnfsoftware.jeb.core.units.IUnit

addChild, addChild, canBePersisted, dispose, execprvfunc, generateQuickState, getChildren, getContributions, getCreationTimestamp, getDescription, getExtraInputs, getFormatter, getFormatType, getIconData, getInterpreters, getLock, getName, getNotes, getNotificationManager, getParent, getParentArtifact, getParentProject, getPropertyDefinitionManager, getPropertyManager, getRealName, getStatus, getUid, getUnitProcessor, initializePropertyObjects, isDisposed, isProcessed, isStale, isTransientChild, notifyGenericChange, postDeserialization, process, removeChild, setName, setNotes, setParent, setRealName, setUnitProcessor

Methods inherited from interface com.pnfsoftware.jeb.core.IUserDataSupport

clearAllData, getAllData, getData, setData

Method Details

getBlockAt

IS7Block getBlockAt(long address)

Retrieve the block whose data (if the block is a data block) or code (if the block is a logic block) is mapped at the provided address.

Parameters:

address - start address

Returns:

null on error

getBlockContaining

IS7Block getBlockContaining(long address)

Retrieve the block whose data (if the block is a data block) or code (if the block is a logic block) whose mapping contains the provided address.

Parameters:

address - an address (not necessarily the start address)

Returns:

null on error

getAddressOfRawBytes

long getAddressOfRawBytes(IS7Block blk)

Retrieve the mapping address of the raw (uninterpreted) bytes of a block.

Parameters:

blk - a block

Returns:

a VM address, -1 on error

getAddressOfCode

long getAddressOfCode(S7.BlockType type,
 int number)

Retrieve the mapping address of a logic block's code.

Parameters:

type - one of OB, FB, FC, SFB, SFC

number - block number

Returns:

a VM address, -1 on error

getAddressOfData

long getAddressOfData(S7.BlockType type,
 int number)

Retrieve the mapping address of a data block's data area.

Parameters:

type - one of DB, SDB

number - block number

Returns:

a VM address, -1 on error

getAddressOfGlobals

long getAddressOfGlobals()

Retrieve the mapping address of the global memory area.

Returns:

a VM address, -1 on error

getAddressOfDigitalInputs

long getAddressOfDigitalInputs()

Retrieve the mapping address of the digital inputs area.

Returns:

a VM address, -1 on error

getAddressOfDigitalOutputs

long getAddressOfDigitalOutputs()

Retrieve the mapping address of the digital outputs area.

Returns:

a VM address, -1 on error

getAddressOfCounters

long getAddressOfCounters()

Retrieve the mapping address of the counters area.

Returns:

a VM address, -1 on error

getAddressOfTimers

long getAddressOfTimers()

Retrieve the mapping address of the timers area.

Returns:

a VM address, -1 on error