08 Macro Script

This chapter provides information about scripts in PIStudio.

= **Script Type** =

Script is applied to realize complex control functions. HMI compile software provide powerful function, simple operation, reliable script system, the features of script are list as follow:

6

7

1) Similar to BASIC grammatical structure;

8

9

BASIC work as the first computer language for the general public, it is easy and efficient to use.

10

11

2) Support all of program logic control structures;

12

13

Software script supports three logic control structures: order, condition, loops. It could realize complexity procedures.

14

15

3) Powerful function; Functions of script are divided into two types: system and custom function.

16

17

* System function: the functions that system has been predefined for users.

18

* Custom function: users could define a function and apply to all scripts.

19

20

4) Support variety of data format;

21

22

Script supports integer, floating, BCD code, byte, string and etc.

23

24

**Scripts Running Method**

25

26

1. **Background Script:** Run independently during start project, screen updates have no influence and valid of all scripts.

27

1. **Screen Script:** Only run under the designated screen. Screen script start running until screen is closed or switched.

28

29

And both screen and background have four modes for script

30

31

(% class="table-bordered" %)

32

|**Property**|**Description**

33

|Initialize|The script would be executed once during loading project.

34

|Close|The script would be run once during closing HMI project.

35

|Timing|The script would run under certain conditions after the HMI is started, until the condition ends.

36

|Bit trigger|Script would be repeat executed when meet the condition of bit trigger.

== **Initialize** ==

Initialize script divided into screen initialize script and background initialize script. Screen initialize script runs once during the initialization of screen; background initialize script runs during the loading of project.

41

42

**Operating procedures**

43

44

1) Click [Background script] in project manager to enter script editor screen, or click [Screen script] in right click menu of screen to enter script editor screen;

45

46

(% style="text-align:center" %)

47

[[image:9.Scripts_html_96fb2991c0580f0f.gif||class="img-thumbnail"]]

48

49

50

(% style="text-align:center" %)

51

[[image:9.Scripts_html_3cebb8edeabbd760.gif||class="img-thumbnail"]]

52

53

2) Double click [initialize] to open script edit window, as below shows;

54

55

(% style="text-align:center" %)

56

[[image:9.Scripts_html_8d93c592be893fad.gif||class="img-thumbnail"]]

57

58

3) Enter scripts in edit window;

== **Close** ==

Close script divided into screen close script and background close script. Screen close script runs once During the destroying of screen because of closing or switching; background close script runs during the closing of project (such as restart HMI, into HMI setup).

63

64

**Operating procedures**

65

66

1. Click [Background script] in project manager to enter script editor screen, or click [Screen script] in right click menu of screen to enter script editor screen;

67

1. Double click [Close] to open script edit window;

68

1. Enter scripts in edit window;

== **Timing** ==

The script would run for a designated time interval.

73

74

**Operating procedures of creating one**

75

76

1. Click [Background script] in project manager to enter script editor screen, or click [Screen script] in right click menu of screen to enter script editor screen;

77

1. Double click [Timing], it would pop-up below setting window;

78

79

(% style="text-align:center" %)

80

[[image:9.Scripts_html_ca0d08792c31539e.gif||class="img-thumbnail"]]

81

82

(% class="table-bordered" %)

83

|**Property**|**Description**

84

|Cycle|Script runs at designated time interval, unit is 10 ms.

85

|Ok|Script created.

86

|Cancel|Cancel the current script setting.

87

88

3) Enter scripts in edit window;

89

90

**Operating procedures of editing**

91

92

1. Click [Background script] in project manager to enter script editor screen, or click [Screen script] in right click menu of screen to enter script editor screen;

93

1. Select [Timing], and click [ [[image:9.Scripts_html_d1db672f9b0fe31.gif]] ]to modify the script execution interval;

94

1. Double click selected [Timing] to open editing window;

95

96

**Operating procedures of deleting**

97

98

1) Click [Background script] in project manager to enter script editor screen, or click [Screen script] in right click menu of screen to enter script editor screen;

99

100

(% style="text-align:center" %)

101

[[image:9.Scripts_html_f7b5302abd3000e3.gif||class="img-thumbnail"]]

102

103

2) Select [Timing], and click [ [[image:9.Scripts_html_75dc3ed25fdbc359.gif]] ] to change interval of script, it pops-up above window

104

105

3) Select [Yes] to execute operation or select [No] to cancel operation;

**✎Note:**

The maximum number of timing script for each screen or background is 32.

110

111

== **Trigger Bit** ==

**Introduction**

Trigger control script is that software will check whether the designated bit meet trigger condition every 20ms. Script execute once condition is met until project closed.

116

117

**Operating procedures of creating one**

118

119

1) Click [Background script] in project manager to enter script editor screen, or click [Screen script] in right click menu of screen to enter script editor screen;

120

121

2) Double click [Trigger bit], it pops-up below setting window;

122

123

(% style="text-align:center" %)

124

[[image:9.Scripts_html_5aa68df50f16cfa2.gif||class="img-thumbnail"]]

125

126

Bit address: It sets trigger address for script;

127

128

Condition: detailed information as below shows;

129

130

(% class="table-bordered" %)

131

|**Condition**|**Description**

132

|TRUE|Script execute once the bit value is TRUE, detects the bit every per approximately 20 ms;

133

|FALSE|Script execute once the bit value is FALSE, detects the bit every per approximately 20 ms;

134

|Bit changed|Execute once the trigger bit switches state;

135

|Rising|Script execute once the bit value from FALSE to TRUE, detects the bit every per approximately 20 ms;

136

|Falling|Script execute once the bit value from TURE to FALSE, detects the bit every per approximately 20 ms;

137

138

3) Set trigger bit and condition, click [OK] to open editing window;

139

140

**Operating procedures of editing**

141

142

1) Click [Background script] in project manager to enter script editor screen, or click [Screen script] in right click menu of screen to enter script editor screen;

143

144

2) Select [Trigger script], and click [ [[image:9.Scripts_html_d1db672f9b0fe31.gif]] ] to change trigger bit and condition;

145

146

3) Double click selected [Trigger script] to open editing window;

147

148

**Operating procedures of deleting**

149

150

1) Click [Background script] in project manager to enter script editor screen, or click [Screen script] in right click menu of screen to enter script editor screen;

151

152

2) Select [Trigger script], and click [ [[image:9.Scripts_html_75dc3ed25fdbc359.gif]] ] to change interval of script, it pops-up below window

153

154

(% style="text-align:center" %)

155

[[image:9.Scripts_html_f7b5302abd3000e3.gif||class="img-thumbnail"]]

156

157

3) Select [Yes] to execute operation or select [No] to cancel operation;

**✎Note:**

The maximum number of trigger script for each screen or background is 32.

162

163

== **Background Function** ==

164

165

Global function is a collection of codes;it can be called in any script.The method reference system function;

166

167

**Operating procedures**

168

169

1) Double click [Background function] in project manager;

170

171

(% style="text-align:center" %)

172

[[image:9.Scripts_html_6240f0610ba63eff.gif||class="img-thumbnail"]]

2) Set parameters;

(% style="text-align:center" %)

177

[[image:9.Scripts_html_d196f8a817949f3e.gif||class="img-thumbnail"]]

178

179

(% class="table-bordered" %)

180

|**Property**|**Description**

181

|Function name|Function name could not be the same as existing.

182

|Return type|None, string, integer, float.

183

|Parameter 1|The name of parameter 1.

184

185

**Operating procedures of editing**

186

187

1) Click [Background function] in project manager to enter script editor screen;

188

189

2) Select Function name, and click [ [[image:9.Scripts_html_c653b64bc266a016.gif]] ] to change parameters;

190

191

3) Double click selected [Trigger script] to open editing window;

192

193

**Operating procedures of deleting**

194

195

1) Click [Background function] in project manager to enter script editor screen;

196

197

2) Select Function name, and click [ [[image:9.Scripts_html_75dc3ed25fdbc359.gif]] ] to change interval of script, it pops-up below window

198

199

(% style="text-align:center" %)

200

[[image:9.Scripts_html_f7b5302abd3000e3.gif||class="img-thumbnail"]]

201

202

3) Select [Yes] to execute operation or select [No] to cancel operation;

**✎Note:**

The maximum parameters for each function are 4, and parameter name can't be unique;

= **Script Usage** =

Script can make project more convenient and flexible. Script is useful in realizing complex HMI function. If the script is used improperly, it may affect the efficiency of entire project. So pay attention to the follow issues:

211

212

1. Do not use too much script loops, if the script loops that execute too many times; it might influence the efficiency of HMI.

213

1. In the cycle scripts, avoid using external register, due to the relatively slow serial communication, frequent access to external registers may cause the execution of scripts severely reduced, even influence the screen respond efficiently. There is fine to use internal register.

214

1. The maximum script length is 512 rows.

215

216

This section describes how to edit scripts and use some of the accompanying tools and features of the script editor.

217

218

== **Script Access to Device** ==

219

220

Software script supports an efficiency way to access the device address by using symbol @.

221

222

(% class="table-bordered" %)

223

|**Writing**|**Meaning**|**Examples**

224

|@B_;@b_;|Access designated bit address|(((

225

@B_I0.0:access bit address I0.0

226

227

@b_HDX0.0:access bit address HDX0.0

228

)))

229

|@W_;@w_;|(% rowspan="2" %)(((

230

Access designated word address

231

232

HMI connect more than automatic control devices, "#"stands for choosing number before the symbol,":"stands for accessing the station number before symbol.

233

234

Access the first protocol without "#",access default station number1 without":".

235

)))|(((

236

@W_IW0:access word address IW0

237

238

@b_HDW0:access word address HDW0

239

)))

240

|@B_(the number of protocol connection)#(station number):address|(((

241

@B_2#2:I0.0:access the bit address I0.0, with the connection number 2 and station number 2;

242

243

@B_I0.0:access to bit address I0.0;

244

)))

245

246

The script can access with the device though: write and read.

**For example**

//If @B_HDX0.0 = 1 then 'read the value from address HDX0.0.//

251

252

//@B_HDX0.0 = 0 'write 0 to address HDX0.0//

//Else//

//@B_HDX0.0 = 1 'write 1 to address HDX0.0//

//Endif//

//@W_QW0 = @W_QW0 + 1 'read data from address QW0, add 1 to this value then write to address QW0.//

261

262

== **Grammar Checking** ==

263

264

**Operating procedures**

265

266

1. Select [[image:9.Scripts_html_2a530bda982b4281.gif]] from script tool bar;

267

1. System does not prompt grammar error if grammar is correct, or system will list all errors;

268

1. Check error information, and modify errors;

269

270

**Error information**

271

272

~1. Identifier ~*~** contains invalid characters

273

274

2. Attempt to redeclare sub ~*~**

275

276

3. Attempt to redeclare function ~*~**

277

278

4. Attempt to use reserved word ~*~** as identifier

279

280

5. Attempt to use type ~*~** as identifier

281

282

6. Unexpected ')' while parsing arguments for function ~*~**

283

284

7. Could not parse expression (one of the arguments of function ~*~**)

285

286

8. Could not parse arguments of ~*~**

287

288

9. Too many arguments for function ~*~**

289

290

10. Not enough arguments for function ~*~**

291

292

~11. '(' expected after sub name ~*~**

293

294

12. Unexpected '(' while parsing arguments for sub ~*~**

295

296

13. Could not parse expression (one of the arguments of sub ~*~**)

297

298

14. Could not parse arguments of ~*~**

299

300

15. Too many arguments for sub/function ~*~**

301

302

16. Not enough arguments for sub/function ~*~**

303

304

17. Could not parse expression

305

306

18. '(' expected after function name ~*~**

307

308

19. Unexpected use of sub ~*~** as a part of expression

309

310

20. Illegal statements preceding subs/functions declaration

311

312

21. Unexpected end of file while looking for 'endsub'

313

314

22. End of line expected after 'else'.

315

316

23. End of line expected after 'endif'.

317

318

24. End of line expected after 'next'.

319

320

25. End of line expected after 'wend'.

321

322

26. 'while', 'until' or end of line expected afte r'do'.

323

324

27. Could not parse expression after 'while'

325

326

28. Could not parse expression after 'until'

327

328

29. 'do' without 'loop'

329

330

30. Sub ~*~** contains invalid character'@'

331

332

31. Sub ~*~** already declared

333

334

32. Function ~*~** already declared

335

336

33. Sub name expected after 'sub'

337

338

34. Function name expected after 'function'

339

340

35. Variable name expected

341

342

36. Argument ~*~** contains invalid character '@'

343

344

37. 'integer', 'floating' or 'string' expected

345

346

