Information for AtmelAT91SAM7

This page provides detailed information about the atmel.ovpworld.org AtmelAT91SAM7 Virtual Platform / Virtual Prototype.

Description
Simple platform of Atmel AT91 ARM7TDMI based system

Limitations
This platform is sufficient to boot Linux

Reference
Rev. 1354D ARM08/02

Licensing
Open Source Apache 2.0

Location
The AtmelAT91SAM7 virtual platform is located in an Imperas/OVP installation at the VLNV: atmel.ovpworld.org / module / AtmelAT91SAM7 / 1.0.

Platform Summary

Table 1: Components in platform

TypeInstanceVendorComponent
ProcessorARM7TDMICorearm.ovpworld.orgarmARM7TDMI
PeripheralAICatmel.ovpworld.orgAdvancedInterruptController
PeripheralWDatmel.ovpworld.orgWatchdogTimer
PeripheralPSatmel.ovpworld.orgPowerSaving
PeripheralPIOatmel.ovpworld.orgParallelIOController
PeripheralTCatmel.ovpworld.orgTimerCounter
PeripheralUSART0atmel.ovpworld.orgUsartInterface
PeripheralUSART1atmel.ovpworld.orgUsartInterface
PeripheralSFatmel.ovpworld.orgSpecialFunction
MemoryextDevovpworld.orgram
Memoryram0ovpworld.orgram
Busmainbus(builtin)address width:32



Processor [arm.ovpworld.org/processor/arm/1.0] instance: ARM7TDMICore

Processor model type: 'arm' variant 'ARM7TDMI' definition
Imperas OVP processor models support multiple variants and details of the variants implemented in this model can be found in:
- the Imperas installation located at ImperasLib/source/arm.ovpworld.org/processor/arm/1.0/doc
- the OVP website: OVP_Model_Specific_Information_arm_ARM7TDMI.pdf

Description
ARM Processor Model

Licensing
Usage of binary model under license governing simulator usage.
Note that for models of ARM CPUs the license includes the following terms:
Licensee is granted a non-exclusive, worldwide, non-transferable, revocable licence to:
If no source is being provided to the Licensee: use and copy only (no modifications rights are granted) the model for the sole purpose of designing, developing, analyzing, debugging, testing, verifying, validating and optimizing software which: (a) (i) is for ARM based systems; and (ii) does not incorporate the ARM Models or any part thereof; and (b) such ARM Models may not be used to emulate an ARM based system to run application software in a production or live environment.
If source code is being provided to the Licensee: use, copy and modify the model for the sole purpose of designing, developing, analyzing, debugging, testing, verifying, validating and optimizing software which: (a) (i) is for ARM based systems; and (ii) does not incorporate the ARM Models or any part thereof; and (b) such ARM Models may not be used to emulate an ARM based system to run application software in a production or live environment.
In the case of any Licensee who is either or both an academic or educational institution the purposes shall be limited to internal use.
Except to the extent that such activity is permitted by applicable law, Licensee shall not reverse engineer, decompile, or disassemble this model. If this model was provided to Licensee in Europe, Licensee shall not reverse engineer, decompile or disassemble the Model for the purposes of error correction.
The License agreement does not entitle Licensee to manufacture in silicon any product based on this model.
The License agreement does not entitle Licensee to use this model for evaluating the validity of any ARM patent.
Source of model available under separate Imperas Software License Agreement.

Limitations
Instruction pipelines are not modeled in any way. All instructions are assumed to complete immediately. This means that instruction barrier instructions (e.g. ISB, CP15ISB) are treated as NOPs, with the exception of any undefined instruction behavior, which is modeled. The model does not implement speculative fetch behavior. The branch cache is not modeled.
Caches and write buffers are not modeled in any way. All loads, fetches and stores complete immediately and in order, and are fully synchronous (as if the memory was of Strongly Ordered or Device-nGnRnE type). Data barrier instructions (e.g. DSB, CP15DSB) are treated as NOPs, with the exception of any undefined instruction behavior, which is modeled. Cache manipulation instructions are implemented as NOPs, with the exception of any undefined instruction behavior, which is modeled.
Real-world timing effects are not modeled: all instructions are assumed to complete in a single cycle.

Verification
Models have been extensively tested by Imperas. ARM7TDMI models have been successfully used by customers to simulate ucLinux on Atmel virtual platforms.

Core Features
Thumb instructions are supported.

Integration Support
This model implements a number of non-architectural pseudo-registers and other features to facilitate integration.

