Main Content

Memory Copy

Copy data from and to memory section

  • Memory Copy block

Libraries:
C2000 Microcontroller Blockset / Memory Operations

Description

Generated code for the Memory Copy block copies data from and to processor memory as configured by block parameters. When you use this block to copy an individual data element from a source to a destination, the block copies the element from the source, using the source data type, and then casts the data element to the specified destination data type.

Include as many instances of the Memory Copy block in a model as required to manipulate memory on a target processor. Each instance of the block works with one variable, address, or set of addresses provided to the block as input.

Specify the source and destination for a memory copy by using block parameters. You can use block parameters to control other aspects of a memory copy, such as:

  • Initialization for memory locations

  • Memory stride and offset during run time

  • Write operations to memory during program initialization, during program termination, and at every sample time

  • Insertion of custom ANSI® C source code before and after each memory copy read and write operation (for example, to lock and unlock registers before and after accessing them)

The Memory Copy block performs operations at three periods during program execution:

  • Initialization

  • Real-time operations

  • Termination

You can use block parameters to control when and how the block initializes memory, copies data or variables to and from memory, and terminates copy operations. The parameters enable you to turn on and off memory copy operations in the three periods independently.

Use the Memory Copy block and the Memory Allocate (Embedded Coder) block to manipulate and allocate memory for custom device drivers, such as PCI bus drivers or codec-style drivers.

During simulation, the Memory Copy block does not perform an operation. The block output is not defined.

Ports

Input

expand all

The source data for the memory copy operation, specified as a scalar or vector.

Port Dependencies

To use this port as the source for the memory copy operation, set parameter Copy from to Input port.

Data Types: single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

The memory address of source data for the copy operation, specified as a scalar or vector.

Port Dependencies

To use this port as the source for the memory copy operation, set parameter Copy from to Specified address and Specify address source to Input port. The Copy Memory block converts input port src to &src.

Data Types: single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Offset to use for data read during the copy operation, specified as a scalar or vector.

Port Dependencies

To create this port, select parameter Use offset when reading and set Specify offset source to Input port.

Data Types: single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

The memory address to use as the data destination for the copy operation, specified as a scalar or vector.

Port Dependencies

To use this port as the destination for the memory copy operation, set parameter Copy to to Specified address and Specify address source to Input port. The Copy Memory block converts output port dst to input port &dst.

Data Types: single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Offset to use for data write during the copy operation, specified as a scalar or vector.

Port Dependencies

To create this port, select parameter Use offset when writing and set Specify offset source to Input port.

Data Types: single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Output

expand all

The data copied, specified as a scalar or vector.

Port Dependencies

To use this port as the destination for the memory copy operation, set parameter Copy to to Output port.

Data Types: single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Parameters

expand all

Source

Specify the source sequential memory location for the copy operation. Specify the data type, size, and other attributes of the source variable.

Specify the input source for the data read part of the copy operation. Choose from the sources listed in this table.

Source of Data ReadParameter Value to Specify
src input portInput port
Memory addressSpecified address
Symbol (variable) in source code lookup tableSpecified source code symbol

Parameter Dependencies

  • If you select Specified address, use Specify address source to specify the source of the memory address and Address to specify the address.

  • If you select Specified source code symbol, use Source code symbol to specify the symbol (variable) in the source code symbol table to copy.

  • If you select Specified address or Specified source code symbol, change Data type to a value other than Inherit from source (the default). If you do not make this change, you receive an error message indicating that the data type cannot be inherited because the input port does not exist.

Specify the source of the memory address of the input source for the copy operation. To specify a memory address for the source variable, select Specify via dialog. That selection enables an Address parameter that you use to specify the memory address.

To specify that the block get the address from the input port, select Input port. When you select Input port, the block input port label changes to &src.

Parameter Dependencies

  • To enable this parameter, set Copy from to Specified address.

  • If you select Specify via dialog, this parameter enables the Address parameter, which you use to specify the address of the source variable.

  • If you select Specify via dialog, set Data type to a value other than Inherit from source (the default). If you do not make this change, you receive an error message indicating that the data type cannot be inherited because the input port does not exist.

  • If you select Inport port , specify a data type for the Data type parameter.

Specify the memory address of the source data in decimal form or in hexadecimal form with a conversion to decimal as shown by the default value hex2dec('00001000').

This example converts Ox1000 to decimal form.

4096 = hex2dec('1000');

For this example, you can specify the address as 4096 or hex2dec('1000').

Parameter Dependencies

To enable this parameter, set Copy from to Specified address and Specify address source to Specify via dialog.

Specify the symbol (variable) in the source code symbol table to copy. The symbol that you specify must exist in the symbol table for your program. The block does not verify whether the symbol exists in the symbol table and whether you specify the symbol with valid syntax. Enter text that specifies the symbol exactly as it appears in your code.

