Index. STMicroelectronics Multicom 4

. . . . . . . . . . . . . . . . . . . . . . . . .202

206

bsp_cpu_info

bsp_cpu_name

. . . . . . . . . . . . . . . . . . . .205

. . . . . . . . . . . . . . . . . . . . 203

bsp_cpus

BSP_INCDIR environment variable

. . . . . . . .202

bsp_mailbox_count

. . . . . . . . . . . . 203

bsp_mailboxes

. . . . . . . . . . . . . . . . 203

bsp_mbox_regs

. . . . . . . . . . . . . . . . . . . . . . .203

bsp_reg_mask

. . . . . . . . . . . . . . . . . . . . . . . .204

BSP_SRCDIR environment variable

. . . . . . .202

bsp_sys_boot_enable

. . . . . . . . . . . . . .204

. . . . . . . . . . . . .204

bsp_sys_boot_registers

bsp_sys_reset_bypass

. . . . . . . . . . 204

bsp_sys_reset_bypass_count

. . . . . . . .204

. . . . . . . . . . . . . . . . .210

bsp_sys_reset_register

bsp_sys_reset_registers

. . . . . . . . . . . . . . . .204

Buffer

MME

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

-

. . . . . . . . . . . . . . . . . . . . . . . . . . .9

Build source code

test suite

. . . . . . . . . . . . . . . . . . . . . . . . . . . .10

C

Cache

MME

. . . . . . . . . . . . . . . . . . . . . . . . . . . .23

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Companion processor

MME

Compilation

. . . . . . . . . . . . . . . . . . . . . . . . . . .11

cores.c

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203

D

Data structure

MME

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45

Debug assertions

. . . . . . . . . . . . . . . . . . . . . . . . . .216

support

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Deferred commands

MME

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Dynamic loading

. . . . . . . . . . . . . . . . 11

E

ELF

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

110

Endianness

MME

Example

MME

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

F

FlagsIn

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

FlagsOut

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

FOURCC format

. . . . . . . . . . . . . . . . . . . . . . . 36

Frame-based transformer

. . . . . . . . . . . . . 31

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

39

H

Host processor

MME

I

ICS

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

-

124

channel communication

. . . . . . . . . . . . . . . 115

CPU watchdog support

. . . . . . . . . . . . . . . 123

debug logging support

. . . . . . . . . . . . . . . . 124

dynamic module loading

. . . . . . . . . . . . . . . 122

initialization

. . . . . . . . . . . . . . . . . . . . . . . . . 111

memory management

. . . . . . . . . . . . . . . . 119

name server

. . . . . . . . . . . . . . . . . . . . . . . . 122

port communication

. . . . . . . . . . . . . . . . . . 117

ICS_channel_alloc

. . . . . . . . . . . . 115

-

116

. . . . . . . . . . . . 151

149

ICS_CHANNEL_CALLBACK

ICS_channel_close

. . . . . . . . . . . . . . . . 115

. . . . . . . . . . . . . . . . . 115

152

ICS_channel_free

. . . . . . . . . . . . 115

153

ICS_channel_open

-

116

. . . . . . . . . . . . . . . . . 115

154

ICS_channel_recv

. . . . . . . . . . . . . . 115

155

ICS_channel_release

. . . . . . . . . . . . 115

156

ICS_channel_send

-

116

. . . . . . . . . . . . . . 115

157

ICS_channel_unblock

. . . . . . . . . . . . . . . . . 123

158

ICS_cpu_connect

. . . . . . . . . . . . . . . 123

159

ICS_cpu_disconnect

. . . . . . . . . . . . . . . . . . . . . 114

160

ICS_cpu_info

. . . . . . . . . . . . . . . . . . . . . 114

161

ICS_cpu_init

. . . . . . . . . . . . . . . . . . . . . . . . . . 126

162

ics_cpu_init

ics_cpu_lookup

. . . . . . . . . . . . . . . . . . . 113

. . . . . . . . . . . . . . . . . . . .113

128

8182595 Rev 5 221/224

Index

ics_cpu_mask

. . . . . . . . . . . . . . . . . . . .113

129

ics_cpu_name

. . . . . . . . . . . . . . . . . . . . .113

130

ics_cpu_reset

. . . . . . . . . . . . . . . . . . . . . .113

131

ics_cpu_self

. . . . . . . . . . . . . . . . . . . . .113

132

ics_cpu_start

133

ICS_cpu_term

. . . . . . . . . . . . . . . . . . . . . . . . .113

163

ics_cpu_type

ics_cpu_type

. . . . . . . . . . . . . . . . . . . . . . . . .134

ics_cpu_version

. . . . . . . . . . . . . . . . . . .113

. . . . . . . . . . . . . . . . . . .124

135

ics_debug_chan

. . . . . . . . . . . . . . . . .124

136

ICS_debug_dump

. . . . . . . . . . . . . 12

164

ics_debug_flags

ICS_dyn_load_file

. . . . . . . . . . . . . . . . .122

. . . . . . . . . . . . . . .122

165

ICS_dyn_load_image

. . . . . . . . . . . . . . . . . . .122

