Revision history. STMicroelectronics Multicom 4

Table 6: Support on Linux user space on page 50

.

Added list of ICS API supported on Linux user space to

Chapter 6: Inter-core system (ICS) API on page 125

MME_GetTransformerCapability on page 58

to add MME_NOMIPS error code.

MME_IsTransformerRegistered on page 62

.

MME_TransformerCapability_t on page 106

to add

AdditionalStatus

field.

Supports the Multicom 4 R4.0.6. (Minor rewordings not listed).

Chapter 1: Building Multicom on page 8

throughout to include some details previously only documented in the Release notes, included ARM

examples in

Section 1.2: Building the library code on page 9

and

Section 1.3:

Building the test code on page 10

and made minor corrections.

Section 1.5: Building relocatable libraries for use with Multicom 4 on page 11

,

Section 1.6: Debugging support on page 12

and

Section 2.11.3: Relocatable library linking on page 33

to update examples.

Table 7 on page 65

to correct the description of

MME_TUNEABLE_TRANSFORMER_TIMEOUT to quote milliseconds instead of microseconds.

Section 5.2.1: ICS configuration and setup on page 112

to correctly reference BSP.

Section 5.5: Memory region management on page 119

to describe

memory mapping for the ARM Cortex-A9 cores; added

Figure 11 on page 121

Minor rewordings not listed.

Chapter 1: Building Multicom on page 8

and

Section 1.1.2: Compiler recommendations on page 9

to add STLinux releases and footnote.

Section 1.4: Compiling and linking against the Multicom 4 libraries on page 11

to remove inappropriate note.

Corrected typo in

Section 1.7: Running the tests under OS21 on page 13

.

Section 2.5.2: Manually managing data buffers on page 24

to correctly

refer to the function MME_RegisterMemory rather than

MME_RegisterBuffer

.

Section 2.11.1: OS21 on page 32

to clarify.

Documented the BSP_INCDIR environment variable in

Appendix A: ICS board support package on page 201

Added details about Linux userspace to

8182595 Rev 5 219/224

220

Revision history

Date

29-Jun-2010

19-Oct-2009

UM1112

Table 34. Document revision history (continued)

Revision Changes

B

A

Supports the Multicom 4 R4.0.2.

Removed all references to ics_load_entry and ics_load_free.

Chapter 1: Building Multicom on page 8

Section 1.1.2: Compiler recommendations on page 9

Section 1.4: Compiling and linking against the Multicom 4 libraries on page 11

Updated the Notes in

Section 1.6: Debugging support on page 12

and added

Section 1.6.1:

Debug logging on page 13

Section 1.8: Running the tests under Linux on page 13

.

Section 2.1.1: Transformers and transformer instances on page 15

and added

Figure 2

Section 2.1.2: Multi-hosting support on page 16

Moved multi-hosting material to

Section 2.8: Fault detection and recovery on page 29

.

MME_PingTransformer on page 70

MME_WaitCommand on page 76

Updated the description of

Added MME_TRANSFORMER_TIMEOUT to

Added MME_COMMAND_TIMEOUT to

MME_ERROR on page 92

.

MME_Event_t on page 94

Table 10 on page 113

and associated text.

Section 5.2.3: ICS initialization and termination on page 114

Section 5.8: CPU watchdog support on page 123

Added Note to

ics_cpu_init on page 126

Updated the description of

, adding

Table 22.

Updated the definition and error of

ics_cpu_self on page 132

ics_cpu_start on page 133

Updated the description of

.

Updated the definition and description of

ics_load_elf_file on page 147

and

ics_load_elf_image on page 148

.

Updated “Context” for

ICS_channel_send on page 157

.

Updated the description of

ICS_cpu_disconnect on page 160

ICS_cpu_init on page 162

Updated the description of

ICS_msg_send on page 176

Updated the description of

.

Introduction to

Appendix A: ICS board support package on page 201

rewritten

and example updated.

Updated num in

Table Note:: The order of the CPU definitions in this table must match that used in the CPU boot and reset tables in reset.c. on page 202

Reset address on page 204

Section A.3.1: CPU table on page 206

Section A.3.2: Mailbox tables on page 207

Section A.3.3: Reset and boot addresses on page 209

Section C.1: Debugging assertions and logging on page 216

Appendix D: ICS Linux module parameters on page 218

.

Initial release.

220/224 8182595 Rev 5

/

Prenesi

Samo prijazen opomnik. Dokument si lahko ogledate tukaj. Najpomembneje pa je, da ga je naša umetna inteligenca že prebrala. Lahko razloži zapletene stvari na preprost način, odgovori na vaša vprašanja v katerem koli jeziku in vam pomaga hitro krmariti tudi po najdaljših ali najbolj zapletenih dokumentih.

Ne, še vedno ga želim poiskati sam

Živjo! Sem AI chatbot, posebej usposobljen za pomoč pri Revision history. STMicroelectronics Multicom 4. Temeljito sem pregledal dokument in vam lahko pomagam najti točne informacije, ki jih potrebujete, ali razložim vsebino na jasen in preprost način. Ne glede na to, ali iščete navodila o določenih funkcijah, korake za odpravljanje težav ali splošno uporabo, lahko zastavite svoja vprašanja. Več podrobnosti kot navedete o svojih pomislekih ali potrebah, natančneje in učinkoviteje vam lahko pomagam!

Pomočnik tipka

Pomočnik je prekinil povezavo. Poskusite znova pozneje.