Halt Reason Introspection
An artifact register HaltReason can be read to determine the reason or reasons that a processor is halted. This register is a bitfield, with the following encoding: bit 0 indicates the processor has executed a wait-for-event (WFE) instruction; bit 1 indicates the processor has executed a wait-for-interrupt (WFI) instruction; and bit 2 indicates the processor is held in reset.

System Register Access Monitor
If parameter enableSystemMonitorBus is True, an artifact 32-bit bus "SystemMonitor" is enabled for each PE. Every system register read or write by that PE is then visible as a read or write on this artifact bus, and can therefore be monitored using callbacks installed in the client environment (use opBusReadMonitorAdd/opBusWriteMonitorAdd or icmAddBusReadCallback/icmAddBusWriteCallback, depending on the client API). The format of the address on the bus is as follows:
bits 31:26 - zero
bit 25 - 1 if AArch64 access, 0 if AArch32 access
bit 24 - 1 if non-secure access, 0 if secure access
bits 23:20 - CRm value
bits 19:16 - CRn value
bits 15:12 - op2 value
bits 11:8 - op1 value
bits 7:4 - op0 value (AArch64) or coprocessor number (AArch32)
bits 3:0 - zero
As an example, to view non-secure writes to writes to CNTFRQ_EL0 in AArch64 state, install a write monitor on address range 0x020e0330:0x020e0333.

System Register Implementation
If parameter enableSystemBus is True, an artifact 32-bit bus "System" is enabled for each PE. Slave callbacks installed on this bus can be used to implement modified system register behavior (use opBusSlaveNew or icmMapExternalMemory, depending on the client API). The format of the address on the bus is the same as for the system monitor bus, described above.

Instance Parameters
Several parameters can be specified when a processor is instanced in a platform. For this processor instance 'ARM7TDMICore' it has been instanced with the following parameters:

Table 2: Processor Instance 'ARM7TDMICore' Parameters (Configurations)

ParameterValueDescription
endianlittleSelect processor endian (big or little)
simulateexceptionssimulateexceptionsCauses the processor simulate exceptions instead of halting
mips100The nominal MIPS for the processor
semihostvendoratmel.ovpworld.orgThe VLNV vendor name of a Semihost library
semihostlibraryinterceptThe VLNV library name of a Semihost library
semihostnameloaderThe VLNV name of a Semihost library

Table 3: Processor Instance 'ARM7TDMICore' Parameters (Attributes)

Parameter NameValueType
variantARM7TDMIenum


Memory Map for processor 'ARM7TDMICore' bus: 'mainbus'
Processor instance 'ARM7TDMICore' is connected to bus 'mainbus' using master port 'INSTRUCTION'.

Processor instance 'ARM7TDMICore' is connected to bus 'mainbus' using master port 'DATA'.

Table 4: Memory Map ( 'ARM7TDMICore' / 'mainbus' [width: 32] )

Lo AddressHi AddressInstanceComponent
0x00xFFFFFram0ram
0x4000000xFFBFFFFFextDevram
0xFFF000000xFFF03FFFSFSpecialFunction
0xFFFCC0000xFFFCFFFFUSART1UsartInterface
0xFFFD00000xFFFD3FFFUSART0UsartInterface
0xFFFE00000xFFFE3FFFTCTimerCounter
0xFFFF00000xFFFF3FFFPIOParallelIOController
0xFFFF40000xFFFF7FFFPSPowerSaving
0xFFFF80000xFFFFBFFFWDWatchdogTimer
0xFFFFF0000xFFFFFFFFAICAdvancedInterruptController


Net Connections to processor: 'ARM7TDMICore'

Table 5: Processor Net Connections ( 'ARM7TDMICore' )

Net PortNetInstanceComponent
fiqNFIQAICAdvancedInterruptController
irqNIRQAICAdvancedInterruptController



Peripheral Instances


Peripheral [atmel.ovpworld.org/peripheral/AdvancedInterruptController/1.0] instance: AIC

Description
AIC: Advanced Interrupt Controller This model contains an accurate Register set interface. The functionality has only been implemented to sufficiently boot uClinux The Advanced Interrupt Controller has an 8-level priority, individually maskable, vectored interrupt controller, and drives the NIRQ and NFIQ pins of the ARM7TDMI from: The external fast interrupt line (FIQ) The three external interrupt request lines (IRQ0 - IRQ2) The interrupt signals from the on-chip peripherals The AIC is extensively programmable offering maximum flexibility, and its vectoring features reduce the real-time overhead in handling interrupts. The AIC also features a spurious vector detection feature, which reduces spurious interrupt handling to a minimum, and a protect mode that facilitates the debug capabilities.