Parameter Dependencies

  • To enable this parameter, set Copy from to Specified source code symbol.

  • Set Data type to a value other than Inherit from source (the default). If you do not make this change, you receive an error message indicating that the data type cannot be inherited because the input port does not exist.

Specify the data type of the source data being copied. To inherit the data type from the src input port, select Inherit from input port.

Specify the number of elements to copy from the source location. Each element has the data type specified by the Data type parameter.

Specify whether the block uses an offset when reading input. The offset value is in elements of the specified data type. Specify the source of the offset by using the Specify offset source parameter.

Parameter Dependencies

  • If you select this parameter, use Specify offset source to specify the source of the offset.

  • Use Offset to specify the offset value.

Specify the source of the input offset for the copy operation. To specify an offset value, select Specify via dialog. That selection enables an Offset parameter that you use to specify the offset value.

To specify for the block to get the offset from an input port, select Input port. When you select Input port, the block creates an input port labeled src ofs and reads the offset value from that port. The src ofs port enables your program to change the offset dynamically during program execution.

Parameter Dependencies

To enable this parameter, select Use offset when reading.

Before copying the first value to the destination, specify the number of values to skip.

Parameter Dependencies

To enable this parameter, select Use offset when reading and set Specify offset source to Specify via dialog.

Specify the spacing for reading the input. By default, the stride value is one, meaning that the generated code reads the input data sequentially. When you add a stride value that is not equal to one, when reading input data, the generated code skips spaces in the source address equal to the stride.

These figures show the stride concept. In the first figure, data is copied without a stride. The second figure shows the results of a stride value of two. You can specify a stride value for the block output with parameter Stride on the Destination tab. You can also compare stride with the offset to see the differences.

Destination

Specify the destination memory location for the copy operation. Specify the attributes of the destination.

Specify the type of output destination for the copy operation. Select one of the values listed in this table.

Parameter ValueDestination of Data Write
Output portBlock dst output port
Specified address Memory location specified by parameters Specify address destination and Address
Specified source code symbolSymbol (variable) specified by parameter Source code symbol

Parameter Dependencies

  • If you select Specified address, use Specify address destination to specify the destination memory location.

  • If you select Specified source code symbol, use Destination code symbol to specify the symbol (variable) in the source code symbol table to which to copy the variable.

Specify the source of the destination memory address of the variable for the copy operation. To specify a memory address for the variable, select Specify via dialog. That selection enables an Address parameter that you use to specify the memory address. To specify that the block get the address from an input port, select Input port. When you select Input port, the block creates an input port labeled &dst. Changing the address dynamically means that you can use the block to copy different variables by providing the variable address from an upstream block in the model.

Parameter Dependencies

  • To enable this parameter, set Copy to to Specified address.

  • If you select Specify via dialog, this parameter enables the Address parameter, which you use to specify the address of the destination variable.

Specify the memory address of the destination variable in decimal form or in hexadecimal form with a conversion to decimal as shown by the default value hex2dec('00001000').

This example converts Ox2000 to decimal form.

8192 = hex2dec('2000');

For this example, you can specify the address as 8192 or hex2dec('2000').

Parameter Dependencies

To enable this parameter, set Copy to to Specified addressand Specify address source to Specify via dialog.

Specify the symbol (variable) in the source code symbol table to which to copy the variable. The symbol that you specify, must exist in the symbol table for your program. The block does not verify whether the symbol exists in the symbol table and whether you specify the symbol with valid syntax. Enter text that specifies the symbol exactly as it appears in your code.

Parameter Dependencies

To enable this parameter, set Copy to to Specified source code symbol.

Specify the data type of the source variable. To inherit the data type from the source variable, select Inherit from source.

Specify whether the block uses an offset when writing output. The offset value is in elements of the specified data type. Specify the source of the offset by using the Specify offset source parameter.

Parameter Dependencies

If you select this parameter, use Specify offset source to specify the source of the offset. Use Offset to specify the offset value.

Specify the source of the offset for the output destination for the copy operation. To specify an offset value for the destination variable, select Specify via dialog. That selection enables an Offset parameter that you use to specify the offset value.

To specify that the block get the offset from the input port, select Input port. When you select Input port, the block adds an input port labeled dst ofs and reads the offset value from that port. The dst ofs port enables your program to change the offset dynamically during execution.

Parameter Dependencies

To enable this parameter, select Specify offset source.

Before writing the first value to the destination, specify the number of values to skip.

Parameter Dependencies

To enable this parameter, select Use offset when writing and set Specify offset source to Specify via dialog.

Specify the spacing for writing the output. By default, the stride value is one meaning that the generated code writes the input data sequentially to the destination in consecutive locations. When you add a stride value that is not equal to one, when writing input data, the generated code skips spaces in the destination address equal to the stride.