New chat

Kazalo vsebine

Conventions used in this guide

1.1.1 Code organization

8

Table 1. The distribution directories

8

1.1.2 Compiler recommendations

9

1.2 Building the library code

9

1.3 Building the test code

10

1.4 Compiling and linking against the Multicom 4 libraries

11

1.5 Building relocatable libraries for use with Multicom 4

11

1.5.1 Relocatable library tool

12

1.6 Debugging support

12

1.6.1 Debug logging

13

1.7 Running the tests under OS21

13

1.8 Running the tests under Linux

13

1.9 BSP configuration

2.1.1 Transformers and transformer instances

15

2.1.2 Multi-hosting support

16

2.1.3 Commands and events

2.1.6 Transformer priorities

19

2.1.7 Structure size

20

2.2 Summary of MME facilities

20

2.3 Initialization

20

2.3.1 Initializing MME

21

2.3.2 Registering transformers

21

2.3.3 Example

21

2.4 Managing transformer lifetimes

22

2.4.1 Querying the capabilities of a transformer

23

2.5 Buffer and cache management

23

2.5.1 Allocating data buffers

24

2.5.2 Manually managing data buffers

24

2.5.3 Subdividing a data buffer

25

2.5.4 Data buffers in Linux user mode

26

2.5.5 Cache management

26

Table 2. MME_ScatterPage_t FlagsIn and FlagsOut

26

2.6 Application and transformer specific data

27

2.7 Issuing commands

27

2.7.1 Aborting commands

29

2.8 Fault detection and recovery

29

2.9 Types of commands

2.9.1 Transforming data

2.9.2 Providing supplementary buffers

2.9.3 Altering global parameters

2.10 Common types of transformer

31

2.10.1 Frame-based operation

31

2.10.2 Stream-based and hybrid operation

31

2.11 Linking and loading

2.11.3 Relocatable library linking

33

3 Writing an MME transformer

34

3.1 Overview

34

Table 3. Transformer function pointers

34

3.2 Managing transformer lifetimes

3.3 Querying the capabilities of a transformer

36

3.4 Processing a command

38

3.4.1 Communicating with the application

39

3.4.2 Deferred commands

40

3.4.3 Streaming and hybrid transformers

41

3.5 Aborting commands

42

3.6 Scheduling and re-entrancy

43

3.7 Parameter passing

44

3.7.1 Data representation

44

Table 4. Data representation - endianness

45

3.7.2 Mapping application data structures into MME parameters

45

3.7.3 Namespace management

Table 6. Support on Linux user space

50

4.1 Function definitions

MME_DeregisterTransformer

MME_GetTransformerCapability

MME_IsTransformerRegistered

Table 7. Tuneable values for MME parameters (continued)

MME_RegisterTransformer

4.2 MME constants, enums and types

79

MME_AbortCommand_t

79

MME_AllocationFlags_t

MME_GenericCallback_t

95

MME_GenericParams_t

96

MME_GetTransformerCapability_t

97

MME_InitTransformer_t

98

MME_MAX_TRANSFORMER_NAME

MME_TermTransformer_t

104

MME_Time_t

105

MME_TransformerCapability_t

106

MME_TransformerHandle_t

107

MME_TransformerInitParams_t

108

MME_UINT

109

5 Overview of the inter-core system (ICS)

110

5.1 Summary of ICS facilities

111

5.2 ICS initialization and system loading

111

5.2.1 ICS configuration and setup

112

5.2.2 CPU loading and initialization

112

Table 9. CPU query functions

Table 10. Program loading functions

Table 11. CPU control functions

Table 12. Information functions

5.2.3 ICS initialization and termination

Table 13. Heap functions

114

114

Table 14. Initialization and termination functions

114

5.3 Channel-based communication

115

Table 15. Channel functions in ICS

115

5.4 Port-based communication

117

Table 16. Port and message functions in ICS (continued)

117

5.5 Memory region management

119

Table 17. Memory region mapping functions

119

5.6 Name server

Table 18. Name server functions

5.7 Dynamic module loading

Table 19. Dynamic code loading functions

Table 20. Failure management functions

5.8 CPU watchdog support

123

123

5.9 Debug logging support

124

Table 21.

124

6 Inter-core system (ICS) API

125

6.1 ics_ function definitions

6.2 ICS_ function definitions

ICS_WATCHDOG_CALLBACK

6.3 Macro definitions

Appendix A ICS board support package

201

A.1 Introduction

201

A.1.1 External BSP location

A.2 BSP data structures

A.2.1 CPU table

Table 28. CPU name table structure

Table 29. Mailbox table structure

A.2.2 Mailbox table

203

203

A.2.3 Reset and boot addresses

203

Table 30. Boot address structure

204

Table 31. Register address structure

204

A.2.4 CPU core name

205

A.3 Example BSP template

A.3.3 Reset and boot addresses

209

A.3.4 CPU core name

210

Appendix B MME supplement

B.1 Parameter encoding

B.1.1 Samples definitions

Table 32. MPEG video decoders specific definitions

Appendix C Advanced build options

216

C.1 Debugging assertions and logging

216

Table 33. Pre-processor macros that enable diagnostic code

216

C.2 Tuneable parameters

217

Appendix D ICS Linux module parameters

D.1 Support for declaring ICS regions on the module load

D.2 Support for declaring ICS companion firmware on the module load

D.3 Support for contiguous allocations from a named BPA2 memory partition