Licensing
Open Source Apache 2.0

Limitations
This model is sufficient to boot Linux

Reference
Rev. 1354D ARM08/02

There are no configuration options set for this peripheral instance.


Peripheral [atmel.ovpworld.org/peripheral/WatchdogTimer/1.0] instance: WD

Description
WD: Watchdog The Watchdog is built around a 16-bit counter and is used to prevent system lock-up if the software becomes trapped in a deadlock. It can generate an internal reset or interrupt, or assert an active level on the dedicated pin NWDOVF. All programming registers are password-protected to prevent unintentional programming. for more information visit http://www.atmel.com/products/at91

Licensing
Open Source Apache 2.0

Limitations
This model is sufficient to boot Linux

Reference
Rev. 1354D ARM08/02

There are no configuration options set for this peripheral instance.


Peripheral [atmel.ovpworld.org/peripheral/PowerSaving/1.0] instance: PS

Description
This model contains an accurate Register set interface. The functionality has only been implemented to sufficiently boot uClinux for more information visit http://www.atmel.com/products/at91

Licensing
Open Source Apache 2.0

Limitations
This model is sufficient to boot Linux

Reference
Rev. 1354D ARM08/02

There are no configuration options set for this peripheral instance.


Peripheral [atmel.ovpworld.org/peripheral/ParallelIOController/1.0] instance: PIO

Description
PIO: Parallel I/O Controller This model contains an accurate Register set interface. The functionality has only been implemented to sufficiently boot uClinux The Parallel I/O Controller has 32 programmable I/O lines. Six pins are dedicated as general-purpose I/O pins. Other I/O lines are multiplexed with an external signal of a peripheral to optimize the use of available package pins. The PIO controller enables generation of an interrupt on input change and insertion of a simple input glitch filter on any of the PIO pins. for more information visit http://www.atmel.com/products/at91

Licensing
Open Source Apache 2.0

Limitations
This model is sufficient to boot Linux

Reference
Rev. 1354D ARM08/02

There are no configuration options set for this peripheral instance.


Peripheral [atmel.ovpworld.org/peripheral/TimerCounter/1.0] instance: TC

Description
TC: Timer Counter This model contains an accurate Register set interface. The functionality has only been implemented to sufficiently boot uClinux The Timer Counter block includes three identical 16-bit timer counter channels. Each channel can be independently programmed to perform a wide range of functions including frequency measurement, event counting, interval measurement, pulse generation, delay timing and pulse width modulation. The Timer Counter can be used in Capture or Waveform mode, and all three counter channels can be started simultaneously and chained together. for more information visit http://www.atmel.com/products/at91

Licensing
Open Source Apache 2.0

Limitations
This model is sufficient to boot Linux

Reference
Rev. 1354D ARM08/02

There are no configuration options set for this peripheral instance.


Peripheral [atmel.ovpworld.org/peripheral/UsartInterface/1.0] instance: USART0

Description
USART: Universal Synchronous/Asynchronous Receiver Transmitter This model contains an accurate Register set interface. The functionality has only been implemented to sufficiently boot uClinux The USART has its own baud rate generator, and two dedicated Peripheral Data Controller channels. The data format includes a start bit, up to 8 data bits, an optional programmable parity bit and up to 2 stop bits. The USART also features a Receiver Timeout register, facilitating variable length frame support when it is working with the PDC, and a Time-guard register, used when interfacing with slow remote equipment. for more information visit http://www.atmel.com/products/at91

Licensing
Open Source Apache 2.0

Limitations
This model is sufficient to boot Linux

Reference
Rev. 1354D ARM08/02

Table 6: Configuration options (attributes) set for instance 'USART0'

AttributesValue
finishOnDisconnect1



Peripheral [atmel.ovpworld.org/peripheral/UsartInterface/1.0] instance: USART1

Description
USART: Universal Synchronous/Asynchronous Receiver Transmitter This model contains an accurate Register set interface. The functionality has only been implemented to sufficiently boot uClinux The USART has its own baud rate generator, and two dedicated Peripheral Data Controller channels. The data format includes a start bit, up to 8 data bits, an optional programmable parity bit and up to 2 stop bits. The USART also features a Receiver Timeout register, facilitating variable length frame support when it is working with the PDC, and a Time-guard register, used when interfacing with slow remote equipment. for more information visit http://www.atmel.com/products/at91

Licensing
Open Source Apache 2.0

Limitations
This model is sufficient to boot Linux