This figure shows a stride value of three applied to writing the input to an output location. You can specify a stride value for the input with parameter Stride on the Source pane. As shown in the figure, you can use an input stride and an output stride at the same time to enable manipulating memory more fully.

Specify the rate at which the memory copy operation occurs in seconds. To use a constant sample time, specify Inf. To inherit the sample time from the input port or, when the block does not have an input port, from the Simulink® model, specify -1.

Options

Configure parameters that control the copy process.

Specify whether to initialize the memory address to a specific value during program initialization.

Parameter Dependencies

If you select this parameter, use a combination of parameters to configure the initialization value.

What to ConfigureParameter
Source of the initialization valueSpecify initialization value source
Initialization value as a constantInitialization value (constant)
Initialization value as a variableInitialization value (source code symbol)
Initialization value as a mask to manipulate register contents at the bit levelApply initialization value as mask
Apply a mask valueBitwise operator

Specify the source of the initial value. To configure the source for initializing memory as a specific value, select Specify constant value. To configure the source as a variable (a symbol), select Specify source code symbol.

Parameter Dependencies

  • To enable this parameter, select Set memory value at initialization.

  • Use Initialization value (constant) or Initialization value (source code symbol) to specify the initial value.

Specify a constant value.

Parameter Dependencies

To enable this parameter, select Set memory value at initialization and set Set initialization value source to Specify constant value.

Specify the symbol (variable) in the source code symbol table to use for the initialization value. The symbol that you specify must exist in the symbol table for your program. The block does not verify whether the symbol exists in the symbol table and whether you specify the symbol with valid syntax. Enter text that specifies the symbol exactly as it appears in your code.

Parameter Dependencies

To enable this parameter, select Set memory value at initialization and set Set initialization value source to Specify source code symbol.

Specify whether to use the initialization value as a mask to manipulate register content at the bit level. Your initialization value is treated as a string of bits for the mask.

To define how to apply the mask value, specify a value for the Bitwise operator parameter.

To use your initialization value as a mask, the output from the copy must be a specific address. The output:

  • Can be a symbol

  • Cannot be an output port

Parameter Dependencies

If you select this parameter, use Bitwise operator to define how to apply the mask value.

Specify the type of bitwise operation to use as a mask to manipulate the memory value. Applying a mask to the copy process means that you can select individual bits in the result. For example, by applying a mask, you can read the value of the fifth bit.

Select one of the bitwise operations in this table.

Bitwise Operation

Description

bitwise AND

Apply the mask value as a bitwise AND to the value in the register.

bitwise OR

Apply the mask value as a bitwise OR to the value in the register.

bitwise exclusive OR

Apply the mask value as a bitwise exclusive OR to the value in the register.

left shift

Shift the bits in the register left by the number of bits represented by the initialization value. For example, if your initialization value is 3, the block shifts the register value to the left 3 bits. In this case, the value must be a positive integer.

right shift

Shift the bits in the register to the right by the number of bits represented by the initialization value. For example, if your initialization value is 6, the block shifts the register value to the right 6 bits. In this case, the value must be a positive integer.

Parameter Dependencies

To enable this parameter, select Apply initialization value as mask.

Specify that your program copy memory during program termination. Copying a value in memory during termination occurs in addition to a copy during program initialization.

Parameter Dependencies

If you select this parameter, you can use Set memory value only at initialization/termination to limit copy operations to occur during program initialization and termination only.

Specify a value to write to memory during program termination.

Parameter Dependencies

To enable this parameter, select Set memory value at termination.

Specify whether to perform copies during program initialization and termination only. When this parameter is cleared, the block performs copies during initialization, real-time operations, and termination. If you select this parameter, the block performs copies during initialization and termination only.

Specify whether the code generator inserts custom ANSI C code immediately before the program writes to the specified memory location. You can use this parameter and Insert custom code after memory write to lock and unlock registers before and after accessing them. For example, some processors have registers that you might need to unlock and lock with EALLOW and EDIS macros before and after your program accesses them.

Parameter Dependencies

If you select this parameter, use Custom code to specify the custom ANSI C code to insert into the generated code immediately before the memory write operation.

Specify whether the code generator inserts custom ANSI C code immediately after the program writes to the specified memory location. You can the Insert custom code before memory write and this parameter to lock and unlock registers before and after accessing them. For example, some processors have registers that you might need to unlock and lock with EALLOW and EDIS macros before and after your program accesses them.

Parameter Dependencies

If you select this parameter, use Custom code to specify the custom ANSI C code to insert into the generated code immediately after the memory write operation.

Specify custom ANSI C code to insert into the generated code immediately before or immediately after the memory write operation. Code that you specify appears in the generated code exactly as you enter it.

Parameter Dependencies

To enable this parameter, select Insert custom code before memory write or Insert custom code after memory write.

Version History

Introduced in R2011a

See Also

(Embedded Coder)