167

ICS_dyn_unload

. . . . . . . . . . . . . . . . . . . . . . .113

169

ics_err_str

. . . . . . . . . . . . . . . . . . . . .116

139

ICS_ERROR

118

ics_heap_alloc

140

ics_heap_base

. . . . . . . . . . . . . . . . . . .114

141

ics_heap_create

. . . . . . . . . . . . . . . . . .114

142

ics_heap_destroy

. . . . . . . . . . . . . . . . . . . . .114

143

ics_heap_free

. . . . . . . . . . . . . . . . . . .114

144

ics_heap_pbase

145

ics_heap_size

. . . . . . . . . . . . . . . . . . .113

146

ics_load_elf_file

. . . . . . . . . . . . . . . .113

147

ics_load_elf_image

. . . . . . . . . . . . . . . . . . . . . . . . .149

148

ics_load_free

ICS_msg_cancel

. . . . . . . . . . . . . . 117

ICS_MSG_DESC

. . . . . . . . . . . . . . . . . . . . . .171

ICS_msg_post

ICS_msg_recv

ICS_msg_send

. . . . . . . . . . . . . . . . . . . . .118

ICS_msg_test

. . . . . . . . . . . . . . . . . . . .118

178

ICS_msg_wait

. . . . . . . . . . . . . . . . . . . .122

179

ICS_nsrv_add

. . . . . . . . . . . . . . . . . .122

180

ICS_nsrv_lookup

. . . . . . . . . . . . . . . . .122

181

ICS_nsrv_remove

183

ICS_port_alloc

. . . . . . . . . . . . . . . .186

ICS_PORT_CALLBACK

ICS_port_cpu

. . . . . . . . . . . . . . . . . . . . .117

. . . . . . . . . . . . . . . . . 117

187

ICS_port_free

ICS_port_lookup

. . . . . . . . . . . . . . 117

ICS_region_add

. . . . . . . . . . . . . . . . . . .119

. . . . . . . . . . . . . . .119

190

ICS_region_phys2virt

. . . . . . . . . . . . . . . .119

192

ICS_region_remove

. . . . . . . . . . . . . . .119

193

ICS_region_virt2phys

. . . . . . . . . . . . . . . . . . . . . . . .200

194

ICS_VERSION

ICS_VERSION_CODE

. . . . . . . . . . . . . . . . . .200

ICS_watchdog_add

. . . . . . . . . . . . . . . .123

. . . . . . . . . . . . .123

195

ICS_WATCHDOG_CALLBACK

. . . . . . . . . . .197

ICS_watchdog_remove

. . . . . . . . . . . . .123

198

ICS_watchdog_reprime

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

199

UM1112

L

Link

Linux

. . . . . . . . . . . . . . . . . . . . 9

M

Mailbox

. . . . . . . . . . . . . . . . . . . . . . . . . 201

. . . . . . . . . . . . . . . . . . . . . . . . . . 203

mbox.c

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

207

MME

-

49

N

Namespace

MME

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

O

OS21

. . . . . . . . . . . . . . . . . . . . . . . . . . . 9

R

Relocatable libraries

. . . . . . . . . . . . . . . . . .11

. . . . . . . . . . . . . . . . . . . . . . . .204

33

Reset address

reset.c

. . . . . . . . . . . . . . . . . . . . . 202

Running test suites

. . . . . . . . . . . . . . . . . . . . . .13

Index

S

sh4rltool

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Software notation

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Source code

. . . . . . . . . . . . . . . . . . . . . . . . . . . 8

ST Micro Connect

. . . . . . . . . . . . . . . . . . . . . . . 6

st200rltool

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Stream-based transformer

. . . . . . . . . . . . . . . 31

T

Transformer

Stiahnuť

Len priateľské pripomenutie. Dokument si môžete pozrieť priamo tu. Ale čo je najdôležitejšie, naša AI si ho už prečítala. Dokáže vysvetliť zložité veci jednoducho, odpovedať na vaše otázky v akomkoľvek jazyku a pomôže vám rýchlo prechádzať aj tie najdlhšie alebo najkomplikovanejšie dokumenty.

Nie, stále si to chcem vyhľadať sám

Ahoj! Som AI chatbot, ktorý je špeciálne vyškolený na pomoc s Index. STMicroelectronics Multicom 4. Dôkladne som preskúmal dokument a môžem vám pomôcť nájsť presné informácie, ktoré potrebujete, alebo vysvetliť obsah jasne a jednoducho. Či už hľadáte rady o konkrétnych funkciách, kroky na riešenie problémov alebo všeobecné použitie, neváhajte a položte svoje otázky. Čím viac podrobností poskytnete o svojich obavách alebo potrebách, tým presnejšie a efektívnejšie vám môžem pomôcť!

Asistent píše

Asistent nie je pri klávesnici. Skúste to znova neskôr.

New chat

Obsah

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

2.5.5 Cache management

Table 2. MME_ScatterPage_t FlagsIn and FlagsOut

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

A.2.2 Mailbox table

Table 29. Mailbox table structure

A.2.3 Reset and boot addresses

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

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