38. ''',' or ')' expected

347

348

39. 'endsub' without 'sub'

349

350

40. 'end function' without 'function'

351

352

41. End of line expected after 'beep'

353

354

42. 'dim' unexpected here

355

356

43. Variable name expected after 'dim'

357

358

44. 'as' expected after variable name

359

360

45. 'integer' 'floating' or 'string' expected after 'as'

361

362

46. ',' or end of line expected after type in dim statement

363

364

47. Could not parse expression after 'while'

365

366

48. End of line expected after' while' condition

367

368

49. 'while' without 'wend'

369

370

50. End of line expected after 'wend'

371

372

51. 'wend' without 'while'

373

374

52. Variable name expected after' for'

375

376

53. '=' expected after variable name

377

378

54. Could not parse expression after 'for'

55. 'to' expected

56. Could not parse expression after 'to'

383

384

57. Could not parse expression after 'step'

385

386

58. End of line expected

387

388

59. 'for' without 'next'

389

390

60. End of line expected after 'next'

391

392

61. 'Next' without 'for'

393

394

62. Could not parse expression after'if'

63. 'then' expected

64. Unexpected end of file while looking for 'endif'

399

400

65. Unexpected end of file while looking for 'else' or 'endif'

401

402

66. 'else' without ‘if'

403

404

67. 'end if' without 'if'

405

406

68. Label name expected after 'goto'

407

408

69. Unexpected end of line while looking for ')' in function call

70. ',' expected

71. Missing ')'

72. Unexpected end of line in expression

415

416

73. Unexpected end of file in expression

417

418

= **Script Function List** =

419

420

== **Mathematical** ==

421

422

(% class="table-bordered" %)

423

|(% style="width:181px" %)**Function**|(% style="width:1308px" %)**Introduction**

424

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Abs__>>path:#_Abs]]|(% style="width:1308px" %)Get absolute value

425

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Acos__>>path:#_ACOS]]|(% style="width:1308px" %)Compute the inverse cosine value

426

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Asc__>>path:#_Asc]]|(% style="width:1308px" %)Return the first character of the string in ASCII value

427

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Asin__>>path:#_ASin]]|(% style="width:1308px" %)Calculate the arcsine value

428

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Atan__>>path:#_ATan]]|(% style="width:1308px" %)Return an arctangent value,the radian ranges -pi/2 to pi/2

429

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Atan2__>>path:#_ATan2]]|(% style="width:1308px" %)Return the arctangent value

430

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Cos__>>path:#_Cos]]|(% style="width:1308px" %)Return a cosine value of an angle

431

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Exp__>>path:#_Exp]]|(% style="width:1308px" %)Returns the power value of e (natural logarithm)

432

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Hypot__>>path:#_Hypot]]|(% style="width:1308px" %)Calculate the value of the hypotenuse of a right triangle

433

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Tan__>>path:#_Tan]]|(% style="width:1308px" %)Implement tan calculation to computing the value

434

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Sin__>>path:#_Sin]]|(% style="width:1308px" %)Implement sin calculation to computing the value

435

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Sqr__>>path:#_Sqr]]|(% style="width:1308px" %)Assign a square root value

436

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SignedInt16__>>path:#_SignedInt16]]|(% style="width:1308px" %)Assign the value to [val] from address A1 which is signed integer

437

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SignedInt32__>>path:#_SignedInt32]]|(% style="width:1308px" %)Assign the value to [val] from address A1 which is signed even integer

438

439

== **Data Migration** ==

440

441

(% class="table-bordered" %)

442

|(% style="width:178px" %)**Function**|(% style="width:1311px" %)**Introduction**

443

|(% style="width:178px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__BMOV__>>path:#_BMOV]]|(% style="width:1311px" %)Copy data with a designated length from source address

444

|(% style="width:178px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__FILL__>>path:#_FILL]]|(% style="width:1311px" %)Write the same value to designated address constantly

445

|(% style="width:178px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SetKeyMap__>>path:#_SetKeyMap]]|(% style="width:1311px" %)The key values of the keyboard are mapped so that multiple keyboard buttons perform the same function

446

447

== **Process Control** ==

448

449

(% class="table-bordered" %)

450

|(% style="width:181px" %)**Function**|(% style="width:1308px" %)**Introduction**

451

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__GOTO__>>path:#_Goto]]|(% style="width:1308px" %)Go to the designated row unconditionally in a function body

452

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__FOR__>>path:#_For._to._step.]]|(% style="width:1308px" %)Execute a command repeatedly for designated times

453

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__END__>>path:#_End]]|(% style="width:1308px" %)End the execution of script

454

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__while__>>path:#_WHILE_..._WEND]]|(% style="width:1308px" %)If the condition is true, then all the commands before Wend in the statement will be executed and then recheck the condition, if the condition is false, the command after Wend will be executed

455

456

== **Data Conversion** ==

457

458

(% class="table-bordered" %)

459

|(% style="width:182px" %)**Function**|(% style="width:1307px" %)**Introduction**

460

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__A2H__>>path:#_A2H]]|(% style="width:1307px" %)Convert string A1 to hexadecimal number

461

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Asfloating__>>path:#_AsFloating]]|(% style="width:1307px" %)Convert parameter to a float

462

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__AsInteger__>>path:#_AsInteger]]|(% style="width:1307px" %)Convert parameter to a integer

463

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__AsString__>>path:#_AsString]]|(% style="width:1307px" %)Convert parameter to a string

464

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__B2W__>>path:#_B2W]]|(% style="width:1307px" %)Convert an array

465

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__BCD__>>path:#_BCD]]|(% style="width:1307px" %)Convert binary to BCD, save the result as return value

466

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__BIN__>>path:#_BIN]]|(% style="width:1307px" %)Convert BCDto binary, save the result in return value

467

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Chr__>>path:#_Chr]]|(% style="width:1307px" %)Convert integer parameter into correspond ASCII character,return the character string

468

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__D2F__>>path:#_D2F]]|(% style="width:1307px" %)Convert the 32 bit integer format data to float then output the result

469

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__D2Float__>>path:#_D2Float]]|(% style="width:1307px" %)Convert the designated value to floating then assign to variable

470

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__D2Int__>>path:#_D2Int]]|(% style="width:1307px" %)Output the 32-bit integer in the form of integer

471

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__DegToRad__>>path:#_DegToRad]]|(% style="width:1307px" %)Convert the angle into correspond radian, and display

472

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__F2D__>>path:#_F2D]]|(% style="width:1307px" %)Convert a 32 bit floating to integer format, and then output the result

473

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__F2S__>>path:#_F2S]]|(% style="width:1307px" %)Output a format of floating that in the type of string

474

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Float2D__>>path:#_Float2D]]|(% style="width:1307px" %)Copy floating value to the address

475

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__H2A__>>path:#_H2A]]|(% style="width:1307px" %)Convert a binary(16 bit) to hexadecimals(4 bit) of ASCII

476

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Int2D__>>path:#_Int2D]]|(% style="width:1307px" %)Write the 32-bit integer into the specified address

477

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__LCase__>>path:#_Lcase]]|(% style="width:1307px" %)Convert all parameters to lowercase strings

478

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__MAX__>>path:#_MAX]]|(% style="width:1307px" %)Compare the value of A2 and A3, assign the greater number to A1

479

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__MIN__>>path:#_MIN]]|(% style="width:1307px" %)Compare the value of A2 and A3, assign the smaller number to A1

480

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__RadToDeg__>>path:#_RadToDeg]]|(% style="width:1307px" %)Convert radiant value to degree

481

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__S2F__>>path:#_S2F]]|(% style="width:1307px" %)Convert string to floating in the specified format

482

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SWAP__>>path:#_SWAP]]|(% style="width:1307px" %)Exchange the high and low bytes of the parameter

483

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__W2B__>>path:#_W2B]]|(% style="width:1307px" %)Combine the high byte of the value of two consecutive addresses into a new value

484

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__W2D__>>path:#_W2D]]|(% style="width:1307px" %)Convert the unsigned Word to unsigned Dword and save the result

485

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__W2F__>>path:#_W2F]]|(% style="width:1307px" %)Convert a 16bit integer to a 32bit floating, and then save to the next word address

486

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__W2S__>>path:#_W2S]]|(% style="width:1307px" %)Convert integer word text as S1 format, and then save

487

488

== **String Processing** ==

489

490

(% class="table-bordered" %)

491

|(% style="width:180px" %)**Function**|(% style="width:1309px" %)**Introduction**

492

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__A2I__>>path:#_A2I]]|(% style="width:1309px" %)A string of length is intercepted from A1 and converted to a single/double word integer, and then this integer is assigned to A2

493

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__InStr__>>path:#_InStr]]|(% style="width:1309px" %)Return the position of str1 in str2

494

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__LEFT__>>path:#_Left]]|(% style="width:1309px" %)Return a string of the specified length from the left side of parameter

495

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Len__>>path:#_Len]]|(% style="width:1309px" %)Return the string length

496

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__LTrim__>>path:#_LTrim]]|(% style="width:1309px" %)Remove the left empty part of the string and return

497

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Mid__>>path:#_Mid]]|(% style="width:1309px" %)Returns a string contain a specified characters length from a string

498

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Right__>>path:#_Right]]|(% style="width:1309px" %)Return a string of the specified length from the right side of parameter

499

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__RTrim__>>path:#_RTrim]]|(% style="width:1309px" %)Clear the empty part on the right side of string [str], then assign the empty part to val

500

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Trim__>>path:#_Trim]]|(% style="width:1309px" %)Return a value of an address without empty string next to it

501

|(% style="width:180px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__UCase__>>path:#_UCase]]|(% style="width:1309px" %)Capitalize the string data, and then assign the value to val

502

503

== **Fixed Constant** ==

504

505

(% class="table-bordered" %)

506

|**Function**|**Introduction**

507

|[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Pi__>>path:#_Constant]]|pi = 3.14159265358979321

508

|True|TRUE = 1

509

|False|FALSE = 0

510

|[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Operator__>>path:#_Operator]]|Operator in scripts edit window

511

|[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Variable__>>path:#_Variable]]|A variable is any factor, trait, or condition that can exist in differing amounts or types

512

513

== **Bit Control** ==

514

515

(% class="table-bordered" %)

516

|(% style="width:178px" %)**Function**|(% style="width:1311px" %)**Introduction**

517

|(% style="width:178px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__ClrB__>>path:#_Clrb]]|(% style="width:1311px" %)Set the bit of A1 as FALSE

518

|(% style="width:178px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__InvB__>>path:#_InvB]]|(% style="width:1311px" %)The state of inverse bit

519

|(% style="width:178px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SetB__>>path:#_SetB_sub]]|(% style="width:1311px" %)Set the bit A1 ON

520

521

== **File Operation** ==

522

523

(% class="table-bordered" %)

524

|(% style="width:177px" %)**Function**|(% style="width:1312px" %)**Introduction**

525

|(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__HmiRegOperator__>>path:../input/9.Scripts.odt/%5Cl%20]]|(% style="width:1312px" %)Data of Upload/ Download address

526

|(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__CopyFile__>>path:../input/9.Scripts.odt/%5Cl%20]]|(% style="width:1312px" %)Copy the A3 file from the A1 directory to the A2 directory according to the format of A4 and A5

527

|(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__DbToCsvFile__>>path:../input/9.Scripts.odt/%5Cl%20]]|(% style="width:1312px" %)Convert db (database file) file to csv format and export it

528

|(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__FileCmpDir__>>path:#HFileCmpDir]]|(% style="width:1312px" %)The filename input and the filename in the folder whether is duplicate or not

529

|(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__MyDeleteFile__>>path:#HMyDeleteFile]]|(% style="width:1312px" %)Delete the designated file

530

|(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__WriteWordToFile__>>path:#HWriteWordToFile]]|(% style="width:1312px" %)Write data with designated length to designated file

531

|(% style="width:177px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__ReadWordFormFile__>>path:#HReadWordFormFile]]|(% style="width:1312px" %)Read data with designated length from designated file

== **Comparison** ==

(% class="table-bordered" %)

536

|(% colspan="2" style="width:389.5px" %)**Function**|(% style="width:691.5px" %)**Introduction**

537

|(% rowspan="8" style="width:255.281px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__IF... THEN GOTO..__>>path:#_IF_..._THEN]](%%).|(% style="width:148.719px" %)IF=|(% rowspan="18" style="width:691.5px" %)Execute correspond instruction when fulfill condition. Condition will be tested during executing if. it will execute the next instruction block of then, if condition is true. Otherwise, execute the later of else. Complete the two instructions, next execute the later of End if.

538

|(% style="width:148.719px" %)IF<>

539

|(% style="width:148.719px" %)IF>

540

|(% style="width:148.719px" %)IF>=

541

|(% style="width:148.719px" %)IF<

542

|(% style="width:148.719px" %)IF<=

543

|(% style="width:148.719px" %)IF AND=0

544

|(% style="width:148.719px" %)IF AND<>0

545

|(% rowspan="8" style="width:255.281px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__IF__>>path:#_IF_..._THEN]]|(% style="width:148.719px" %)IF=

546

|(% style="width:148.719px" %)IF<>

547

|(% style="width:148.719px" %)IF>

548

|(% style="width:148.719px" %)IF>=

549

|(% style="width:148.719px" %)IF<

550

|(% style="width:148.719px" %)IF<=

551

|(% style="width:148.719px" %)IF AND=0

552

|(% style="width:148.719px" %)IF AND<>0

553

|(% colspan="2" style="width:389.5px" %)ELSE

554

|(% colspan="2" style="width:389.5px" %)ENDIF

555

556

== **Application Type** ==

557

558

(% class="table-bordered" %)

559

|(% style="width:181px" %)**Function**|(% style="width:1308px" %)**Introduction**

560

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__AddrStringCompare__>>path:#_AddrStringCompare]]|(% style="width:1308px" %)Compare the designated length of two character strings

561

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__beep__>>path:#_Beep]]|(% style="width:1308px" %)Enable buzzer

562

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__IsFloating__>>path:#_IsFloating]]|(% style="width:1308px" %)whether a parameter is floating, return TRUE if it is floating, otherwise return FALSE

563

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__IsInteger__>>path:#_IsInteger]]|(% style="width:1308px" %)whether a parameter(A1) is integer, return TRUE if the parameter is integer, otherwise return FALSE

564

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Log__>>path:#_Log]]|(% style="width:1308px" %)Log function: return the natural logarithm of the value

565

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Log10__>>path:#_Log10]]|(% style="width:1308px" %)Log function: return the natural logarithm of the value

566

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__MSeconds__>>path:#_MSeconds]]|(% style="width:1308px" %)Display the current microseconds of system

567

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__NewNoAddr__>>path:#_NewNoAddr]]|(% style="width:1308px" %)At the basic of source address A2,offset designated length,obtain a new address A1

568

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__NewStatAddr__>>path:#_NewStatAddr]]|(% style="width:1308px" %)At the basic of source address A2,offset the designated length,to obtain a new station A1.

569

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__NStringCompare__>>path:#_NStringCompare]]|(% style="width:1308px" %)Compare whether the designated length of two strings is the same,return 1 to A1 if yes,otherwise return 0

570

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Power__>>path:#_Power]]|(% style="width:1308px" %)The value of [expr2] to the power of [expr1] will be assigned to Var

571

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Rand__>>path:#_RAND]]|(% style="width:1308px" %)Generate a random number

572

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__ReadAddr__>>path:#_ReadAddr]]|(% style="width:1308px" %)Assign the value in the specified address to [word]

573

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__SleepA__>>path:#_SleepA]]|(% style="width:1308px" %)Wait time T(ms)

574

|(% style="width:181px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__WriteAddr__>>path:#_WriteAddr]]|(% style="width:1308px" %)Assign the value from A2 to address A1

== **Others** ==

(% class="table-bordered" %)

579

|(% style="width:182px" %)**Function**|(% style="width:1307px" %)**Introduction**

580

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Dim...as...__>>path:#_DIM_..._AS]]|(% style="width:1307px" %)Declare a variable

581

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__do__>>path:#_DO_..._LOOP]]|(% style="width:1307px" %)Condition determent instruction

582

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Function__>>path:#_Function]]|(% style="width:1307px" %)Differ from internal function, need to declare the name, parameter, code of the function

583

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__Sub__>>path:#_Sub]]|(% style="width:1307px" %)Declare the name, parameters and codes of the Sub (sub function)

584

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__PrintText__>>path:#_PrintText]]|(% style="width:1307px" %)Output the contents to the printer for printing

585

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__PI_GetTickCount__>>path:#_PI_GetTickCount]]|(% style="width:1307px" %)Write the starting time in the set address as a 32-bit integer

586

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__StAndFtChange__>>path:#_StAndFtChange]]|(% style="width:1307px" %)Calculate the number of seconds from January 1, 1970 to the current time

587

|(% style="width:182px" %)[[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__GetServerDelayInfo__>>path:#_GetServerDelayInfo]]|(% style="width:1307px" %)Convert string to hexadecimal number

588

589

= **Function Description** =

== **A2H** ==

**Function**

Val = A2H(A1)

**Description**

Convert string in the specified address to a hexadecimal number;

**Parameters**

**A1:** Source data, only convert the first four digits of string

604

605

**Val:** The value is hexadecimal number.

**Example**

//@W_HDW20=A2H(@W_HDW10) ' convert the string of HDW10 to hex then save in HDW20.//

610

611

**Input:** @W_HDW10=255

612

613

**Result:** @W_HDW20=255

**✎Note:**

A1 needs to be address (such as:@W_HDW000002).

618

619

Only [0~~1], [a~~f] can be converted, others will be converted to 0

== **A2I** ==

**Function**

A2I (A1, A2, length, S)

**Description**

Intercept a string of the specified length from A1,convert it to a single/double word integer and assign this integer to A2.

**Parameters**

**A1:** String to be intercepted

634

635

**A2:** The final integer value

636

637

**Length:** intercepts the length of the string

638

639

**S:** Control single or double words.

640

641

S=0, indicating an integer single word; S=1, indicating an integer double word.

642

643

**Return value:** none

**Example**

//A2I("@W_HDW200","@W_HDW100",4,0) 'converts a string into a 16-bit (single word) decimal integer//

648

649

//A2I("@W_HDW600","@W_HDW500",4,1)' converts a string to a 32-bit (double word) decimal integer//

650

651

**Input:**@W_HDW200="12345", **Result:** @W_HDW100=1234

652

653

**Input:**@W_HDW600="12345", **Result:** @W_HDW500=1234

**✎Note:**

A1 and A2 need to be address (such as:@W_HDW000002).

== **Abs** ==

**Function**

val = Abs(A1)

**Description**

The absolute value of A1.

**Parameters**

**A1: **the data of absolute value, need to be variable.

672

673

**Val: **it is absolute value that is address or variable.

**Example**

//Dim a as integer 'a is defined as integer//

678

679

//a = SignedInt16("@W_HDW0")'convert the data of @W_HDW0 into signed data.//

680

681

//@W_HDW1 = Abs(a) 'assign the returned absolute value to @W_HDW1//

682

683

**Input: **@W_HDW0=-6

684

685

**Result: **@W_HDW1=6

**✎Note:**

**SignedInt16** function is designed to convert unsigned to signed.

== **ACos** ==

**Function**

val = ACos(A1)

**Description**

To compute the inverse cosine value of A1.

**Parameters**

**A1: **floating value, can be an address or variable.

704

705

**Val: **return value is floating, can be an address or variable.

**Example**

//Dim a ,b as floating'define two float variable a,b//

710

711

//a = 0.5 'assign the designated value to a//

712

713

//b = ACos(a) 'the inverse cosine value of "a" is a radian which assign to variable b.//

714

715

//'to add the following sentence if needed to view the return value~://

716

717

//float2d("@W_HDW200", b)'float b written into HDW200.//

718

719

**Result:** @W_HDW200=1.047

**✎Note:**

Please call **RadToDeg** function to convert radian into angle.

724

725

== **AddrStringCompare** ==

**Function**

val = AddrStringCompare(A1, A2, length)

**Description**

It is designed to compare the designated length of two character strings. The string value is 1 when the two strings are the same.

**Parameters**

**A1, A2: **character string, need to be an address (such as:"@W_HDW000002")

738

739

**Length: **The length of character string.

740

741

**Val: **Return value, 0 or 1.

**Example**

//if AddrStringCompare("@W_HDW10","@W_HDW0",2)=1 then//

746

747

//'compare the character string of HDW10 and @W_HDW0 whether value are 1.//

748

749

//@W_HDW20=1 '@W_HDW20 display 1//

//else//

//@W_HDW20=0'@W_HDW20 display 0//

//Endif//

**Input: **@W_HDW10="1a2 ", @W_HDW0="1a2 ",

758

759

**Result:** @W_HDW20=1

760

761

**Input: **@W_HDW10="ab2 ", @W_HDW0="12a ",

762

763

**Result: **@W_HDW20=0

== **Asc** ==

**Function**

val = Asc(A1)

**Description**

Return the first character of the string in ASCII value.

**Parameters**

**A1:**character string, it can be an address (such as: @W_HDW000002)

778

779

**val:**return value,ASCII value,it could be an address or variable.

**Example**

//@W_HDW10 = Asc("A") 'return the ASCII value of A to HDW10//

784

785

//@W_HDW11 = Asc("a")'return the ASCII value of a to HDW11//

786

787

//@W_HDW12 = Asc("Apple") 'return the first character A of string Apple to HDW12//

788

789

//@W_HDW13 = Asc("123") 'return the first character ASCII value 1 of string 123 to HDW13.//

790

791

**Result: **@W_HDW10 = 65

@W_HDW11 = 97

@W_HDW12 = 65

@W_HDW13 = 49

== **AsFloating** ==

**Function**

val = AsFloating(A1)

**Description**

Convert parameter A1 to a float.

**Parameters**

A1: integer variable.

812

813

**val: **return float value, can be a variable or address.

**Example**

//Dim a as integer 'define a integer variable {a}.//

818

819

//a = @W_HDW10 'assign @W_HDW10 to a//

820

821

//b = AsFloating(a) 'convert integer a to float then assign to b.//

822

823

//b = b/1.2 'add as following sentence when need to view the return value~://

824

825

//Float 2D("@W_HDW11",b) 'float variable b written into HDW11.//

826

827

**Input: **@W_HDW10=24,

828

829

**Result: **@W_HDW11=20.00(set two decimals)

== **ASin** ==

**Function**

val = ASin(A1)

**Description**

Calculate the arcsine value of A1.

**Parameters**

**A1: **Float can be an address or variable.

844

845

**Val: **Return float value, can be an address or variable.

**Example**

//Dim a, b as floating'define two float variable a,b//

850

851

//a = 0.5'assign the designated value to a//

852

853

//b=ASin(a) 'calculate the arcsine value of a ,assign the radian to b.//

854

855

//'Add the following command if need to view the return value~://

856

857

//float2d ("@W_HDW200", b) 'float variable b written into HDW200//

858

859

**Result:**@W_HDW200=0.524

**✎Note:**

Pleasecall **RadToDeg** function to convert radian into angle.

== **AsInteger** ==

**Function**

val = AsInteger(A1)

**Description**

Convert parameter A1 to integer value.

**Parameters**

**A1: **floating need to be a variable.

878

879

**Val: **the value returned could can be a variable or address.

**Example**

//Dim a as floating 'define floating variable a//

884

885

//a = D2Float("@W_HDW0",a) 'use D2Float function to save the float date of HDW0 in a//

886

887

//b= AsInteger(a) 'convert the float a into integer, the return value assigned to b//

888

889

//@W_HDW10=b 'save b to HDW10//

890

891

**Input:** @W_HDW0=20.12,

892

893

**Result:** @W_HDW10=20

== **AsString** ==

**Function**

val = AsString(A1)

**Description**

Convert parameter A1 to a character string.

**Parameters**

A1: not string parameter, it can be a variable.

908

909

Val: return string value, variable or address.

**Example**

Script 1:

//a=123 'assign a value to a//

916

917

//b=234 'assign a value to b//

918

919

//c=AsString(a)+AsString(b) 'convert a and b to string then add up the two strings ,assign the result to c.//

920

921

//@W_HDW0=c 'assign c to HDW0//

922

923

//d=a+b 'plus a with b//

924

925

//@W_HDW100=d 'assign d to (HDW100)//

926

927

**Result: **@W_HDW0=123234

@W_HDW100=357

Script 2:

//W2S("@W_HDW200","@W_HDW300","02d")//

934

935

//W2S("@W_HDW210","@W_HDW400","02d")//

936

937

//W2S("@W_HDW220","@W_HDW500","02d")//

938

939

//@W_HDW0=AsString(@W_HDW300)+AsString(@W_HDW400)+AsString(@W_HDW500)//

940

941

**Input:**@W_HDW200=12,@W_HDW210=34,@W_HDW220=56

942

943

**Result :**@W_HDW300=12,@W_HDW400=34,@W_HDW500=56,@W_HDW0=123456

**✎Note:**

Ensure the data always is two words; otherwise occur error. reference the other chapter of W2S function

== **ATan** ==

**Function**

var = ATan(A1)

**Description**

Return an arctangent value,the radian ranges -pi/2 to pi/2.

**Parameters**

**A1:**Can be float, address or variable.

962

963

**Val:**radian of return value.

**Example**

//@W_HDW20= Atan (@W_HDW10)'save the arctangent value of (HDW10) to (HDW20)//

968

969

**Input: **@W_HDW10=1.000,@W_HDW20=0.785

**✎Note:**

Please call RadToDeg function convert radian to angle.

== **ATan2** ==

**Function**

val = ATan2(A1,A2)

**Description**

Return the arctangent value of A1/A2,radian range

**Parameters**

**A1, A2:** Address or variable.

988

989

**Val: **returned value is a radian, range -pi to pi.

990

991

**Notice: **ATan2 use sign of two parameters to define the quadrant of return value.

**Example**

//@W_HDW20= ATan2 (@W_HDW10,@W_HDW12)'save the arctangent value of (HDW10/HDW12) to (HDW20).//

996

997

**Input:**@W_HDW10=1.0,@W_HDW12=1.0,

998

999

**Result: **@W_HDW20=0.785

**✎Note:**

Please call **RadToDeg** function convert radian to angle.

== **B2W** ==

**Function**

B2W(A1, A2, length)

**Description**

Convert an array (begins with A2, unit: byte, to another array (begins with A1, unit: word).

**Parameters**

**A1: **Saving address after converting

1018

1019

**A2: **Address of the value be converted

1020

1021

**Length:** The length of conversion

1022

1023

**Return value:**None

**Example**

//B2W(@W_HDW100,@W_HDW10,2) 'convert (@W_HDW10) to the length of 2,save as the result that begins with @W_HDW100.//

1028

1029

**Input: **@W_HDW10=1A2B

1030

1031

**Result: **@W_HDW100=2B

@W_HDW101=1A

**✎Note:**

A1 and A2 need to be address(e.g.: @W_HDW000002);

1038

1039

Length could be address or variable;

1040

1041

This is a subprogram; it has no returned value.

== **BCD** ==

**Function**

val = BCD(A1)

**Description**

Convert A1(binary) to BCD, save the result as return value.

**Parameters**

**A1: **The binary be converted; it can be an address or variable.

1056

1057

**Val: **Return value, BCD code; it can be an address or variable.

**Example**

//@W_HDW20=BCD(@W_HDW10) 'convert HDW10 (binary) to BCD code, then save in (HDW20)//

1062

1063

**Input:** @W_HDW10=11111111(binary)

1064

1065

**Result:** @W_HDW20=255

**✎Note:**

Return value is a word; it hexadecimal corresponds to BCD code.

== **Beep** ==

**Function**

Beep()

**Description**

Enable buzzer

**Parameters**

None

**Example**

//if @B_HDX100.0=1 then 'beep when the bit switch HDX100.0 set ON//

//beep()//

//endif//

**Result: **HMI beep when bit switch HDX100.0 set ON.

== **BIN** ==

**Function**

Val = BIN(A1)

**Description**

Convert A1 (BCD) into binary, save the result in return value.

**Parameters**

**A1:** The BCD code is converted; it can be address or variable.

1108

1109

**Val:** Return binary value,it can be address or variable.

**Example**

//@W_HDW20=BIN(@W_HDW10) 'convert HDW10(BCD) to binary, save the result in (HDW20)//

1114

1115

**Input:** @W_HDW10=255

1116

1117

**Result:** @W_HDW20=11111111 (binary)

== **BMOV** ==

**Function**

BMOV(A1, A2,length)

**Description**

Copy data with a designated length from source address A2 to A1.

**Parameter**

**A1:** saving address;

1132

1133

**A2:** source address;

1134

1135

**length:** operating length;

**Example**

//@W_HDW20 = 20 'assign value to HDW20//

1140

1141

//@W_HDW21 = 21 'assign value to HDW21//

1142

1143

//@W_HDW22 = 22 'assign value to HDW22//

1144

1145

//BMOV(@W_HDW10,@W_HDW20,3) 'assign the word address of HDW20, HDW21, HDW22 to HDW10, HDW11, HDW12//

**Result:**

@W_HDW10 = 20

@W_HDW11 = 21

@W_HDW12 = 22

**✎Note:**

A1 and A2 need to be address

1158

1159

Length can be an integer variable or an address. When destAddr and srcAddr are PLC (external device) addresses, the length range is 1-2048, and the 2049th address would not be operated when the range is exceeded.

1160

1161

When destAddr and srcAddr are HMI addresses, the length range is 1-4096, and This function is invalid when out of range.

== **Chr** ==

**Function**

val = Chr(A1, A2, ...)

**Description**

Convert integer parameter into correspond ASCII character, return the character string.

**Parameters**

**A1, A2....:** converted integer; it can be an address or variable.

1176

1177

**Val: **returned value, can be an address or variable.

**Example**

//@W_HDW100=Chr(@W_HDW20, @W_HDW21, @W_HDW22, @W_HDW23, @W_HDW24)//

1182

1183

//'convert the value of(HDW20, HDW21 ,HDW22, HDW23, HDW24) to ASCII character, assign the value to (HDW100)//

1184

1185

**Input** 72,69,76,76,79 step by step according to HDW20, HDW21, HDW22, HDW23, HDW24,

1186

1187

**Result** returns HELLO to (@W_HDW100).

== **Clrb** ==

**Function**

ClrB(A1)

**Description**

Set the bit of A1 as FALSE (0).

**Parameters**

**A1:** System address(bit)

**✎Note:**

subprogram has no return value.

**Example**

//ClrB(@B_HDX100.0) 'assign 0 to (@B_HDX100.0)//

== **Constant** ==

**Description**

Script supported constant, users can use on script:

1216

1217

pi = 3.14159265358979321

TRUE = 1

FALSE = 0

**Example**

//Dim a as integer 'define integer a//

1226

1227

//a = RadToDeg(pi) 'convert radian pi to angle then assign to a,RadToDeg function is used to convert radian to angle.//

1228

1229

//@W_HDW11 = a 'assign a to (HDW11)//

1230

1231

**Result: **@W_HDW11=180

== **CopyFile** ==

**Function**

A6=CopyFile(A1,A2,A3,A4,A5)

**Description**

Copy the A3 file from the A1 directory to the A2 directory according to the format of A4 and A5, and write returned value status to A6.

**Parameters**

**A1: **the source path of the file to be copied.

**A2: **target path.

**A3:** the name of the file to be copied.

1250

1251

**A4: **copy type (0: copy file, 1: copy directory).

1252

1253

**A5: **Whether to overwrite the file with the same name when copying (0: Yes, 1: No).

1254

1255

**A6: **returned value.

0: copy failed

1: copy succeeded

2: Parameter error

3: U disk does not exist

1264

1265

4: SD card does not exist

5: Path error

**Example**

* Copy a single file:

1272

1273

//@W_HDW100 = " test.csv"//

1274

1275

//CopyFile("UDisk/Test","Flash/Test","test.csv",0,0) 'Copy the Test.csv file in the UDisk/Test directory to the Flash/Test directory.//

1276

1277

Can also be written as //CopyFile("UDisk/Test","Flash/Test",@W_HDW100,0,0)//

1278

1279

(2) Copy the entire directory file:

1280

1281

//CopyFile("UDisk/Test","Flash/Test","",1,0) ' Copy the files in the UDisk/Test//

1282

1283

//directory to the Flash/Test directory.//

**✎Note:**

* Both source and destination paths need to begin with UDisk or Flash or SDCard;

1288

* A1 and A2 could be string (requires double quotes) or variable, maximum character length 127 allowed in path;

1289

* A3 could be a string, such as: [FileName] (requires double quotes); or address, such as: @W_HDW100 (no need to add double quotes);

1290

* A4 and A5 could be values, addressesor variable;

1291

* A6 could be address or variable.

== **Cos** ==

**Function**

Val = Cos(A1)

**Description**

Return a cosine value of an angle.

**Parameters**

**A1: **a float radian of angle, it can be an address or variable.

1306

1307

**Val: **return float value, it can be an address or variable.

**Example**

//Dim a, b as floating 'define float a, b//

1312

1313

//b = pi/3 'convert the value of HDW11 to float and assign to 'b'.//

1314

1315

//a=Cos(b) 'return the cosine value of'b' and assign the result to 'a'.//

1316

1317

//'to add the following sentence if need to view the return value~://

1318

1319

//Float2D("@W_HDW20",a) 'the float value of a written into HDW13.//

1320

1321

**Result: **@W_HDW20=0.5

**✎Note:**

Please call **RadToDeg** function convert radian to angle.

== **D2F** ==

**Function**

D2F (A1, A2) or A1= D2F (A1, A2)

**Description**

Convert the 32-bit integer format data to float then output the result.

**Parameters**

**A1: **required data, begin with"@";

1340

1341

**A2: **source data, begin with"@";

**Example**

//D2F(@W_HDW2,@W_HDW0) 'convert the double word (HDW0) to float, save the result to (HDW2).//

1346

1347

//@W_HDW2=D2F(@W_HDW2,@W_HDW0) 'convert the double word (HDW0) to float, save the result to (HDW2).//

1348

1349

**Result: **HDW0=100, HDW2=100

== **D2Float** ==

**Function**

F= D2Float("A1",F)

**Description**

Convert the designated value to floating then assign to variable.

**Parameters**

**A1:** Source data;

**F:** User-defined floating variable

**Example**

//dim F as floating 'define F as floating//

1370

1371

//F=D2Float("@W_HDW10",F) 'assign the value of (HDW10) to F in floating//

1372

1373

//Float2D("@W_HDW12",F) 'copy the floating value of F to HDW12 register,use to display result.//

1374

1375

**Result: **HDW10=200,

HDW12=200.

**✎Note:**

A1 needs to be address;

== **D2Int** ==

**Function**

A2= D2Float("A1",A2)

**Description**

Output the 32-bit integer in the form of integer.

**Parameters**

**A1:** Source data can only be the HMI internal or external register starting with "@".

1396

1397

**A2: **Target data can only use theinteger variable defined by script.

**Example**

//dim var1 as integer 'define var1 as integer//

1402

1403

//var1=D2Int("@W_HDW0",var1) 'Read out the 32-bit integer in HDW0 and save the result in var1.//

//HDW0=9999999,//

**Result:** Var1=9999999

1408

1409

== **DbToCSVFile** ==

**Function**

A8=DbToCSVFile(A1,A2,A3,A4,A5,A6,A7)

**Description**

Convert db (database file) file to csv format and export it.

**Parameters**

**A1: **db file save path (value is integer);

1422

1423

~=0: Alarm record file in HMI flash;

1424

1425

~=1: Alarm record file in UDisk (USB flash disk);

1426

1427

~=2: Alarm record file in SD card;

1428

1429

~=3: Data record file in HMI flash;

1430

1431

~=4: Data record file in UDisk (USB flash disk);

1432

1433

~=5: Data record file in SD card;

1434

1435

**A2: **group numer of db file (value is integer);

1436

1437

Used during exporting data record file, the group number could be seen in the data record setting interface;

1438

1439

**A3:** csv file save path (value is integer);

1440

1441

~=0: Save in UDisk (USB flash disk);

1442

1443

~=1: Save in SD card;

**A4: **csv name;

**A5: **start time of data recordin db file(string), consecutive 6 word addresses (the values in the address are year, month, day, hour, minute, second);

1448

1449

**A6:** end time of data recordin db file(string), consecutive 6 word addresses (the values in the address are year, month, day, hour, minute, second);

1450

1451

**A7:** csv encoding format;

~=0 UTF8 format;

~=1 GBK format;

**A8:** returned value;

1458

1459

~=0: Failed to export;

~=1: Exported;

~=2: db file path error;

1464

1465

~=3: U disk or SD card does not exist;

~=4: csv name error;

~=5: db file does not exist;

1470

1471

~=6: csv file already exists;

**Example**

@W_HDW100 = 2018

@W_HDW101 = 12

@W_HDW102 = 25

@W_HDW103 = 19

@W_HDW104 = 10

@W_HDW105 = 30

@W_HDW200 = 2018

@W_HDW201 = 12

@W_HDW202 = 25

@W_HDW203 = 20

@W_HDW204 = 10

@W_HDW205 = 30

Export data record file

1500

1501

//DbToCsvFile(3,2,0,"123.csv","@W_HDW100","@W_HDW200",0)‘In the HMI flash, the group number is 2, and the data records collected in the time of 2010.12.25 19:10:30-2018.12.25 20:10:30 are exported to the 123.csv file in the Udisk in UTF8 format.//

1502

1503

Export alarm record file

1504

1505

//DbToCsvFile(0,0,0,"456.csv","@W_HDW100","@W_HDW200",1)‘The alarm records generated in HMI Flash at 2018.12.25 19:10:30-2018.12.25 20:10:30 are exported to the 456.csv file in the Udisk in GBK format.//

**✎Note:**

A1 can be an address or a variable or a value, and the path need to start with UDisk or Flash or SDCard;

1510

1511

A2 can be an address or a variable or a value;

1512

1513

A3 can be an address or a variable or a value, and the path need to start with UDisk or Flash or SDCard;

1514

1515

A4 can be an address or variables or string, and the length of the file name (sum of values, English, Chinese) could not exceed 127;

1516

1517

A5 need to be an address;

1518

1519

A6 need to be an address;

1520

1521

A7 can be an address or a variable or a value;

== **DegToRad** ==

**Function**

A2 = DegToRad(A1)

**Description**

Convert the angle into correspond radian, and display.

**Parameters**

**A1:** inputting angle supports address, other variable or floating.

1536

1537

**A2: **outputting radian supports address, other variable or floating.

**Example**

Script 1

//@W_HDW12=DegToRad(@W_HDW10) 'input angle on (HDW10),convert to correspond redian and copy to (HDW12)//

1544

1545

**Result: **HDW10=180; HDW12=3.14159

Script 2

//dim a as floating 'set variable//

1550

1551

//dim b as floating 'set variable//

1552

1553

//b=30 'input angle//

1554

1555

//a=DegToRad(b) 'convert the length of radian and copy to variable {a}//

1556

1557

//float2d("@W_HDW0", a) 'display the value of floating on(HDW0)//

1558

1559

**Result:** HDW0=0.52360

1560

1561

== **DIM ... AS ...** ==

**Function**

Dim "variable" as "date type"

**Description**

Declare a variable, stable the type of data.

**Parameters**

**Variable: **begin with letter, other character can be letter, numbers, underscores ('_'), need to begin with '@' if it is address;

1574

1575

**Data type:**string,floating,integer;

**Example**

//dim a as integer 'define a as integer//

1580

1581

//dim @W_HDW0 as floating 'define @W_HDW0 as floating//

1582

1583

//dim hi as string 'define "hi" as string//

**Result:**

a is integer

@W_HDW0 is floating

hi is string

**✎Note:**

Use the variable of Dim during running, could not change the type, Dim will be missed if the type of variable is no difined. Variable could be declared in once.

1596

1597

== **DO ... LOOP** ==

**Function**

Do [While | Until condition]

[statements]

Loop

or

Do

[statements]

Loop [While | Until condition]

**Description**

Condition determent instruction.

1618

1619

Do while.loop executes an instruction of block repeatedly when condition is true.

1620

1621

Do until.loop executes an instruction of block repeatedly until condition is false.

**Parameters**

**Condition: **determine condition; obtain the expression of True or False.

1626

1627

**Statements: **execute one or more instructions repeatedly when condition is True or until condition is True.

1628

1629

If condition is true, all statements are executed until the Wend statement is encountered. Control then returns to the While statement and condition is again checked. If condition is still True, the process is repeated. If it is not true, execution resumes with the statement following the Wend statement.

**Example**

//dim i as integer 'end DO loop when i=100//

//do while i<100//

//i=i+1//

//@W_HDW0=i//

//loop//

**Result: **HDW0=100

== **End** ==

**Function**

Terminates the script immediately.

**Description**

End the execution of script.

**Parameters**

**Statement:** Judging condition, use with IF together. end script when meet condition.

**Example**

//If a = 10 Then End 'end script when a=10.//

1662

1663

**Result:** End the script program.

== **Exp** ==

**Function**

A1=Exp(A2)

**Description**

Returns the power value of e (natural logarithm), save the outputting result to A1, e=2.71828182846.

**Parameters**

**A1: **the goal date: the power floating value of returning, need to begin with '@'([[(% class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" %)__e.g.@W_HDW10__>>path:mailto:'@'(e.g.@W_HDW10]](%%));

1678

1679

**A2: **Source data, natural exponential function, need to be integer or variable. Could not not begin with the address of "@"(e.g.@W_HDW10)

**Example**

//dim a as integer'define a as integer//

1684

1685

//a = @W_HDW2 ' assign the value of (HDW2) to variable a//

1686

1687

//@W_HDW0= Exp(a)'exponential is the value of (HDW2),save result to(HDW0)//

**Result:** HDW2=2,

HDW0=7.38905600

== **F2D** ==

**Function**

F2D (A1, A2)

**Description**

Convert a 32 bit floating to integer format, then output the result.

**Parameters**

**A1: **Destination, the value can be an address(e.g.@W_HDW12).

1706

1707

**A2: **source date, it can be an address or other variable.

**Example**

//F2D(@W_HDW12,@W_HDW10) 'convert the floating of (HDW10) to integer, save in (HDW12).//

**Result:**

HDW10=200,

HDW12=200

== **F2S** ==

**Function**

F2S (A1,A2,s1)

**Description**

Output a format of floating that in the type of string.

**Parameters**

**A1:** Source address, used to store floating, the value is an address(e.g.@W_HDW200);

1732

1733

**A2:** Destination address, used to store string after converted, value is an address(e.g.@W_HDW100).

1734

1735

**S1:** the format of displaying goal data. such as the format of 03.03f,f, used for outputting a single-precision in the form of decimal.m.nf:means m column and n decimals when outputting.

**Example**

//F2S("@W_HDW200", "@W_HDW100", "03.03f") '(HDW200) is floating input,(HDW100) is text output;//

1740

1741

**Result: **HDW200=1.22365,

HDW100=1.224

== **FileCmpDir** ==

**Function**

FileCmpDir(A1, A2, A3, A4, A5, A6, A7, A8, A9)

**Description**

The filename input and the filename in the folder whether is duplicate or not.

**Parameters**

A1: file path (value is integer);

In HMI:

~=0: Recipe folder in HMI flash;

1762

1763

~=1: Custom folder in UDisk (USB flash disk);

1764

1765

~=2: Custom folder in SD card.

1766

1767

~=3: Custom folder in HMI flash;

In simulator:

~= 0: D:/Recipe/

~= 1: C:/WECON/CustomFileDir/

1774

1775

~= 2: C:/WECON/CustomFileDir/

1776

1777

~= 3: C:/WECON/CustomFileDir/

1778

1779

**✎Note:** A1 can be an address,variable or fixed value.

1780

1781

A2: file name (value is string);

1782

1783

The file name would be compared;

1784

1785

**✎Note: **A2 can be an address, variable or string. The length of file name cannot exceed 32 characters.

1786

1787

A3: folder name (value is integer);

1788

1789

The folder name would be compared;

1790

1791

**✎Note: **A3 can be an address, variable or string. The length of file name cannot exceed 32 characters.

1792

1793

A4:file name display address (value is a string);

1794

1795

Display the specified number of file names in the specified folder.

1796

1797

**✎Note:** Can only use address here. And the length of the file name cannot exceed 32 characters.

1798

1799

A5: Function type (value is an integer)

1800

1801

~= 0: compare whether the file name in the folder and the file name input are duplicated or not.

1802

1803

~= 1: return list of file names.

1804

1805

~= 100: compare file names, without input suffix .csv

1806

1807

**✎Note: **A5 can be an address, variable or value.

1808

1809

A6: Return value (value is an integer)

1810

1811

~= 1: Successfully opened the folder.

1812

1813

~= 2: Failed to open the folder.

1814

1815

~= 3: The file has duplicate names

1816

1817

**✎Note:** A6 must be an address.

1818

1819

A7: File number (value is an integer)

1820

1821

Display the number of files in the folder (up to 100)

1822

1823

**✎Note: **A7 must be an address.

1824

1825

A8: File creation time (value is a string);

1826

1827

Display the time of file creation, time occupies 32 characters

1828

1829

A9: The maximum number of files to read (value is an integer)

1830

1831

Set the maximum number of files to read (up to 100 files)

1832

1833

**✎Note:** A9 can be an address, variable or value.

**Example**

1) Read the specified number of files in the folder.

1838

1839

FileCmpDir(@W_HDW1254, @W_HDW50, "File", "", 0, "@W_HDW0", "", "", 10)'Determine whether there is a file with the same name as @W_HDW50 in the file directory of HDW1254.@W_HDW0=3 is Yes.@W_HDW0 = 1 is No.@W_HDW0=2 is comparison failed.

1840

1841

2) Compare filename input and the filename in the folder whether is duplicate or not.

1842

1843

FileCmpDir(@W_HDW1254, "", "File", "@W_HDW200", 1, "@W_HDW0", "@W_HDW300", "@W_HDW400", 10)’The file name under the directory File in the flash is written to the continuous address begin from @W_HDW200, the file creation time is written to the continuous address begin from @W_HDW400, the number of files is written to the address @W_HDW300, the maximum number of files is 10

1844

1845

3) Compare the csv file name in the folder and the csv file name input whether is duplicated or not.

1846

1847

FileCmpDir(@W_HDW1254, @W_HDW50, "File", "", 100, "@W_HDW0", "", "", 10)' Judge whether there is a file in the directory File in the flash is same with following: @W_HDW50, @W_HDW50.csv, @ W_HDW50.CSV , @W_HDW0=3 is Yes, @W_HDW0 = 1 is No ,@W_HDW0=2 is comparison failed

== **FILL** ==

**Function**

FILL (A1, A2, A3)

**Description**

Write the same value to designated address constantly.

**Parameters**

**A1:** The beginning address, it can be an address (e.g.@ W_ HDW25);

1862

1863

**A2:** Source data, it needs to be written in continuous value, the value can be an address, variable or constant;

1864

1865

**A3:** The number of operation, writing address number, it can be an address, variable or constant;

1866

1867

When the PLC (external device) address is used in this function, the length range is 1-2048, and only the 2048th address can be operated when the range is exceeded.

1868

1869

When the HMI internal address is used in this function, the length range is 1-4096. If the function is out of range, then the function is invalid.

**Example**

//FILL (@W_HDW25, 10, 3) 'At the beginning three address of @W_ HDW25 is 10.//

1874

1875

**Result: **At the beginning three address of @W_ HDW25 is 10, @W_ HDW25=10, @W_ HDW26=10, @W_ HDW27=10.

== **Float2D** ==

**Function**

Float2D (A1,A2);

**Description**

Copy floating value to the address.

**Parameters**

**A1: **Goal address, the value need to be address (e.g.@W_HDW102);

1890

1891

**A2:** Source data, it can be floating;

**Example**

//dim f as floating 'define f as floating//

1896

1897

//f=1.1 'assign a designated value to f//

1898

1899

//Float2D ("@W_HDW102",f) 'assign the value f to HDW102//

1900

1901

**Result:** HDW102=1.1

1902

1903

== **For. to. step. next** ==

**Function**

For counter = start to end Step

[Statements]

**Description**

Execute a command repeatedly for designated times.

**Parameters**

**counter: **Work as a variable for loop counter;

1920

1921

**start: **The start value of counter, it could be any variable type or expression;

1922

1923

**end: **The end value of counter, it could be any variable type or expression;

1924

1925

**step: **Every loop, the changed value of counter is step value, step default if it is not designation.

1926

1927

step default as below

1928

1929

if start>end, step default is 1;

1930

1931

if start< end. It could be any variable type or expression;

1932

1933

**statements: **Between For with Next, execute instruction set of designated times;

1934

1935

Set a loop of for...Next in another loop, it can nest call the loop of for...Next. Different from a while, for only search once value from end. Empty for loop will be ignored, and could not delay time.

**Example**

//'Use HDX2.0 to trigger the loop//

1940

1941

//for i=100 to 0 step -5 ' set the start is 100,end is 0,subtract 5 every time, execute 20 times totally.//

1942

1943

//@W_HDW100=@W_HDW100+1 ' execute (HDW100+1) 21 times totally, the final result is 21.//

//Next//

//@B_HDX2.0=0//

**Result: **HDW100=21

== **Function** ==

**Function**

Function name (arglist)

statements

name = expression

statements

End Function

**Description**

Unlike internal function, it needs to declare the name, parameter, code of the function.

**Parameters**

**Name: **function name.

1972

1973

**arglist: **stands for the variable list of parameter, this parameter will be entered during calling function. use comma to separate.

1974

1975

**statements:**a set of code in running function body.

1976

1977

**Notice: **it could not define a function program at any other program body. Write name first and then follow with parameter list, when calling function. Declare function need to before be calling. in the internal function body, it could be assigned to a function name from returned value at any place. Return value is 0 if not assign function name. Functions can recursive, but it may lead to stack overflow.

**Example**

//Function sincos (angle as floating)//

1982

1983

//sincos = sin(angle) + cos(angle)//

//End Function<//

//........//

//@W_0002 = sincos(pi/2)//

//........//

== **GetServerDelayInfo** ==

**Function**

A3=GetSerVerDelayInfo(A1,A2)

**Description**

Convert string A1 to hexadecimal number.

**Parameters**

**A1:** The starting address, save the delay data of each server (10 consecutive addresses, the last 7 addresses are reserved), when the server testing fails, the value in the corresponding address is -1. The unit is ms (signed decimal number).

2006

2007

(% class="table-bordered" %)

2008

|**Address**|**Description**

2009

|A1|Delay data of the server configured in [Project Settings]

2010

|A1+1|Delay data of Server 1

2011

|A1+2|Delay data of Server 2

2012

2013

**A2: **Server test result address

2014

2015

(% class="table-bordered" %)

2016

|(% style="width:239px" %)**Address**|(% style="width:1250px" %)**Description**

2017

|(% style="width:239px" %)0 bit|(% style="width:1250px" %)Set ON, Server configured in [Project Settings] fails

2018

|(% style="width:239px" %)1^^st^^bit|(% style="width:1250px" %)Set ON, Server 1 fails

2019

|(% style="width:239px" %)2^^nd^^bit|(% style="width:1250px" %)Set ON, Server 2 fails

2020

|(% style="width:239px" %)3^^rd^^~~ 10^^th^^bits|(% style="width:1250px" %)Reserved

2021

|(% style="width:239px" %)11^^th^^bit|(% style="width:1250px" %)Set ON, network error, network port interface failure

2022

2023

**A3:**Returns the preferred server number or network status (automatically selects the server with the best connection network status).

2024

2025

~=0: Server configured in [Project Settings];

~=1: Server 1;

~=2: Server 2;

~=3~~10: Reserved;

~=100: Try again later (two test intervals need to wait 30 seconds);

2034

2035

~=101: Failed to test Server;

**Example**

//@W_HDW200 = GetServerDelayInfo("@W_HDW100", "@W_HDW50")//

Result:

HDW100: Delay data of the server configured in [Project Settings]

2044

2045

HDW101: Delay data of Server 1

2046

2047

HDW102: Delay data of Server 2

2048

2049

HDX50.0=1:Server configured in [Project Settings] fails

2050

2051

HDX50.1=1: Server 1 fails

2052

2053

HDX50.2=1:Server 2 fails;

2054

2055

HDX50.11= 1: network error, network port interface failure;

2056

2057

When the server signal is stable, the optimal server is automatically connected according to the network status @W_HDW200. When the server connection is abnormal, @W_HDW200=101, the server test fails or the test is abnormal.

**✎Note:**

The time interval between executions of this function could not be less than 30 seconds, otherwise an error will occur.

== **Goto** ==

**Function**

Goto label

**Description**

Go to the designated row without any condition in a function body.

**Parameters**

**Label:** target character, start with letter in row label, end with(:)of any string.row label has no sensitive to the format of letter.

**Example**

//Goto sd 'go to the row which start with "sd";//

2080

2081

**Result:** Go to sd row.

**✎Note:**

Goto only can jump into the internal function that visible row.

== **H2A** ==

**Function**

A1 = H2A (A2)

**Description**

Convert a binary (16-bit) to hexadecimals (4-bit) of ASCII.

**Parameters**

**A1: **Returned value, string, it could be an address or variable.

2100

2101

**A2: **Binary is needed to be converted, the value could be a address or variable.

**Example**

//@W_HDW100= H2A (@W_HDW0) ' convert the binary of (HDW0) to character and save in (HDW100).//

2106

2107

**Result:** HDW0=200,

HDW=100

== **HmiRegoperator** ==

**Function**

HmiRegoperator (A1,A2,A3,A4,A5,A6)

**Description**

Data of Upload/ Download address

**Parameters**

**A1: **The start address of target

2124

2125

**A2: **Length, address length, unit: word, range: 1~~1000

**A3: s**torage

A3=0, select USB flash disk as storage, and save files in Root directory;

2130

2131

A3=1, select SD card as storage, and save files in Root directory;

2132

2133

**A4: **File name address, itneed to be address such as"@ W_HDW2"

2134

2135

**A5**: Upload / download data

2136

2137

A5=0, save the data in the specified address as a file and store the file in the root directory;

2138

2139

A5=1, Read data from file and it woule be written into specified address;

2140

2141

**A6:** State display, it needs to be address, such as "@ W_HDW2";

A6=1, Normal

A6=2, USB flash disk/ SD card does not exist

2146

2147

A6=3, File doesn’t exist;

2148

2149

A6=4, File name error;

A6=5, Check error

A6=6, Abnormal communication;

2154

2155

A6=7, HUW register is not allowed;

2156

2157

A6=8, Address length range error (address length range: 1-1000);

**Example**

Script 1

//HmiRegoperator("@W_HDW0",10,0,"@W_HDW2000",0,"@W_HDW3000")’The data in HDW0-HDW10 is saved as a file, the file name is set by HDW2000 and stored in a USB flash disk.//

Script 2

//HmiRegoperator("@W_HDW0",10,1,"@W_HDW2000",1,"@W_HDW3000")//

2168

2169

//Read the values from files which stored in the SD card (files named by the HDW2000), and write these values to the HDW0-HDW10.//

**✎Note:**

* The length of the file name is less than 32 characters, and the file name consists of numbers and letters (the file name does not meet this standard; WECON does not guarantee the accuracy of the data).

2174

* The interval of download function operation should be 5s or more.

2175

* A1 need to be address such as “@W_HDW2”.

2176

* Please use “Character Input/Display” object for it, and the file name consists of numbers and letters, could not be punctuated characters, maximum character length 32 allowed.

== **Hypot** ==

**Function**

Var = Hypot (expr1, expr2)

**Description**

Calculate the value of the hypotenuse of a right triangle.

**Parameters**

**expr1, expr2: **Source data, the two sides of right triangle. it need to be address;

2191

2192

**Var:** Destination data,it need to be address;

**Example**

//@W_HDW200=Hypot (@W_HDW105,@W_HDW108) ' input the value of right-angle side at (HDW105) and (HDW108),and assign the result of the hypotenuse to (HDW200).//

2197

2198

**Result: **HDW105=3,

HDW108=4,

HDW200=5

**✎Note:**

hypot function could support integer and floating when the format of source data and target data are the same.

2207

2208

== **IF ... THEN ... ELSE ... END IF** ==

**Function**

If condition Then

Statements

[Else

else statements]

End If

**Description**

Conditional judgments instruction. When the [Condition] defined by [IF] is TURN, the operation following [THEN] is performed. When [Condition] is FALSE, the operation after [ELSE] is executed.

**Parameters**

**condition: **any expression, the value could be true or false.

2229

2230

**statement: **execute the instruction block when condition is true.

2231

2232

**else statement: **execute the instruction block when condition is false.

**Example**

//if @W_HDW105=200 then ' judging condition: whether the value of (HDW105) is 200//

2237

2238

//@W_HDW108=1 'the value of (HDW108) is 1 if fulfil condition//

//else//

//@W_HDW200=1 ' the value of (HDW200) is 1 if not fulfil condition.//

//Endif//

**Result:**

HDW105=199;

HDW108=0;

HDW200=1

== **InStr** ==

**Function**

var = InStr ("str1", "str2")

**Description**

Returned the position of str1 in str2(start with 0), set -1 if no result.

**Parameters**

**str1:** source string, it could only be string, not address;

2267

2268

**str2:** target string, it could only be string, not address;

2269

2270

**var:** Returned value, the format of data needs to be string;

**Example**

//dim a as floating//

2275

2276

//a = InStr ("Hello", "o") ' calculate the position of"o"in"hello".//

2277

2278

//float2d ("@W_HDW0",a) ' Returned value is 4.(start with 0)//

**Result:** HDW0=4

== **Int2D** ==

**Function**

Int2D("A1",A2)

**Description**

Write the 32-bit integer into the target address

**Parameters**

**A1: **Source data could only be the HMI internal or external register starting with "@".

2295

2296

**A2:** Target data could only use the integer variable defined by script.

**Example**

//dim var1 as integer 'define var1 as integer//

2301

2302

//Int2D("@W_HDW0", var1) 'Read out the 32-bit integer in var1 and save the result in HDW0 .//

//var1=9999999,//

**Result:** HDW0=9999999.

== **InvB** ==

**Function**

InvB (A1)

**Description**

The state of inverse bit, it is a sub function, no returned value. Achieve the state of switching address constantly.

**Parameters**

**A1:** it is an address.

**Example**

//InvB (@B_HDX0.1) 'switch the state if (HDX0.1).//

2325

2326

**Result: **Switch the state of (HDX0.1) constantly.

== **IsFloating** ==

**Function**

A2=IsFloating (A1)

**Description**

Decide whether a parameter is floating, return true if it is floating, otherwise return FALSE.

**Parameter**

**A1:** source data, variable;

2341

2342

**A2:** target data, variable;

**Example**

//dim a as integer//

//dim b as floating//

2349

2350

//b= D2float ("@W_HDW200",b) 'assign the value of (HDW200) to b//

2351

2352

//a = IsFloating (b) 'judge whether b is floating or not//

2353

2354

//@W_HDW300=a 'save the result to (HDW300)//

**Result: **HDW300=1

== **IsInteger** ==

**Function**

A2= IsInteger (A1)

**Description**

Determine whether a parameter(A1) is integer, return TRUE if the parameter is integer, otherwise return FALSE.

**Parameter**

**A1:** Source date, it is variable or number;

2371

2372

**A2:** Target date, need to be variable, it could not be system address ;

**Example**

//dim a as integer//

//a = IsInteger (20) 'determine whether 20 is integer//

2379

2380

//@W_HDW300=a ' display the result on (HDW300)//

**Result:** HDW300=1

== **IsString** ==

**Function**

val = IsString(expr)

**Description**

Determine whether a parameter is string, return TRUE if it is string, otherwise return FALSE.

**Parameters**

**Expr:** source string, it could be a variable or string, not address;

2397

2398

**Val:** target date, the result need to be variable, could not be address;

**Example**

//dim a as integer 'define variable, display the result;//

2403

2404

//a= isstring ("hello") 'determine whether"hello"is string;//

2405

2406

//@W_HDW0=a 'assign the result to (HDW0)//

**Result: **HDW=1

== **Lcase** ==

**Function**

A2 = LCase(A1)

**Description**

Convert all parameters to lowercase strings.

**Parameters**

**A1: **source string, it could be an address or variable;

2423

2424

**A2: **outputting string, it could be an address or variable;

**Example**

//@W_HDW33 = LCase (@W_HDW25) 'input source sting on (HDW25), convert it to destination string and display the result on (HDW33);//

2429

2430

**Result:** HDW25=HELLO

HDW33=hello

== **Left** ==

**Function**

Val =Left (String, Length)

**Description**

Return a string of the specified length from the left side of parameter.

**Parameters**

**String:** source string; it could be an address or string.

2447

2448

**Length: **return the number of character. It could be an address, integer or variable. Return empty string if length<1. return the whole string if length not less than the character number of string.

2449

2450

**Val: **destination string, outputting string, it could be an address or variable.

**Example**

//@W_HDW30=Left (@W_HDW36, @W_HDW40) '(HDW36) used to input source string,(HDW30) used to display the string result;//

Result: HDW36=hello,

HDW40=2,

HDW30=he

== **Len** ==

**Function**

Length=Len(String)

**Description**

Return the string length.

**Parameters**

**String:** source string, it could be a address or string;

2475

2476

**Length:** target data, return value, it could be a address, variable, integer or floating;

**Example**

//@W_HDW30=Len (@W_HDW36) 'count the character number of (HDW36), save the result to (HDW30);//

2481

2482

**Result:** HDW36=hello

HDW30=5

== **Log** ==

**Function**

a= Logn (x)=Log(x)/Log(n)

**Description**

Log function:return the natural logarithm of the value.

**Parameters**

**a: **source date,it could be a variable, but it could not be address;

2499

2500

**x, n:** source date, it could be a variable, but it could not be address;

**Example**

//Dim a as integer 'define a as integer;//

2505

2506

//Dim b as integer 'define b as integer;//

2507

2508

//Dim c as integer 'define c as integer;//

2509

2510

//b=@W_HDW10 'assigns a value to b//

2511

2512

//c=@W_HDW20 'assigns a value to c//

2513

2514

//a=Log (b)/Log(c) 'calculate logarithm//

//@W_HDW0//

//=a 'assign the result to (HDW0)//

2519

2520

**Result:** HDW10=27,

HDW20=3,

HDW0=3

== **Log10** ==

**Function**

a=Log10(x)= Log(x) / Log(10)

**Description**

Log function: return the natural logarithm.

**Parameters**

**A:** target data, result could be variable, could not be address;

2539

2540

**x:** source data, it could be variable that needs to be the multiples of 10, can’t be address

**Example**

//dim a as integer 'define a as integer//

2545

2546

//dim b as integer 'define b as integer//

2547

2548

//b=@W_HDW10 'assign a value to b//

2549

2550

//a= Log (b)/Log(10) 'result//

2551

2552

//@W_HDW0=a 'assign the result to (HDW0)//

2553

2554

**Result: **HDW10=100,

HDW0=2

== **LTrim** ==

**Function**

val=LTrim("string")

**Description**

Remove the left empty part of the string and return.

**Parameters**

**Val:** Destination string, it could be either a variable or address;

2571

2572

**string:** Source string, it could be either a variable or address;

**Example**

//dim a as string//

//a=Ltrim("hello")//

//@W_HDW103=a//

**Result:** HDW103=hello

== **MAX** ==

**Function**

A1=MAX(A2,A3)

**Description**

Compare the value of A2 and A3, assign the greater value to A1.

**Parameters**

**A1:** Return value (used to store the greater value between A2 with A3).

2597

2598

**A2:** The first comparison value.

2599

2600

**A3:** The second comparison value.

**✎Note:**

A1,A2,A3 should be only used in unsigned integer or unsigned address.

**Example**

//DIM A1 as integer//

2609

2610

//@W_HDW106=10 'assign the value to (@W_HDW106), unsigned decimal word.//

2611

2612

//@W_HDW107=5 'assign the value to (?@W_HDW107),unsigned decimal word.//

2613

2614

//A1 = Max(@W_HDW106,@W_HDW107)//

//@W_HDW105 = A1//

**Result: **@W_HDW105 = 10

**Mid**

**Function**

A1=mid(A2, start, length)

**Description**

Returns a string contain a specified characters length from a string.

**Parameters**

**A1:** string contains the selected characters, it needs to be a string

2633

2634

**A2:** string to be selected, it needs to be a variable or address

2635

2636

**Start:** the start position of string, it needs to be a variable or address, it means that count begin with 0.

2637

2638

**Length:** the designated length of string, maximum character length 127 allowed

**Example**

//DIM A1 as string//

//A1 = Mid("hellokitty",1,2) 'select the string of in "//

//@W_HDW106=A1//

**Result: **@W_HDW106 'display "el" on text input and output window

== **MIN** ==

**Function**

A1=MIN(A2,A3)

**Description**

Compare the value of A2 and A3, assign the smaller value to A1.

**Parameters**

**A1: **Return value (used to store the snaker value between A2 with A3).

2663

2664

**A2: **The first comparison value.

2665

2666

**A3: **The second comparison value.

**Example**

//DIM A1 as integer//

2671

2672

//@W_HDW106=10 'assign the value to (@W_HDW106), unsigned decimal word.//

2673

2674

//@W_HDW107=5 'assign the value to (@W_HDW107), unsigned decimal word.//

2675

2676

//A1 = Min(@W_HDW106,@W_HDW107)//

//@W_HDW105 = A1//

**Result:** @W_HDW105 = 5

**✎Note:**

A1, A2,A3 only used in unsigned integer or unsigned address.

== **MSeconds** ==

**Function**

A1=MSeconds( )

**Description**

A1 is used to display the current milliseconds of system.

**Parameters**

**A1: **used to store the current milliseconds of system.

**Example**

//DIM A1 as integer//

2703

2704

//@W_HDW0= 10 'assign a value to (@W_HDW0), unsigned decimal word//

2705

2706

//A1=MSeconds() 'return the current milliseconds of system to A1//

//@W_HDW0=A1//

//@W_HDW1=A1>>16 'display milliseconds on screen, (HDW0) is an 32-bit unsigned decimal integer address//

2711

2712

**Result:** @W_HDW0 will generate the time value of changing milliseconds unit.

**✎Note:**

A1 is 32-bit unsigned integer variable or unsigned integer address;

2717

2718

MSeconds() function rolls back over to zero once the maximum value has been reached (4294967295->0, 1,2,....4294967295->0, 1, 2,....4294967295->0, 1, 2);

2719

2720

== **MyDeleteFile** ==

**Function**

MyDeleteFile (A1,A2,A3,A4,A5)

**Description**

Delete the specified file

**Parameters**

A1: File location (value is an integer);

In HMI:

~=0: Recipe folder in HMI flash;

2737

2738

~=1: Custom folder in UDisk (USB flash disk);

2739

2740

~= 2: Custom folder in SD card.

2741

2742

~=3: Custom folder in HMI flash;

In simulator:

~= 0: D:/Recipe/

~= 1: C:/WECON/CustomFileDir/

2749

2750

~= 2: C:/WECON/CustomFileDir/

2751

2752

~= 3: C:/WECON/CustomFileDir/

2753

2754

**✎Note:** A1 can be an address, variable or value.

2755

2756

A2: filename (value is string);

2757

2758

Input the name of the file want to delete.

2759

2760

**✎Note: **A2 can be an address , variable or a character string, and the length of the file name cannot exceed 32 characters.

2761

2762

A3: folder name (value is integer);

2763

2764

Input the folder where the file want to delete.

2765

2766

**✎Note: **A3 can be an address , variable or a character string, and the length of the folder name cannot exceed 32 characters.

2767

2768

A4: Delete function type (value is integer)

2769

2770

~= 0: Delete the specified file.

2771

2772

~= 1: Delete all files.

2773

2774

**✎Note: **A4 can be an address , variable or value.

2775

2776

A5: Return value (value is an integer)

2777

2778

~= 0: parameter error

2779

2780

~= 1: Delete successfully

~= 2: Delete failed

~= 3: Failed to open file

2785

2786

**✎Note:** A5 must be an address.

**Example**

MyDeleteFile(@W_HDW1254,@W_HDW4200,@W_HDW4300,@W_HDW1250,"@W_HDW1252")

2791

2792

‘According to the value of @W_HDW1250, delete the designated file @W_HDW4200 in the folder @W_HDW4300 or delete all files in the folder @W_HDW4300.

== **NewNoAddr** ==

**Function**

A1= NewNoAddr (A2, length)

**Description**

At the basic of source address A2, offset designated length, obtain a new address A1.

**Parameters**

**A1: **address after offsetting, it must be String type variable.

2807

2808

**A2:** source address, it must be an address(e.g.:"@W_HDW2")

2809

2810

**Length: **offset length, it must be a constant or an integer variable.

**Example**

//DIM A1 as string//

//A1=NewNoAddr("@W_HDW0",50) '(HDW0) offsets 50 words address (16 bit), and save the result to A1//

2817

2818

//@W_HDW1=A1 '(HDW50) save in A1//

2819

2820

**Result: **(@W_HDW1) character input/display will show @W_HDW50

2821

2822

== **NewStatAddr** ==

**Function**

A1= NewStatAddr (A2, length)

**Description**

At the basic of source address A2, offset the designated length, to obtain a new station A1.

**Parameters**

**A1: **The address after offsetting, it needs to be variable.

2835

2836

**A2:** Source station address, it needs to be address (e.g.:"@W_1:10").

2837

2838

**Length: **offset length

**Example**

//DIM A1 as string//

//A1=NewStatAddr("@W_1:10",2) 'address 10 of station address 1 that offset 2 station addresses, then save the result to A1//

2845

2846

//@W_HDW1=A1 'address 3:10 is saved in A1//

2847

2848

**Result: **@W_HDW1 character input/display will show @W_3:10

2849

2850

== **NStringCompare** ==

**Function**

A1= NStringCompare (A2, A3, length)

**Description**

Compare whether the designated length of two strings is the same, return 1 to A1 if yes, otherwise return 0.

**Parameters**

**A1: **Returned value (compare the designated length of two strings, display 1 when equal, else 0). It could be an address or variable.

2863

2864

**A2: **the address of string to be compared, it needs to be address.

2865

2866

**A3: **source string, it needs to be variable or constant string.

2867

2868

**Length: **string length to be compared

**Example**

//@W_HDW1= NStringCompare("@W_HDW0","87654",5)//

2873

2874

//if @W_HDW1=1 then//

2875

2876

//@B_HDX10.0=1 'result: HDX10.0 set ON 'when the two strings are the same.//

//endif//

//if @W_HDW1=0 then//

2881

2882

//@B_HDX10.0=0 'result:HDX10.0 set OFF 'when not equal.//

//Endif//

== **Operator** ==

(% class="table-bordered" %)

2889

|**Operation**|**Symbol**|**Example**|**Return type**

2890

|Addition|+|A1=A2+A3|Return type depending on the type of variable or address of the addition

2891

|Subtraction|-|A1=A2-A3|Return type depending on the type of variable or address of the subtraction

2892

|Multiplication|*|A1=A2*A3|Return type depending on the type of variable or address of the multiplication

2893

|Division|/|A1=A2/A3|Return type depending on the type of variable or address of the division

2894

|Remainder|Mod ~(%)|(((

A1=A2 mod A3

A1=A2%A3

)))|Returns the remainder of the division of two numbers. The type of the return value is an integer

2899

|Logical OR|Or(~|)|(((

A1=A2 or A3

A1=A2|A3

)))|Returns the result of a logical OR. The type of the return value is an integer.

2904

|Logic AND|And (&)|(((

A1=A2 and A3

A1=A2&A3

)))|Returns the result of a logical AND. The type of the return value is an integer.

2909

|Logical XOR|Xor (^)|(((

A1=A2 xor A3

A1=A2^A3

)))|Returns the result of a logical XOR. The type of the return value is an integer.

2914

|Logical reversal|Not (!)|(((

A1=not A1

A1=A2!A3

)))|Returns the result of a logical reversal. The type of the return value is an integer.

2919

|Left shift|<<|A1=A2<<A3|Shift the value of A2 to the left by A3 digits and return the displacement result. The type of the return value is an integer.

2920

|Right shift|>>|A1=A2>>A3|Shift the value of A2 to the right by A3 digits and return the displacement result. The type of the return value is an integer.

2921

|Bit reversal|~~|A1=~~A1|Perform a bit reversal on a value. The type of the return value is an integer.

2922

2923

== **PI_GetTickCount** ==

**Function**

PI_GetTickCount (A1, A2)

**Description**

Writethe startingtime tothe set address asa 32-bit integer.

**Parameters**

**A1: **Source data could only be the HMI internal or external register starting with "@".

2936

2937

**A2: **=0: Unit of time for returning 0ms;(the value will become 0 after 49.7 days and so on)

2938

2939

~=1: Unit of time for returning 10 ms;(the value will become 0 after 497 days and so on)

2940

2941

~=2: Unit of time for returning 100 ms;(the value will become 0 after 4970 days and so on)

2942

2943

~=3: Unit of time for returning 1000ms;(the value will become 0 after 49700 days and so on)

2944

2945

**✎Note: **If user restarts the hmi,all value will be 0.

**Example**

//PI_GetTickCount("@W_HDW100",0)'save the starting time in HDW100 address as a 32-bit integer.//

2950

2951

**Result: **HDW100=123456(different returned data for each moment)

== **Power** ==

**Function**

var = power (expr1, expr2)

**Description**

The value of [expr2] to the power of [expr1] will be assigned to Var.

**Parameters**

**var:** returned value.

2966

2967

**expr 1:** base number.

2968

2969

**expr 2:** power number.

**Example**

//Dim a as floating//

2974

2975

//a=power (2, 3) 'the value of 3 to the power of 2 is assigned to a.//

2976

2977

//Float2D("@W_HDW10",a) 'assign the float value of a to @W_HDW10//

2978

2979

**Result: **@W_HDW10=8

== **PrintText** ==

**Function**

PrintText(A)

**Description**

Print the content of A or locates in A.

**Parameters**

**A:** source data. A could be a variable or a string ( text information),not a register address.

**Example**

* A is text information

2998

2999

//PrintText("HMI 8070”)//

3000

3001

**Result: **Printer will print out “HMI 8070”

* A is variable

//Dim a as string//

//a= “HMI 8070”//

//PrintText(a)//

**Result:** Printer will print out “HMI 8070”

**✎Note:**

source data length range:1-128 characters.

== **RadToDeg** ==

**Function**

Var= RadToDeg(expr)

**Description**

Convert radiant value to degree, then assigned to Var.

**Parameters**

**Var:** return degree value.

3030

3031

**expr:** input radiant value.

**Example**

//Dim a as floating//

3036

3037

//a = RadToDeg(pi) 'assignt the degree value of ? to a.//

3038

3039

//Float2D("@W_HDW4",a) 'assign the degree value to address "@W_HDW4".//

3040

3041

**Result:** @W_HDW4=180

== **RAND** ==

**Function**

Var = rand(expr1)

**Description**

Generate a random number.

**Parameter**

**Var:** generated random number.

3056

3057

**Expr1:** the base number.

**Example**

//@W_HDW0=rand(@W_HDW0) 'Set the value of address@W_HDW0 as the base number to generate random number.//

3062

3063

**Result:** @W_HDW0 random number.

== **ReadAddr** ==

**Function**

Word = ReadAddr(A1)

**Description**

Assigned the red value from A1 to word.

**Parameter**

**Word: **return value

**Example**

//Dim word as integer//

//@W_HDW100=10//

//word = ReadAddr("@W_HDW100") 'Read the value of address @W_HDW100 and assign to word.//

//@W_HDW200=word//

**Result:** @W_HDW200=10

3090

3091

== **ReadWordFormFile** ==

**Function**

ReadWordFormFile (A1, A2, A3, A4, A5, A6)

**Description**

Read data of specified length from specified file

**Parameters**

A1: File location (value is an integer);

In HMI:

~=0: Recipe folder in HMI flash;

3108

3109

~=1: Custom folder in UDisk (USB flash disk);

3110

3111

~= 2: Custom folder in SD card.

3112

3113

~=3: Custom folder in HMI flash;

In simulator:

~= 0: D:/Recipe/

~= 1: C:/WECON/CustomFileDir/

3120

3121

~= 2: C:/WECON/CustomFileDir/

3122

3123

~= 3: C:/WECON/CustomFileDir/

3124

3125

**✎Note:** A1 can be an address, variable or value.

3126

3127

A2: File name (value is a string);

3128

3129

Input the file name want to write.

3130

3131

**✎Note: **A2 must be an address, and the length of the file name cannot exceed 32 characters.

3132

3133

A3: Data start address (value is a string);

3134

3135

Input the data want to write

3136

3137

**✎Note: **A3 must be the address.

3138

3139

A4: Data length (value is an integer)

3140

3141

Set the length of the data to be written (unit:word)

3142

3143

**✎Note: **A4 can be an address , variable or value.

3144

3145

A5: Return value (value is an integer)

3146

3147

~= 1: Successfully read

3148

3149

~= 2: Failed to open the folder

3150

3151

~= 3: Read address error

3152

3153

~= 4: File reading error

3154

3155

**✎Note: **A5 must be an address.

3156

3157

A6: Folder name (value is a string);

3158

3159

Input the folder where to be written the file.

3160

3161

**✎Note:** A6 can be an address or a variable or a character string, and the length of the folder name cannot exceed 32 characters

**Example**

ReadWordFormFile(@W_HDW1254,"@W_HDW4200","@W_HDW2000",@W_HDW4000,"@W_HDW4100", @W_HDW4300)'Write the @W_HDW4000 words in the file @W_HDW4200 in the directory @W_HDW4300 into the address @W_HDW2000 specified location by @W_HDW1254

== **Right** ==

**Function**

val = Right (string, length)

**Description**

Return a string of the specified length from the right side of parameter.

**Parameter**

**string: **the operated string.

3180

3181

**length:** the designated number of byte required to return, count from the right side.

**Example**

//@W_HDW103= Right("Hello", 3) 'return "llo"//

3186

3187

**Result: **@W_HDW103="llo"

== **RTrim** ==

**Function**

val = RTrim(str)

**Description**

Clear the empty part on the right side of string [str], then assign the empty part to val

**Parameter**

**val: **returned value.

3202

3203

**str:** the string needs to be operated.

**Example**

//@W_HDW0 = RTrim(" -Hell o- ") 'retrun" -Hell o-"//

3208

3209

**Result:** @W_HDW0display " -Hell o-"

== **S2F** ==

**Function**

S2F (A1,A2,s1)

**Description**

S2F is used to translate the string stored in A1 to floating and store the floating number in A2 according to the data format shown in A2.

**Parameters**

**A1:** initial data address, used to store the string data, it should be the internal address of HMI or external address that started with “@”,like @W_HDW0

3224

3225

**A2:** destination address, used to store the floating number data. It should be the internal address of HMI or external address that started with “@”,like @W_HDW0

3226

3227

**S1:** display format of target data, for example m.nf, m means the length of string is m, n means the decimal places, f is the format used to output single precision number. (Since the floating point number is up to 7 digits, the decimal point in the string is also a bit, so it is recommended that the length should not exceed 8 bits)

Return value: none

**Example**

The lengTh of string is 8

3234

3235

//@W_HDW0="12345.67"//'Assign the string “12345.67" to HDW1

3236

3237

//S2F("@W_HDW0","@W_HDW100","8.2f") 'read string "12345.67 "from HDW0and convert it into a floating point with 2 decimal places, store in the HDW100 .//

3238

3239

**Result: **@W_HDW100 address displays “12345.67”.

3240

3241

The length of string is less than 8

3242

3243

//@W_HDW0="1234.5 67"‘assign the string“1234.567”to HDW1//

3244

3245

//S2F("@W_HDW0","@W_HDW100","6.2f") ' read string "1234 .5"from HDW0and convert it into a floating point with 2 decimal places, store in the HDW100 .//

3246

3247

**Result: **the floating value of @W_HDW100 is 1234.50

3248

3249

The length of string is more than 8

3250

3251

//@W_HDW0="12345.6789"’assign the string “12345.6789” to HDW1//

3252

3253

//S2F("@W_HDW0","@W_HDW100","8.2f") ' read string "12345 .67" from HDW0 and convert it into a floating point with 2 decimal places, store in the HDW100 .//

3254

3255

**Result: **the floating value of @W_HDW100 is 12345.67

== **SetB** ==

**Function**

SetB(A1)

**Description**

Set the bit A1 ON.

**Parameters**

**A1:**Bit address

**Example**

//SetB(@B_HDX100.0) 'Set the address {@B_HDX100.0} ON//

3274

3275

**Result: **@B_HDX100.0=1

== **SetKeyMap** ==

**Function**

SetKeyMap(A1,A2,A3)

**Description**

The key values of the keyboard are mapped so that multiple keyboard buttons perform the same function.

**Parameters**

**A1:** The starting address of the source key;It needs to be an address format;

3290

3291

**A2: **The starting address of the mapped value; It needs to be an address format;

3292

3293

**A3: **Mapping length (continuous length of mapped address); It needs to be a value, the maximum mapping range: 108 key values;

**Example**

//@W_HDW3000 = 3 ' The starting address of the source key//

//@W_HDW3001 = 5//

//@W_HDW3002 = 7//

//@W_HDW3003 = 9//

//@W_HDW3004 = 61//

//@W_HDW4100 = 103 'The starting address of the mapped value//

//@W_HDW4101 = 105//

//@W_HDW4102 = 106//

//@W_HDW4103 = 108//

//@W_HDW4104 = 28//

//SetKeyMap("@W_HDW3000","@W_HDW4100",5) ' Map the values of the HDW4000~~HDW4004 addresses to the HDW3000~~HDW3004 addresses.//

**Result**

Map the value of the HDW4000~~HDW4004 address (mapped to 103 105 106 108 28) to the value of the HDW3000~~HDW3004 address (source key value 3 5 7 9 61)

3322

3323

Button 2 (key value 3) is mapped to the direction key (key value is 103), button 4 (key value 5) is mapped to the left arrow key (key value is 105), and so on. When using the keyboard, the function of input 2 could be performed on both the button 2 and the direction button.

3324

3325

== **SignedInt16** ==

**Function**

val = SignedInt16(A1)

**Description**

Assign the value to {val} from address A1 which is signed integer.

**Parameters**

**A1: **contain signed integer as "@W_HDW000002"

3338

3339

**Val: **returned value

**Example**

//Dim a as integer 'Integer variable a//

3344

3345

//a = SignedInt16("@W_HDW0") 'read signed integer from HDW0 addresses and assign the value to a//

3346

3347

//@W_HDW2=a'assign the value a to HDW2//

3348

3349

**Input: **@W_HDW0=-2:

3350

3351

**Result:** @W_HDW2=-2.

3352

3353

== **SignedInt32** ==

**Function**

val = SignedInt32 (A1)

**Description**

Assign the value to {val} from address A1 which is signed even integer.

**Parameters**

**A1: **the address contains signed even integer

3366

3367

**Val:** Returned value

**Example**

//Dim a as integer 'define {a} as a integer//

3372

3373

//a = SignedInt32("@W_HDW0") 'read signed even integer from HDW0, then assign this value to a.//

3374

3375

//@W_HDW2=a 'assign the value of a to HDW2//

//@W_HDW3=a>>16//

**Input: **@W_HDW0=-2

3380

3381

**Result:** @W_HDW2=-2

@W_HDW13=-1

== **Sin** ==

**Function**

val = Sin(A1)

**Description**

Get the sine value of A1, and copy result to val.

**Parameters**

**A1: **A1 needs to be an angle.

3398

3399

**Val: **Returned value.

**Example**

//Dim a as floating 'floating variable a,b//

3404

3405

//a=sin(pi/6) 'return sinb to a//

3406

3407

//Float2D("@W_HDW13",a) 'assign the value of the floating variable a to address HDW13.//

3408

3409

**Result:** @W_HDW13=0.5

== **SleepA** ==

**Function**

SleepA(T)

**Description**

Wait time T(ms).

**Parameters**

**T:** wait time, the unit is [ms]

3424

3425

**Returned value:** none.

**Example**

//SleepA(10) 'wait 10ms//

3430

3431

**Result:** When the script runs to SleepA(10), it means the scripts would go running after waiting 10ms

== **Sqr** ==

**Function**

val = Sqr(A1)

**Description**

Assign a square root value of A1 to val.

**Parameters**

**A1: **the data need to be operated

3446

3447

**Val: **Returned value

**Example**

//@W_HDW0 = Sqr(4) 'calculate the square root of HDW0//

3452

3453

**Result:** @W_HDW0=2

3454

3455

== **StAndFtChange** ==

**Function**

StAndFtChange(A1,A2,A3)

**Description**

Calculate the number of seconds from January 1, 1970 to the current time, and also be invertible.

**Parameters**

**A1: **The start address of curren t time (Enter or output year, month, day, minute, and second); It needs to begin with address"@", and occupies 6 addresses;

3468

3469

**A2: **The number of seconds; It needs to begin with address “@", data format 32-bit unsigned.

3470

3471

**A3: **conversion method;

3472

3473

A3=0, convert time to seconds;

3474

3475

A3=1, convert seconds to time;

3476

3477

**Returned value: **none;

**Example**

Script 1

//StAndFtChange("@W_HDW10","@W_HDW20",0) // //‘use HDW10 as start address, and enter year, month, day, hour, minute, second. The script calculates the number of seconds from January 1, 1970 to the time of the entry, and stores the result in HDW20//

3484

3485

**Input: **HDW10 = 2017,HDW11 = 12, HDW12 = 9 , HDW13 = 15, HDW14 = 15, HDW15 = 0

3486

3487

**Output:** 1512832500

Script 2

//StAndFtChange("@W_HDW30","@W_HDW20",1) ‘read number of seconds from HDW20, and the script calculates the date time, and stores the result start from HDW30//

3492

3493

**Input:** 1512833760

3494

3495

**Output:** HDW30 = 2017, HDW31 = 12, HDW32 = 9, HDW33 = 15, HDW34 = 36, HDW35 = 0

== **Sub** ==

**Function**

Sub name (arglist)

statements

End Sub

**Description**

Declare the name, parameters and codes of the Sub (sub function)

**Parameters**

**Name: **naming rules refer to variable.

3514

3515

**Arglist: **variable list.

3516

3517

**Statements:** the code set of the sub function.

**Example**

//sub samesub(a,b as integer) ' samesub and integer variable a,b//

//c=a+b//

//@W_HDW0=c//

//endsub//

//samesub(1,12) 'call function samesub//

3530

3531

**Result:** @W_HDW0=13

== **SWAP** ==

**Function**

SWAP(A1,length)

**Description**

Swap the big-endian with the little-endian from address A1, swap length is adjustable.

**Parameters**

**A1: **the swapped high endian, need to be an address as HDW_000002.

3546

3547

**Length: **swap length.

3548

3549

**Returned value:** None.

**Example**

//@W_HDW103=0x1234 'assign value to HDW103//

3554

3555

//@W_HDW104=0x2345 'assign value to HDW104//

3556

3557

//@W_HDW105=0x2565 'assign value to HDW105//

3558

3559

//@W_HDW106=0x2675 'assign value to HDW106//

3560

3561

//SWAP(@W_HDW103,4) 'swap the high and low endian for the 4 adjacent addresses start with HDW103.//

**Result:**

@W_HDW103=0x3412

@W_HDW104=0x4523

@W_HDW105=0x6525

@W_HDW106=0x7526

== **Tan** ==

**Function**

val = Tan(A1)

**Description**

Get the returned tagent value of A1, and then assign to val.

**Parameters**

**A1: **A1 needs to be an angle.

3586

3587

**Val: **Returned value.

**Example**

//Dim a as floating 'define a floating variable a//

3592

3593

//a=TAN(pi/3) 'calculate the tangent value of pi/3 and assign to a//

3594

3595

//Float2D("@W_HDW16",a) 'assign the value of a to HDW16//

3596

3597

**Result:** @W_HDW13=1.732

== **Trim** ==

**Function**

val = Trim(A1)

**Description**

Return A string in A1 without empty string next to it.

**Parameters**

**A1: **The operated string

3612

3613

**val: **Returned value

**Example**

//@W_HDW1=Trim(" ab ")//

3618

3619

**Result: **@W_HDW1="ab"

== **UCase** ==

**Function**

val = UCase(A1)

**Description**

Capitalize the string data, and then assign the value to val.

**Parameters**

**A1: **Operated string, address or variable.

3634

3635

**Val: **Returned value

**Example**

//@W_HDW1=ucase("abcd") 'Capitalize abcd then assign the value to HDW1//

3640

3641

**Result: **@W_HDW1="ABCD"

== **Variable** ==

**Description**

A variable is any factor, trait, or condition that could exist in differing amounts or types.

**Define variable**

Use Dim to define variable in script. The variable could be string, floating, integer.

**Example:**

//Dim a as floating ‘define variable {a} as a floating.//

3656

3657

//Dim b,c,d as integer‘define variable {b,c,d} as integer//

**Naming rules**

The first letter needs to be English letter.

No symbols.

Maximum character length 15 allowed.

== **W2B** ==

**Function**

W2B(A1, A2, A3)

**Description**

Replace the high endian of [A2]+1 with the high endian of A2.

**Parameters**

**A1:** operated address.

3680

3681

**A2:** source address.

3682

3683

**A3: **the conversion length.

3684

3685

**Returned value:** none.

**Example**

//@W_HDW0 = 4660 'assign 16bit value 1234 to HDW0.//

3690

3691

//@W_HDW1=0x5678 'assign 16bit value 5678 to HDW1.//

3692

3693

//@W_HDW2 = 0x2425 'assign 16bit value 2425 to HDW1.//

3694

3695

//@W_HDW3 = 0x3536 'assign 16bit value 3536 to HDW0.//

3696

3697

//@W_HDW4 = 0x1415 'assign 16bit value 1415 to HDW0.//

3698

3699

//W2B(@W_HDW20,@W_HDW0, @W_HDW10)//

3700

3701

//@W_HDW10=1 ‘save the high endian {34} of HDW0 to HDW20.//

3702

3703

**Result:** @W_HDW20=0x34, @W_HDW21=0, @W_HDW22=0

== **W2D** ==

**Function**

W2D(A1, A2)

**Description**

Convert the unsigned Word to unsigned Dword and save the result in A1.

**Parameters**

**A1: **operated address .

3718

3719

**A2:** source address.

Returned value.

**Example**

Unsigned decimal word

3726

3727

//@W_HDW0 = 1234 'assign 1234 to HDW0.//

3728

3729

//W2D(@W_HDW2, @W_HDW0) 'convert unsigned word {1234} from HDW0 to Dword and save in HDW2//

3730

3731

**Result:** @W_HDW0=12345, @W_HDW2=12345, @W_HDW3=0

Signed decimal word

//@W_HDW0 = -12345 'assign value to HDW0: convert {-12344} to unsigned decimal word is {53191}.//

3736

3737

//W2D(@W_HDW2, @W_HDW0) 'save unsigned Dword to HDW0//

3738

3739

**Result: **@W_HDW0=-12345,@W_HDW2=53191,@W_HDW3=0

== **W2F** ==

**Function**

A1 = W2F (A2)

**Description**

Convert a 16bit integer to a 32bit floating, and then save to the next word of A1.

Parameters

**A1:** operated address.

3754

3755

**A2:** source address.

3756

3757

Returned value: none.

**Example**

A1, A2 are addresses

//@W_HDW0 = 1234 ' assign unsigned word {1234} HDW0 @W_HDW1=W 2F(@W_HDW0) ‘ Convert {1234} to a 32bit floating and then save to HDW1, HDW2.//

3764

3765

**Result: **@W_HDW1=1234'32bit floating

3766

3767

A1 is an address,A2 is variable

//dim a as integer//

//a=134 'define a integer 134 to a,//

3772

3773

//@W_HDW2=W2F (a) 'convert to 32bit floating save to HDW1, HDW2.//

3774

3775

**Result: **@W_HDW1=134' 32bit floating

== **W2S** ==

**Function**

W2S(A1,A2,S1)

**Description**

Convert integer word in address A1 text as S1 format, and then save to A2.

**Parameters**

**A1:** operated address.

3790

3791

**A2:** source address.

3792

3793

**S1:** saving format.

3794

3795

* d format: Decimal format.d: Real data length.Md: Designated data length. 0md: Designated data length if the length is shorter than m adds 0 at the left.

3796

* format: Unsigned octal format. Mo and 0mo is also applied.

3797

* x format: unsigned Hex integer format ?Mx and 0mx is also applied.

3798

* c format: ASCII format.

**Example**

Decimal format

//@W_HDW1=1456'assign value {1456} to HDW1.//

3805

3806

//W2S("@W_HDW1", "@W_HDW10", "6d") ' convert{1456} to decimal text and save to HDW10.//

3807

3808

**Result: **@W_HDW10 shown "1456"

0md

//@W_HDW1=1456 ' assign value {1456} to HDW1//

3813

3814

//W2S("@W_HDW1", "@W_HDW10", "06d") ' convert{1456} to integer decimal text and add 2 {0} on the left of the data then save to HDW10.//

3815

3816

**Result:** @W_HDW10 show text "001456"

3817

3818

== **WaitEthernetStart** ==

**Function**

WaitEthernetStart (A1)

**Description**

Waiting for Ethernet to start, it will extend the HMI start up time (only added in PI i series, Ethernet start up is earlier than HMI in other PI series)

**Parameters**

**A1: **Waiting timeout (1~~20s)

3831

3832

If A1=0, the wait timeout is 10s;

3833

3834

If A1>20, the wait timeout is 20s;

3835

3836

**Returned value:** None

**Example**

//WaitEthernetStart (15)//

3841

3842

‘The maximum waiting time is 15 seconds. If Ethernet is not started within 15 seconds, HMI will start the system and no longer wait for ethernet.

3843

3844

== **WHILE ... WEND** ==

**Function**

While condition

[statements]

Wend

**Description**

If the condition is true, then all the commands before Wend in the statement will be executed then recheck the condition, if the condition is false, the command after Wend will be executed.

**Parameters**

**Condition: **Number or string, the result represents as True or False.

3861

3862

**Returned value:** None.

**Example**

//while @W_HDW1>50 'the condition is the value of HDW1 bigger than 50.//

3867

3868

//@W_HDW1=@W_HDW1-1 'when the condition is true, execute subtract 1 from 1HDW.//

//wend//

//@W_HDW2=@W_HDW2+1 ' when the condition is false, execute add 1 from 1HDW.//

3873

3874

**Result:** If HDW1=60, after executed; HDW1=50, if the condition is true.

== **WriteAddr** ==

**Function**

WriteAddr(A1,A2)

**Description**

Assign the value from A2 to address A1.

**Parameters**

**A1:** operated address

3889

3890

**A2:** source address

3891

3892

**Returned value:** None.

**Example**

//dim f as integer ' integer f//

3897

3898

//f=13 ' assign the value 13 to f//

3899

3900

//WriteAddr("@W_HDW1",f) ' write the value to HDW1.//

3901

3902

//WriteAddr("@W_HDW10",@W_HDW2) ' write the value from HDW2 to HDW10.//

Result:

HDW1=13

HDW10= HDW2'IF HDW2=1456,Then HDW10=1456;IF HDW2=-123,Then HDW10=-123

3909

3910

== **WriteWordToFile** ==

**Function**

WriteWordToFile (A1,A2,A3,A4,A5,A6)

**Description**

Write data of designated length to specified file

**Parameters**

A1: File location (value is an integer);

In HMI:

~=0: Recipe folder in HMI flash;

3927

3928

~=1: Custom folder in UDisk (USB flash disk);

3929

3930

~= 2: Custom folder in SD card.

3931

3932

~=3: Custom folder in HMI flash;

In simulator:

~= 0: D:/Recipe/

~= 1: C:/WECON/CustomFileDir/

3939

3940

~= 2: C:/WECON/CustomFileDir/

3941

3942

~= 3: C:/WECON/CustomFileDir/

3943

3944

**✎Note: **A1 can be an address, variable or value.

3945

3946

A2: File name (value is a string);

3947

3948

Input the file name want to write.

3949

3950

**✎Note: **A2 must be an address, and the length of the file name cannot exceed 32 characters.

3951

3952

A3: Data start address (value is a string);

3953

3954

Input the data want to write

3955

3956

**✎Note: **A3 must be the address.

3957

3958

A4: Data length (value is an integer)

3959

3960

Set the length of the data to be written (unit:word)

3961

3962

**✎Note: **A4 can be an address , variable or value.

3963

3964

A5: Return value (value is an integer)

3965

3966

~= 1: Successfully written

3967

3968

~= 2: Failed to open the folder

3969

3970

~= 3: Read address error

3971

3972

~= 4: File writing error

3973

3974

~= 5: The file already exists

3975

3976

**✎Note: **A5 must be an address.

3977

3978

A6: Folder name (value is a string);

3979

3980

Input the folder where to be written the file.

3981

3982

**✎Note: **A6 can be an address or a variable or a character string, and the length of the folder name cannot exceed 32 characters

**Example**

WriteWordToFile(@W_HDW1254,"@W_HDW4200","@W_HDW1000",@W_HDW4000,"@W_HDW4100", @W_HDW4300)'Write the @W_HDW4000 words in the address @W_HDW1000 to the file @W_HDW4200 in directory @W_HDW4300 specified location by @W_HDW1254

Wiki source code of 08 Macro Script

Navigation

Table of Contents