22.10.2 Extended Script Restrictions

• When using external storage, verify the restrictions identified below.
  5.6.3 Restrictions on External Storage Usage

• For Device Addresses, only the LS Area and USR Area (Extended User Area) can be used.

• You can call user-defined functions created with D-Script/Global D-Script, but if you access a device address outside the range of the internal device in the function, it may not operate normally. Also, when transferred (during the creation of data for the display unit), user-defined functions are created independently for D-Scripts, Global D-Scripts, and Extended Scripts.

• When calling a function from a function, the maximum number of nested levels is 9.

• Up to 254 functions can be called. (The number of functions available with "Call" is 254.)

• Extended Script does not affect the tag count.

• Functions (for example string operations) supported only by Extended Script, do not operate when called with D-Script or Global D-Script.

• The available data format is Bin. BCD data format is disabled.

• The size of the Send buffer is 2048 bytes, while the Receive buffer is 8192 bytes. When flow control is used and available space in the receive buffer is low (receive buffer usage is 75% or more), the display unit will request the device/PLC to pause transmission. When sufficient space becomes available (receive buffer usage is less than 30%), the display unit requests the device/PLC to restart transmission.

• D-Script/Global D-Script and Extended Script cannot be selected simultaneously. Note the combinations listed in the table below.

• About Text notation
  When using text strings with _strset ( ) and other functions, enclose the string in double quotation marks (" "). To display double quotation marks in the text string, add the slash (\) symbol and express as [\"]. As there is no way to represent the slash (\) with a single symbol, use a character code expression such as strset(databuf0,92).
  Example)

"ABC\"DEF"→ABC"DEF

"ABC\DEF"→ABC\DEF

"ABC\\"DEF"→ABC\"DEF

"ABC\\DEF"→ABC\\DEF

• For functions where a negative number is entered for an argument that does not accept negative numbers^*1, the entered number operates as unsigned^*2.

  *1 For example, "the number of bytes" of the _CF_read () argument cannot accept negative numbers because it defines the size of data to read.

  *2 For example, [-1] is handled as 65535 for 16 bits, and 4294967295 for 32 bits.

• The size of the dedicated Extended SIO buffers databuf0, databuf1, databuf2, and databuf3 are all 1 KB.

• There is no differentiation between upper and lower case for text in the parameters.

• In an Extended Script, when using a device address where you define the access type, the instructions and operators you can use are as follows.

• Offset Address

• Addition (+), Subtraction (-), Modulus (%), Multiplication (*), Division (/), and Assignment (=)

• You cannot use the following characters in folder or file names. They will cause an error.
  : , = + / " [ ] | < > ? [space]
  However, for the Copy File function, you cannot use the following characters.
  : , = + / " [ ] | < > ? ~ * \

• When defining the folder and file name, use the [System Language] as defined in the [Display] tab. From the [Project] menu point to [System Settings] and click [Display Unit]. When you use a language other than the system language, file and folder names may not display the characters you entered.

• The following restrictions exist for CF File Operation, SD File Operation, SD/CFast File Operation, and USB File Operation.

• You can only use the 8.3 format (8 characters for the file name, the period, and 3 characters for the extension) for the file name.

• To set a root folder, specify " " (empty string) as the folder name.

• Limit the number of files to 100 in the folder you are accessing. Operation of other functions may slow down.

• When using draw functions in Extended Scripts, create scripts that use "_wait" functions or "if" expressions.
  Extended Scripts with draw functions only may cause excessive load on the display update process and reduce the processing speed of the script. When the processing speed is reduced, bit 5 in LS9101 (Extended Script error status) turns ON. After editing the script expression, transfer the project again.

What to Be Careful of When Reading the Same Device Address in the Same Extended Script

Even when the same device address is used in the same extended script, values read from the device address may differ depending on the processing timing of extended scripts.

To avoid this situation, please program scripts to temporarily store data in internal devices or temporary addresses.

Example:

When Using USR Area

[w:[#INTERNAL]USR20000]=[w:[#MEMLINK]0100]
[w:[#INTERNAL]USR00000]=[w:[#INTERNAL]USR20000]
[w:[#INTERNAL]USR00001]=[w:[#INTERNAL]USR20000]

When Using Temporary Address

[t:0000]=[w:[#MEMLINK]0100]
[w:[#INTERNAL]USR00000]=[t:0000]
[w:[#INTERNAL]USR00001]=[t:0000]