Reference
Rev. 1354D ARM08/02

There are no configuration options set for this peripheral instance.


Peripheral [atmel.ovpworld.org/peripheral/SpecialFunction/1.0] instance: SF

Description
This model contains an accurate Register set interface. The functionality has only been implemented to sufficiently boot uClinux The AT91FR40162SB provides registers that implement the following special functions. Chip Identification RESET Status Protect Mode for more information visit http://www.atmel.com/products/at91

Licensing
Open Source Apache 2.0

Limitations
This model is sufficient to boot Linux

Reference
Rev. 1354D ARM08/02

There are no configuration options set for this peripheral instance.


Other Sites/Pages with similar information

Information on the AtmelAT91SAM7 Virtual Platform can also be found on other web sites :
www.ovpworld.org has the library pages http://www.ovpworld.org/library/wikka.php?wakka=CategoryPlatform
www.imperas.com has more information on the model library

A couple of documents (from other related sites that might be of interest)
http://www.ovpworld.org: iGen Model Generator Introduction
http://www.ovpworld.org: iGen Peripheral Generator User Guide

Two Videos on these models (from other sites)
http://www.ovpworld.org: MIPS Demo Video Presentation
http://www.ovpworld.org: Renesas v850 Bare Metal Video Presentation


Currently available Imperas / OVP Virtual Platforms / Virtual Prototypes.

FamilyVirtual Platform / Virtual Prototype
ARM Based Platforms    BareMetalArm7Single BareMetalArmCortexADual BareMetalArmCortexASingle BareMetalArmCortexASingleAngelTrap BareMetalArmCortexMSingle AlteraCycloneV_HPS ArmIntegratorCP ArmVersatileExpress ArmVersatileExpress-CA15 ArmVersatileExpress-CA9 AtmelAT91SAM7 ArmCortexMFreeRTOS ArmCortexMuCOS-II HeteroArmNucleusMIPSLinux FreescaleKinetis60 FreescaleKinetis64 FreescaleVybridVFxx AlteraCycloneV_HPS ArmIntegratorCP ARMv8-A-FMv1 ArmVersatileExpress ArmVersatileExpress-CA15 ArmVersatileExpress-CA9 AtmelAT91SAM7 ArmCortexMFreeRTOS ArmCortexMuCOS-II ArmuKernel Zynq_PS
MIPS Based Platforms    BareMetalM14KSingle BareMetalMips32Dual BareMetalMips32Single BareMetalMips64Single BareMetalMipsDual BareMetalMipsSingle HeteroArmNucleusMIPSLinux MipsMalta MipsMalta
Vendor Platforms    BareMetalNios_IISingle AlteraCycloneIII_3c120 AlteraCycloneV_HPS AlteraCycloneIII_3c120 AlteraCycloneV_HPS BareMetalArcSingle BareMetalArm7Single BareMetalArmCortexADual BareMetalArmCortexASingle BareMetalArmCortexASingleAngelTrap BareMetalArmCortexMSingle ArmIntegratorCP ArmVersatileExpress ArmVersatileExpress-CA15 ArmVersatileExpress-CA9 ArmIntegratorCP ARMv8-A-FMv1 ArmVersatileExpress ArmVersatileExpress-CA15 ArmVersatileExpress-CA9 AtmelAT91SAM7 AtmelAT91SAM7 FreescaleKinetis60 FreescaleKinetis64 FreescaleVybridVFxx Or1kUclinux ArmCortexMFreeRTOS ArmCortexMuCOS-II HeteroArmNucleusMIPSLinux ArmCortexMFreeRTOS ArmCortexMuCOS-II ArmuKernel ArmuKernelDual Quad_ArmVersatileExpress-CA15 BareMetalM14KSingle BareMetalMips32Dual BareMetalMips32Single BareMetalMips64Single BareMetalMipsDual BareMetalMipsSingle MipsMalta MipsMalta BareMetalOr1kSingle BareMetalM16cSingle BareMetalPowerPc32Single BareMetalV850Single ghs-multi RenesasUPD70F3441 ghs-multi RenesasUPD70F3441 Zynq_PL_DualMicroblaze Zynq_PL_NoC Zynq_PL_NoC_node Zynq_PL_NostrumNoC Zynq_PL_NostrumNoC_node Zynq_PL_RO Zynq_PL_SingleMicroblaze Zynq_PL_TTELNoC Zynq_PL_TTELNoC_node XilinxML505 XilinxML505 zc702 zc706 Zynq Zynq_PL_Default Zynq_PS