Memory Copy

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

Parameter Dependencies

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

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

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

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.

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

Parameter Dependencies

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

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.

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.

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

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:

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.

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.