C Language Executor Library (For Conversion from … MANUAL B-64183EN/01 C Language Executor Library...

PROGRAMMING MANUAL

B-64183EN/01

C Language Executor Library (For Conversion from PMC C Language Function)

FANUC Series 30*/300*/300*s-MODEL AFANUC Series 31*/310*/310*s-MODEL A5 FANUC Series 31*/310*/310*s-MODEL A FANUC Series 32*/320*/320*s-MODEL A

� ��

� ��

��

��

� ��

��

��

��

��!��!�

��

�� "��

��

B-64183EN/01 DEFINITION OF WARNING, CAUTION, AND NOTE

s-1

DEFINITION OF WARNING, CAUTION, AND NOTE This manual includes safety precautions for protecting the user and preventing damage to the machine. Precautions are classified into Warning and Caution according to their bearing on safety. Also, supplementary information is described as a Note. Read the Warning, Caution, and Note thoroughly before attempting to use the machine.

WARNING Applied when there is a danger of the user being

injured or when there is a danger of both the user being injured and the equipment being damaged if the approved procedure is not observed.

CAUTION

Applied when there is a danger of the equipment being damaged, if the approved procedure is not observed.

NOTE The Note is used to indicate supplementary

information other than Warning and Caution. • Read this manual carefully, and store it in a safe place.

B-64183EN/01 TABLE OF CONTENTS

c-1

TABLE OF CONTENTS

DEFINITION OF WARNING, CAUTION, AND NOTE .................................s-1 1 GETTING STARTED...............................................................................1

1.1 OVERVIEW ................................................................................................... 2 1.2 RELATED DRAWING NUMBER ................................................................... 3

2 HOW TO MAKE APPLICATION .............................................................4 2.1 INSTALLATION OF THE "C LIBRARY FOR CONVERSION" ON A

PERSONAL COMPUTER.............................................................................. 5 2.2 CNC HARDWARE ......................................................................................... 9 2.3 COMPATIBILITY WITH THE "C LIBRARY FOR C LANGUAGE BOARD" .. 10 2.4 CONVERSION POINTS .............................................................................. 13

3 FUNCTION REFERENCE .....................................................................18 3.1 FUNCTION LIST.......................................................................................... 19 3.2 SYSTEM CALL............................................................................................ 25

3.2.1 Read the Task Timer Value....................................................................................25 3.2.2 Set the Task Timer Value .......................................................................................26 3.2.3 Wait for the Timer Value .......................................................................................27 3.2.4 Wait for Time .........................................................................................................28 3.2.5 Create an Event Flag ..............................................................................................29 3.2.6 Delete the Event Flag .............................................................................................30 3.2.7 Set the Event Flag...................................................................................................31 3.2.8 Wait for the Event Flag ..........................................................................................32 3.2.9 Clear the Event Flag ...............................................................................................33 3.2.10 Set the Event Flag (Pulse type) ..............................................................................34 3.2.11 Create a Semaphore................................................................................................35 3.2.12 Delete the Semaphore.............................................................................................36 3.2.13 Set the Semaphore ..................................................................................................37 3.2.14 Wait for the Semaphore..........................................................................................38

3.3 SWITCH SCREEN....................................................................................... 39 3.3.1 Switch to the User Application Screen...................................................................39 3.3.2 Wait for Switching to the User Application Screen ...............................................40 3.3.3 Switch to the CNC Screen......................................................................................41

3.4 MDI KEYS ................................................................................................... 42 3.4.1 MDI Key Code Table .............................................................................................42

TABLE OF CONTENTS B-64183EN/01

c-2

3.4.2 Read key.................................................................................................................44 3.4.3 Control a Key-in Line.............................................................................................46 3.4.4 Read Key Status .....................................................................................................49 3.4.5 Disable Function Keys ...........................................................................................50 3.4.6 Enable Function Keys ............................................................................................51 3.4.7 Read a Function Key ..............................................................................................52 3.4.8 Disable Custom Keys .............................................................................................53 3.4.9 Enable Custom Keys ..............................................................................................54

3.5 ACCESS TO THE PMC ADDRESS............................................................. 55 3.5.1 Read from the PMC Address (bit)..........................................................................56 3.5.2 Write to the PMC Address (bit) .............................................................................57 3.5.3 Read from the PMC Address (char) .......................................................................58 3.5.4 Read from the PMC Address (short) ......................................................................59 3.5.5 Read from the PMC Address (long).......................................................................60 3.5.6 Read from the PMC Address (unsigned char)........................................................61 3.5.7 Read from the PMC Address (unsigned short).......................................................62 3.5.8 Read from the PMC Address (unsigned long) .......................................................63 3.5.9 Write to the PMC Address (char)...........................................................................64 3.5.10 Write to the PMC Address (short)..........................................................................65 3.5.11 Write to the PMC Address (long)...........................................................................66 3.5.12 Write to the PMC Address (unsigned char) ...........................................................67 3.5.13 Write to the PMC Address (unsigned short) ..........................................................68 3.5.14 Write to the PMC Address (unsigned long) ...........................................................69

3.6 READ SYSTEM INFORMATION................................................................. 70 3.6.1 Read CNC Information ..........................................................................................70 3.6.2 Read Symbol and Comment in LADDER Program

(16 characters symbol is available) ........................................................................71 3.6.3 Read Symbol and Comment in LADDER Program...............................................73 3.6.4 Read a Message in LADDER Program ..................................................................75

3.7 ACCESS TO THE EXTENDED NONVOLATILE MEMORY ........................ 76 3.7.1 Read from the Extended Nonvolatile Memory ......................................................76 3.7.2 Write to the Extended Nonvolatile Memory ..........................................................77 3.7.3 Get Size of the Extended Nonvolatile Memory .....................................................78

3.8 CHARACTER DISPLAY .............................................................................. 79 3.8.1 Color Palette for the Character Display..................................................................79 3.8.2 Coordinates of the Character Screen ......................................................................80 3.8.3 Character Code .......................................................................................................81


c-3

3.8.4 Initialize the Character Screen (80 Columns x 30 Lines)......................................82 3.8.5 Initialize a Character Screen

(80 Columns x 25 Lines or 40 Columns x 16 Lines) .............................................83 3.8.6 Erase the Entire Screen...........................................................................................84 3.8.7 Clear Lines .............................................................................................................85 3.8.8 Clear Columns........................................................................................................86 3.8.9 Set a Display Position.............................................................................................87 3.8.10 Set a Display Attribute ...........................................................................................88 3.8.11 Change Attribute of the Characters Being Displayed ............................................89 3.8.12 Display ASCII Characters ......................................................................................90 3.8.13 Display Characters (Kanji, Hiragana and Special Characters) ..............................91 3.8.14 Display Hex Size Characters ..................................................................................93 3.8.15 Display Cursor........................................................................................................94 3.8.16 Display Characters (ASCII, Kanji and Hiragana) .................................................96 3.8.17 Save the Character Screen ......................................................................................98 3.8.18 Restore the Character Screen................................................................................100 3.8.19 Control the Screen ................................................................................................101 3.8.20 Set Background Color of the Character Screen....................................................102 3.8.21 Set Palette for Character Screen ...........................................................................103 3.8.22 Initialize the Character Screen (74 Columns x 27 Lines)....................................104 3.8.23 Initialize the Character Screen (74 Columns x 30 Lines)....................................105 3.8.24 Initialize printf() ...................................................................................................106

3.9 GRAPHIC DISPLAY .................................................................................. 107 3.9.1 Color Palette for Graphic Display ........................................................................107 3.9.2 Coordinates of the Graphic Screen.......................................................................108 3.9.3 Open the Graphic Screen......................................................................................109 3.9.4 Close the Graphic Screen .....................................................................................110 3.9.5 Clear the Graphic Screen......................................................................................111 3.9.6 Display or Hide the Graphic Screen.....................................................................112 3.9.7 Set a Graphic Line Type.......................................................................................113 3.9.8 Set a Graphic Color ..............................................................................................114 3.9.9 Draw Straight Lines..............................................................................................115 3.9.10 Draw an Arc .........................................................................................................116 3.9.11 Paint ....................................................................................................................118 3.9.12 Shift ....................................................................................................................119 3.9.13 Get Graphic Screen Status....................................................................................120 3.9.14 Erase the Square ...................................................................................................121

TABLE OF CONTENTS B-64183EN/01

c-4

3.9.15 Set Palette for the Graphic Screen........................................................................122 3.10 READER / PUNCHER INTERFACE.......................................................... 123

3.10.1 Open the Reader / Puncher Interface....................................................................124 3.10.2 Close the Reader / Puncher Interface ...................................................................127 3.10.3 Read from the Reader / Puncher Interface............................................................128 3.10.4 Write to the Reader / Puncher Interface ...............................................................129 3.10.5 Open the Reader / Puncher Interface (for FANUC Handy File) ..........................130 3.10.6 Get the File Information .......................................................................................134 3.10.7 Delete the File ......................................................................................................136 3.10.8 Open the Reader / Puncher Interface....................................................................138 3.10.9 Close the Reader / Puncher Interface ...................................................................141 3.10.10 Read from the Reader / Puncher Interface............................................................142 3.10.11 Write to the Reader / Puncher Interface ...............................................................143 3.10.12 Open the Reader / Puncher Interface (for FANUC Handy File) ..........................144 3.10.13 Get the File Information .......................................................................................147 3.10.14 Delete the File ......................................................................................................148

3.11 CNC WINDOW .......................................................................................... 150 3.11.1 CNC Window Function (Read) ............................................................................150 3.11.2 CNC Window Function (Write) ...........................................................................152 3.11.3 External Data Input ..............................................................................................154

3.12 CNC PROGRAM ....................................................................................... 155 3.12.1 Start Registration of the CNC Program................................................................155 3.12.2 Register the CNC Program...................................................................................156 3.12.3 End Registration of the CNC Program.................................................................158 3.12.4 Start DNC running of the CNC Program .............................................................159 3.12.5 Run the CNC Program (DNC running) ................................................................161 3.12.6 End DNC Running of the CNC Program .............................................................163 3.12.7 Search the CNC Program (Supported 8 Digits Program Number).......................164 3.12.8 Search the CNC Program .....................................................................................165 3.12.9 Delete All CNC Programs ....................................................................................166 3.12.10 Delete the CNC Program (Supported 8 Digits Program Number) .......................167 3.12.11 Delete the CNC Program......................................................................................168 3.12.12 Start Reading of the CNC Program (Supported 8 Digits Program Number) .......169 3.12.13 Start Reading of the CNC Program......................................................................170 3.12.14 Read the CNC Program........................................................................................171 3.12.15 End Reading of the CNC Program .......................................................................173 3.12.16 Read the CNC Program Memory Information .....................................................174


c-5

3.12.17 Start Reading of the CNC Program List (Supported 8 Digits Program Number) 175 3.12.18 Start Reading of the CNC Program List...............................................................177 3.12.19 Read the CNC Program List.................................................................................178 3.12.20 End Reading of the Program List .........................................................................180 3.12.21 Start Registration of the CNC Program................................................................181 3.12.22 Register the CNC Program...................................................................................182 3.12.23 End Registration of the CNC Program.................................................................184 3.12.24 Start DNC running of the CNC Program .............................................................185 3.12.25 Run the CNC Program (DNC running) ................................................................186 3.12.26 End DNC Running of the CNC Program .............................................................188 3.12.27 Search the CNC Program (Supported 8 Digits Program Number).......................189 3.12.28 Search the CNC Program .....................................................................................190 3.12.29 Delete All CNC Programs ....................................................................................191 3.12.30 Delete the CNC Program (Supported 8 Digits Program Number) .......................192 3.12.31 Delete the CNC Program......................................................................................193 3.12.32 Start Reading of the CNC Program (Supported 8 Digits Program Number) .......194 3.12.33 Start Reading of the CNC Program......................................................................195 3.12.34 Read the CNC Program........................................................................................196 3.12.35 End Reading of the CNC Program .......................................................................198 3.12.36 Read the CNC Program Memory Information .....................................................199 3.12.37 Start Reading of the CNC Program List (Supported 8 Digits Program Number) 200 3.12.38 Start Reading of the CNC Program List...............................................................201 3.12.39 Read the CNC Program List.................................................................................202 3.12.40 End Reading of the Program List .........................................................................204

3.13 CHARACTER CODE CONVERSION ........................................................ 205 3.13.1 Convert Characters from ASCII to ISO Code ......................................................205 3.13.2 Convert Characters from ISO to ASCII Code ......................................................206

4 CHARACTER CODE (KANJI, HIRAGANA AND OTHERS)..............207

B- 64183EN/01 1.GETTING STARTED

-1-

1 GETTING STARTED

1.GETTING STARTED B- 64183EN/01

-2-

1.1 OVERVIEW The "C language executor library (for conversion from PMC C language)" is for the Series 30i/ 31i/ 32i and provides functions that are compatible with "Series 15i/ 150i/ 16i/ 160i/ 160is/ 18i/ 180i/ 180is/ 21i/ 210i/ 210is C-language library for C language board". If you use the "C language executor library (for conversion from PMC C language)" when you convert the C language application running on the "Series 15i/ 150i/ 16i/ 160i/ 160is/ 18i/ 180i/ 180is/ 21i/ 210i/ 210is C language board" to one running on the "Series 30i/ 31i/ 32i C language executor", there are following merits. ・ You can save your efforts to convert the calling of C library

functions in the C language program. In this manual, the function reference for the "C language executor library (for conversion from PMC C language)" is mainly described. About details of the "Series 30i/ 31i/ 32i C language executor", refer to the following manual.

Manual Drawing number Series 30i/ 300i/ 300is-MODEL A Series 31i/ 310i/ 310is-MODEL A Series 31i/ 310i/ 310is-MODEL A5 Series 32i/ 320i/ 320is-MODEL A C language executor operator's manual

B-63944EN-3

In this manual, following abbreviations will be used.

Item Abbreviation C language executor library (for conversion from PMC C language)

C library for conversion

Series 15i/ 150i/ 16i/ 160i/ 160is/ 18i/ 180i/ 180is/ 21i/ 210i/ 210is C language board

C language board

Series 15i/ 150i/ 16i/ 160i/ 160is/ 18i/ 180i/ 180is/ 21i/ 210i/ 210is C language library for C language board

C library for C language board

C language library (for C language executor) C library for C executor

B- 64183EN/01 1.GETTING STARTED

-3-

1.2 RELATED DRAWING NUMBER The related drawing number is shown below.

Drawing number Name Contents A02B-0303-J734 Macro executor +

C language executor This is the execution option for C executor.

A02B-0303-J738#1M Custom software size 1 MB A02B-0303-J738#2M Custom software size 2 MB A02B-0303-J738#3M Custom software size 3 MB A02B-0303-J738#4M Custom software size 4 MB A02B-0303-J738#5M Custom software size 5 MB A02B-0303-J738#6M Custom software size 6 MB

This is the memory option for C executor. The system of C executor uses about 700 KB memories and the "C library for conversion" uses about 100 KB memories. Therefore, the memory size that you can use is smaller than the total memory size. [Memory size] = [Total memory size] – [about 800 KB]

A02B-0303-J736 C language executor additional SRAM This is the nonvolatile memory option. (Optional)You can use 192 KB of nonvolatile memory.

A02B-0303-J993#64K Nonvolatile memory expansion 64 KB A02B-0303-J993#256K Nonvolatile memory expansion 256 KB

This is the nonvolatile memory option. (Optional)You can use 64 KB or 256 KB of nonvolatile memory. To access this memory, you have to use the function pmc_rdkpm(), pmc_wrkpm(), pl_kpmrd() or pl_kpmwrt().

A08B-9010-J610#EN07 C language library (for C language executor)

This is the "C language library" for the C executor.

B-63944JA-3 Series 30i/ 300i/ 300is-MODEL A Series 31i/ 310i/ 310is-MODEL A Series 31i/ 310i/ 310is-MODEL A5 Series 32i/ 320i/ 320is-MODEL A C language executor operator's manual

This is the manual for the C executor.

A08B-9210-J719#ZZ11 C language executor library (for conversion from PMC C language)

This is the "C library for conversion". If you use this library, you can save efforts to convert the C language program running on a "C language board" to one running on a "30i/ 31i/ 32i C executor".

WindRiver Diab C/C++ Power-PC Compiler

This is the C/C++ compiler and linker.

2.HOW TO MAKE APPLICATION B- 64183EN/01

-4-

2 HOW TO MAKE APPLICATION

B- 64183EN/01 2.HOW TO MAKE APPLICATION

-5-

2.1 INSTALLATION OF THE "C LIBRARY FOR CONVERSION" ON A PERSONAL COMPUTER

The development environment of C executor

The "C library for conversion" has to be installed on the development environment of C executor on a personal computer. If a C compiler and the "C library for C executor" have not been installed on a personal computer, install them. About the installation of C compiler and the "C library for C executor", refer to the following manual. ・ "C language executor operator's manual B-63944EN-3"

C library for conversion The files and directories structure of the installation CD-ROM of the "C library for conversion" is shown below.

pmclib.h Header file clblib.o Library file The example of files and directories structure of the development environment of C executor is shown below. To install the "C library for conversion", (1) Copy the file "pmclib.h" into "inc" directory. (2) Copy the file "clblib.o" into "lib" directory.

Modification of "makefile" To use the "C library for conversion", you have to bind the "clblib.o" to the executable file when a linking process. To do this, you should apply modifications, that is to add the file "$(FCLIB)¥clblib.o" to the description of source files of linking command, in the "makefile".

<CD-ROM>

inc

pmclib.h

lib

clblib.o

<Install directory of the C library for C executor>

inc

<- pmclib.h

lib

<- clblib.o

man

tool

user


-6-

The example of modification of "makefile" is shown below. The number of modification point is 10.

# Make file for FS30i C Executor user application # # This makefile is for NMAKE.EXE #

# 2000.09.10 FANUC LTD. # 2000.09.12 ... #------------------------------------------------------------------------------ .¥STEP1¥STEP1_1.MAP : $(TASK1) $(RAMOBJ) $(SELEC) .¥STEP1¥STEP1_1.LNK $(TOOL)¥STEP1.LNK 1 $(LINK) -@<<$(TMP_FILE) .¥STEP1¥STEP1_1.LNK -o .¥STEP1¥STEP1_1.ELF $(TASK1) $(RAMOBJ) $(FCLIB)¥tsk1_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥STEP1¥STEP1_1.MAP <<NOKEEP $(TASK1LEN) : .¥STEP1¥STEP1_1.MAP $(TOOL)¥GAWK -v task=1 -f $(TOOL)¥CHK_LEN1.AWK .¥STEP1¥STEP1_1.MAP > $(TASK1LEN) #------------------------------------------------------------------------------ .¥STEP1¥STEP1_2.MAP : $(TASK2) $(RAMOBJ) $(SELEC) .¥STEP1¥STEP1_2.LNK $(TOOL)¥STEP1.LNK 2 $(LINK) -@<<$(TMP_FILE) .¥STEP1¥STEP1_2.LNK -o .¥STEP1¥STEP1_2.ELF $(TASK2) $(RAMOBJ) $(FCLIB)¥tsk2_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥STEP1¥STEP1_2.MAP <<NOKEEP $(TASK2LEN) : .¥STEP1¥STEP1_2.MAP $(TOOL)¥GAWK -v task=2 -f $(TOOL)¥CHK_LEN1.AWK .¥STEP1¥STEP1_2.MAP > $(TASK2LEN) #------------------------------------------------------------------------------ .¥STEP1¥STEP1_3.MAP : $(TASK3) $(RAMOBJ) $(SELEC) .¥STEP1¥STEP1_3.LNK $(TOOL)¥STEP1.LNK 3 $(LINK) -@<<$(TMP_FILE) .¥STEP1¥STEP1_3.LNK -o .¥STEP1¥STEP1_3.ELF $(TASK3) $(RAMOBJ) $(FCLIB)¥tsk3_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥STEP1¥STEP1_3.MAP <<NOKEEP $(TASK3LEN) : .¥STEP1¥STEP1_3.MAP $(TOOL)¥GAWK -v task=3 -f $(TOOL)¥CHK_LEN1.AWK .¥STEP1¥STEP1_3.MAP > $(TASK3LEN) ...


-7-

#------------------------------------------------------------------------------ .¥STEP1¥STEP1_4.MAP : $(TASK4) $(RAMOBJ) $(SELEC) .¥STEP1¥STEP1_4.LNK $(TOOL)¥STEP1.LNK 4 $(LINK) -@<<$(TMP_FILE) .¥STEP1¥STEP1_4.LNK -o .¥STEP1¥STEP1_4.ELF $(TASK4) $(RAMOBJ) $(FCLIB)¥tsk4_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥STEP1¥STEP1_4.MAP <<NOKEEP $(TASK4LEN) : .¥STEP1¥STEP1_4.MAP $(TOOL)¥GAWK -v task=4 -f $(TOOL)¥CHK_LEN1.AWK .¥STEP1¥STEP1_4.MAP > $(TASK4LEN) #------------------------------------------------------------------------------ .¥STEP1¥STEP1_5.MAP : $(TASK5) $(RAMOBJ) $(SELEC) .¥STEP1¥STEP1_5.LNK $(TOOL)¥STEP1.LNK 5 $(LINK) -@<<$(TMP_FILE) .¥STEP1¥STEP1_5.LNK -o .¥STEP1¥STEP1_5.ELF $(TASK5) $(RAMOBJ) $(FCLIB)¥tsk5_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥STEP1¥STEP1_5.MAP <<NOKEEP $(TASK5LEN) : .¥STEP1¥STEP1_5.MAP $(TOOL)¥GAWK -v task=5 -f $(TOOL)¥CHK_LEN1.AWK .¥STEP1¥STEP1_5.MAP > $(TASK5LEN) #------------------------------------------------------------------------------ $(TASKALEN) : $(CHK_LEN) echo s/SRAM_LEN/$(SRAM_LEN)/g> $(TASKALEN) $(TOOL)¥GAWK -f $(TOOL)¥CHK_LEN2.AWK <<$(TMP_FILE) >> $(TASKALEN) $(CHK_LEN) <<NOKEEP #------------------------------------------------------------------------------ TASK1.ELF : $(TASKALEN) $(SELEC) .¥STEP2¥TASK1.DAT $(TOOL)¥STEP2.LNK 1 $(TOOL)¥SED -f $(TASKALEN) .¥STEP2¥TASK1.DAT > .¥STEP2¥TASK1.LNK $(LINK) -@<<$(TMP_FILE) .¥STEP2¥TASK1.LNK -o TASK1.ELF $(TASK1) $(RAMOBJ) $(FCLIB)¥tsk1_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥map¥task1.map <<NOKEEP #------------------------------------------------------------------------------ TASK2.ELF : $(TASKALEN) $(SELEC) .¥STEP2¥TASK2.DAT $(TOOL)¥STEP2.LNK 2 $(TOOL)¥SED -f $(TASKALEN) .¥STEP2¥TASK2.DAT > .¥STEP2¥TASK2.LNK $(LINK) -@<<$(TMP_FILE) .¥STEP2¥TASK2.LNK -o TASK2.ELF $(TASK2) $(RAMOBJ) $(FCLIB)¥tsk2_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥map¥task2.map <<NOKEEP #------------------------------------------------------------------------------ ...


-8-

#------------------------------------------------------------------------------ TASK3.ELF : $(TASKALEN) $(SELEC) .¥STEP2¥TASK3.DAT $(TOOL)¥STEP2.LNK 3 $(TOOL)¥SED -f $(TASKALEN) .¥STEP2¥TASK3.DAT > .¥STEP2¥TASK3.LNK $(LINK) -@<<$(TMP_FILE) .¥STEP2¥TASK3.LNK -o TASK3.ELF $(TASK3) $(RAMOBJ) $(FCLIB)¥tsk3_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥map¥task3.map <<NOKEEP #------------------------------------------------------------------------------ TASK4.ELF : $(TASKALEN) $(SELEC) .¥STEP2¥TASK4.DAT $(TOOL)¥STEP2.LNK 4 $(TOOL)¥SED -f $(TASKALEN) .¥STEP2¥TASK4.DAT > .¥STEP2¥TASK4.LNK $(LINK) -@<<$(TMP_FILE) .¥STEP2¥TASK4.LNK -o TASK4.ELF $(TASK4) $(RAMOBJ) $(FCLIB)¥tsk4_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥map¥task4.map <<NOKEEP #------------------------------------------------------------------------------ TASK5.ELF : $(TASKALEN) $(SELEC) .¥STEP2¥TASK5.DAT $(TOOL)¥STEP2.LNK 5 $(TOOL)¥SED -f $(TASKALEN) .¥STEP2¥TASK5.DAT > .¥STEP2¥TASK5.LNK $(LINK) -@<<$(TMP_FILE) .¥STEP2¥TASK5.LNK -o TASK5.ELF $(TASK5) $(RAMOBJ) $(FCLIB)¥tsk5_lib.o $(FCLIB)¥cexe_lib.o $(FCLIB)¥clblib.o $(FCLIB)¥jump_tbl.o -@O=.¥map¥task5.map <<NOKEEP ...


-9-

2.2 CNC HARDWARE The comparison between the hardware, to execute the C language application, for the "Series 30i/ 31i/ 32i C executor" and one for the "Series 15i/ 16i/ 18i/ 21i C language board" is shown below.

Item Series 30i/ 31i/ 32iC executor

Series 16i/ 18i/ 21i C language board

Series 15i C language board

CPU PowerPC compatible CPU

80486DX2 80486DX2

Program code 2 MB in the maximum (Optional)

2 MB in the maximum (Optional)

Work memory

About 5.2 MB in the maximum (Optional) *Note 1 256 KB in the

maximum 256 KB in the

maximum Work memory (Nonvolatile)

About 250 KB in the maximum (Optional) *Note 2, 3

64 KB in the maximum (Optional)

64 KB in the maximum (Optional)

Display 10.4" color LCD 10.4" color LCD 9.5" monochrome

LCD 8.4" color LCD

7.2" monochrome LCD

10.4" color LCD 9.5" monochrome

LCD

RS-232C 2ch 2ch 2ch Memory card Supported Not supported Not supported Touch panel Supported Not supported Not supported

NOTE 1. When a "Custom software size 6MB" option,

A02B-0303-J738#6M, is equipped and the "C library for conversion" is used, you can use about 5.2 MB memory.

2. When a "C language executor additional SRAM" option, A02B-0303-J736, is equipped, you can use about 250 KB nonvolatile memory.

3. When a "Nonvolatile memory expansion 256 KB" option, A02B-0303-J993#256K, is equipped, you can use additional 256 KB of nonvolatile memory.


-10-

2.3 COMPATIBILITY WITH THE "C LIBRARY FOR C LANGUAGE BOARD"

Overview

The "C library for conversion" is designed to be compatible with the "C library for C language board". However, some functions are unavailable and behavior of some functions is different from "C library for C language board" because of the difference of hardware and CNC system software, and the restriction of the C executor. In this case, to use a similar conventional function of C executor is worth considering. The software block diagram of "C library for conversion" is shown below.

C language application

C library for C executor

C library for conversion

CNC system software

Display driver

Keyboarddriver

RS-232Cdriver

Memory card driver

Other driver

Many functions of the "C library for conversion" are designed to call some functions of the "C library for C executor" to carry out the purpose. This means that the "C library for conversion" have tendency to be slower than the "C library for C executor". Furthermore, the simultaneous use of some similar function of the "C library for C executor" may be restricted, such as functions related to RS-232C and CNC program. If the execution speed or above restriction turn into a grave issue, to use a similar conventional function of C executor is worth considering.

The different points from the "C library for C language board"

The differences between the "C library for conversion" and the "C library for C language board" are shown below. About the details, see the reference of each function.

- System call Following functions are unavailable. ・ os_chng_pri(), os_new_mem(), os_disp_mem(), os_rep_mem(),

os_mak2_sem(), os_queu_sem(), os_make_mbx(), os_delt_mbx(), os_read_mbx(), os_red2_mbx(), os_writ_mbx(), os_wrt2_mbx(), os_make_pkt(), os_delt_pkt(), os_send_pkt(), os_recv_pkt(), os_mark_pkt(), os_rmrk_pkt(), os_curr_tsk()

-


-11-

- Switch screen Some behaviors of the following function are different. ・ pl_pcmdi()

- MDI keys

Following functions are unavailable. ・ pl_fcustom_ign(), pl_fcustom_avail()

Some behaviors of following functions are different. ・ pl_keysts(), pl_fkey_ign(), pl_fkey_avail()

- Access to the PMC address

Following functions are unavailable. ・ pl_memc(), pl_memuc(), pl_mems(), pl_memus(), pl_meml(),

pl_memul(), pl_memc2(), pl_memuc2(), pl_mems2(), pl_memus2(), pl_meml2(), pl_memul2()

Following functions are added. ・ pl_memcrd2(), pl_memucrd2(), pl_memsrd2(), pl_memusrd2(),

pl_memlrd2(), pl_memulrd2(), pl_memcwrt2(), pl_memucwrt2(), pl_memswrt2(), pl_memuswrt2(), pl_memlwrt2(), pl_mwmulwrt2()

- Read system information

Some behaviors of the following function are different. ・ pl_sysinfrd()

The following function is added. ・ pl_symcmt2()

- Access to the extended nonvolatile memory

The "Nonvolatile memory expansion 256 KB" option is added.

- Character display Following functions are unavailable. ・ pl_dspopen2(), pl_dspopen3()

Some behaviors of following functions are different. ・ pl_dspopen4(), pl_dspstrw(), pl_cursor(), initreq_printf()

- Graphic display

The following function is unavailable. ・ pl_grpopen2()

Some behavior of the following function is different. ・ pl_grparc()


-12-

- Reader / puncher interface The baud rate setting "19200 bps" is unavailable. The simultaneous use of similar function in "C library for C executor" is restricted.

- CNC window

The following function is unavailable. ・ pl_exin()

Some behaviors of following functions are different. ・ pl_windr(), pl_windw()

- CNC program

The following functions are unavailable. ・ pl_nc_vrfstart(), pl_nc_verify(), pl_nc_vrfend(),

pl_nc_vrfstart2(), pl_nc_verify2(), pl_nc_vrfend2() The simultaneous use of similar function in "C library for C executor" is restricted.

- Character code conversion

All functions are compatible.

- Floating point All functions defined in the file "math.h" are available. There may be some difference of accuracy because the CPU and the C compiler are different.


-13-

2.4 CONVERSION POINTS Conversion points from C language board to C executor are shown below.

C Compiler Followings are conversion points caused by the differences of C compiler.

Item

30i/ 31i/ 32i C executor Diab C/C++

15i/ 16i/ 18i/ 21i C language board

INTEL i-C286

Conversion Points

Addressing 32 bit addressing 16 bit addressing The addressing size is extended from 16 bits to 32 bits. You can access memory over 64 KB size.

Size of "int" 4 bytes 2 bytes The size of "int" is different. The program, that the size of "int" is assumed 2 bytes, has to be modified.

Size of pointer 4 bytes 2 bytes (near) 4 bytes (far)

The size of pointer is different. The program, that the size of pointer is assumed 2 bytes, has to be modified.

char 1 byte 1 byte short 2 bytes 2 bytes long 4 bytes 2 bytes float 4 bytes 2 bytes

double 8 bytes 2 bytes

Data alignment

pointer 4 bytes 2 bytes

The default setting of data alignment is different. The program, that the location address of a member in a structure is assumed, has to be modifiled.

Byte order Big endian Little endian The byte order is different. The program, that the byte order is assumed little endian, has to be modified.

Syntax checking of compiler

Stricter Looser The syntax checking of a C compiler becomes stricter.


-14-

Tasks The differences between task on "30i/ 31i/ 32i C executor" and task on "15i/ 16i/ 18i/ 21i C language board" are shown below.

Item

30i/ 31i/ 32i C executor

15i/ 16i/ 18i/ 21i C language board

Number of tasks 5 in the maximum 16 in the maximum Task priority Fixed Programmable

Execution cycle Fixed Programmable Other character The purpose of each

task have been defined and fixed.

All tasks have a same character.

On "C executor", you can use up to five tasks. The purpose of an each task has been defined and an each task will executed automatically in certain cycle with certain task priority. The characters of each task on C executor are shown below.

CNC System Task (Axes Control etc.) High Real-time Custom Macro

(A-5) High-level Task CNC System Task (Preparing etc.) Auxiliary Macro of Macro Executor

(A-3) Alarm Task (A-2) Communication Task

CNC System Task(Display etc.)

(A-1) Main Task

(A-4) Window Task

Low Priority

(A-1) Main task (Priority: Low) This task is to execute a process for user application screen. In

this task, you can use almost all the library functions. When the user application screen is changed to another screen, this task is automatically suspended by the system. When the user application screen is displayed again, this task is automatically executed again. If no background process is necessary in the user application, you should describe all programs in this task.

(A-2) Communication task (Priority: Middle) This task is to execute a background communication process

using RS-232C. In this task, the use of some kind of functions is restricted.

You should describe a background communication process using RS-232C in this task. If the background communication process is not required, this means that the communication process runs only on the user screen, you should describe it in the Main task.

(A-3) Alarm task (Priority: Middle) This task is to execute a background process. In this task, the use

of some kind of functions is restricted. This task is executed automatically and cyclically. Its execution

cycle occasionally may changes because of the busy status of the


-15-

CNC system software. Therefore, you should describe background process, which does not require strict cyclic execution, in this task.

(A-4) Window task (Priority: Low) This task is to execute a virtual machine operator's panel function

or virtual keyboard function using a touch panel. In this task, the use of some kind of functions is restricted.

(A-5) High-level task (Priority: High) This task is to execute a background process that requires a short

and accurate execution cycle. The priority of this task is very high, this means that a large process in this task may have effect on the execution of CNC system software. Carefully you should select the process running in this task.

In this task, the use of some kind of functions is restricted. The functions that you can use are described in the following manuals. - "3.1 Function List" in this manual - "C language executor operator's manual, B-63944EN-3,

Function List" The details of the High-level task are described in the following

manual. - "C language executor operator's manual, B-63944EN-3,

High-level Task" When you convert a C program running on "C language board" to "C executor", you should assign all tasks on C language board to five tasks on C executor. The assignment policy is shown below. (1) Classify all tasks on "C language board" under following four

types. (B-1) Background process (High priority) Select process carefully that has to be executed in high and

accurate cycle such a machine and a CNC control. (B-2) Background process (Low priority) Select process that is nearly executed in cyclically. (B-3) Background process (RS-232C) Select RS-232C process that has to be executed in

background on any screens. (B-4) User application screen process Select process that is executed when a user application

screen is displayed, such a displaying process, key handling and so on. You should select a RS-232C process that is only executed on user screen too.


-16-

(2) You should describe above classified process to following each task on C executor.

Classification

in (1) Tasks

on C executor (B-1) (A-5) High-level task (B-2) (A-3) Alarm task (B-3) (A-2) Communication task (B-4) (A-1) Main task

Using functions When you use the "C library for conversion", you can use both functions of "C library for conversion" and "C library for C executor". Using the "C library for conversion", you can save your efforts to convert the calling of C library functions in the C language program. Furthermore, you can also use the rich functions of the "C library for C executor". However, the mixed use of some kind of functions in each library may be restricted, such as RS-232C functions and CNC program functions. About the details, refer to the following manual.

・ "3.10 READER / PUNCHER INTERFACE" in this manual ・ "3.12 CNC PROGRAM" in this manual

By the library structure, the "C library for conversion" have tendency to be slower than the "C library for C executor". If the slower execution speed of the user program turn into grave issue, to use a similar conventional function of "C library for C executor" is worth considering. If you develop a new user application, we recommend that you use the rich functions in "C library for C executor" rather than "C library for conversion".

Common variables You should define common variables in the file "DRAMVAR.C".

Nonvolatile variables There are two types of nonvolatile memory. The way to access is different between them. If you use nonvolatile memory area newly, the type (1) is recommended because of the easy programming. (1) "C language executor additional SRAM (A02B-0303-J736)" You can use about 250 KB nonvolatile memory. In addition, you

can program and use it by the description of normal C language sentence.

(2) "Nonvolatile memory expansion 64 KB (A02B-0303-J993#64K)" or "Nonvolatile memory expansion 256 KB (A02B-0303-J993#256K)" You can use 64 KB or 256 KB nonvolatile memory. You can access it using the function pl_kpmrd() or pl_kpmwrt().


-17-

PMC address The byte order is different between "C executor" and "C language board" because they have different type of CPU. This means that the direct accessing using a pointer is not compatible between them. Therefore, following functions are unavailable in "C library for conversion". ・ pl_memc(), pl_memuc(), pl_mems(), pl_memus(), pl_meml(),

pl_memul() ・ pl_memc2(), pl_memuc2(), pl_mems2(), pl_memus2(),

pl_meml2(), pl_memul2() You should use functions "pmc_rdpmcrng()" and "pmc_wrpmcrng()" in "C library for C executor" or following new functions in "C library for conversion" ・ pl_memcrd2(), pl_memucrd2(), pl_memsrd2(), pl_memusrd2(),

pl_memlrd2(), pl_memulrd2() ・ pl_memcwrt2(), pl_memucwrt2(), pl_memswrt2(),

pl_memuswrt2(), pl_memlwrt2(), pl_mwmulwrt2() The example using "C library for conversion" is shown below. Before) num = *pl_mems2(id, offset); num |= 0x8000; *pl_mems2(id, offset) = num; After) num = pl_memsrd2(id, offset, NULL); num |= 0x8000; pl_memswrt2(id, offset, num);

3.FUNCTION REFERENCE B- 64183EN/01

-18-

3 FUNCTION REFERENCE

B- 64183EN/01 3.FUNCTION REFERENCE

-19-

3.1 FUNCTION LIST

SYSTEM CALL No. Name Content Available

task 3.2.1 os_show_tim() Read the Task Timer Value MWAC 3.2.2 os_set_tim() Set the Task Timer Value MWAC 3.2.3 os_sync_tim() Wait for the Timer Value MWAC 3.2.4 os_wait_tim() Wait for Time MWAC 3.2.5 os_make_flg() Create an Event Flag MAC 3.2.6 os_delt_flg() Delete the Event Flag MAC 3.2.7 os_sign_flg() Set the Event Flag MAC 3.2.8 os_wait_flg() Wait for the Event Flag MAC 3.2.9 os_clar_flg() Clear the Event Flag MAC 3.2.10 os_puls_flg() Set the Event Flag (Pulse type) MAC 3.2.11 os_make_sem() Create a Semaphore MAC 3.2.12 os_delt_sem() Delete the Semaphore MAC 3.2.13 os_sign_sem() Set the Semaphore MAC 3.2.14 os_wait_sem() Wait for the Semaphore MAC

- os_chng_pri() Change the Task Priority - - os_new_mem() Allocate Memory - - os_disp_mem() Free Memory - - os_repo_mem() Get Memory Information - - os_mak2_sem() Create a Semaphore (Exclusive control type) - - os_queu_sem() Change the Semaphore Type - - os_make_mbx() Create a Mailbox - - os_delt_mbx() Delete the Mailbox - - os_read_mbx() Receive Message (4 bytes) - - os_red2_mbx() Receive Message (8 bytes) - - os_writ_mbx() Send Message (4 bytes) - - os_wrt2_mbx() Send Message (8 bytes) - - os_make_pkt() Create a Packet - - os_delt_pkt() Delete the Packet - - os_send_pkt() Send the Packet - - os_recv_pkt() Receive a Packet - - os_mark_pkt() Set Mark to the Packet - - os_rmrk_pkt() Clear Mark to the Packet - - os_curr_tsk() Get Task ID -

M: Main Task, W: Window Task, A: Alarm Task, C: Communication Task, H: High-level Task, -: Not supported

SWITCH SCREEN No. Name Content Available

task 3.3.1 pl_pcmdi() Switch to the User Application Screen MWAC 3.3.2 pl_pcmdi_wait() Wait for Switching to the User Application Screen M 3.3.3 pl_ncmdi() Switch to the CNC Screen MWAC



-20-

MDI KEYS No. Name Content Available

task 3.4.2 pl_mdikey() Read key M 3.4.3 pl_keydef() Control a Key-in Line M 3.4.4 pl_keysts() Read Key Status M 3.4.5 pl_fkey_ign() Disable Function Key M 3.4.6 pl_fkey_avail() Enable Function Keys M 3.4.7 pl_fkey_sts() Read a Function Key M 3.4.8 pl_fcustom_ign() Disable Custom Keys M 3.4.9 pl_fcustom_avail() Enable Custom Keys M


ACCESS TO THE PMC ADDRESS No. Name Content Available

task 3.5.1 pl_membrd2() Read from the PMC Address (bit) MWACH 3.5.2 pl_membwrt2() Write to the PMC Address (bit) MWACH 3.5.3 pl_memcrd2() Read from the PMC Address (char) MWACH 3.5.4 pl_memsrd2() Read from the PMC Address (short) MWACH 3.5.5 pl_memlrd2() Read from the PMC Address (long) MWACH 3.5.6 pl_memucrd2() Read from the PMC Address (unsigned char) MWACH 3.5.7 pl_memusrd2() Read from the PMC Address (unsigned short) MWACH 3.5.8 pl_memulrd2() Read from the PMC Address (unsigned long) MWACH 3.5.9 pl_memcwrt2() Write to the PMC Address (char) MWACH 3.5.10 pl_memswrt2() Write to the PMC Address (short) MWACH 3.5.11 pl_memlwrt2() Write to the PMC Address (long) MWACH 3.5.12 pl_memucwrt2() Write to the PMC Address (unsigned char) MWACH 3.5.13 pl_memuswrt2() Write to the PMC Address (unsigned short) MWACH 3.5.14 pl_memulwrt2() Write to the PMC Address (unsigned long) MWACH

- pl_memc() Get Pointer to the PMC Address (char *) - - pl_mems() Get Pointer to the PMC Address (short *) - - pl_meml() Get Pointer to the PMC Address (long *) - - pl_memuc() Get Pointer to the PMC Address (unsigned char *) - - pl_memus() Get Pointer to the PMC Address (unsigned short *) - - pl_memul() Get Pointer to the PMC Address (unsigned long *) - - pl_membrd() Read from the PMC Address - - pl_membwrt() Write to the PMC Address - - pl_memc2() Get Pointer to the PMC Address (char *) - - pl_mems2() Get Pointer to the PMC Address (short *) - - pl_meml2() Get Pointer to the PMC Address (long *) - - pl_memuc2() Get Pointer to the PMC Address (unsigned char *) - - pl_memus2() Get Pointer to the PMC Address (unsigned short *) - - pl_memul2() Get Pointer to the PMC Address (unsigned long *) -



-21-

READ SYSTEM INFORMATION No. Name Content Available

task 3.6.1 pl_sysinfrd() Read CNC Information MWACH 3.6.2 pl_symcmt2() Read Symbol and Comment in LADDER Program

(16 characters symbol is available) MWACH

3.6.3 pl_symcmt() Read Symbol and Comment in LADDER Program MWACH 3.6.4 pl_message() Read a Message in LADDER Program MWACH


ACCESS TO THE EXTENDED NONVOLATILE MEMORY No. Name Content Available

task 3.7.1 pl_kpmrd() Read from the Extended Nonvolatile Memory MWACH 3.7.2 pl_kpmwrt() Write to the Extended Nonvolatile Memory MWACH 3.7.3 pl_kpmsiz() Get Size of the Extended Nonvolatile Memory MWACH


CHARACTER DISPLAY No. Name Content Available

task 3.8.4 pl_dspopen4() Initialize the Character Screen

(80 Columns x 30 Lines) M

3.8.5 pl_dspopen() Initialize a Character Screen (80 Columns x 25 Lines or 40 Columns x 16 Lines)

M

3.8.6 pl_dspclr() Erase the Entire Screen MW 3.8.7 pl_dspclrl() Clear Lines MW 3.8.8 pl_dspclrc() Clear Columns MW 3.8.9 pl_dsppos() Set a Display Position MW 3.8.10 pl_dspcolor() Set a Display Attribute MW 3.8.11 pl_dspattr() Change Attribute of the Characters Being Displayed MW 3.8.12 pl_dspstr() Display ASCII Characters MW 3.8.13 pl_dspstrw() Display Characters

(Kanji, Hiragana and Special Characters) MW

3.8.14 pl_dsptrblr() Display Hex Size Characters MW 3.8.15 pl_cursor() Display Cursor MW 3.8.16 pl_dspchar() Display Characters

(ASCII, Kanji and Hiragana) MW

3.8.17 pl_dspsave() Save the Character Screen MW 3.8.18 pl_dspresave() Restore the Character Screen MW 3.8.19 pl_dspcntl() Control the Screen MW 3.8.20 pl_backcolor() Set Background Color of the Character Screen MW 3.8.21 pl_dsppalette() Set Palette for Character Screen MW 3.8.22 pl_dspopen2() Initialize the Character Screen

(74 Columns x 27 Lines) M

3.8.23 pl_dspopen3() Initialize the Character Screen (74 Columns x 30 Lines)

M

3.8.24 initreq_printf() Initialize printf() MW M: Main Task, W: Window Task, A: Alarm Task, C: Communication Task, H: High-level Task, -: Not supported


-22-

GRAPHIC DISPLAY No. Name Content Available

task 3.9.3 pl_grpopen() Open the Graphic Screen M 3.9.4 pl_grpclose() Close the Graphic Screen M 3.9.5 pl_grpclr() Clear the Graphic Screen MW 3.9.6 pl_grpdspon() Display or Hide the Graphic Screen MW 3.9.7 pl_grplntyp() Set a Graphic Line Type MW 3.9.8 pl_grpcolor() Set a Graphic Color MW 3.9.9 pl_grpline() Draw Straight Lines MW 3.9.10 pl_grparc() Draw an Arc MW 3.9.11 pl_paint() Paint MW 3.9.12 pl_grpsft() Shift MW 3.9.13 pl_grpstatus() Get Graphic Screen Status MW 3.9.14 pl_grpclr2() Erase the Square MW 3.9.15 pl_grppalette() Set Palette for the Graphic Screen MW

- pl_grpopen2() Open the Graphic Screen (432 dots x 592 dots) - M: Main Task, W: Window Task, A: Alarm Task, C: Communication Task, H: High-level Task, -: Not supported

READER / PUNCHER INTERFACE No. Name Content Available

task

3.10.1 pl_rsopen2() Open the Reader / Puncher Interface C 3.10.2 pl_rsclose2() Close the Reader / Puncher Interface C 3.10.3 pl_rsrd2() Read from the Reader / Puncher Interface C 3.10.4 pl_rswrt2() Write to the Reader / Puncher Interface C 3.10.5 pl_fopen2() Open the Reader / Puncher Interface

(for FANUC Handy File) C

3.10.6 pl_fdir2() Get the File Information C 3.10.7 pl_fdel2() Delete the File C 3.10.8 pl_rsopen() Open the Reader / Puncher Interface C 3.10.9 pl_rsclose() Close the Reader / Puncher Interface C

3.10.10 pl_rsrd() Read from the Reader / Puncher Interface C 3.10.11 pl_rswrt() Write to the Reader / Puncher Interface C 3.10.12 pl_fopen() Open the Reader / Puncher Interface

(for FANUC Handy File) C

3.10.13 pl_fdir() Get the File Information C 3.10.14 pl_fdel() Delete the File C



-23-

CNC WINDOW No. Name Content Available

task 3.11.1 pl_nc_windr() CNC Window Function (Read) No. 23, 24,

25, 26, 27, 28, 29, 30, 31, 34, 50,

153 MWACH

Others MWAC

3.11.2 pl_nc_windw() CNC Window Function (Write) MWAC - pl_exin() External Data Input -


CNC PROGRAM No. Name Content Available

task 3.12.1 pl_nc_dwnstart2() Start Registration of the CNC Program MWAC 3.12.2 pl_nc_download2() Register the CNC Program MWAC 3.12.3 pl_nc_dwnend2() End Registration of the CNC Program MWAC

- pl_nc_vrfstart2() Start Verification of the CNC Program - - pl_nc_verify2() Verify the CNC Program - - pl_nc_vrfend2() End Verification of the CNC Program -

3.12.4 pl_nc_dncstart2() Start DNC running of the CNC Program MWAC 3.12.5 pl_nc_dnc2() Run the CNC Program (DNC running) MWAC 3.12.6 pl_nc_dncend2() End DNC Running of the CNC Program MWAC 3.12.7 pl_nc_search2_8d() Search the CNC Program

(Supported 8 Digits Program Number) MWAC

3.12.8 pl_nc_search2() Search the CNC Program MWAC 3.12.9 pl_nc_delall2() Delete All CNC Programs MWAC

3.12.10 pl_nc_delete2_8d() Delete the CNC Program (Supported 8 Digits Program Number)

MWAC

3.12.11 pl_nc_delete2() Delete the CNC Program MWAC 3.12.12 pl_nc_upstart2_8d() Start Reading of the CNC Program


3.12.13 pl_nc_upstart2() Start Reading of the CNC Program MWAC 3.12.14 pl_nc_upload2() Read the CNC Program MWAC 3.12.15 pl_nc_upend2() End Reading of the CNC Program MWAC 3.12.16 pl_nc_dir2() Read the CNC Program Memory Information MWAC 3.12.17 pl_nc_pdirstart2_8d() Start Reading of the CNC Program List


3.12.18 pl_nc_pdirstart2() Start Reading of the CNC Program List MWAC 3.12.19 pl_nc_progdir2() Read the CNC Program List MWAC 3.12.20 pl_nc_pdirend2() End Reading of the Program List MWAC 3.12.21 pl_nc_dwnstart() Start Registration of the CNC Program MWAC 3.12.22 pl_nc_download() Register the CNC Program MWAC 3.12.23 pl_nc_dwnend() End Registration of the CNC Program MWAC

- pl_nc_vrfstart() Start Verification of the CNC Program - - pl_nc_verify() Verify the CNC Program - - pl_nc_vrfend() End Verification of the CNC Program -


-24-

No. Name Content Available task

3.12.24 pl_nc_dncstart() Start DNC running of the CNC Program MWAC 3.12.25 pl_nc_dnc() Run the CNC Program (DNC running) MWAC 3.12.26 pl_nc_dncend() End DNC Running of the CNC Program MWAC 3.12.27 pl_nc_search_8d() Search the CNC Program


3.12.28 pl_nc_search() Search the CNC Program MWAC 3.12.29 pl_nc_delall() Delete All CNC Programs MWAC 3.12.30 pl_nc_delete_8d() Delete the CNC Program


3.12.31 pl_nc_delete() Delete the CNC Program MWAC 3.12.32 pl_nc_upstart_8d() Start Reading of the CNC Program


3.12.33 pl_nc_upstart() Start Reading of the CNC Program MWAC 3.12.34 pl_nc_upload() Read the CNC Program MWAC 3.12.35 pl_nc_upend() End Reading of the CNC Program MWAC 3.12.36 pl_nc_dir() Read the CNC Program Memory Information MWAC 3.12.37 pl_nc_pdirstart_8d() Start Reading of the CNC Program List


3.12.38 pl_nc_pdirstart() Start Reading of the CNC Program List MWAC 3.12.39 pl_nc_progdir() Read the CNC Program List MWAC 3.12.40 pl_nc_pdirend() End Reading of the Program List MWAC


CHARACTER CODE CONVERSION No. Name Content Available

task 3.13.1 pl_asciso() Convert Characters from ASCII to ISO Code MWACH 3.13.2 pl_isoasc() Convert Characters from ISO to ASCII Code MWACH



-25-

3.2 SYSTEM CALL

3.2.1 Read the Task Timer Value [Name]

os_show_tim

[Syntax] #include <oscall.h> void os_show_tim(unsigned long *time) ;

[Arguments] Input

--- Output

*time: Timer value

[Return] ---

[Description] This function reads a timer value. The unit of a timer value is the tick: one tick = eight msec. This function reads the timer value of the timer specific to each task. A timer value read with this function does not fully match the actually elapsed time. To simply read time, use the clock() function, which has a higher precision.


-26-

3.2.2 Set the Task Timer Value [Name]

os_set_tim

[Syntax] #include <oscall.h> void os_set_tim(unsigned long new_time, unsigned long *old_time);

[Arguments] Input

new_time: New timer value Output

*old_time: Old timer value

[Return] ---

[Description] This function sets a timer value. This function reads the timer value of the timer specific to each task. A timer value read with this function does not fully match the actually elapsed time. To simply read time, use the clock function, which has a higher precision.


-27-

3.2.3 Wait for the Timer Value [Name]

os_sync_tim

[Syntax] #include <oscall.h> unsigned short os_sync_tim(unsigned long wakeup_time);

[Arguments] Input

wakeup_time: Timer value Output

---

[Return] EC_TIMOUT: (0x011a) Normal termination.

[Description] This function makes the task wait until specified time comes. No other tasks can be held in wait state. This instruction does not return the error value 0. When specified time has come, the error value "EC_TIMOUT" is returned. Actually, the task is held for the period ("wakeup_time" - current time). If the "wakeup_time" is less than the current time (that is, if a past point time is specified), the task is not held in wait state. Before this function can be executed, the current time must be read using os_show_tim(). In wakeup_time, a value not greater than 7FFFFFFFh (198 days, 20 hours, 11 minutes, 9 seconds, and 180 msec) may be set. The unit of a time value to be specified in "wakeup_time" is the tick (= 8 msec).


-28-

3.2.4 Wait for Time [Name]

os_wait_tim

[Syntax] #include <oscall.h> unsigned short os_wait_tim(unsigned long timeout_value);

[Arguments] Input

timeout_value: Wait time Output

---

[Return] EC_TIMOUT: (0x011a) Normal completion

[Description] This function makes the task wait for a specified time. No other tasks can be held in wait state. This instruction does not return the error value 0. When specified time has come, the error value "EC_TIMOUT" is returned. The task is held in wait state for the time specified in "timeout_value". In "timeout_value", a value not greater than FFFFFFFFH (397 days, 16 hours, 22 minutes, 18 seconds, and 360 msec) may be set. The unit of a time value to be specified in "timeout_value" is the tick (= 8 msec).


-29-

3.2.5 Create an Event Flag [Name]

os_make_flg

[Syntax] #include <oscall.h> unsigned short os_make_flg(unsigned char event_flag_id);

[Arguments] Input

event_flag_id: Event flag ID Output

---

[Return] 0: Normal termination EC_FLGID: (0x0107) Event flag ID error EC_EXSTFLG: (0x0111) The event flag already exists.

[Description] This function creates an event flag. The size of an event flag is 32 bits. (Thirty-two flags make up one group.) Before an event flag can be used, this function must be issued.


-30-

3.2.6 Delete the Event Flag [Name]

os_delt_flg

[Syntax] #include <oscall.h> unsigned short os_delt_flg(unsigned char event_flag_id);

[Arguments] Input

event_flag_id: Event flag ID Output

---

[Return] 0: Normal termination EC_FLGID: (0x0107) Event flag ID error EC_NXSTFLG: (0x0112) The event flag does not exists.

[Description] This function deletes an event flag. The error code "EC_DELFLG" is returned to the task that possessed a deleted event flag.


-31-

3.2.7 Set the Event Flag [Name]

os_sign_flg

[Syntax] #include <oscall.h> unsigned short os_sign_flg(unsigned char event_flag_id,

unsigned long flag_on_message); [Arguments] Input

event_flag_id: Event flag ID flag_on_message: Flag pattern

Output ---

[Return]

0: Normal completion EC_FLGID: (0x0107) Event flag ID error EC_NXSTFLG: (0x0112) The event flag does not exists.

[Description] This function sets an event flag. A flag is recorded in the image of the event flag.


-32-

3.2.8 Wait for the Event Flag [Name]

os_wait_flg

[Syntax] #include <oscall.h> unsigned short os_wait_flg(unsigned char event_flag_id,

unsigned long wait_message, unsigned short and_or, long wait_limit, unsigned long *return_message);

[Arguments] Input

event_flag_id: Event flag ID wait_message: Flag pattern and_or: 0:AND,1:OR wait_limit: Be sure to set 0 (*).

Output return_message: When zero (AND) is set in "and_or", zero is

returned at all times. When one (OR) is set in "and_or", the signaled flags are returned.

[Return]

0: Normal completion EC_FLGID: (0x0107) Event flag ID error EC_NXSTFLG: (0x0112) The event flag does not exists. EC_DELFLG: (0x0117) The event flag was deleted.

[Description] This function makes the task wait until the event flag is signaled. When "AND_W(0)" is set in "and_or", an "AND" wait is specified. In this case, the system waits for all flags specified in "wait_message" to be signaled. When "OR_W(1)" is set, an "OR" wait is specified. In this case, the system waits for at least one of the flags specified in "wait_message" to be signaled.


-33-

3.2.9 Clear the Event Flag [Name]

os_clar_flg

[Syntax] #include <oscall.h> unsigned short os_clar_flg(unsigned char event_flag_id,

unsigned long clear_message);

[Arguments] Input

event_flag_id: Event flag ID clear_message: Flag pattern

Output ---

[Return] 0: Normal completion EC_FLGID: (0x0107) Event flag ID error EC_NXSTFLG: (0x0112) The event flag does not exists.

[Description] This function clears an event flag. The flag specified in "clear_message" of the image of an event flag is cleared.


-34-

3.2.10 Set the Event Flag (Pulse type) [Name]

os_puls_flg

[Syntax] #include <oscall.h> unsigned short os_puls_flg(unsigned char event_flag_id,

unsigned long puls_message);

[Arguments] Input

event_flag_id: Event flag ID puls_message: Flag pattern

Output ---

[Return] 0: Normal completion EC_FLGID: (0x0107) Event flag ID error EC_NXSTFLG: (0x0112) The event flag does not exists.

[Description] This function sets an event flag. A signaled flag is recorded in the image of the event flag.


-35-

3.2.11 Create a Semaphore

[Name] os_make_sem

[Syntax] #include <oscall.h> unsigned short os_make_sem(unsigned char semaphore_id, char

initial_value);

[Arguments] Input

semaphore_id: Semaphore ID initial_value: Initial value

Output ---

[Return] 0: Normal completion EC_SEMID: (0x0106 ) Semaphore ID error EC_EXSTSEM: (0x010f ) The semaphore already exists.

[Description] This function creates a semaphore.


-36-

3.2.12 Delete the Semaphore

[Name] os_delt_sem

[Syntax] #include <oscall.h> unsigned short os_delt_sem(unsigned char semaphore_id);

[Arguments] Input

semaphore_id: Semaphore ID Output

---

[Return] 0: Normal completion EC_SEMID: (0x0106) Semaphore ID error EC_NXSTSEM: (0x0110) The semaphore does not exists.

[Description] This function deletes a semaphore. The error code "EC_DELSEM" is returned to the task that was waiting for the deleted semaphore.


-37-

3.2.13 Set the Semaphore

[Name] os_sign_sem

[Syntax] #include <oscall.h> unsigned short os_sign_sem(unsigned char semaphore_id);

[Arguments] Input

semaphore_id: Semaphore ID Output

---

[Return] 0: Normal completion EC_SEMID: (0x0106) Semaphore ID error EC_NXSTSEM: (0x0110) The semaphore does not exists. EC_SEMOVF: (0x011c) Semaphore overflow

[Description] This function signals a semaphore. The counter is incremented. If the value of the counter is zero or less, the first task of the waiting task queue is placed in ready state.


-38-

3.2.14 Wait for the Semaphore

[Name] os_wait_sem

[Syntax] #include <oscall.h> unsigned short os_wait_sem(unsigned char semaphore_id,

long wait_limit) ;

[Arguments] Input

semaphore_id: Semaphore ID wait_limit: Be sure to set zero (*)

Output ---

[Return] 0: Normal completion. EC_SEMID: (0x0106) Semaphore ID error EC_NXSTSEM: (0x0110) The semaphore does not exists. EC_DELSEM: (0x0116) The semaphore was deleted. EC_SEMUDF: (0x011d) Semaphore underflow

[Description] This function makes the task wait until the semaphore is signaled. The counter is decremented. If the value of the counter is a negative value, the task is placed in wait state.


-39-

3.3 SWITCH SCREEN 3.3.1 Switch to the User Application Screen

[Name]

pl_pcmdi

[Syntax] #include <pmclib.h> void pl_pcmdi(void);

[Arguments] Input

--- Output

---

[Return] ---

[Description] When this function is executed, the screen display can be switched to the C application screen assigned to the custom key beforehand. Internally, crt_cncscrn(CRT_CUS_CEXE) of the C executor is called. So, when using this function, assign the C application screen to the custom key (CRT_CUS_CEXE) by using the crt_setuserscrn() function of the C executor. (See the sample program below.) If the C application screen is not assigned correctly, this function does not operate normally. /* MAIN task */ #include <crt.h> main() { int scrn_table[] = {CRT_CUS_CEXE}; crt_setuserscrn(scrn_tbl_size(scrn_table), scrn_table); }

[Related Function]

crt_cncscrn(), crt_setuserscrn()


-40-

3.3.2 Wait for Switching to the User Application Screen [Name]

pl_pcmdi_wait()

[Syntax] #include <pmclib.h> void pl_pcmdi_wait(void);

[Arguments] Input

--- Output

---

[Return] ---

[Description] This function is no operation. This function is provided for the keeping compatibility to the C program for "C language board" In "C executor", when a screen is changed from user application screen to other screen, the main task will automatically stop. If you develop a new application, you do not have to call this function.


-41-

3.3.3 Switch to the CNC Screen [Name]

pl_ncmdi

[Syntax] #include <pmclib.h> void pl_ncmdi(void);

[Arguments] Input

--- Output

---

[Return] ---

[Description] When this function is executed, the screen can be switched to the CNC absolute position screen Internally, crt_cncscrn(CRT_POS_ABS) of the C executor is called. When you want to switch another CNC screen, use crt_cncscrn() in the "C library for C executor".

[Related Function] crt_cncscrn()


-42-

3.4 MDI KEYS

3.4.1 MDI Key Code Table

0 1 2 3 4 5 6 7 0 SP 0 @ P 1 ! 1 A Q 2 " 2 B R 3 # 3 C S 4 $ 4 D T 5 % 5 E U 6 & 6 F V 7 ' 7 G W 8 ( 8 H X 9 TAB ) 9 I Y A EOB * : J Z B + ; K [ C , < L ¥ D - = M ] E . > N ~ F / ? O _

8 9 A B C D E F 0 RESET SKV1*1 F0*2 1 SKV2*1 F1*2 2 SKV3*1 F2*2 3 SKV4*1 F3*2 4 SHIFT INSERT SKV5*1 AUX F4*2 5 S.CAN*3 DELETE SKV6*1 F5*2 6 CAN ALTER SKV7*1 F6*2 7 A.CAN*4 ALT SKV8*1 F7*2 8 [→] INPUT SKV9*1 POS F8*2 9 [←] CALC PROG F9*2

A [↓] HELP OFFSET SETTING

B [↑] CTRL SYSTEM

C ABC/abc MESSAG

E

D GRAPH*5

E PAGE ↓

CUSTOM *5

FR*2 [ ]

F ↑

PAGE

FL*2 [ ]

" " indicates command key.


-43-

NOTE 1. The keys from "SKV1" through "SKV9" are virtual

soft keys. The bottom key is "SKV1". 2. The keys from "F0" through "F9" are horizontal soft

keys. From the left side, the keys are "FL", "F9"-"F0" and "FR". Please carefully that the order from "F0" to "F9" is different from the function in "C library for C executor".

3. The "S.CAN" is returned when a "SHIFT" key is released in "SHIFT" state.

4. The "A.CAN" is returned when a "CAN" key is pressed in "SHIFT" state.

5. The key code of the [GRAPH/CUSTOM] key on a small keyboard is "0xED". The key code of the [GRAPH] key on a normal keyboard is "0xED". The key code of the [CUSTOM] key on a normal keyboard is "0xEE".


-44-

3.4.2 Read key [Name]

pl_mdikey

[Syntax] #include <pmclib.h> short pl_mdikey(unsigned short * input_len, char * input_buffer);

[Arguments] Input

--- Output

input_len: Pointer to the variable to which the number of keyed characters is returned

input_buffer: Pointer to the array to which keyed characters are returned

[Return]

0: No key input 88H-FFH: Command key

[Description] This function reads the key. The function keys (E8H-EFH) cannot be read usually. However, if you execute the function pl_fkey_ign(), you can read it. You should set a pointer to the sufficient size of array to the "input_buffer". About the command key codes, refer to the "3.4.1 MDI Key Code Table". Note that the key code of the "INPUT" key is 98H in the "C library for conversion", but one is 0DH in the "C executor". Be careful when using the both libraries.

[Example]

/* MAIN task */ #include <stdlib.h> #include <pmclib.h> #define INPUT_KEY 0x98 long get_number(void) { long number; short ret; unsigned short len; char buf[256]; while(0 == (ret = pl_mdikey(&len, buf))) { os_wait_tim(32 /*msec*/ / 8); } if (ret == INPUT_KEY) {


-45-

number = strtol(buf, NULL, 0); } else { number = 0; } return number; }

[Related Function]

getchar(), getch()


-46-

3.4.3 Control a Key-in Line [Name]

pl_keydef

[Syntax] #include <pmclib.h> short pl_keydef(short * cntl);

[Arguments] Input

cntl: Key-in line control information

cntl +0 CF Key-in line control flag

+2 LN Maximum number of input characters +4 LA Display attribute +6 X Column position +8 Y Line position

+10 PN Number of prompt characters +12 PA Prompt display attribute +14 S1 S2 STRING: Prompt character string +16 S3 S4

... ... +30 S15 S16

NULL

#7 #6 #5 #4 #3 #2 #1 #0

CF KYMMK KYDSP KYDPS KYPRM

KYDSP: Echo-back display is:

= 0: Not provided = 1: Provided

KYDPS: The echo-back display position (valid when KYDSP = 1) is: = 0: Standard display position = 1: Changed

KYPRM: Prompt display (valid when KYDSP = 1) is: = 0: Not provided = 1: Provided

KYMMK: Display of ">" (valid when KYDSP = 1) is: = 1: Provided = 0: Not provided

LN: Maximum number of input characters Set the maximum allowable number of characters input on the key-in line (0 to 60). If 0, a negative value, or a value greater than 60 is set, the specification of 60 is assumed.


-47-

LA: Display attribute When echo-back display is to be provided on the key-in line (KYDSP = 1), set the attribute of characters. Normal attribute: Color code + 0x00 Reverse attribute: Color code + 0x10 Blink attribute: Color code + 0x08 Color code : Black:0x00, Red:0x20, Green:0x40, Yellow:0x60, Blue:0x80, Magenta:0xA0, Cyan:0xC0, White:0xE0

PA: Prompt display attribute When prompt display is to be provided (KYPRM = 1), set the attribute of prompt characters. Normal: Color code+0x00 Reverse: Color code+0x10 Blink: Color code+0x08 Color code: Black:0x00, Red:0x20, Green:0x40, Yellow:0x60, Blue:0x80, Magenta:0xA0, Cyan:0xC0, White:0xE0

X: Column position of the key-in line (0 to maximum display column position) When the key-in line display position is to be changed (KYDPS = 1), set a new column position. When the display position is not to be changed (KYDPS = 0), the column position is 0.

Y: Line position of the key-in line (0 to maximum display line position) When the key-in line display position is to be changed (KYDPS = 1), set a new line position. When the display position is not to be changed (KYDPS = 0), the line position will be 23.

PN: Number of prompt characters When prompt display is to be provided (KYPRM = 1), set the number of characters of a prompt character string. A value from 1 to 17 (including a NULL character) can be specified.

STRING: Prompt character string When prompt display is to be provided (KYPRM = 1), set a character string. In the case of access of short type, the byte order differs from that used with the C language board. Note that a character string is set in the order from a high byte to a low byte.

Output


-48-

---

[Return] 0: Normal completion.

[Description] This function sets the key-in line setting.

[Example] #include <pmclib.h> void setup_keyinline(void) { /* white, (x, y) = (40, 25) */ const short cntl[16] = {0x06, 40, 0xe0, 40, 25, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}; pl_keydef(cntl); }


-49-

3.4.4 Read Key Status [Name]

pl_keysts

[Syntax] #include <pmclib.h> short pl_keysts(short * code);

[Arguments] Input

--- Output

*code: Key code

code[0] Code1 code[1] Code2

code[0]: When a key is pressed, the key code of the key is

returned once instantly If the key is then held down, 0 is returned. If no key is pressed, 0 is returned.

code[1]: The value 0 is returned at all times.


[Description] When a key is pressed, this function reads the key code once. The read key code is stored in the "code[0]". If you keep pressing the key and call this function repeatedly, zero will be returned to the "code[0]". If the no key is pressed, zero will be returned to the "code[0]". If you press two keys simultaneously, the corresponding key codes are returned by the order of pressing of the keys. Zero is stored always in the "code[1]". Note that the behavior of this function differs from one in the "C library for C language board".

[Related Function]

kbhit(), getch(), getchar()


-50-

3.4.5 Disable Function Keys [Name]

pl_fkey_ign

[Syntax] #include <pmclib.h> void pl_fkey_ign(void);

[Arguments] Input

--- Output

---

[Return] ---

[Description] This function disables the switching screen by pressing the function keys. Even after this function is executed, you can switch screen by calling the pl_ncmdi() or the pl_pmcmdi(). Note that the keep relays K18#0 and K901#0 (IGNKEY), which are used in the "C library for C language board", are not supported in the "C library for conversion". This function is equivalent to the following function call of the "C executor": crt_setswt(CRT_SWT_MFKY | CRT_SWT_GREN | CRT_SWT_GRON);

[Related Function] crt_setswt()


-51-

3.4.6 Enable Function Keys [Name]

pl_fkey_avail

[Syntax] #include <pmclib.h> void pl_fkey_avail(void);

[Arguments] Input

--- Output

---

[Return] ---

[Description] This function enables the switching screen by pressing the function keys. Note that the keep relays K18#0 and K901#0 (IGNKEY), which are used in the "C library for C language board", are not supported in the "C library for conversion". This function is equivalent to the following function call of the C executor: crt_setswt(CRT_SWT_GREN | CRT_SWT_GRON);

[Related Function] crt_setswt()


-52-

3.4.7 Read a Function Key [Name]

pl_fkey_sts

[Syntax] #include <pmclib.h> short pl_fkey_sts(void);

[Arguments] Input

--- Output

---

[Return] 0: When a function key is disabled (after

pl_fkey_ign() is called), the function key is pressed.

1: No function key is pressed.

[Description] This function is to know if any function keys are pressed or not when the function key is disabled by calling the pl_fkey_ign(). If you read the key code of the function key, use the crt_readfkey() in the "C library for C executor".

[Related Function] crt_readfkey()

[Example] #include <pmclib.h> void check_fkey(void) { if (pl_fkey_sts() == 0) { pl_fkey_avail(); pl_ncmdi(); pl_pcmdi_wait(); } }


-53-

3.4.8 Disable Custom Keys [Name]

pl_fcustom_ign

[Syntax] #include <pmclib.h> void pl_fcustom_ign(void);

[Arguments] Input

--- Output

---

[Return] ---

[Description] This function performs no operation. On the "C executor", it is impossible to disable custom key input alone. Check if the crt_setswt(), pl_fkey_ign(), or pl_fkey_avail() for disabling a function key can be used instead.

[Related Function] crt_setswt ()


-54-

3.4.9 Enable Custom Keys [Name]

pl_fcustom_avail

[Syntax] #include <pmclib.h> void pl_fcustom_vail(void);

[Arguments] Input

--- Output

---

[Return] ---

[Description] This function performs no operation. On the "C executor", it is impossible to disable custom key input alone. Check if pl_fkey_ign() or pl_fkey_avail() for disabling a function key can be used instead.

[Related Function] crt_setswt ()


-55-

3.5 ACCESS TO THE PMC ADDRESS The byte order is different between "C executor" and "C language board" because they have different type of CPU. This means that the direct accessing using a pointer is not compatible between them. Therefore following functions in "C library for conversion" is unavailable. ・ pl_memc(), pl_memuc(), pl_mems(), pl_memus(), pl_meml(),

pl_memul() ・ pl_memc2(), pl_memuc2(), pl_mems2(), pl_memus2(),

pl_meml2(), pl_memul2() You should use functions "pmc_rdpmcrng()" and "pmc_wrpmcrng()" in "C library for C executor" or following new functions in "C library for conversion" ・ pl_memcrd2(), pl_memucrd2(), pl_memsrd2(), pl_memusrd2(),

pl_memlrd2(), pl_memulrd2() ・ pl_memcwrt2(), pl_memucwrt2(), pl_memswrt2(),

pl_memuswrt2(), pl_memlwrt2(), pl_mwmulwrt2() The example using "C library for conversion" is shown below. Before) num = *pl_mems2(id, offset); num |= 0x8000; *pl_mems2(id, offset) = num; After) num = pl_memsrd2(id, offset, NULL); num |= 0x8000; pl_memswrt2(id, offset, num); NOTE All functions in this section can access a PMC

address on 1st PMC, cannot access it on 2nd or 3rd PMC.


-56-

3.5.1 Read from the PMC Address (bit) [Name]

pl_membrd2

[Syntax] #include <pmclib.h> short pl_membrd2(unsigned short id, unsigned short offset, unsigned

short bit);

[Arguments] Input

id: PMC address ID G:0, F:1, Y:2, X:3, A:4, R:5, T:6, K:7, C:8, D:9, M:10, N:11, E:12

offset: PMC address offset bit: PMC address bit position (0-7)

Output ---

[Return] 0: The specified bit is OFF. 1: The specified bit is ON. -1: The specification of "id", "offset", or "bit" is

invalid.

[Description] This function reads bit from the PMC address.

[Related Function] pmc_rdpmcrng(), pmc_wrpmcrng()


-57-

3.5.2 Write to the PMC Address (bit) [Name]

pl_membwrt2

[Syntax] #include <pmclib.h> short pl_membwrt2(unsigned short id, unsigned short offset, unsigned

short bit, short status);

[Arguments] Input


offset: PMC address offset bit: PMC address bit position (0-7) status: Write value (0 or 1)

Output ---

[Return] 0: Normal completion. -1: The specification of "id", "offset", or "bit" is

invalid.

[Description] This function writes the bit value to the PMC address.



-58-

3.5.3 Read from the PMC Address (char) [Name]

pl_memcrd2

[Syntax] #include <pmclib.h> char pl_memcrd2(unsigned short id, unsigned short offset, short *

error);

[Arguments] Input


offset: PMC address offset Output

*error: Completion code 0: Terminated normally. –1: The specification of "id" or "offset" is invalid. If a NULL pointer is specified for "error", no completion code is returned.

[Return]

A read value is returned. When the function is terminated abnormally, 0 is returned.

[Description] This function reads "char" type value from the PMC address.


[Example] /* Read the value of R800 as a char type value */ #define SIGNAL_R 5 short error; char data; data = pl_memcrd2(SIGNAL_R, 800, &error); if (error != 0) { /* error handling */ }


-59-

3.5.4 Read from the PMC Address (short) [Name]

pl_memsrd2

[Syntax] #include <pmclib.h> short pl_memsrd2(unsigned short id, unsigned short offset, short *

error);

[Arguments] Input

id: PMC ADDRESS ID G:0, F:1, Y:2, X:3, A:4, R:5, T:6, K:7, C:8, D:9, M:10, N:11, E:12



[Return]


[Description] This function reads "short" type value from the PMC address.



-60-

3.5.5 Read from the PMC Address (long) [Name]

pl_memlrd2

[Syntax] #include <pmclib.h> long pl_memlrd2(unsigned short id, unsigned short offset, short *

error);

[Arguments] Input




[Return]


[Description] This function reads "long" type value from the PMC address.



-61-

3.5.6 Read from the PMC Address (unsigned char) [Name]

pl_memucrd2

[Syntax] #include <pmclib.h> unsigned char pl_memucrd2(unsigned short id, unsigned short offset,

short * error);

[Arguments] Input




[Return]


[Description] This function reads "unsigned char" type value from the PMC address.



-62-

3.5.7 Read from the PMC Address (unsigned short) [Name]

pl_memusrd2

[Syntax] #include <pmclib.h> unsigned short pl_memusrd2(unsigned short id, unsigned short offset,

short * error);

[Arguments] Input




[Return]


[Description] This function reads "unsigned short" type value from the PMC address.



-63-

3.5.8 Read from the PMC Address (unsigned long) [Name]

pl_memulrd2

[Syntax] #include <pmclib.h> unsigned long pl_memulrd2(unsigned short id, unsigned short offset,

short * error);

[Arguments] Input




[Return]


[Description] This function reads "unsigned long" type value from the PMC address.



-64-

3.5.9 Write to the PMC Address (char) [Name]

pl_memcwrt2

[Syntax] #include <pmclib.h> short pl_memcwrt2(unsigned short id, unsigned short offset, char

data);

[Arguments] Input


offset: PMC address offset data: Write value

Output ---

[Return] 0: Normal completion. -1: The specification of "id" or "offset" is invalid.

[Description]

This function writes "char" type value to the PMC address.


[Example] /* Write 100 to R800 as a char type value */ #define SIGNAL_R 5 short error; short ret; ret = pl_memcwrt2(SIGNAL_R, 800, 100); if (ret != 0) { /* error handling */ }


-65-

3.5.10 Write to the PMC Address (short) [Name]

pl_memswrt2

[Syntax] #include <pmclib.h> short pl_memswrt2(unsigned short id, unsigned short offset, short

data);

[Arguments] Input



Output ---


[Description] This function writes "short" type value to the PMC address.



-66-

3.5.11 Write to the PMC Address (long) [Name]

pl_memlwrt2

[Syntax] #include <pmclib.h> short pl_memlwrt2(unsigned short id, unsigned short offset, long

data);

[Arguments] Input



Output ---


[Description] This function writes "long" type value to the PMC address.



-67-

3.5.12 Write to the PMC Address (unsigned char) [Name]

pl_memucwrt2

[Syntax] #include <pmclib.h> short pl_memucwrt2(unsigned short id, unsigned short offset,

unsigned char data);

[Arguments] Input



Output ---


[Description] This function writes "unsigned char" type value to the PMC address.



-68-

3.5.13 Write to the PMC Address (unsigned short) [Name]

pl_memuswrt2

[Syntax] #include <pmclib.h> short pl_memuswrt2(unsigned short id, unsigned short offset,

unsigned short data);

[Arguments] Input



Output ---


[Description] This function writes "unsigned short" type value to the PMC address.



-69-

3.5.14 Write to the PMC Address (unsigned long) [Name]

pl_memulwrt2

[Syntax] #include <pmclib.h> short pl_memulwrt2(unsigned short id, unsigned short offset,

unsigned long data);

[Arguments] Input



Output ---


[Description] This function writes "unsigned long" type value to the PMC address.



-70-

3.6 READ SYSTEM INFORMATION 3.6.1 Read CNC Information

[Name]

pl_sysinfrd

[Syntax] #include <pmclib.h> short pl_sysinfrd(unsigned short id)

[Arguments] Input

id: Read data type ID

ID (id)

Data type Return value

Description

0 CNC model 0 Series 30i MODEL-A 1 CNC type 0-0x0f

0x10-0x1f 0x20-0x2f 0x30-0x3f 0x40-0x4f

Machining system Lathe system Multi-path lathe system Multi-path machining system Multi-path compound system

2 CRT type 6 9

14" 9"

3 KEY type 0 0 is always returned. 4 Total number

of axes (1st path)

n Total number of axes on 1st path

5 (reserved) - 86 Total number

of axes (2nd path)

n Total number of axes on 2nd path

87 (reserved) -

Output

---

[Return] Other than -1: Read data –1: The specification of "id" is invalid.

[Description] This function reads various CNC information items. The return values related to some types of "id" are different from "C library for C language board".

[Related Function] cnc_sysinfo(), crt_gettype(), cnc_setpath()


-71-

3.6.2 Read Symbol and Comment in LADDER Program (16 characters symbol is available) [Name]

pl_symcmt2

[Syntax] #include <pmclib.h> unsigned short pl_symcmt2(unsigned char id,

unsigned char type, unsigned short offset, unsigned short bit, unsigned char * symbol, unsigned char * comment, unsigned char * size);

[Arguments] Input


type: 0: Byte address 1: Bit address


Output *symbol: Read symbol string (up to 17 characters including

a NULL character) *comment: Read comment string(up to 31 characters including

a NULL character) *size: Comment string size (not including a NULL

character)

[Return] 0: Normal completion 1: The "id", "type", "offset" or "bit" is invalid, or

there is no sequence program.

[Description] This function reads a symbol or comment of the specified PMC address. Up to 16 symbol characters can be read. Up to 30 comment characters can be read. At the end of the read character string "*symbol" or "*comment", a NULL character ('¥0') is added. For a "symbol", set a pointer to an array not smaller than 17 characters. For a "comment", set a pointer to an array not smaller than 31 characters.


-72-

If no symbol or comment is defined, a NULL character ('¥0') is returned as "*symbol" or "*comment". NOTE 1. This function can read a symbol or comment in 1st

PMC, cannot read it in 2nd or 3rd PMC. 2. This function cannot read a extended symbol or

extended comment.

[Example] /* Read a bit symbol and comment from R800.0 */ #define SIGNAL_R 5 char symbol[17]; char comment[31]; unsigned short size; unsigned short ret; ret = pl_symcmt2(SIGNAL_R, 1, 800, 0, &symbol, &comment, &size); if (ret == 0) { printf("SYMBOL: %s¥n", symbol); printf("COMMENT: %s¥n", comment); }


-73-

3.6.3 Read Symbol and Comment in LADDER Program [Name]

pl_symcmt

[Syntax] #include <pmclib.h> unsigned short pl_symcmt(unsigned char id,

unsigned char type, unsigned short offset, unsigned short bit, unsigned char * symbol, unsigned char * comment, unsigned char * size);

[Arguments] Input


type: 0: Byte address 1: Bit address


Output *symbol: Read symbol string (up to 7 characters including a

NULL character) *comment: Read comment string(up to 31 characters including

a NULL character) *size: Comment string size (not including a NULL

character)

[Return] 0: Normal completion. 1: The "id", "type", "offset" or "bit" is invalid, or

there is no sequence program.

[Description] This function reads a symbol or comment of the specified PMC address. Up to 6 symbol characters can be read. Up to 30 comment characters can be read. At the end of the read character string "*symbol" or "*comment", a NULL character ('¥0') is added. For a "symbol", set a pointer to an array not smaller than 7 characters. For a "comment", set a pointer to an array not smaller than 31 characters.


-74-

If no symbol or comment is defined, a NULL character ('¥0') is returned as "*symbol" or "*comment". NOTE 1. This function can read a symbol or comment in 1st

PMC, cannot read it in 2nd or 3rd PMC. 2. This function cannot read a extended symbol or

extended comment.

[Example] /* Read a bit symbol and comment from R800.0 */ #define SIGNAL_R 5 char symbol[7]; char comment[31]; unsigned short size; unsigned short ret; ret = pl_symcmt(SIGNAL_R, 1, 800, 0, &symbol, &comment, &size); if (ret == 0) { printf("SYMBOL: %s¥n", symbol); printf("COMMENT: %s¥n", comment); }


-75-

3.6.4 Read a Message in LADDER Program [Name]

pl_message

[Syntax] #include <pmclib.h> unsigned short pl_message(unsigned short offset,

unsigned short bit, unsigned char * message, unsigned short * size);

[Arguments]

Input offset: "A" address offset bit: "A" address bit position (0-7)

Output *message: Read message (up to 256 characters including a

NULL character) *size: Number of characters of a read message (not

including a NULL character)

[Return] 0 Normal completion. 1 The "offset" or "bit" is invalid.

[Description]

This function reads a message of the specified PMC address 'A'. At the end of a read message string, a NULL character ('¥0') is added. For "message", set a pointer to an array not smaller than 256 characters. If no message is defined, only NULL character ('¥0') is returned to "*message". NOTE This function can read a message in 1st PMC,

cannot read it in 2nd or 3rd PMC.

[Example] /* Read a message defined at A10.0 */ char message[256]; unsigned short size; unsigned short ret; ret = pl_message(10, 0, message, &size); if (ret == 0) { printf("message[] = %s¥n", message); }


-76-

3.7 ACCESS TO THE EXTENDED NONVOLATILE MEMORY 3.7.1 Read from the Extended Nonvolatile Memory

[Name]

pl_kpmrd

[Syntax] #include <pmclib.h> short pl_kpmrd(unsigned long offset,

char * data, unsigned short size);

[Arguments] Input

offset: Read start offset size: Number of bytes to be read

Output *data: Read data

[Return] 0: Normal completion. 2: The "offset" or "size" is invalid. 6: No option

[Description] This function reads data from the extended nonvolatile memory. In "data", set an array that is not smaller than the value specified in "size".

[Related Function] pmc_rdkpm(), pmc_wrkpm(), pmc_kpmsiz()

[Example]

/* Read 1KB from offset 0 */ char data[1024]; short ret; ret = pl_kpmrd(0, data, sizeof(data)); if (ret != 0) { /* error handling */ }


-77-

3.7.2 Write to the Extended Nonvolatile Memory [Name]

pl_kpmwrt

[Syntax] #include <pmclib.h> short pl_kpmwrt(unsigned long offset,

char * data, unsigned short size);

[Arguments] Input

offset: Write start offset *data: Write data size: Number of bytes to be written

Output ---

[Return] 0: Normal completion. 2: The "offset" or "size" is invalid. 6: No option

[Description] This function writes data to the extended nonvolatile memory.


[Example] /* Clear 10 bytes from offset 0 to zeros */ short ret; const char data[10]={0, 0, 0, 0, 0, 0, 0, 0, 0, 0}; ret = pl_kpmwrt(0, data, sizeof(data)); if (ret != 0) { /* error handling */ }


-78-

3.7.3 Get Size of the Extended Nonvolatile Memory [Name]

pl_kpmsiz

[Syntax] #include <pmclib.h> unsigned long pl_kpmsiz(void);

[Arguments] Input

--- Output

---

[Return] 0: No option Other than 0: Number of bytes of the extended nonvolatile

memory

[Description] This function reads the total size of the extended nonvolatile memory.


[Example] unsigned long size; size = pl_kpmsiz(); printf("NONVOLATILE MEMORY SIZE = %d bytes¥n", size);


-79-

3.8 CHARACTER DISPLAY 3.8.1 Color Palette for the Character Display

On the character screen, you can set current color by the palette number, from 0 to 15. The correspondence of the palette number to the default color is shown below.

Palette number

Color R G B

0 Black 0 0 0 1 Red 0x3f 0 0 2 Green 0 0x3f 0 3 Yellow 0x3f 0x3f 0 4 Blue 0 0 0x3f 5 Magenta 0x3f 0 0x3f 6 Cyan 0 0x3f 0x3f 7 White 0x3f 0x3f 0x3f 8 Dark gray 0x18 0x18 0x18 9 Dark red 0x1c 0x0c 0x0c

10 Dark green 0x0c 0x1c 0x0c 11 Dark yellow 0x1c 0x1c 0x0c 12 Dark blue 0x0c 0x0c 0x1c 13 Dark magenta 0x1c 0x0c 0x1c 14 Dark cyan 0x0c 0x1c 0x1c 15 Light gray 0x28 0x28 0x28


-80-

3.8.2 Coordinates of the Character Screen Coordinates of the character screen, 80 columns and 30 lines mode, is shown below.

The coordinates of character screen (80 columns * 30 lines) X 0 1 2 3 . . . . . 76 77 78 79 0 1 2 3 . .

Y . . . . 25 26 28 29


-81-

3.8.3 Character Code

NOTE 1. Graph characters, marked with , can be

displayed with the graph character mode. 2. About the KANJI code, refer to "1 CHARACTER

CODE (KANJI, HIRAGANA AND OTHERS)".


-82-

3.8.4 Initialize the Character Screen (80 Columns x 30 Lines) [Name]

pl_dspopen4

[Syntax] #include <pmclib.h> short = pl_dspopen4(void);

[Arguments] Input

--- Output

---

[Return] 0: Normal completion. 3: The display unit does not allow this display mode

to be set.

[Description] This function initializes the character screen with the mode of 80 columns × 30 lines. This function is usable with a display unit of VGA type only. This function is equivalent to the following function call: crt_setmode(CRT_MODE_V30); The initialization flag for R9072 used on the "C library for C language board" is no longer used. Therefore, R9072 need not be set.

[Related Function] crt_setmode()


-83-

3.8.5 Initialize a Character Screen (80 Columns x 25 Lines or 40 Columns x 16 Lines) [Name]

pl_dspopen

[Syntax] #include <pmclib.h> short pl_dspopen(void);

[Arguments] Input

--- Output

---


[Description] This function initializes the character screen. On a display unit with 12 horizontal soft keys, the screen mode will be "80 Columns x 25 Lines" and this function is equivalent to the following function call: crt_setmode(CRT_MODE_80X25); On a display unit with seven horizontal soft keys, the screen mode will be "40 Columns x 16 Lines" and this function is equivalent to the following function call: crt_setmode(CRT_MODE_40X16);

[Related Function] crt_setmode()


-84-

3.8.6 Erase the Entire Screen [Name]

pl_dspclr

[Syntax] #include <pmclib.h> short pl_dspclr(void);

[Arguments] Input

--- Output

---


[Description] This function clears the entire character screen. Graphic display is not cleared. This function is equivalent to the following function call: printf("¥x1b[2J"];

[Related Function] Escape sequence (ESC[2J]


-85-

3.8.7 Clear Lines [Name]

pl_dspclrl

[Syntax] #include <pmclib.h> short pl_dspclrl(short * cntl);

[Arguments] Input

*cntl: Control information

cntl[0] Clear start line (Y) 0 to cntl[1] Number of lines

Output ---

[Return] 0: Normal completion. 5: The "*cntl" is invalid.

[Description] This function clears the specified lines on the character screen.

[Related Function] Escape sequence (ESC[2K]

[Example] /* Clear four lines from line 0 */ short ret; short cntl[2] = {0, 4}; ret = pl_dspclrl(cntl); if (ret != 0) { /* error handling */ }


-86-

3.8.8 Clear Columns [Name]

pl_dspclrc

[Syntax] #include <pmclib.h> short pl_dspclrc(short * cntl);

[Arguments] Input


cntl[0] Start column (X) 0 to cntl[1] Start line (Y) 0 to cntl[2] Number of columns

Output ---


[Description] This function clears the specified columns on the character screen.

[Related Function] Escape sequence (ESC[0K, ESC[1K, ESC[2K]

[Example] /* Clear 10 columns from line 0 and column 40 */ short ret; short cntl[3] = {0, 40, 10}; ret = pl_dspclrc(cntl); if (ret != 0) { /* error handling */ }


-87-

3.8.9 Set a Display Position [Name]

pl_dsppos

[Syntax] #include <pmclib.h> short pl_dsppos(short * cntl);

[Arguments] Input


cntl[0] Column (X) 0 to cntl[1] Line (Y) 0 to

Output ---


[Description] This function sets a current display position on the character screen. This function is equivalent to the following function call: printf("¥x1b[%d;%dH", cntl[1]+1, cntl[0]+1]

[Related Function] Escape sequence (ESC[y;xH)

[Example] /* Set a display position at line 4 and column 2 */ short ret; short cntl[2] = {2, 4}; ret = pl_dsppos(cntl); if (ret != 0) { /* error handling */ }


-88-

3.8.10 Set a Display Attribute [Name]

pl_dspcolor

[Syntax] #include <pmclib.h> short pl_dspcolor(short * cntl);

[Arguments] Input


cntl[0] Color code 0 to cntl[1] Reverse setting 0 to

cntl[0]: Color code

Black:0x00, Red:0x20, Green:0x40, Yellow:0x60, Blue:0x80, Magenta:0xA0, Cyan:0xC0, White:0xE0

cntl[1]: Reverse setting Normal:0x00, Reverse:0x10

Output ---


[Description] This function sets a current display color and reverse attribute on the character screen.

[Related Function] Escape sequence (ESC[nm]


-89-

3.8.11 Change Attribute of the Characters Being Displayed [Name]

pl_dspattr

[Syntax] #include <pmclib.h> short pl_dspattr(short * cntl);

[Arguments] Input


cntl[0] Start column (X) 0 to cntl[1] Start line (Y) 0 to cntl[2] Attribute cntl[3] Number of columns

cntl[0]: Set a column position where to start changing the

attribute (X = 0 and up). cntl[1]: Set a line position where to start changing the

attribute (Y = 0 and up). cntl[2]: Set a color and display attribute.

Normal: Color code + 0x00 Blink: Color code + 0x08 Reverse: Color code + 0x10 Color code: Black:0x00, Red:0x20, Green:0x40, Yellow:0x60, Blue:0x80, Magenta:0xA0, Cyan:0xC0, White:0xE0

cntl[3]: Set the number of columns whose display attribute is to be changed.

Output ---


[Description] This function changes the attribute (color, blink or reverse) of characters already displayed on the screen. This function does not affect the current display attribute that is set by pl_dspcolor().

[Related Function] crt_settextattr()


-90-

3.8.12 Display ASCII Characters [Name]

pl_dspstr

[Syntax] #include <pmclib.h> short pl_dspstr(short attr, char * str, unsigned short size);

[Arguments] Input

attr: Display attribute Normal: 0x18 Blink: 0x17

*str: Character string to be displayed (up to 101 characters including a NULL character) Set a NULL character ('¥0') at the end of a character string.

size: Number of characters (up to 100) Output

---

[Return] 0: Normal completion. 5: The "attr", "*str" or "size" is invalid.

[Description] This function displays one-byte characters such as ASCII characters.

[Related Function] putchar(), puts(), printf(), Escape sequence


-91-

3.8.13 Display Characters (Kanji, Hiragana and Special Characters) [Name]

pl_dspstrw

[Syntax] #include <pmclib.h> short pl_dspstrw(short attr, short * str, unsigned short size);

[Arguments] Input


*str: Character string to be displayed (up to 101 characters including a NULL character) Set a character string by using the shift JIS code. Set 0 at the end of a character string. This argument functions as a pointer to data of short type. However, it is recommended that character codes be set in arrays of character type and a pointer to the array be set in this argument, as in the example of programming indicated below. In this case, set one character in a set of two arrays (a set of two bytes). Specifically, when setting a two-byte character, set the first byte of the character code in index 2n of an array of character type, and set the second by of the character code in index 2n+1. When setting a one-byte character such as an ASCII character, set the character code in index 2n of an array of character type, and set 0 in index 2+1. When setting a character of a character string of two-byte characters in array str[n] of short type, for example, set the first byte of the character code in the high-order byte position of str[n] and set the second byte of the character code in the low-order byte position of str[n]. When setting a one-byte character such as an ASCII character, set the character code in the high-order byte position of str[n] and set 0 in the low-order byte position of str[n]. When setting a character string in a variable of short type, note that the byte order


-92-

differs from that used with the "C library for C language board".

size: Number of bytes of a specified character string

When calculating the number of bytes, remember that one character consists of two bytes. The maximum allowable number of bytes is 200.

Output ---

[Return] 0: Normal completion. 2: The "size" is invalid. 5: The "attr" or "*str" is invalid.

[Description] This function displays two-byte characters such as kanji, hiragana, and special characters.


[Example] /* Example of displaying the ASCII characters 'A' and the two-byte

character 'A' */ /* ASCII character 'A' = 0x41 */ /* 2bytes character 'A' = 0x82, 0x60 */ #include <pmclib.h> short ret; /* Using character array */ char strc[] = {0x41, 0x00, 0x82, 0x60, 0x00, 0x00}; ret = pl_dspstrw(0x18, (short *)strc, sizeof(strc)); if (ret != 0) { /* error handling */ }


-93-

3.8.14 Display Hex Size Characters [Name]

pl_dsptrblr

[Syntax] #include <pmclib.h> short pl_dsptrblr(short attr, char * str, unsigned short size);

[Arguments] Input


*str: Character string to be displayed (up to 101 characters including a NULL character) Set a NULL character ('¥0') at the end of a character string.

size: Number of bytes of a specified character string

Output ---

[Return] 0: Normal completion. 5: The "str" or "size" is invalid.

[Description] This function displays hex size characters. The displayable characters are uppercase alphabetic characters, numeric characters, "-" (minus), "." (period), and " " (space). With the "C library for C language board", this function is named "Display Triple Size Characters". On the "C executor", the display function equivalent to this function is named "Display Hex Size Characters". So, the same name is used in this library as well.

[Related Function] putchar(), puts(), printf(), Escape sequence (ESC(6)

[Example]

short ret; const char str[] = "012-. ABC"; ret = pl_dsptrblr(0x18, str, sizeof(str)); if (ret != 0) { /* error handling */ }


-94-

3.8.15 Display Cursor [Name]

pl_cursor

[Syntax] #include <pmclib.h> short pl_cursor(short * cntl);

[Arguments] Input


cntl[0] Column (X) 0 to cntl[1] Line (Y) 0 to cntl[2] Attribute cntl[3] Number of cursor

characters

cntl[0]: Set a column position for cursor display (X = 0 and

up). cntl[1]: Set a line position for cursor display (Y = 0 and

up). cntl[2]: Set the display attribute of the cursor. Attribute

Attribute Cursor type 0x0C 0x80

Underline cursor display

0x4C 0x6C

Blink underline cursor display

0x2C Clear cursor

cntl[3]: Set the number of cursor characters (up to 40 characters)

Output ---


[Description] This function displays or clears a cursor on the character screen. When clearing the cursor, specify the same argument values (column, line, the number of cursor characters) as used for display. Only one cursor may be displayed on the screen. The specification of this function is different from one of "C library for C language board".

[Related Function]


-95-

crt_2ndcursor() [Example]

/* Display cursor at the position, (X, Y) = (20, 3). */ short ret; short cntl_on[] = {20, 3, 0x0080, 10}; short cntl_off[] = {20, 3, 0x002c, 10}; ret = pl_cursor(cntl_on); /* print cursor */ if (ret != 0) { /* error handling */ } ret = pl_cursor(cntl_off); /* erase cursor */ if (ret != 0) { /* error handling */ }


-96-

3.8.16 Display Characters (ASCII, Kanji and Hiragana) [Name]

pl_dspchar

[Syntax] #include <pmclib.h> short pl_dspchar(short * cntl);

[Arguments] Input


cntl[0] Data size (N) cntl[1] Attribute (A) cntl[2] Character type (S) cntl[3] Column (X) 0 to cntl[4] Line (Y) 0 to cntl[5] XX XX Character

to cntl[n] XX XX

cntl[0]: Set the number of bytes in the character area

cntl[5] and up. cntl[1]: Set a color and display attribute.

Normal: Color code + 0x00 Blink: Color code + 0x08 Reverse: Color code + 0x10 Color code: Black:0x00, Red:0x20, Green:0x40, Yellow:0x60, Blue:0x80, Magenta:0xA0, Cyan:0xC0, White:0xE0

cntl[2]: Set a character type. 1: One-byte characters such as ASCII characters

2: Two-byte characters in the JIS code 3: Triple height and double width size characters 4: Mixture of one-byte characters and two-byte

characters in the shift JIS code 5: Graphic characters (character codes 0x85 to

0x8F) cntl[3]: Set a display start column position (0 and up). cntl[4]: Set a display start line position (0 and up). cntl[5]-cntl[n]: Set characters.

At the end of a character string, set a NULL character ('¥0"). The argument cntl represents a pointer to data of short type. However, it is recommended that the


-97-

character string area "cntl[5]" to "cntl[n]" be set via a pointer variable of character type as in the example of programming provided below.

Output ---

[Return] 0: Normal completion. 2: The "cntl[0]" is invalid. 5: The "cntl[2]" is invalid.

[Description] This function displays characters with a specified attribute at a specified position.


[Example] /* Example of displaying the ASCII characters 'A' and the two-byte

character 'A' */ /* ASCII character 'A' = 0x41 */ /* 2bytes character 'A' = 0x82, 0x60 */ #include <pmclib.h> short cntl[7]; char * pstr; cntl[0] = 4, cntl[1]=0xE0, cntl[2]=4, cntl[3]= 0, cntl[4]=0; pstr = &cntl[5]; strcpy(pstr, "A¥x82¥x60"); ret = pl_dspchar(cntl); if (ret != 0) { /* error handling */ }


-98-

3.8.17 Save the Character Screen [Name]

pl_dspsave

[Syntax] #include <pmclib.h> short pl_dspsave(short id, short * cntl, unsigned char * buf);

[Arguments] Input

id: Specify a screen save mode. 0: Saves the entire screen. 1: Saves a part (up to 80 characters) of the screen

to area 1. 2: Saves a part (up to 80 characters) of the screen




to area 5. *cntl: Control information Set this argument when a value from 1 to 5 is set in

"id". Set a NULL pointer when 0 is set in "id".

cntl[0] Column (X) 0 to cntl[1] Line (Y) 0 to cntl[2] Number of columns

(C) 1 to 80

Output

*buf: Save area Set a pointer to an array variable for saving the screen. The size required to save the screen is 4 bytes per column. So, when the entire screen is to be saved ("id" = 0), the size of a required save area is: 80 columns × 30 lines × 4 bytes = 9600 bytes.

[Return]

0: Normal completion. 3: The "id" is invalid. 5: The "cntl[0]", "cntl[1]" or "cntl[2]" is invalid.


-99-

[Description] This function saves a part of the character screen or the entire character screen to the memory. This function is used with pl_dspresave() to temporarily save or restore the character screen. Cursor display is not saved.

[Related Function] crt_gettextimg(), crt_puttextimg()

[Example] #include <pmclib.h> short ret; unsigned char buf[80*30*4]; ret = pl_dspsave(0, NULL, buf); if (ret != 0) { /* error handling */ } ret = pl_dspresave(0, buf); if (ret != 0) { /* error handling */ }


-100-

3.8.18 Restore the Character Screen [Name]

pl_dspresave

[Syntax] #include <pmclib.h> short pl_dspresave(short id, unsigned char * buf);

[Arguments] Input

id: Specify the restoration of the character screen. In "id", set the same value as used for execution of pl_dspsave().

0: Restores the entire screen. 1: Restores a part (up to 80 characters) of the

screen to area 1. 2: Restores a part (up to 80 characters) of the




screen to area 5. *buf: Save area Set a pointer to the same array variable as used for

execution of pl_dspsave().

Output ---

[Return] 0: Normal completion. 3: The "id" is invalid.

[Description] This function restores a part of the screen or the entire screen saved to the memory with pl_dspsave(). The cursor is not restored.

[Related Function] crt_gettextimg(), crt_puttextimg()


-101-

3.8.19 Control the Screen [Name]

pl_dspcntl

[Syntax] #include <pmclib.h> short pl_dspcntl(short id);

[Arguments] Input

id: 0: Sets the monochrome mode (without brightness modulation).

1: Sets gray scale display or color display. 2: Turns off the video signal. 3: Turn on the video signal. If a value other than 0 to 3 is set, the setting of 3 is

assumed.

Output ---


[Description] This function controls the screen.

[Related Function]

crt_setmode(), Escape sequence (ESC[9l, ESC[9h]


-102-

3.8.20 Set Background Color of the Character Screen [Name]

pl_backcolor

[Syntax] #include <pmclib.h> short pl_backcolor(short no);

[Arguments] Input

no: Palette specification Set the value of a palette number (0 to 15) × 0x20.

Output ---


[Description] This function sets the background color of the character screen. This function is usable with a display unit of VGA type only.

[Related Function] Escape sequence (ESC[4xm, ESC[3m, ESC[23m]


-103-

3.8.21 Set Palette for Character Screen [Name]

pl_dsppalette

[Syntax] #include <pmclib.h> short pl_dsppalette(long * cntl);

[Arguments] Input

*cntl: Palette color information Set color information for each palette. Set 0 in

"cntl[0]" for palette No. 0 at all times.

cntl[0] Color information for palette No. 0

0 at all times


to cntl[15] Color information for

palette No. 15

Set the "R" value, "G" value, and "B" value of each

palette in the format below. A value from 0 to 0x3F can be specified as a "R" value, "G" value, and "B" value.

bit 31 23 15 7

cntl[n] Set 0. "B" value "G" value "R" value

Output

---

[Return] 0: Normal completion. 3: The display unit is of other than VGA and XGA

types.

[Description] This function sets color information for each palette. This function is usable with a display unit of VGA or XGA type only.

[Related Function] crt_setallpalette()


-104-


pl_dspopen2


[Arguments] Input

--- Output

---


[Description] The display mode, "74 columns x 27 lines", is not supported. If you execute this function, the screen will be initialized with "80 columns x 30 lines" mode. This function is equivalent to the following function call: crt_setmode(CRT_MODE_V30);

[Related Function] crt_setmode ()


-105-


pl_dspopen3


[Arguments] Input

--- Output

---


[Description] The display mode, "74 columns x 30 lines", is not supported. If you execute this function, the screen will be initialized with "80 columns x 30 lines" mode. This function is equivalent to the following function call: crt_setmode(CRT_MODE_V30);

[Related Function] crt_setmode ()


-106-

3.8.24 Initialize printf() [Name]

initreq_printf

[Syntax] #include <pmclib.h> void initreq_printf(unsigned char task_id);

[Arguments] Input

--- Output

---


[Description] This function is no longer used. This function need not be called. If this function is called, the value 0 is returned without performing any processing.


-107-

3.9 GRAPHIC DISPLAY 3.9.1 Color Palette for Graphic Display

On the graphic screen, you can set current color by the palette number, from 0 to 15. The correspondence of the palette number to the default color is shown below.

Palette number

Color R G B

0 Black 0 0 0 1 Red 0x3f 0 0 2 Green 0 0x3f 0 3 Yellow 0x3f 0x3f 0 4 Blue 0 0 0x3f 5 Magenta 0x3f 0 0x3f 6 Cyan 0 0x3f 0x3f 7 White 0x3f 0x3f 0x3f 8 Dark gray 0x18 0x18 0x18 9 Dark red 0x1c 0x0c 0x0c

10 Dark green 0x0c 0x1c 0x0c 11 Dark yellow 0x1c 0x1c 0x0c 12 Dark blue 0x0c 0x0c 0x1c 13 Dark magenta 0x1c 0x0c 0x1c 14 Dark cyan 0x0c 0x1c 0x1c 15 Light gray 0x28 0x28 0x28


-108-

3.9.2 Coordinates of the Graphic Screen Coordinates of the graphic screen, 640 x 480 dots, are shown below.

The Coordinates of the graphic screen (640 x 480 dots) Y (0, 239)

X (-320, 0) (0, 0) (319, 0)

(0, -240)


-109-

3.9.3 Open the Graphic Screen [Name]

pl_grpopen

[Syntax] short pl_grpopen(void);

[Arguments] Input

--- Output

--- [Return]

0: Normal completion. 6: No graphic function

[Description] This function initializes graphic screen. The graphic screen is cleared. Before calling a graphic function, execute pl_grpopen(). When a series of graphic functions have been called, execute pl_grpclose().

[Related Function] crt_opengr(), _setvideomode(), crt_setswt(), _clearscreen(), crt_closegr()


-110-

3.9.4 Close the Graphic Screen [Name]

pl_grpclose

[Syntax] #include <pmclib.h> short pl_grpclose(void);

[Arguments] Input

--- Output

---


[Description] This function closes the graphic screen. When a series of graphic functions have been called, execute this function.

[Related Function] crt_closegr(), crt_opengr()


-111-

3.9.5 Clear the Graphic Screen [Name]

pl_grpclr

[Syntax] #include <pmclib.h> short pl_grpclr(void);

[Arguments] Input

--- Output

---


[Description] This function clears the entire graphic screen. At this time, the character screen is not cleared.

[Related Function]

_clearscreen()


-112-

3.9.6 Display or Hide the Graphic Screen [Name]

pl_grpdspon

[Syntax] #include <pmclib.h> short pl_grpdspon(short display);

[Arguments] Input

display: The graphic screen is displayed or hidden 0: Hides the graphic screen. 1: Displays the graphic screen.

Output ---

[Return] 0: Normal completion. 6: No graphic function

[Description] This function displays or hides the graphic screen. This function is equivalent to the following function call: #include <crt.h> crt_graphic(CRT_OFF_BEAM); /* display == 0 */ crt_graphic(CRT_ON_BEAM); /* display == 1 */

[Related Function] crt_graphic()


-113-

3.9.7 Set a Graphic Line Type [Name]

pl_grplntyp

[Syntax] #include <pmclib.h> short pl_grplntyp(short type);

[Arguments] Input

type: Line type 0: Solid line 1: Dashed line 2: Dot-dash line 3: Double-dot-dash line 4: Deletion line

Output ---


[Description] This function sets the current graphic line type. The setting is valid until the next line type is set. This function is equivalent to the following function call: #include <graph.h> _setlinestyle(0xffff); /* type == 0 */ _setlinestyle(0xf0f0); /* type == 1 */ _setlinestyle(0x0x3cff); /* type == 2 */ _setlinestyle(0x333f); /* type == 3 */ _setlinestyle(0x0000); /* type == 4 */

[Related Function] _setlinestyle()


-114-

3.9.8 Set a Graphic Color

[Name]

pl_grpcolor

[Syntax] #include <pmclib.h> short pl_grpcolor(short color);

[Arguments] Input

color: Palette number Set a palette number (0 to 15).

Output ---


[Description] This function sets the current graphic color. The setting is valid until the next color is set. This function is equivalent to the following function call: #include <graph.h> _setcolor(color);

[Related Function] _setcolor()


-115-

3.9.9 Draw Straight Lines [Name]

pl_grpline

[Syntax] #include <pmclib.h> short pl_grpline(short * cntl, unsigned short size);

[Arguments] Input

*cntl: Drawing information Set the start point and end of a straight line to be

drawn. On a VGA type display unit, the valid X coordinate ranges from -320 to 319, and the valid Y coordinate ranges from -240 to 239.

cntl[0] X Start point cntl[1] Y cntl[2] X End point 1 cntl[3] Y cntl[4] X End point 2 cntl[5] Y

to cntl[2n] X End point n

cntl[2n+1] Y

size: Number of bytes of drawing information ("*cntl") Set the number of bytes of the "*cntl" array above.

The minimum size is 8 bytes for "cntl[0]"-"cntl[3]". The size can be incremented in steps of 4 bytes.

Output ---

[Return] 0: Normal completion. 2: The "size" is invalid.

[Description] This function draws a straight line on the graphic screen.

[Related Function] _moveto(), _lineto()


-116-

3.9.10 Draw an Arc [Name]

pl_grparc

[Syntax] #include <pmclib.h> short pl_grparc(short * cntl, unsigned short size);

[Arguments] Input

*cntl: Drawing information Set parameters and the coordinates of a start point,

end points, and centers in the following format:

cntl[0] X Start point cntl[1] Y cntl[2] P Parameter 1 cntl[3] X End point 1 cntl[4] Y cntl[5] X Center 1 cntl[6] Y

to cntl[5n-3] P Parameter n cntl[5n-2] X End point n cntl[5n-1] Y

cntl[5n] X Center n cntl[5n+1] Y

Set a parameter in the following format:

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0

Unused (a) Unused

(a) Drawing direction 0: Clockwise, 1: Counterclockwise

size: Number of bytes of drawing information ("*cntl") Set the number of bytes of the "*cntl" array above.

The minimum size is 14 bytes for "cntl[0]"-"cntl[6]". The size can be incremented in steps of 10 bytes.

Output ---

[Return] 0: Normal completion. 2: The "size" is invalid.


-117-

[Description] This function draws an arc on the graphic screen.

[Related Function] _arc()


-118-

3.9.11 Paint [Name]

pl_paint

[Syntax] #include <pmclib.h> short pl_paint(short * cntl);

[Arguments] Input

*cntl: Drawing information Set drawing information in the following format:

cntl[0] X Start point cntl[1] Y cntl[2] P Parameter

cntl[2]: Parameter

Set palette number, 0 to 7, of the boundary of the area that you want to paint.

0: The palette number of the boundary is regarded as current palette number.

1-7: Palette number of the boundary Output

-

[Return] 0: Normal completion. 3: The "cntl[2]" is invalid. 6: No graphic function

[Description] The specific area on the graphic screen is painted with the current palette color. Its area should be defined by closed line and the start point must not be on the closed line. Set the palette number of the closed line to "cntl[2]".

[Related Function] _floodfill()


-119-

3.9.12 Shift [Name]

pl_grpsft

[Syntax] #include <pmclib.h> short pl_grpsft(short * cntl);

[Arguments] Input

*cntl: Shift value Set the shift value with the following format.

cntl[0] X Shift value (dot) cntl[1] Y

Output

-


[Description] Entire graphic screen is shifted but the coordinates system of the graphic screen is not shifted.

[Related Function] _imagesize(), _getimage(), _putimage()


-120-

3.9.13 Get Graphic Screen Status [Name]

pl_grpstatus

[Syntax] #include <pmclib.h> short pl_grpstatus(void);

[Arguments] Input

- Output

-

[Return] 0: Previous graphic screen is no longer available. You have to call the pl_grpopen() to initialize the

graphic screen and to draw graphic object again. 1: Previous graphic screen is available. You should call the pl_grpdspon() to display the

previous graphic screen.

[Description] To use this function, you can judge if you need to redraw the graphic screen or not when a screen is switched back to the application screen.

[Related Function] crt_opengr()


-121-

3.9.14 Erase the Square [Name]

pl_grpclr2

[Syntax] #include <pmclib.h> short pl_grpclr2(short * cntl);

[Arguments] Input

*cntl: Specification of the square Set the coordinates of the square with the

following format.

cntl[0] X1 Top-left (dot) cntl[1] Y1 cntl[2] X2 Bottom-right (dot) cntl[3] Y2

Output

-

[Return] 0: Normal completion 6: Abnormal completion

[Description] This function erases specific square area on the graphic screen. The character screen is not erased.

[Related Function] _rectangle()


-122-

3.9.15 Set Palette for the Graphic Screen [Name]

pl_grppalette

[Syntax] #include <pmclib.h> short pl_grppalette(long * cntl);

[Arguments] Input

*cntl: Palette color information Set color information for each palette. Set 0 in

cntl[0] for palette No. 0 at all times.


0 at all times


to cntl[15] Color information for

palette No. 15

Set the "R" value, "G" value, and "B" value of each

palette in the format below. A value from 0 to 0x3F can be specified as a "R" value, "G" value, and "B" value.

bit 31 23 15 7

cntl[n] Set 0. "B" value "G" value "R" value

Output

---


[Description] This function sets the color palette for the graphic screen.

[Related Function] _remapallpalette()


-123-

3.10 READER / PUNCHER INTERFACE There are three choices to use RS-232C communication functions. (1) You can use only functions named "pl_xxxx()" in "C library for

conversion". (2) You can use only functions named "pl_xxxx2()" in "C library for

conversion". (3) You can use only conventional functions in "C library for C

executor". Note that you cannot use above three types of functions together. We recommend that you choose (2) or (3).


-124-

3.10.1 Open the Reader / Puncher Interface [Name]

pl_rsopen2

[Syntax] #include <pmclib.h> short pl_rsopen2(short * cntl);

[Arguments] Input

*cntl: Control information Set the communication parameter for RS-232C as

following format.

cntl[0] OP Channel number, mode, flow control cntl[1] OB Baud rate cntl[2] OS Stop bits, Parity setting (Low byte)

DC3 code (High byte) cntl[3] OC Output code (Low byte)

Input code (High byte)

OP (cntl[0]): The channel number, mode and the method of flow

control Set the channel number of RS-232C, communication mode and the method of flow control as following format.

n: Bidirectional (Hardware flow control) Set the channel number of RS-232C to "n". In this

setting, the communication line is opened with bidirectional mode and controlled by the hardware flow control. No control code is output when the communication line is opened or closed. To use this setting, you can read or write binary data. The writing to the target device is flow-controlled by the "CS" signal from the target device. The reading from the target device is flow-controlled by the "RS" signal from the CNC.

1n: Reading (DC1 / DC3 flow control) Set the channel number of RS-232C to "n". In this

setting, the communication line is opened with reading mode and controlled by the DC1 / DC3 flow control. The DC1 code is output to the target device when the communication line is opened. The DC3 code is output to the target device when the communication line is closed. The reading


-125-

from the target device is flow-controlled by the DC1 and DC3 code from the CNC.

2n: Writing (DC1 / DC3 flow control) Set the channel number of RS-232C to "n". In this

setting, the communication line is opened with writing mode and controlled by the DC1 / DC3 flow control. The DC2 code is output to the target device when the communication line is opened. The DC4 code is output to the target device when the communication line is closed. The writing to the target device is flow-controlled by the DC1 and DC3 code from the target device.

9n: Bidirectional (DC1 / DC3 flow control) Set the channel number of RS-232C to "n". In this

setting, the communication line is opened with bidirectional mode and controlled by the DC1 / DC3 flow control. No control code is output when the communication line is opened or closed. The writing to the target device is flow-controlled by the DC1 and DC3 code from the target device. The reading from the target device is flow-controlled by the DC1 and DC3 code from the CNC.

OB (cntl[1]): Baud rate 7:600bps, 8:1200bps, 9:2400bps, 10:4800bps,

11:9600bps OS (cntl[2]): Stop bits, parity and DC3 code Set the stop bits and parity setting to the low byte

as following format. 1: 1 stop bit, none parity 2: 2 stop bits, none parity 11: 1 stop bit, odd parity 12: 2 stop bits, odd parity 21: 1 stop bit, even parity 22: 2 stop bits, even parity Set the DC3 code to the high byte as following

format. 0: The DC3 code is 0x93. 0x13: The DC3 code is 0x13. For example, when the setting is "2 stop bits,

non-parity, the DC3 code is 0x13", you should set the 0x1302 to OS (cntl[2]).

OC (cntl[3]): Output code, input code Set the output code to the low byte as following

format.


-126-

When the OP (cntl[0]) == n, this setting is unavailable.

1: ASCII, 2: ISO Set the input code to the high byte as following

format. 0: Automatic detection 1: ISO (The input code is checked.) For example, when the setting is "Output and input

code is ASCII", you should set the 0x0001 to OC (cntl[3]).

Output

[Return] 0: Normal completion. -1: Specified channel is already in use by another user. 5: Invalid arguments

[Description] This function opens the reader / puncher interface. You should open the interface by the calling of pl_rsopen2() before the calling of pl_rsrd2() or pl_rswrt2(). You should close the interface by the calling of pl_rsclose2() after the calling of pl_rsrd2() or pl_rswrt2(). When you open the interface using the pl_rsopen2(), you cannot use the function pl_rsrd(), pl_rswrt() or pl_rsclose(). You should use the pl_rsrd2(), pl_rswrt2() or pl_rsclose2(). When you use this function, you cannot use the conventional function related to the RS-232C communication in "C library for C executor" together.

[Related Function] rs_open()


-127-

3.10.2 Close the Reader / Puncher Interface [Name]

pl_rsclose2

[Syntax] #include <pmclib.h> short pl_rsclose2(short channel);

[Arguments] Input

channel: Channel number of RS-232C Set the channel number (1-) of RS-232C.

Output ---

[Return] 0: Normal completion. 5: The argument is invalid.

[Description] This function closes the reader / puncher interface. You should close the interface by the calling of pl_rsclose2() after the calling of pl_rsrd2() or pl_rswrt2(). When you open the interface using the pl_rsopen(), you cannot use the function pl_rsclose2(). You should use the pl_rsclose(). When you use this function, you cannot use the conventional function related to the RS-232C communication in "C library for C executor" together.

[Related Function] rs_close(), fca_close()


-128-

3.10.3 Read from the Reader / Puncher Interface [Name]

pl_rsrd2

[Syntax] #include <pmclib.h> short pl_rsrd(short channel, char * buf, unsigned short * size);

[Arguments] Input

channel: Channel number of RS-232C Set the channel number (1-) of RS-232C. buf: Pointer to the buffer Set the pointer to the array that the read data is

stored. *size: Size of the buffer Set size of the buffer. The maximum size is 256

bytes. Output

*buf: Read data The read data is stored. *size: Size of read data The size of read data is returned. The value is

equal or less than the specified value at calling. [Return]

0: Normal completion. -11: The reader / puncher interface is not opened. 2: The "*size" is invalid. 5: The argument or read value is invalid. 20: The communication status is invalid or the "DR"

signal is OFF. 21: There is no data in communication buffer. After

certain time, call this function again.

[Description] This function reads data from reader / puncher interface. You should open the interface by the calling of pl_rsopen2(), not pl_rsopen(), before the calling of pl_rsrd2(). You should close the interface by the calling of pl_rsclose2(), not pl_rsclose(), after the calling of pl_rsrd2(). When you use this function, you cannot use the conventional function related to the RS-232C communication in "C library for C executor" together.

[Related Function] rs_read()


-129-

3.10.4 Write to the Reader / Puncher Interface [Name]

pl_rswrt2

[Syntax] #include <pmclib.h> short pl_rswrt2(short channel, char * buf, unsigned short size);

[Arguments] Input

channel: Channel number of RS-232C Set the channel number (1-) of RS-232C. *buf: Data Set the array that you want to write. size: Size of the data Set size of the data that you want to write. The

maximum size is 256 bytes. Output

---

[Return] 0: Normal completion -11: The reader / Puncher interface is not opened. -12: Cannot write 2: The "size" is invalid. 5: The argument is invalid. 20: The communication status is invalid or the "DR"

signal is OFF.

[Description] This function writes data to the reader / puncher interface. You should open the interface by the calling of pl_rsopen2(), not pl_rsopen(), before the calling of pl_rswrt2(). You should close the interface by the calling of pl_rsclose2(), not pl_rsclose(), after the calling of pl_rswrt2(). When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together.

[Related Function] rs_wrt()


-130-

3.10.5 Open the Reader / Puncher Interface (for FANUC Handy File) [Name]

pl_fopen2

[Syntax] #include <pmclib.h> short pl_fopen2(short * cntl, short file_no, char * file_name);

[Arguments] Input


following format.

cntl[0] OP Channel number, mode, flow control cntl[1] OB Baud rate cntl[2] OS Stop bits, Parity setting (Low byte)

DC3 code (High byte) cntl[3] OC Output code (Low byte)

Input code (High byte)




setting, the communication line is opened with reading mode and controlled by the DC1 / DC3 flow control. The DC1 code is output to the target device when the communication line is opened. The DC3 code is output to the target device when the communication line is closed. The reading from the target device is flow-controlled by the DC1 and DC3 code from the CNC.


setting, the communication line is opened with writing mode and controlled by the DC1 / DC3 flow control. The DC2 code is output to the target device when the communication line is opened. The DC4 code is output to the target device when the communication line is closed. The writing to


-131-

the target device is flow-controlled by the DC1 and DC3 code from the target device.

3n: Reading directory, deleting a file. Set the channel number of RS-232C to "n". In this

setting, you can read directory information or delete the file in FANUC Handy File.


11:9600bps OS (cntl[2]): Stop bits, parity and DC3 code Set the stop bits and parity setting to the low byte

as following format. 1: 1 stop bit, none parity 2: 2 stop bits, none parity 11: 1 stop bit, odd parity 12: 2 stop bits, odd parity 21: 1 stop bit, even parity 22: 2 stop bits, even parity Set the DC3 code to the high byte as following

format. 0: The DC3 code is 0x93. 0x13: The DC3 code is 0x13. For example, when the setting is "2 stop bits,

non-parity, the DC3 code is 0x13", you should set the 0x1302 to OS (cntl[2]).

OC (cntl[3]): Output code, input code Set the output code to the low byte as following

format. When the OP (cntl[0]) == n, this setting is

unavailable. 1: ASCII, 2: ISO Set the input code to the high byte as following

format. 0: Automatic detection 1: ISO (The input code is checked.) For example, when the setting is "Output and input

code is ASCII", you should set the 0x0001 to OC (cntl[3]).

file_no: File number Set the file number on FANUC Handy File to

operate. When you specify the file by the file name, set zero.

*file_name: File name


-132-

Set the file name on FANUC Handy File to operate. You should terminate the file name string with NUL ('¥0'). When you use a MS-DOS format floppy disk, the file name is 12 characters in the maximum, "8 characters in the maximum" + ". (dot)" + "3 characters in the maximum". When you use a FANUC format floppy disk, the file name is 17 characters in the maximum. When you specify the file number, you should set NULL(0) to the "file_name".

NOTE When you specify both the file number and the file

name, specification by the file name is available.

Output ---

[Return] 0: Normal completion -1: Specified channel is already in use by another user. 5: The argument is invalid.

[Description] This function opens the reader / puncher interface for FANUC Handy File. You should open the interface by the calling of pl_fopen2() before the calling of pl_rsrd2(), pl_rswrt2(), pl_fdir2() or pl_fdel2(). You should close the interface by the calling of pl_rsclose2() after the calling of pl_rsrd2(), pl_rswrt2(), pl_fdir2() or pl_fdel2(). When you open the interface using the pl_fopen2(), you cannot use the function pl_rsrd(), pl_rswrt(), pl_fdir(), pl_fdel() or pl_rsclose(). You should use the pl_rsrd2(), pl_rswrt2(), pl_fdir2(), pl_fdel2() or pl_rsclose2(). When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together. ・ When you open the interface with the file number and with the

setting OP (cntl[0]) = 2n, files after the specified number will be deleted and the new file, its file number is specified number, will be created.

・ When you open the interface with the file number "0" and with the setting OP (cntl[0]) = 2n, the new file, its file number is the last file number + 1, will be created.

・ When you open the interface with the file number "-1" and with the setting OP (cntl[0]) = 2n, all files will be deleted, and next, the new file, which file number is "1", will be created.


-133-

・ When you create a file with the setting OP (cntl[0]) = 2n, the default file name will be "#FCAxxxx" for FANUC format floppy disk or will be "#xxxx.DAT" for MS-DOS format floppy disk.

・ When you open the interface with the file name and with the setting OP (cntl[0]) = 2n, the new file, its file number is the last file number + 1 and which file name is specified name, will be created.

[Related Function]

fca_open(), fcs_fopen()


-134-

3.10.6 Get the File Information [Name]

pl_fdir2

[Syntax] #include <pmclib.h> short pl_fdir2(short channel, short file_no, char * file_name, long *

size);

[Arguments] Input

channel: Channel number of RS-232C Set the channel number (1-) of RS-232C. file_no: File number Set the file number.

Output *file_name: File name Set pointer to the array to store the file name. The

array size should be 17 bytes. The read file name is 17 characters. The file name is not terminated with NUL ('¥0'). When the file name is less than 17 characters, space character will be added.

"AAAAAAAA.BBB " *size: File size Set pointer to the variable to store the file size.

[Return] 0: Normal completion -11: The reader / puncher interface is not opened. 5: The argument is invalid. 20: The communication status is invalid or the "DR"

signal is OFF. 23: No specified file

[Description] This function reads the file name and the file size. You should open the interface by the calling of pl_fopen2() with the setting OP (cntl[0]) = 3n, not pl_fopen(), before the calling of pl_fdir2(). You should close the interface by the calling of pl_rsclose2(), not pl_rsclose(), after the calling of pl_fdir2(). If you want to read the information of two or more files, call pl_fopen2(), pl_fdir2() and pl_rsclose2() repeatedly. When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together.


-135-

[Related Function] fca_readdir()


-136-

3.10.7 Delete the File [Name]

pl_fdel2

[Syntax] #include <pmclib.h> short pl_fdel2(short channel, short file_no, char * file_name);

[Arguments] Input

channel: Channel number of RS-232C Set the channel number (1-) of RS-232C. file_no: File number Set the file number on FANUC Handy File to


*file_name: File name Set the file name on FANUC Handy File to operate.

You should terminate the file name string with NUL ('¥0'). When you use a MS-DOS format floppy disk, the file name is 12 characters in the maximum, "8 characters in the maximum" + ". (dot)" + "3 characters in the maximum". When you use a FANUC format floppy disk, the file name is 17 characters in the maximum. When you specify the file number, you should set NULL(0) to the "file_name".



Output ---

[Return] 0: Normal completion -11: The reader / puncher interface is not opened. 5: The argument is invalid.

[Description] The function deletes the specified file. You should open the interface by the calling of pl_fopen2() with the setting OP (cntl[0]) = 3n, not pl_fopen(), before the calling of pl_fdel2(). You should close the interface by the calling of pl_rsclose2(), not pl_rsclose(), after the calling of pl_fdel2(). If you


-137-

want to delete two of more files, call pl_fopen2(), pl_fdel2() and pl_rsclose2() repeatedly. When some file is deleted, the file number after the deleted file will be changed. When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together.

[Related Function] fca_delete()


-138-

3.10.8 Open the Reader / Puncher Interface [Name]

pl_rsopen

[Syntax] #include <pmclib.h> short pl_rsopen(short * cntl);

[Arguments] Input


following format.

cntl[0] OP Channel number, mode, flow control cntl[1] OB Baud rate cntl[2] OS Stop bits, Parity setting (Low byte) cntl[3] OC Output code (Low byte)



n: Bidirectional (Hardware flow control) Set the channel number of RS-232C to "n". In this

setting, the communication line is opened with bidirectional mode and controlled by the hardware flow control. No control code is output when the communication line is opened or closed. To use this setting, you can read or write binary data. The writing to the target device is flow-controlled by the "CS" signal from the target device. The reading from the target device is flow-controlled by the "RS" signal from the CNC.




-139-



9n: Bidirectional (DC1 / DC3 flow control) Set the channel number of RS-232C to "n". In this

setting, the communication line is opened with bidirectional mode and controlled by the DC1 / DC3 flow control. No control code is output when the communication line is opened or closed. The writing to the target device is flow-controlled by the DC1 code from the target device. The reading from the target device is flow-controlled by the DC3 code from the CNC.

10n: Bidirectional (DC1 / DC3 flow control) This setting is nearly same as OP=9n. The

difference is that the DC3 code is 0x13. OB (cntl[1]): Baud rate 7:600bps, 8:1200bps, 9:2400bps, 10:4800bps,

11:9600bps OS (cntl[2]): Stop bits, parity Set the stop bits and parity setting to the low byte

as following format. 1: 1 stop bit, none parity 2: 2 stop bits, none parity 11: 1 stop bit, odd parity 12: 2 stop bits, odd parity 21: 1 stop bit, even parity 22: 2 stop bits, even parity OC (cntl[3]): Output code Set the output code to the low byte as following

format. When the OP (cntl[0]) == n, this setting is

unavailable. 1: ASCII, 2: ISO

Output ---

[Return]


-140-

0: Normal completion. -1: Specified channel is already in use by another user. 5: Invalid arguments

[Description] This function opens the reader / puncher interface. You should open the interface by the calling of pl_rsopen() before the calling of pl_rsrd() or pl_rswrt(). You should close the interface by the calling of pl_rsclose() after the calling of pl_rsrd() or pl_rswrt(). When you open the interface using the pl_rsopen(), you cannot use the function pl_rsrd2(), pl_rswrt2() or pl_rsclose2(). You should use the pl_rsrd(), pl_rswrt() or pl_rsclose(). When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together.

[Related Function] rs_open()


-141-

3.10.9 Close the Reader / Puncher Interface [Name]

pl_rsclose

[Syntax] #include <pmclib.h> short pl_rsclose(void);

[Arguments] 入力

--- Output

---

[Return] 0: Normal completion. Other than 0: Abnormal completion.

[Description] This function closes the reader / puncher interface. You should close the interface by the calling of pl_rsclose() after the calling of pl_rsrd() or pl_rswrt(). When you open the interface using the pl_rsopen2(), you cannot use the function pl_rsclose(). You should use the pl_rsclose2(). When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together.

[Related Function]

rs_close(), fca_close()


-142-

3.10.10 Read from the Reader / Puncher Interface [Name]

pl_rsrd

[Syntax] #include <pmclib.h> short pl_rsrd(char * buf, unsigned short * size);

[Arguments] Input

buf: Pointer to the buffer Set the pointer to the array that the read data is

stored. *size: Size of the buffer Set size of the buffer. The maximum size is 256

bytes. Output

*buf: Read data The read data is stored. *size: Size of read data The size of read data is returned. The value is

equal or less than the specified value at calling.

[Return] 0: Normal completion. -11: The reader / puncher interface is not opened. 2: The "*size" is invalid. 5: The argument or read value is invalid. 20: The communication status is invalid or the "DR"

signal is OFF. 21: There is no data in communication buffer. After

certain time, call this function again.

[Description] This function reads data from reader / puncher interface. You should open the interface by the calling of pl_rsopen(), not pl_rsopen2(), before the calling of pl_rsrd(). You should close the interface by the calling of pl_rsclose(), not pl_rsclose2(), after the calling of pl_rsrd(). When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together.

[Related Function] rs_read()


-143-

3.10.11 Write to the Reader / Puncher Interface [Name]

pl_rswrt

[Syntax] #include <pmclib.h> short pl_rswrt(char * buf, unsigned short size);

[Arguments] Input

*buf: Data Set the array that you want to write. size: Size of the data Set size of the data that you want to write. The

maximum size is 256 bytes. Output

---

[Return] 0: Normal completion -11: The reader / Puncher interface is not opened. -12: Cannot write 2: The "size" is invalid. 5: The argument is invalid. 20: The communication status is invalid or the "DR"

signal is OFF.

[Description] This function writes data to the reader / puncher interface. You should open the interface by the calling of pl_rsopen(), not pl_rsopen2(), before the calling of pl_rswrt(). You should close the interface by the calling of pl_rsclose(), not pl_rsclose2(), after the calling of pl_rswrt(). When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together.

[Related Function] rs_wrt()


-144-

3.10.12 Open the Reader / Puncher Interface (for FANUC Handy File) [Name]

pl_fopen

[Syntax] #include <pmclib.h> short pl_fopen(short * cntl, short file_no, char * file_name);

[Arguments] Input


following format.

cntl[0] OP Channel number, mode, flow control cntl[1] OB Baud rate cntl[2] OS Stop bits, Parity setting (Low byte) cntl[3] OC Output code (Low byte)








-145-

3n: Reading directory, deleting a file. Set the channel number of RS-232C to "n". In this

setting, you can read directory information or delete the file in FANUC Handy File.


11:9600bps OS (cntl[2]): Stop bits, parity setting Set the stop bits and parity setting to the low byte

as following format. 1: 1 stop bit, none parity 2: 2 stop bits, none parity 11: 1 stop bit, odd parity 12: 2 stop bits, odd parity 21: 1 stop bit, even parity 22: 2 stop bits, even parity OC (cntl[3]): Output code Set the output code to the low byte as following

format. 1: ASCII, 2: ISO The target device is FANUC Handy File, you

should set "2". file_no: File number Set the file number on FANUC Handy File to






Output ---


-146-

[Return] 0: Normal completion. -1: Specified channel is already in use by another user. 5: The argument is invalid.

[Description] This function opens the reader / puncher interface for FANUC Handy File. You should open the interface by the calling of pl_fopen(), not pl_fopen2(), before the calling of pl_rsrd(), pl_rswrt(), pl_fdir() or pl_fdel(). You should close the interface by the calling of pl_rsclose(), not pl_rsclose2(), after the calling of pl_rsrd(), pl_rswrt(), pl_fdir() or pl_fdel(). When you open the interface using the pl_fopen(), you cannot use the function pl_rsrd2(), pl_rswrt2(), pl_fdir2(), pl_fdel2() or pl_rsclose2(). You should use the pl_rsrd(), pl_rswrt(), pl_fdir(), pl_fdel() or pl_rsclose(). When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together. ・ When you open the interface with the file number and with the

setting OP (cntl[0]) = 2n, files after the specified number will be deleted and the new file, its file number is specified number, will be created.

・ When you open the interface with the file number "0" and with the setting OP (cntl[0]) = 2n, the new file, its file number is the last file number + 1, will be created.

・ When you open the interface with the file number "-1" and with the setting OP (cntl[0]) = 2n, all files will be deleted, and next, the new file, which file number is "1", will be created.

・ When you create a file with the setting OP (cntl[0]) = 2n, the default file name will be "#FCAxxxx" for FANUC format floppy disk or will be "#xxxx.DAT" for MS-DOS format floppy disk.

・ When you open the interface with the file name and with the setting OP (cntl[0]) = 2n, the new file, its file number is the last file number + 1 and which file name is specified name, will be created.

[Related Function]

fca_open(), fcs_fopen()


-147-

3.10.13 Get the File Information [Name]

pl_fdir

[Syntax] #include <pmclib.h> short pl_fdir(short file_no, char * file_name, long * size);

[Arguments] Input

file_no: File number Set the file number.

Output *file_name: File name Set pointer to the array to store the file name. The

array size should be 17 bytes. The read file name is 17 characters. The file name is not terminated with NUL ('¥0'). When the file name is less than 17 characters, space character will be added.

"AAAAAAAA.BBB " *size: File size Set pointer to the variable to store the file size.

[Return] 0: Normal completion. -11: The reader / puncher interface is not opened. 5: The argument is invalid. 20: The communication status is invalid or the "DR"

signal is OFF. 23: No specified file

[Description] This function reads the file name and the file size. You should open the interface by the calling of pl_fopen() with the setting OP (cntl[0]) = 3n, not pl_fopen2(), before the calling of pl_fdir(). You should close the interface by the calling of pl_rsclose(), not pl_rsclose2(), after the calling of pl_fdir(). If you want to read the information of two or more files, call pl_fopen(), pl_fdir() and pl_rsclose() repeatedly. When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together.

[Related Function] fca_readdir()


-148-

3.10.14 Delete the File [Name]

pl_fdel

[Syntax] #include <pmclib.h> short pl_fdel(short file_no, char * file_name);

[Arguments] Input

file_no: File number Set the file number on FANUC Handy File to






Output ---

[Return] 0: Normal completion. -11: The reader / puncher interface is not opened. 5: The argument is invalid.

[Description] The function deletes the specified file. You should open the interface by the calling of pl_fopen() with the setting OP (cntl[0]) = 3n, not pl_fopen2(), before the calling of pl_fdel(). You should close the interface by the calling of pl_rsclose(), not pl_rsclose2(), after the calling of pl_fdel(). If you want to delete two of more files, call pl_fopen(), pl_fdel() and pl_rsclose() repeatedly.


-149-

When some file is deleted, the file number after the deleted file will be changed. When you use this function, you cannot use the conventional function related to The RS-232C communication in "C library for C executor" together.

[Related Function] fca_delete()


-150-

3.11 CNC WINDOW

3.11.1 CNC Window Function (Read) [Name]

pl_nc_windr

[Syntax] #include <pmclib.h> short pl_nc_windr(short * cntl);

[Arguments] Input

*cntl: Control information Set the function code, the number and the attribute. The required array size depends on the function

code, the data number and the data attribute. You should prepare enough array size accordingly.

Supported function code is shown below. No. 0, 13, 15, 17, 19, 21, 23, 24, 25, 26, 27, 28, 29,

30, 31, 32, 33, 34, 50, 59, 74, 75, 76, 90, 153, 154, 155, 156, 321, 395

About the details, refer to the following manual. "Series 30i/ 31i/ 32i PMC Programming manual

(B-63983EN)"

cntl[0] Function code cntl[1] (Return code) cntl[2] (Length) cntl[3] Number cntl[4] Attribute

cntl[5] (Data) to

cntl[n] (Data)


-151-

Output *cntl: Return value The return code, the length and the data are

returned. The read data is returned from the "Data (cntl[5])".

cntl[0] (Function code) cntl[1] Return code cntl[2] Length cntl[3] (Number) cntl[4] (Attribute) cntl[5] Data

to cntl[n] Data

[Return]

0: Normal completion -1: Rejected The reading is rejected by the CNC because of the

busy. Call this function again. -10: Rejected The reading is not completed. Call this function

repeatedly until the completion. 1: The function code cntl[0] is invalid. 3: The number cntl[3] is invalid. 4: The attribute cntl[4] is invalid. 6: No option

[Description] This function reads the various CNC data through the CNC window.

[Related Function] cnc_sysinfo(), cnc_rdprgnum(), cnc_rdseqnum(), cnc_actf(), cnc_acts(), cnc_absolute(), cnc_machine(), cnc_relative(), cnc_distance(), cnc_skip(), cnc_srvdelay(), cnc_accdecdly(), cnc_rddynamic(), cnc_statinfo(), cnc_alarm(), cnc_rdalminfo(), cnc_rdtofs(), cnc_rdtofsr(), cnc_rdzofs(), cnc_rdzofsr(), cnc_rdparam(), cnc_rdparar(), cnc_rdset(), cnc_rdsetr(), cnc_rdpitchr(), cnc_rdmacro(), cnc_rdmacror(), cnc_rdpmacro(), cnc_rdpmacror(), cnc_modal(), cnc_diagnoss(), cnc_diagnosr(), cnc_adcnv(), cnc_rdopmsg(), cnc_setpath(), cnc_rdspload(), cnc_rdmovrlap()


-152-

3.11.2 CNC Window Function (Write) [Name]

pl_nc_windw

[Syntax] #include <pmclib.h> short pl_nc_windw(short * cntl);

[Arguments] Input

*cntl: Control information Set the function code, the length, the number, the

attribute and the data. The required array size depends on the function

code, the data number and the data attribute. You should prepare enough array size accordingly.

Supported function code is shown below. No. 14, 16, 18, 20, 22, 60, 323, 396 About the details, refer to the following manual. "Series 30i/ 31i/ 32i PMC Programming manual

(B-63983EN)"

cntl[0] Function code cntl[1] (Return code) cntl[2] Length cntl[3] Number cntl[4] Attribute cntl[5] Data

to cntl[n] Data

Output

*cntl: Return value The return code is returned.

cntl[0] (Function code) cntl[1] Return code cntl[2] (Length) cntl[3] (Number) cntl[4] (Attribute) cntl[5] (Data)

to cntl[n] (Data)

[Return]

0: Normal completion -1: Rejected


-153-

The reading is rejected by the CNC because of the busy. Call this function again.

-10: Rejected The reading is not completed. Call this function

repeatedly until the completion. 1: The function code cntl[0] is invalid. 2: The length cntl[2] is invalid. 3: The number cntl[3] is invalid. 4: The attribute cntl[4] is invalid. 5: The data cntl[5] is invalid. 6: No option 7: Write protected

[Description] This function writes the various CNC data thorough the CNC window.

[Related Function] cnc_wrtofs(), cnc_wrtofsr(), cnc_wrzofs(), cnc_wrzofsr(), cnc_wrparam(), cnc_wrparas(), cnc_wrset(), cnc_wrsets(), cnc_wrpitchr(), cnc_wrmacro(), cnc_wrmacror(), cnc_wrpmacro(), cnc_wrpmacror(), cnc_setpath(), cnc_settimer()


-154-

3.11.3 External Data Input [Name]

pl_exin

[Syntax] #include <pmclib.h> short pl_exin(short * cntl);

[Arguments] Input

--- Output

---

[Return] ---

[Description] This function is not supported. Use the function EXIN (SUB 42) in your LADDER program. If this function is called, the value 0 is returned without performing any processing.


-155-

3.12 CNC PROGRAM

3.12.1 Start Registration of the CNC Program [Name]

pl_nc_dwnstart2

[Syntax] #include <pmclib.h> short pl_nc_dwnstart2(unsigned short path);

[Arguments] Input

path: The CNC path number(from 1) Set the CNC path number. When you set zero, first

path CNC is selected. Output

---

[Return] 0: Normal completion. -1: Rejected When the CNC is following status, this function

cannot be executed. - Another command is executing. (Downloading,

Verifying, Uploading, listing program) - The CNC is in background editing mode. - The CNC is in MDI mode. - P/S 000 or P/S101 alarm status

1: The "path" is invalid. 7: Write protect

[Description] This function starts a registration of the CNC program. You should call the pl_nc_dwnstart2() before the calling of the pl_nc_download2(). You should call the pl_nc_dwnend2() after the pl_nc_download2(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.

[Related Function] cnc_dwnstart(), cnc_download(), cnc_dwnend()


-156-

3.12.2 Register the CNC Program [Name]

pl_nc_download2

[Syntax] #include <pmclib.h> short pl_nc_download2(unsigned short path, char * buf, unsigned

short size);

[Arguments] Input


path CNC is selected. *but: CNC program Set the CNC program that you want to register

with following format. "Oxxxx¥n(Block 1)¥n(Block 2)¥n...¥nMxx¥n%" The "Oxxxx" is a program number, the "Mxx" is a

M code. The beginning of CNC program should be program number, "Oxxxx". The end of CNC program should be the "%" character.

Example) O1234 ; G1 F0.3 W10. ; M30 : % If you want to register above CNC program, you

should set following string. "O1234¥nG1F0.3W10.¥nM30¥n%" You can register 256 characters of CNC program

in the maximum in one time calling. If you want to register more than 256 characters of CNC program, you should call this function repeatedly.

size: Byte count of the CNC program Set the byte count of the CNC program.

Output ---

[Return] 0: Normal completion. -11: The function pl_nc_dwnstart2() is not called. 1: The "path" is invalid. 2: The "size" is invalid.


-157-

5: The CNC program is invalid. This error happens when following cases. - The duplicate number program has been

registered. - An illegal character is found in the CNC

program. - When a TV check is enabled, a block that

includes odd number of characters is detected. - The maximum number of programs is

exceeded. 8: No space in the CNC tape memory

[Description] This function registers the CNC program. You can register the CNC program, which is described using ASCII characters. You should call the pl_nc_dwnstart2() before the calling of the pl_nc_download2(). You should call the pl_nc_dwnend2() after the calling of the pl_nc_download2(). You can register the CNC program that is more than 256 characters by the repeated calling of this function. When you register the duplicate number of CNC program, the behavior of the CNC is depends on the CNC parameter "REP (No.3201#2)". REP = 0: The return code is "5" and no CNC program registers. REP = 1: The return code is "0" and the existing CNC program will be

replaced by the specified program. However, when the existing CNC program that should be replaced is currently selected by the CNC, you cannot replace it.

When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-158-

3.12.3 End Registration of the CNC Program [Name]

pl_nc_dwnend2

[Syntax] #include <pmclib.h> short pl_nc_dwnend2(unsigned short path);

[Arguments] Input



---

[Return] 0: Normal completion. -11: The function pl_nc_dwnstart2() is not called. 1: The "path" is invalid. 5: The CNC program is invalid. This error happens

when following cases. - The duplicate number program has been





[Description] This function ends a registration of the CNC program. You should call the pl_nc_dwnend2() after the calling of the pl_nc_dwnload2(). The error code of the pl_nc_download2(), which is previously called, may be sometimes returned in this function. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-159-

3.12.4 Start DNC running of the CNC Program [Name]

pl_nc_dncstart2

[Syntax] #include <pmclib.h> short pl_nc_dncstart2(unsigned short path);

[Arguments] Input



---



Verifying, Uploading, listing program) - Alarm state - The "Automatic operation signal OP (F000#7)"

is on. - The "DMMC signal (G42#7)" is off.

1: The "path" is invalid.

[Description] This function starts a DNC running of the CNC program. You should call the pl_nc_dncstart2() before the calling of the pl_nc_dnc2(). You should call the pl_nc_dncend2() after the calling of the pl_nc_dnc2(). The procedure of the DNC running is shown below. (1) Set the CNC to MEM mode. (2) Turn the "DMMC signal (G42#7)" on. (3) Execute the pl_nc_dncstart2(). (4) Turn the "ST signal (G7#2)" off and on and off to start program. (5) Transfer the CNC program using the pl_nc_dnc2(). (6) Execute the pl_nc_dncend2(). (7) Reset the CNC after the completion of the CNC program. (8) Turn the "DMMC signal (G42#7)" off. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.


-160-

[Related Function]

cnc_dncstart(), cnc_dnc(), cnc_dncend()


-161-

3.12.5 Run the CNC Program (DNC running) [Name]

pl_nc_dnc2

[Syntax] #include <pmclib.h> short pl_nc_dnc2(unsigned short path, char * buf, unsigned short

size);

[Arguments] Input


path CNC is selected. *but: CNC program Set the CNC program that you want to run with

following format. "Oxxxx¥n(Block 1)¥n(Block 2)¥n...¥nMxx¥n%" The "Oxxxx" is a program number, the "Mxx" is a


Example) O1234 ; G1 F0.3 W10. ; M30 : % If you want to run above CNC program, you

should set following string. "O1234¥nG1F0.3W10.¥nM30¥n%" You can run 256 characters of CNC program in the

maximum in one time calling. If you want to run more than 256 characters of CNC program, you should call this function repeatedly.


Output ---


cannot be executed.


-162-

- Another command is executing. (Downloading, Verifying, Uploading, listing program)

- Alarm status - The "Automatic operation signal OP (F000#7)"


-2: Reset state Stop the calling of this function and call the

pl_nc_dncend2(). -11: The function pl_nc_dncstart2() is not called. 1: The "path" is invalid. 2: The "size" is invalid. 5: The CNC program is invalid.

- An illegal character is found in the CNC program.

- When a TV check is enabled, a block that includes odd number of characters is detected.

[Description]

This function runs the CNC program. (DNC running) You can run the CNC program, which is described using ASCII characters". You should call the pl_nc_dncstart2() before the calling of the pl_nc_dnc2(). You should call the pl_nc_dncend2() after the calling of the pl_nc_dnc2(). You can run the CNC program that is more than 256 characters by the repeated calling of this function. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.

[Related Function] cnc_dncstart(), cnc_dnc(), cnc_dncend()


-163-

3.12.6 End DNC Running of the CNC Program [Name]

pl_nc_dncend2

[Syntax] #include <pmclib.h> short pl_nc_dncend2(unsigned short path);

[Arguments] Input



---

[Return] 0: Normal completion. -2: Reset state -11: The function pl_nc_dncstart2() is not called. 1: The "path" is invalid. 5: The CNC program is invalid.



[Description]

This function ends the DNC running of the CNC program. You should call the pl_nc_dncend2() after the calling of the pl_nc_dnc2(). The error code of the pl_nc_dnc2(), which is previously called, may be sometimes returned in this function. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-164-

3.12.7 Search the CNC Program (Supported 8 Digits Program Number) [Name]

pl_nc_search2_8d

[Syntax] #include <pmclib.h> short pl_nc_search2(unsigned short path, long no);

[Arguments] Input


path CNC is selected. no: The CNC program number Set the CNC program number, which you want to

search. Output

---



Verifying, Uploading, listing program) - The CNC is in EDIT or MEM mode, and the

"Automatic operation signal OP (F000#7) is on.

- Alarm state of P/S 000 or P/S 101 1: The "path" is invalid. 5: No specified program 7: Write protect

[Description] This function searches the CNC program to run in MEM mode. When the CNC is in EDIT or MEM mode, the foreground search will be done. When the CNC is in another mode, the background search will be done. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.

[Related Function] cnc_search()


-165-

3.12.8 Search the CNC Program [Name]

pl_nc_search2

[Syntax] #include <pmclib.h> short pl_nc_search2(unsigned short path, short no);

[Arguments] Input



search. Output

---





- Alarm state of P/S 000 or P/S 101 1: The "path" is invalid. 5: No specified program 7: Write protect




-166-

3.12.9 Delete All CNC Programs [Name]

pl_nc_delall2

[Syntax] #include <pmclib.h> short pl_nc_delal2l(unsigned short path);

[Arguments] Input



---



Verifying, Uploading, listing program) - The "Automatic operation signal OP (F000#7)"

is on. - Alarm state of P/S 000, P/S 101 or BP/S.

1: The "path" is invalid. 7: Memory protected, Program protected

[Description]

This function deletes all CNC programs. The selected CNC program in foreground is also deleted. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.

[Related Function] cnc_delall()


-167-

3.12.10 Delete the CNC Program (Supported 8 Digits Program Number) [Name]

pl_nc_delete2_8d

[Syntax] #include <pmclib.h> short pl_nc_delete2_8d(unsigned short path, long no);

[Arguments] Input



delete. Output

---





1: The "path" is invalid. 5: No specified program 7: Memory protected, Program protected

[Description]

This function deletes the CNC program. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.

[Related Function] cnc_delete()


-168-

3.12.11 Delete the CNC Program [Name]

pl_nc_delete2

[Syntax] #include <pmclib.h> short pl_nc_delete2(unsigned short path, short no);

[Arguments] Input



delete. Output

---





1: The "path" is invalid. 5: No specified program 7: Memory protected, Program protected

[Description]




-169-

3.12.12 Start Reading of the CNC Program (Supported 8 Digits Program Number) [Name]

pl_nc_upstart2_8d

[Syntax] #include <pmclib.h> short pl_nc_upstart2_8d(unsigned short path, long no);

[Arguments] Input



read. Output

---




is on. - Alarm state of P/S 000, P/S 101 or BP/S. - The CNC is in background editing mode or

MDI mode. 1: The "path" is invalid. 5: No specified program 7: Program protected

[Description] This function starts reading of the CNC program. You should call the pl_nc_upstart2_8d() before the calling of the pl_nc_upload2(). You should call the pl_nc_upend2() after the calling of the pl_nc_upload2(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.

[Related Function] cnc_upstart(), cnc_upload(), cnc_upend()


-170-

3.12.13 Start Reading of the CNC Program [Name]

pl_nc_upstart2

[Syntax] #include <pmclib.h> short pl_nc_upstart2(unsigned short path, short no);

[Arguments] Input



read. Output

---





MDI mode. 1: The "path" is invalid. 5: No specified program 7: Program protected

[Description] This function starts reading of the CNC program. You should call the pl_nc_upstart2() before the calling of the pl_nc_upload2(). You should call the pl_nc_upend2() after the calling of the pl_nc_upload2(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-171-

3.12.14 Read the CNC Program [Name]

pl_nc_upload2

[Syntax] #include <pmclib.h> short pl_nc_upload2(unsigned short path, char * buf, unsigned short

size);

[Arguments] Input


path CNC is selected. buf: Pointer to the array to store the read program Set the pointer to the array, which the read CNC

program is stored. *size: Size of array Set the size of array. You can set 256 bytes in the

maximum. Output

*buf: Read CNC program The CNC program is stored with the following

format. "¥nOxxxx¥n(Block 1)¥n(Block

2)¥n...¥nMxx¥n%" The "Oxxxx" is the program number. The "Mxx" is

the M code. The end of the CNC program is the "%" character. Note that the read CNC program is not terminated with NUL ('¥0').

*size: Size of read data The size of read data is returned. The value is


[Return] 0: Normal completion. -11: The function pl_nc_upstart2() is not called. 1: The "path" is invalid. 2: The "size" is invalid.

[Description] This function reads the CNC program. You can read the CNC program described by ASCII characters. You should call the pl_nc_upstart2_8d() or pl_nc_upstart2() before the calling of the pl_nc_upload2(). You should call the pl_nc_upend2() after the calling of the pl_nc_upload2().


-172-

You can read the CNC program that is more than 256 characters by the repeated calling of this function. The end of CNC program is the "%". Call until the "%" character is read repeatedly. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-173-

3.12.15 End Reading of the CNC Program [Name]

pl_nc_upend2

[Syntax] #include <pmclib.h> short pl_nc_upend2(unsigned short path);

[Arguments] Input



---

[Return] 0: Normal completion. -11: The function pl_nc_upstart2() is not called. 1: The "path" is invalid.

[Description] This function ends the reading of the CNC program. You should call pl_nc_upend2() after the calling of the pl_nc_upload2(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-174-

3.12.16 Read the CNC Program Memory Information [Name]

pl_nc_dir2

[Syntax] #include <pmclib.h> short pl_nc_dir2(unsigned short path, short * cntl);

[Arguments] Input


path CNC is selected. cntl: Pointer to the array to store the read data Set the pointer to the array, which the read data is

stored. The 12-byte array is required. Output

*cntl: Read data The read data is stored with the following format.

cntl[0] The number of CNC programs

cntl[1] The number of CNC programs, which you can

register.

cntl[2] cntl[3]

Used memory (Characters)

cntl[4] cntl[5]

Unused memory (Characters)

[Return]

0: Normal completion. 1: The "path" is invalid.

[Description] This function reads the CNC program memory information. You can read the number of CNC programs, the number of CNC programs that you can register, and the used and unused characters in the memory can be read. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.

[Related Function] cnc_rdproginfo()


-175-

3.12.17 Start Reading of the CNC Program List (Supported 8 Digits Program Number) [Name]

pl_nc_pdirstart2_8d

[Syntax] #include <pmclib.h> short pl_nc_pdirstart2_8d(unsigned short path, short type, long *

cntl);

[Arguments] Input


path CNC is selected. type: Data type Set the data type that you want to read. 0: Read the CNC program number 1: Read the CNC program number, comment and

the number of used characters. *cntl: Control information Set the start and end number of the CNC program

with following format. If you set zero to the start number, the list is read from the top of the CNC program. If you set zero to the end number, the list is read until bottom of the CNC program.

cntl[0] Start program number cntl[1] End program number

Output

---

[Return] 0: Normal completion. 1: The "path" is invalid. 3: The "type" is invalid.

[Description] This function starts reading of the CNC program list. You should call the pl_nc_pdirstart2_8d() before the calling of the pl_nc_progdir2(). You should call the pl_nc_pdirend2() after the calling of the pl_nc_progdir2(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.


-176-

[Related Function] cnc_rdprogdir()


-177-

3.12.18 Start Reading of the CNC Program List [Name]

pl_nc_pdirstart2

[Syntax] #include <pmclib.h> short pl_nc_pdirstart2(unsigned short path, short type, short * cntl);

[Arguments] Input


path CNC is selected. type: Data type Set the data type that you want to read. 0: Read the CNC program number 1: Read the CNC program number, comment and




Output

---

[Return] 0: Normal completion. 1: The "path" is invalid. 3: The "type" is invalid.

[Description] This function starts reading of the CNC program list. You should call the pl_nc_pdirstart2() before the calling of the pl_nc_progdir2(). You should call the pl_nc_pdirend2() after the calling of the pl_nc_progdir2(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-178-

3.12.19 Read the CNC Program List [Name]

pl_nc_progdir2

[Syntax] #include <pmclib.h> short pl_nc_progdir2(unsigned short path, char * buf, unsigned short *

size);

[Arguments] Input


path CNC is selected. buf: The pointer to the array to store the read data Set the pointer to the array, which the read data is

stored. *size: Size of array Set the size of array. You can set 256 bytes in the

maximum. Output

*buf: Read CNC program list - When you set zero to the "type", the data will

be read with following format. "OxxxxOxxxx ... %"

- When you set 1 to the "type", the data will be read with following format.

- "%¥nOxxxx(Comment)yyyy¥nOxxxx(Comment)yyyy¥n...%"

The "Oxxxx" is the CNC program number, which sorted by its character code. The "yyyy" is the number of characters of the CNC program and this size is rounded off to 80 characters unit. The "(Comment)" is a comment string, which is described after the program number "Oxxxx". The comment that you can read is 50 characters, included "()", in the maximum. The characters over 50 cannot be read. When no comment is described, the "()" will be returned.

Note that this read comment is not terminated with NULL ('¥0').

[Return]

0: Normal completion. -1: Rejected


-179-

When the CNC is following status, this function cannot be executed. - Another command is executing. (Downloading,

Verifying, Uploading, listing program) - Alarm state of P/S 000 or P/S 101 - The CNC is in background editing mode or

MDI mode. -2: Reset state -11: The function pl_nc_pdirstart2() is not called. 1: The "path" is invalid. 2: The "size" is invalid.

[Description] This function reads the CNC program list. You should call the pl_nc_pdirstart2_8d() or pl_nc_pdirstart2() before the calling of the pl_nc_progdir2(). You should call the pl_nc_pdirend2() after the calling of the pl_nc_progdir2(). The end of data is the "%". Call until the "%" character is read repeatedly. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-180-

3.12.20 End Reading of the Program List [Name]

pl_nc_pdirend2

[Syntax] #include <pmclib.h> short pl_nc_pdirend2(unsigned short path);

[Arguments] Input



---

[Return] 0: Normal completion. -11: The function pl_nc_pdirstart2() is not called. 1: The "path" is invalid.

[Description] This function ends the reading of the CNC program list. You should call the pl_pdirend2() after the calling of the pl_progdir2(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-181-

3.12.21 Start Registration of the CNC Program [Name]

pl_nc_dwnstart

[Syntax] #include <pmclib.h> short pl_nc_dwnstart(void);

[Arguments] Input

--- Output

---



Verifying, Uploading, listing program) - The CNC is in background editing mode. - The CNC is in MDI mode. - P/S 000 or P/S101 alarm status

7: Write protect

[Description] This function starts a registration of the CNC program. You should call the pl_nc_dwnstart() before the calling of the pl_nc_download(). You should call the pl_nc_dwnend() after the pl_nc_download(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-182-

3.12.22 Register the CNC Program [Name]

pl_nc_download

[Syntax] #include <pmclib.h> short pl_nc_download(char * buf, unsigned short size);

[Arguments] Input

*but: CNC program Set the CNC program that you want to register

with following format. "Oxxxx¥n(Block 1)¥n(Block 2)¥n...¥nMxx¥n%" The "Oxxxx" is a program number, the "Mxx" is a


Example) O1234 ; G1 F0.3 W10. ; M30 : % If you want to register above CNC program, you

should set following string. "O1234¥nG1F0.3W10.¥nM30¥n%" You can register 256 characters of CNC program

in the maximum in one time calling. If you want to register more than 256 characters of CNC program, you should call this function repeatedly.


Output ---

[Return] 0: Normal completion. -11: The function pl_nc_dwnstart() is not called. 2: The "size" is invalid. 5: The CNC program is invalid. This error happens



program.


-183-


- The maximum number of programs is exceeded.

8: No space in the CNC tape memory

[Description] This function registers the CNC program. You can register the CNC program, which is described using ASCII characters. You should call the pl_nc_dwnstart() before the calling of the pl_nc_download(). You should call the pl_nc_dwnend() after the calling of the pl_nc_download(). You can register the CNC program that is more than 256 characters by the repeated calling of this function. When you register the duplicate number of CNC program, the behavior of the CNC is depends on the CNC parameter "REP (No.3201#2)". REP = 0: The return code is "5" and no CNC program registers. REP = 1: The return code is "0" and the existing CNC program will be

replaced by the specified program. However, when the existing CNC program that should be replaced is currently selected by the CNC, you cannot replace it.




-184-

3.12.23 End Registration of the CNC Program [Name]

pl_nc_dwnend

[Syntax] #include <pmclib.h> short pl_nc_dwnend(void);

[Arguments] Input

--- Output

---

[Return] 0: Normal completion. -11: The function pl_nc_dwnstart() is not called. 5: The CNC program is invalid. This error happens






[Description] This function ends a registration of the CNC program. You should call the pl_nc_dwnend() after the calling of the pl_nc_dwnload(). The error code of the pl_nc_download(), which is previously called, may be sometimes returned in this function. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-185-

3.12.24 Start DNC running of the CNC Program [Name]

pl_nc_dncstart

[Syntax] #include <pmclib.h> short pl_nc_dncstart(void);

[Arguments] Input

--- Output

---



Verifying, Uploading, listing program) - Alarm state - The "Automatic operation signal OP (F000#7)"


[Description]

This function starts a DNC running of the CNC program. You should call the pl_nc_dncstart() before the calling of the pl_nc_dnc(). You should call the pl_nc_dncend() after the calling of the pl_nc_dnc(). The procedure of the DNC running is shown below. (1) Set the CNC to MEM mode. (2) Turn the "DMMC signal (G42#7)" on. (3) Execute the pl_nc_dncstart(). (4) Turn the "ST signal (G7#2)" off and on and off to start program. (5) Transfer the CNC program using the pl_nc_dnc(). (6) Execute the pl_nc_dncend(). (7) Reset the CNC after the completion of the CNC program. (8) Turn the "DMMC signal (G42#7)" off. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-186-

3.12.25 Run the CNC Program (DNC running) [Name]

pl_nc_dnc

[Syntax] #include <pmclib.h> short pl_nc_dnc(char * buf, unsigned short size);

[Arguments] Input

*but: CNC program Set the CNC program that you want to run with

following format. "Oxxxx¥n(Block 1)¥n(Block 2)¥n...¥nMxx¥n%" The "Oxxxx" is a program number, the "Mxx" is a


Example) O1234 ; G1 F0.3 W10. ; M30 : % If you want to run above CNC program, you

should set following string. "O1234¥nG1F0.3W10.¥nM30¥n%" You can run 256 characters of CNC program in the

maximum in one time calling. If you want to run more than 256 characters of CNC program, you should call this function repeatedly.


Output ---



Verifying, Uploading, listing program) - Alarm status - The "Automatic operation signal OP (F000#7)"

is on.


-187-

- The "DMMC signal (G42#7)" is off. -2: Reset state Stop the calling of this function and call the

pl_nc_dncend(). -11: The function pl_nc_dncstart() is not called. 2: The "size" is invalid. 5: The CNC program is invalid.



[Description]

This function runs the CNC program. (DNC running) You can run the CNC program, which is described using ASCII characters". You should call the pl_nc_dncstart() before the calling of the pl_nc_dnc(). You should call the pl_nc_dncend() after the calling of the pl_nc_dnc(). You can run the CNC program that is more than 256 characters by the repeated calling of this function. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-188-

3.12.26 End DNC Running of the CNC Program [Name]

pl_nc_dncend

[Syntax] #include <pmclib.h> short pl_nc_dncend(void);

[Arguments] Input

--- Output

---

[Return] 0: Normal completion. -2: Reset state -11: The function pl_nc_dncstart() is not called. 5: The CNC program is invalid.



[Description]

This function ends the DNC running of the CNC program. You should call the pl_nc_dncend() after the calling of the pl_nc_dnc(). The error code of the pl_nc_dnc(), which is previously called, may be sometimes returned in this function. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-189-

3.12.27 Search the CNC Program (Supported 8 Digits Program Number) [Name]

pl_nc_search_8d

[Syntax] #include <pmclib.h> short pl_nc_search_8d(long no);

[Arguments] Input

no: The CNC program number Set the CNC program number, which you want to

search. Output

---





- Alarm state of P/S 000 or P/S 101 5: No specified program 7: Write protect




-190-

3.12.28 Search the CNC Program [Name]

pl_nc_search

[Syntax] #include <pmclib.h> short pl_nc_search(short no);

[Arguments] Input


search. Output

---





- Alarm state of P/S 000 or P/S 101 5: No specified program 7: Write protect




-191-

3.12.29 Delete All CNC Programs [Name]

pl_nc_delall

[Syntax] #include <pmclib.h> short pl_nc_delall(void);

[Arguments] Input

--- Output

---





7: Memory protected, Program protected [Description]

This function deletes all CNC programs. The selected CNC program in foreground is also deleted. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.

[Related Function] cnc_delall()


-192-

3.12.30 Delete the CNC Program (Supported 8 Digits Program Number) [Name]

pl_nc_delete_8d

[Syntax] #include <pmclib.h> short pl_nc_delete_8d(long no);

[Arguments] Input


delete. Output

---





5: No specified program 7: Memory protected, Program protected

[Description]




-193-

3.12.31 Delete the CNC Program [Name]

pl_nc_delete

[Syntax] #include <pmclib.h> short pl_nc_delete(short no);

[Arguments] Input


delete. Output

---





5: No specified program 7: Memory protected, Program protected

[Description]




-194-

3.12.32 Start Reading of the CNC Program (Supported 8 Digits Program Number) [Name]

pl_nc_upstart_8d

[Syntax] #include <pmclib.h> short pl_nc_upstart_8d(long no);

[Arguments] Input


read. Output

---





MDI mode. 5: No specified program 7: Program protected

[Description] This function starts reading of the CNC program. You should call the pl_nc_upstart_8d() before the calling of the pl_nc_upload(). You should call the pl_nc_upend() after the calling of the pl_nc_upload(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-195-

3.12.33 Start Reading of the CNC Program [Name]

pl_nc_upstart

[Syntax] #include <pmclib.h> short pl_nc_upstart(short no);

[Arguments] Input


read. Output

---





MDI mode. 5: No specified program 7: Program protected

[Description] This function starts reading of the CNC program. You should call the pl_nc_upstart() before the calling of the pl_nc_upload(). You should call the pl_nc_upend() after the calling of the pl_nc_upload(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-196-

3.12.34 Read the CNC Program [Name]

pl_nc_upload

[Syntax] #include <pmclib.h> short pl_nc_upload(char * buf, unsigned short size);

[Arguments] Input

buf: Pointer to the array to store the read program Set the pointer to the array, which the read CNC

program is stored. *size: Size of array Set the size of array. You can set 256 bytes in the

maximum. Output

*buf: Read CNC program The CNC program is stored with the following

format. "¥nOxxxx¥n(Block 1)¥n(Block

2)¥n...¥nMxx¥n%" The "Oxxxx" is the program number. The "Mxx" is

the M code. The end of the CNC program is the "%" character. Note that the read CNC program is not terminated with NUL ('¥0').

*size: Size of read data The size of read data is returned. The value is


[Return] 0: Normal completion. -11: The function pl_nc_upstart() is not called. 2: The "size" is invalid.

[Description] This function reads the CNC program. You can read the CNC program described by ASCII characters. You should call the pl_nc_upstart_8d() or pl_nc_upstart() before the calling of the pl_nc_upload(). You should call the pl_nc_upend() after the calling of the pl_nc_upload(). You can read the CNC program that is more than 256 characters by the repeated calling of this function. The end of CNC program is the "%". Call until the "%" character is read repeatedly.


-197-




-198-

3.12.35 End Reading of the CNC Program [Name]

pl_nc_upend

[Syntax] #include <pmclib.h> short pl_nc_upend(void);

[Arguments] Input

--- Output

---

[Return] 0: Normal completion. -11: The function pl_nc_upstart() is not called.

[Description] This function ends the reading of the CNC program. You should call pl_nc_upend() after the calling of the pl_nc_upload(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-199-

3.12.36 Read the CNC Program Memory Information [Name]

pl_nc_dir

[Syntax] #include <pmclib.h> short pl_nc_dir(short * cntl);

[Arguments] Input

cntl: Pointer to the array to store the read data Set the pointer to the array, which the read data is

stored. The 12-byte array is required. Output

*cntl: Read data The read data is stored with the following format.

cntl[0] The number of CNC programs

cntl[1] The number of CNC programs, which you can

register.

cntl[2] cntl[3]

Used memory (Characters)

cntl[4] cntl[5]

Unused memory (Characters)

[Return]

0: Normal completion.

[Description] This function reads the CNC program memory information. You can read the number of CNC programs, the number of CNC programs that you can register, and the used and unused characters in the memory can be read. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.

[Related Function] cnc_rdproginfo ()


-200-

3.12.37 Start Reading of the CNC Program List (Supported 8 Digits Program Number) [Name]

pl_nc_pdirstart_8d

[Syntax] #include <pmclib.h> short pl_nc_pdirstart_8d(short type, long * cntl);

[Arguments] Input

type: Data type Set the data type that you want to read. 0: Read the CNC program number 1: Read the CNC program number, comment and




Output

---

[Return] 0: Normal completion. 3: The "type" is invalid.

[Description] This function starts reading of the CNC program list. You should call the pl_nc_pdirstart_8d() before the calling of the pl_nc_progdir(). You should call the pl_nc_pdirend() after the calling of the pl_nc_progdir(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-201-

3.12.38 Start Reading of the CNC Program List [Name]

pl_nc_pdirstart

[Syntax] #include <pmclib.h> short pl_nc_pdirstart(short type, short * cntl);

[Arguments] Input

type: Data type Set the data type that you want to read. 0: Read the CNC program number 1: Read the CNC program number, comment and




Output

---

[Return] 0: Normal completion. 3: The "type" is invalid.

[Description] This function starts reading of the CNC program list. You should call the pl_nc_pdirstart() before the calling of the pl_nc_progdir(). You should call the pl_nc_pdirend() after the calling of the pl_nc_progdir(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-202-

3.12.39 Read the CNC Program List [Name]

pl_nc_progdir

[Syntax] #include <pmclib.h> short pl_nc_progdir(char * buf, unsigned short * size);

[Arguments] Input

buf: The pointer to the array to store the read data Set the pointer to the array, which the read data is

stored. *size: Size of array Set the size of array. You can set 256 bytes in the

maximum. Output

*buf: Read CNC program list - When you set zero to the "type", the data will

be read with following format. "OxxxxOxxxx ... %"

- When you set 1 to the "type", the data will be read with following format.

- "%¥nOxxxx(Comment)yyyy¥nOxxxx(Comment)yyyy¥n...%"

The "Oxxxx" is the CNC program number, which sorted by its character code. The "yyyy" is the number of characters of the CNC program and this size is rounded off to 80 characters unit. The "(Comment)" is a comment string, which is described after the program number "Oxxxx". The comment that you can read is 50 characters, included "()", in the maximum. The characters over 50 cannot be read. When no comment is described, the "()" will be returned. Note that this read comment is not terminated with NULL ('¥0').

[Return]

0: Normal completion. -1: Rejected When the CNC is following status, this function


Verifying, Uploading, listing program)


-203-

- Alarm state of P/S 000 or P/S 101 - The CNC is in background editing mode or

MDI mode. -2: Reset state -11: The function pl_nc_pdirstart() is not called. 2: The "size" is invalid.

[Description] This function reads the CNC program list. You should call the pl_nc_pdirstart_8d() or the pl_nc_pdirstart() before the calling of the pl_nc_progdir(). You should call the pl_nc_pdirend() after the calling of the pl_nc_progdir(). The end of data is the "%". Call until the "%" character is read repeatedly. When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-204-

3.12.40 End Reading of the Program List [Name]

pl_nc_pdirend

[Syntax] #include <pmclib.h> short pl_nc_pdirend(void);

[Arguments] Input

--- Output

---

[Return] 0: Normal completion. -11: The function pl_nc_pdirstart() is not called.

[Description] This function ends the reading of the CNC program list. You should call the pl_pdirend() after the calling of the pl_progdir(). When you use this function, you cannot use the conventional function related to the CNC program operation in "C library for C executor" together.



-205-

3.13 CHARACTER CODE CONVERSION

3.13.1 Convert Characters from ASCII to ISO Code [Name]

pl_asciso

[Syntax] #include <pmclib.h> void pl_asciso(unsigned short size, char * buf);

[Arguments] Input

size: The size of characters to be converted (1 to 65535) buf: Pointer to the source of conversion

Output *buf: Converted data

[Return] ---

[Description] This function converts characters from ASCII to ISO code.

[Related Function] ---


-206-

3.13.2 Convert Characters from ISO to ASCII Code [Name]

pl_isoasc

[Syntax] #include <pmclib.h> void pl_isoasc(unsigned short size, char * buf);

[Arguments] Input

size: The size of characters to be converted (1 to 65535) buf: Pointer to the source of conversion

Output *buf: Converted data

[Return] ---

[Description] This function converts characters from ASCII to ISO code.

[Related Function] ---

B- 64183EN/01 4.CHARACTER CODE (KANJI, HIRAGANA AND OTHERS)

-207-

4 CHARACTER CODE (KANJI, HIRAGANA AND OTHERS)

JIS Shift JIS 0 1 2 3 4 5 6 7 8 9 A B C D E F

2120 813F 全角空白 , 。 , ．・：；？！ " ゜ ´ ｀ ¨

2130 814F ＾￣＿ヽヾゝゞ〃仝々〆〇ー ― ‐ ／

2140 815F ＼～ ∥ ｜ … ‥ ' ' " " （）〔〕［］

2150 816F ｛｝〈〉《》「」『』【】＋－ ± ×2160 8180 ÷ ＝ ≠ ＜＞ ≦ ≧ ∞ ∴ ♂ ♀ ° ′ ″ ℃ ￥

2170 8190 ＄￠￡％＃＆＊＠ § ☆ ★ ○ ● ◎ ◇

Sym

bol

2220 819E ◆ □ ■ △ ▲ ▽ ▼ ※ 〒 → ← ↑ ↓ 〓 2330 824F ０１２３４５６７８９ 2340 825F ＡＢＣＤＥＦＧＨＩＪＫＬＭＮＯ

2350 826F ＰＱＲＳＴＵＶＷＸＹＺ 2360 8280 ａｂｃｄｅｆｇｈｉｊｋｌｍｎｏN

um/A

lph

2370 8290 ｐｑｒｓｔｕｖｗｘｙｚ 2420 829E ぁあぃいぅうぇえぉおかがきぎく

2430 82AE ぐけげこごさざしじすずせぜそぞた

2440 82BE だちぢっつづてでとどなにぬねのは

2450 82CE ばぱひびぴふぶぷへべぺほぼぽまみ

2460 82DE むめもゃやゅゆょよらりるれろゎわHira

gana

2470 82EE ゐゑをん 2520 833F ァアィイゥウェエォオカガキギク

2530 834F グケゲコゴサザシジスズセゼソゾタ

2540 835F ダチヂッツヅテデトドナニヌネノハ

2550 836F バパヒビピフブプヘベペホボポマミ

2560 8380 ムメモャヤュユョヨラリルレロヮワKat

akan

a

2570 8390 ヰヱヲンヴヵヶ 2620 839E Α Β Γ Δ Ε Ζ Η Θ Ι Κ Λ Μ Ν Ξ Ο

2630 83AE Π Ρ Σ Τ Υ Φ Χ Ψ Ω 2640 83BE α β γ δ ε ζ η θ ι κ λ μ ν ξ οG

reek

2650 83CE π ρ σ τ υ φ χ ψ ω The marked character, " ", cannot be used.

4.CHARACTER CODE (KANJI, HIRAGANA AND OTHERS) B- 64183EN/01

-208-


01E0 ┬ ┐ ┤ ┘ ┴ └ ├ ┌ ─ │ ┼

2F40 885F

Spec

ial

2F50 886F


-209-


3020 889E 亜唖娃阿哀愛挨姶逢葵茜穐悪握渥

3030 88AE 旭葦芦鯵梓圧斡扱宛姐虻飴絢綾鮎或

3040 88BE 粟袷安庵按暗案闇鞍杏以伊位依偉囲Kan

ji

3050 88CE 夷委威尉惟意慰易椅為畏異移維緯胃

3060 88DE 萎衣謂違遺医井亥域育郁磯一壱溢逸

3070 88EE 稲茨芋鰯允印咽員因姻引飲淫胤蔭

3120 893F 院陰隠韻吋右宇烏羽迂雨卯鵜窺丑

3130 894F 碓臼渦嘘唄欝蔚鰻姥厩浦瓜閏噂云運

3140 895F 雲荏餌叡営嬰影映曳栄永泳洩瑛盈穎

3150 896F 頴英衛詠鋭液疫益駅悦謁越閲榎厭円

3160 8980 園堰奄宴延怨掩援沿演炎焔煙燕猿縁

3170 8990 艶苑薗遠鉛鴛塩於汚甥凹央奥往応

3220 899E 押旺横欧殴王翁襖鴬鴎黄岡沖荻億

3230 89AE 屋憶臆桶牡乙俺卸恩温穏音下化仮何

3240 89BE 伽価佳加可嘉夏嫁家寡科暇果架歌河

3250 89CE 火珂禍禾稼箇花苛茄荷華菓蝦課嘩貨

3260 89DE 迦過霞蚊俄峨我牙画臥芽蛾賀雅餓駕

3270 89EE 介会解回塊壊廻快怪悔恢懐戒拐改

3320 8A3F 魁晦械海灰界皆絵芥蟹開階貝凱劾

3330 8A4F 外咳害崖慨概涯碍蓋街該鎧骸浬馨蛙

3340 8A5F 垣柿蛎鈎劃嚇各廓拡撹格核殻獲確穫

3350 8A6F 覚角赫較郭閣隔革学岳楽額顎掛笠樫

3360 8A80 橿梶鰍潟割喝恰括活渇滑葛褐轄且鰹

3370 8A90 叶椛樺鞄株兜竃蒲釜鎌噛鴨栢茅萱

3420 8A9E 粥刈苅瓦乾侃冠寒刊勘勧巻喚堪姦

3430 8AAE 完官寛干幹患感慣憾換敢柑桓棺款歓

3440 8ABE 汗漢澗潅環甘監看竿管簡緩缶翰肝艦

3450 8ACE 莞観諌貫還鑑間閑関陥韓館舘丸含岸

3460 8ADE 巌玩癌眼岩翫贋雁頑顔願企伎危喜器

3470 8AEE 基奇嬉寄岐希幾忌揮机旗既期棋棄

3520 8B3F 機帰毅気汽畿祈季稀紀徽規記貴起

3530 8B4F 軌輝飢騎鬼亀偽儀妓宜戯技擬欺犠疑

3540 8B5F 祇義蟻誼議掬菊鞠吉吃喫桔橘詰砧杵

3550 8B6F 黍却客脚虐逆丘久仇休及吸宮弓急救

3560 8B80 朽求汲泣灸球究窮笈級糾給旧牛去居

3570 8B90 巨拒拠挙渠虚許距鋸漁禦魚亨享京

3620 8B9E 供侠僑兇競共凶協匡卿叫喬境峡強

3630 8BAE 彊怯恐恭挟教橋況狂狭矯胸脅興蕎郷

3640 8BBE 鏡響饗驚仰凝尭暁業局曲極玉桐粁僅

3650 8BCE 勤均巾錦斤欣欽琴禁禽筋緊芹菌衿襟

3660 8BDE 謹近金吟銀九倶句区狗玖矩苦躯駆駈

3670 8BEE 駒具愚虞喰空偶寓遇隅串櫛釧屑屈

3720 8C3F 掘窟沓靴轡窪熊隈粂栗繰桑鍬勲君

3730 8C4F 薫訓群軍郡卦袈祁係傾刑兄啓圭珪型


-210-


3740 8C5F 契形径恵慶慧憩掲携敬景桂渓畦稽系

3750 8C6F 経継繋罫茎荊蛍計詣警軽頚鶏芸迎鯨

3760 8C80 劇戟撃激隙桁傑欠決潔穴結血訣月件Kan

ji

3770 8C90 倹倦健兼券剣喧圏堅嫌建憲懸拳捲

3820 8C9E 検権牽犬献研硯絹県肩見謙賢軒遣

3830 8CAE 鍵険顕験鹸元原厳幻弦減源玄現絃舷

3840 8CBE 言諺限乎個古呼固姑孤己庫弧戸故枯

3850 8CCE 湖狐糊袴股胡菰虎誇跨鈷雇顧鼓五互

3860 8CDE 伍午呉吾娯後御悟梧檎瑚碁語誤護醐

3870 8CEE 乞鯉交佼侯候倖光公功効勾厚口向

3920 8D3F 后喉坑垢好孔孝宏工巧巷幸広庚康

3930 8D4F 弘恒慌抗拘控攻昂晃更杭校梗構江洪

3940 8D5F 浩港溝甲皇硬稿糠紅紘絞綱耕考肯肱

3950 8D6F 腔膏航荒行衡講貢購郊酵鉱砿鋼閤降

3960 8D80 項香高鴻剛劫号合壕拷濠豪轟麹克刻

3970 8D90 告国穀酷鵠黒獄漉腰甑忽惚骨狛込

3A20 8D9E 此頃今困坤墾婚恨懇昏昆根梱混痕

3A30 8DAE 紺艮魂些佐叉唆嵯左差査沙瑳砂詐鎖

3A40 8DBE 裟坐座挫債催再哉塞妻宰彩才採栽

3A50 8DCE 歳済災采犀砕砦祭斎細菜裁載際剤在

3A60 8DDE 材罪財冴坂阪堺榊肴咲崎埼碕鷺作削

3A70 8DEE 咋搾昨朔柵窄策索錯桜鮭笹匙冊刷

3B20 8E3F 察拶撮擦札殺薩雑皐鯖捌錆鮫皿晒

3B30 8E4F 三傘参山惨撒散桟燦珊産算纂蚕讃賛

3B40 8E5F 酸餐斬暫残仕仔伺使刺司史嗣四士始

3B50 8E6F 姉姿子屍市師志思指支孜斯施旨枝止

3B60 8E80 死氏獅祉私糸紙紫肢脂至視詞詩試誌

3B70 8E90 諮資賜雌飼歯事似侍児字寺慈持時

3C20 8E9E 次滋治爾璽痔磁示而耳自蒔辞汐鹿

3C30 8EAE 式識鴫竺軸宍雫七叱執失嫉室悉湿漆

3C40 8EBE 疾質実蔀篠偲柴芝屡蕊縞舎写射捨赦

3C50 8ECE 斜煮社紗者謝車遮蛇邪借勺尺杓灼爵

3C60 8EDE 酌釈錫若寂弱惹主取守手朱殊狩珠種

3C70 8EEE 腫趣酒首儒受呪寿授樹綬需囚収周

3D20 8F3F 宗就州修愁拾洲秀秋終繍習臭舟蒐

3D30 8F4F 衆襲讐蹴輯週酋酬集醜什住充十従戎

3D40 8F5F 柔汁渋獣縦重銃叔夙宿淑祝縮粛塾熟

3D50 8F6F 出術述俊峻春瞬竣舜駿准循旬楯殉淳

3D60 8F80 準潤盾純巡遵醇順処初所暑曙渚庶緒

3D70 8F90 署書薯藷諸助叙女序徐恕鋤除傷償


-211-


3E20 8F9E 勝匠升召哨商唱嘗奨妾娼宵将小少

3E30 8FAE 尚庄床廠彰承抄招掌捷昇昌昭晶松梢

3E40 8FBE 樟樵沼消渉湘焼焦照症省硝礁祥称章Kan

ji

3E50 8FCE 笑粧紹肖菖蒋蕉衝裳訟証詔詳象賞醤

3E60 8FDE 鉦鍾鐘障鞘上丈丞乗冗剰城場壌嬢常

3E70 8FEE 情擾条杖浄状畳穣蒸譲醸錠嘱埴飾

3F20 903F 拭植殖燭織職色触食蝕辱尻伸信侵

3F30 904F 唇娠寝審心慎振新晋森榛浸深申疹真

3F40 905F 神秦紳臣芯薪親診身辛進針震人仁刃

3F50 906F 塵壬尋甚尽腎訊迅陣靭笥諏須酢図厨

3F60 9080 逗吹垂帥推水炊睡粋翠衰遂酔錐錘随

3F70 9090 瑞髄崇嵩数枢趨雛据杉椙菅頗雀裾

4020 909E 澄摺寸世瀬畝是凄制勢姓征性成政

4030 90AE 整星晴棲栖正清牲生盛精聖声製西誠

4040 90BE 誓請逝醒青静斉税脆隻席惜戚斥昔析

4050 90CE 石積籍績脊責赤跡蹟碩切拙接摂折設

4060 90DE 窃節説雪絶舌蝉仙先千占宣専尖川戦

4070 90EE 扇撰栓栴泉浅洗染潜煎煽旋穿箭線

4120 913F 繊羨腺舛船薦詮賎践選遷銭銑閃鮮

4130 914F 前善漸然全禅繕膳糎噌塑岨措曾曽楚

4140 915F 狙疏疎礎祖租粗素組蘇訴阻遡鼠僧創

4150 916F 双叢倉喪壮奏爽宋層匝惣想捜掃挿掻

4160 9180 操早曹巣槍槽漕燥争痩相窓糟総綜聡

4170 9190 草荘葬蒼藻装走送遭鎗霜騒像増憎

4220 919E 臓蔵贈造促側則即息捉束測足速俗

4230 91AE 属賊族続卒袖其揃存孫尊損村遜他多

4240 91BE 太汰詑唾堕妥惰打柁舵楕陀駄騨体堆

4250 91CE 対耐岱帯待怠態戴替泰滞胎腿苔袋貸

4260 91DE 退逮隊黛鯛代台大第醍題鷹滝瀧卓啄

4270 91EE 宅托択拓沢濯琢託鐸濁諾茸凧蛸只

4320 923F 叩但達辰奪脱巽竪辿棚谷狸鱈樽誰

4330 924F 丹単嘆坦担探旦歎淡湛炭短端箪綻耽

4340 925F 胆蛋誕鍛団壇弾断暖檀段男談値知地

4350 926F 弛恥智池痴稚置致蜘遅馳築畜竹筑蓄

4360 9280 逐秩窒茶嫡着中仲宙忠抽昼柱注虫衷

4370 9290 註酎鋳駐樗瀦猪苧著貯丁兆凋喋寵

4420 929E 帖帳庁弔張彫徴懲挑暢朝潮牒町眺

4430 92AE 聴脹腸蝶調諜超跳銚長頂鳥勅捗直朕

4440 92BE 沈珍賃鎮陳津墜椎槌追鎚痛通塚栂掴

4450 92CE 槻佃漬柘辻蔦綴鍔椿潰坪壷嬬紬爪吊

4460 92DE 釣鶴亭低停偵剃貞呈堤定帝底庭廷弟

4470 92EE 悌抵挺提梯汀碇禎程締艇訂諦蹄逓

4520 933F 邸鄭釘鼎泥摘擢敵滴的笛適鏑溺哲

4530 934F 徹撤轍迭鉄典填天展店添纏甜貼転顛

4540 935F 点伝殿澱田電兎吐堵塗妬屠徒斗杜渡


-212-


4550 936F 登菟賭途都鍍砥砺努度土奴怒倒党冬

4560 9380 凍刀唐塔塘套宕島嶋悼投搭東桃梼棟

4570 9390 盗淘湯涛灯燈当痘祷等答筒糖統到 Kan

ji

4620 939E 董蕩藤討謄豆踏逃透鐙陶頭騰闘働

4630 93AE 動同堂導憧撞洞瞳童胴萄道銅峠鴇匿

4640 93BE 得徳涜特督禿篤毒独読栃橡凸突椴届

4650 93CE 鳶苫寅酉瀞噸屯惇敦沌豚遁頓呑曇鈍

4660 93DE 奈那内乍凪薙謎灘捺鍋楢馴縄畷南楠

4670 93EE 軟難汝二尼弐迩匂賑肉虹廿日乳入

4720 943F 如尿韮任妊忍認濡禰祢寧葱猫熱年

4730 944F 念捻撚燃粘乃廼之埜嚢悩濃納能脳膿

4740 945F 農覗蚤巴把播覇杷波派琶破婆罵芭馬

4750 946F 俳廃拝排敗杯盃牌背肺輩配倍培媒梅

4760 9480 楳煤狽買売賠陪這蝿秤矧萩伯剥博拍

4770 9490 柏泊白箔粕舶薄迫曝漠爆縛莫駁麦

4820 949E 函箱硲箸肇筈櫨幡肌畑畠八鉢溌発

4830 94AE 醗髪伐罰抜筏閥鳩噺塙蛤隼伴判半反

4840 94BE 叛帆搬斑板氾汎版犯班畔繁般藩販範

4850 94CE 釆煩頒飯挽晩番盤磐蕃蛮匪卑否妃庇

4860 94DE 彼悲扉批披斐比泌疲皮碑秘緋罷肥被

4870 94EE 誹費避非飛樋簸備尾微枇毘琵眉美

4920 953F 鼻柊稗匹疋髭彦膝菱肘弼必畢筆逼

4930 954F 桧姫媛紐百謬俵彪標氷漂瓢票表評豹

4940 955F 廟描病秒苗錨鋲蒜蛭鰭品彬斌浜瀕貧

4950 956F 賓頻敏瓶不付埠夫婦富冨布府怖扶敷

4960 9580 斧普浮父符腐膚芙譜負賦赴阜附侮撫

4970 9590 武舞葡蕪部封楓風葺蕗伏副復幅服

4A20 959E 福腹複覆淵弗払沸仏物鮒分吻噴墳

4A30 95AE 憤扮焚奮粉糞紛雰文聞丙併兵塀幣平

4A40 95BE 弊柄並蔽閉陛米頁僻壁癖碧別瞥蔑箆

4A50 95CE 偏変片篇編辺返遍便勉娩弁鞭保舗鋪

4A60 95DE 圃捕歩甫補輔穂募墓慕戊暮母簿菩倣

4A70 95EE 俸包呆報奉宝峰峯崩庖抱捧放方朋

4B20 963F 法泡烹砲縫胞芳萌蓬蜂褒訪豊邦鋒

4B30 964F 飽鳳鵬乏亡傍剖坊妨帽忘忙房暴望某

4B40 965F 棒冒紡肪膨謀貌貿鉾防吠頬北僕卜墨

4B50 966F 撲朴牧睦穆釦勃没殆堀幌奔本翻凡盆

4B60 9680 摩磨魔麻埋妹昧枚毎哩槙幕膜枕鮪柾

4B70 9690 鱒桝亦俣又抹末沫迄侭繭麿万慢満

4C20 969E 漫蔓味未魅巳箕岬密蜜湊蓑稔脈妙

4C30 96AE 粍民眠務夢無牟矛霧鵡椋婿娘冥名命

4C40 96BE 明盟迷銘鳴姪牝滅免棉綿緬面麺摸模


-213-


4C50 96CE 茂妄孟毛猛盲網耗蒙儲木黙目杢勿餅

4C60 96DE 尤戻籾貰問悶紋門匁也冶夜爺耶野弥

4C70 96EE 矢厄役約薬訳躍靖柳薮鑓愉愈油癒 Kan

ji

4D20 973F 諭輸唯佑優勇友宥幽悠憂揖有柚湧

4D30 974F 涌猶猷由祐裕誘遊邑郵雄融夕予余与

4D40 975F 誉輿預傭幼妖容庸揚揺擁曜楊様洋溶

4D50 976F 熔用窯羊耀葉蓉要謡踊遥陽養慾抑欲

4D60 9780 沃浴翌翼淀羅螺裸来莱頼雷洛絡落酪

4D70 9790 乱卵嵐欄濫藍蘭覧利吏履李梨理璃

4E20 979E 痢裏裡里離陸律率立葎掠略劉流溜

4E30 97AE 琉留硫粒隆竜龍侶慮旅虜了亮僚両凌

4E40 97BE 寮料梁涼猟療瞭稜糧良諒遼量陵領力

4E50 97CE 緑倫厘林淋燐琳臨輪隣鱗麟瑠塁涙累

4E60 97DE 類令伶例冷励嶺怜玲礼苓鈴隷零霊麗

4E70 97EE 齢暦歴列劣烈裂廉恋憐漣煉簾練聯

4F20 983F 蓮連錬呂魯櫓炉賂路露労婁廊弄朗

4F30 984F 楼榔浪漏牢狼篭老聾蝋郎六麓禄肋録

4F40 985F 論倭和話歪賄脇惑枠鷲亙亘鰐詫藁蕨

4F50 986F 椀湾碗腕 The marked character, " ", cannot be used.

B-64183EN/01 INDEX

i-1

INDEX <A>

ACCESS TO THE EXTENDED NONVOLATILE

MEMORY.......................................................................76

ACCESS TO THE PMC ADDRESS ..............................55

<C> Change Attribute of the Characters Being Displayed .....89

Character Code................................................................81

CHARACTER CODE (KANJI, HIRAGANA AND

OTHERS)......................................................................207

CHARACTER CODE CONVERSION ........................205

CHARACTER DISPLAY...............................................79

Clear Columns.................................................................86

Clear Lines ......................................................................85

Clear the Event Flag........................................................33

Clear the Graphic Screen ..............................................111

Close the Graphic Screen ..............................................110

Close the Reader / Puncher Interface .................... 127, 141

CNC HARDWARE...........................................................9

CNC PROGRAM.......................................................... 155

CNC WINDOW ............................................................150

CNC Window Function (Read) .....................................150

CNC Window Function (Write) ....................................152

Color Palette for Graphic Display .................................107

Color Palette for the Character Display ..........................79

COMPATIBILITY WITH THE "C LIBRARY FOR

C LANGUAGE BOARD" ..............................................10

Control a Key-in Line .....................................................46

Control the Screen.........................................................101

CONVERSION POINTS ................................................13

Convert Characters from ASCII to ISO Code ...............205

Convert Characters from ISO to ASCII Code ...............206

Coordinates of the Character Screen ...............................80

Coordinates of the Graphic Screen................................108

Create a Semaphore.........................................................35

Create an Event Flag .......................................................29

<E> Delete All CNC Programs..................................... 166, 191

Delete the CNC Program....................................... 168, 193

Delete the CNC Program

(Supported 8 Digits Program Number) .........................167

Delete the CNC Program


Delete the Event Flag ......................................................30

Delete the File ....................................................... 136, 148

Delete the Semaphore......................................................36

Disable Custom Keys ......................................................53

Disable Function Keys ....................................................50

Display ASCII Characters ...............................................90

Display Characters (ASCII, Kanji and Hiragana) ..........96

Display Characters

(Kanji, Hiragana and Special Characters) .......................91

Display Cursor ................................................................94

Display Hex Size Characters...........................................93

Display or Hide the Graphic Screen..............................112

Draw an Arc ..................................................................116

Draw Straight Lines ......................................................115

<E> Enable Custom Keys .......................................................54

Enable Function Keys .....................................................51

End DNC Running of the CNC Program ..............163, 188

End Reading of the CNC Program ........................173, 198

End Reading of the Program List .......................... 180, 204

End Registration of the CNC Program..................158, 184

Erase the Entire Screen ...................................................84

Erase the Square............................................................121

External Data Input .......................................................154

<F> FUNCTION LIST ...........................................................19

FUNCTION REFERENCE.............................................18

<G> Get Graphic Screen Status.............................................120

Get Size of the Extended Nonvolatile Memory...............78

Get the File Information........................................134, 147

GETTING STARTED.......................................................1

GRAPHIC DISPLAY....................................................107

<H> HOW TO MAKE APPLICATION ...................................4

Initialize a Character Screen

(80 Columns x 25 Lines or 40 Columns x 16 Lines).......83

INDEX B-64183EN/01

i-2

<I> Initialize printf() ............................................................106

Initialize the Character Screen

(74 Columns x 27 Lines) ............................................... 104


(74 Columns x 30 Lines) ............................................... 105


(80 Columns x 30 Lines) .................................................82

INSTALLATION OF THE "C LIBRARY FOR

CONVERSION" ON A PERSONAL COMPUTER .........5

<M> MDI Key Code Table......................................................42

MDI KEYS .....................................................................42

<O> Open the Graphic Screen...............................................109

Open the Reader / Puncher Interface..................... 124, 138

Open the Reader / Puncher Interface

(for FANUC Handy File) ...................................... 130, 144

<P> Paint ..............................................................................118

<R> Read a Function Key.......................................................52

Read a Message in LADDER Program ...........................75

Read CNC Information ...................................................70

Read from the Extended Nonvolatile Memory................76

Read from the PMC Address (bit)...................................56

Read from the PMC Address (char) ................................58

Read from the PMC Address (long)................................60

Read from the PMC Address (short) ...............................59

Read from the PMC Address (unsigned char).................61

Read from the PMC Address (unsigned long).................63

Read from the PMC Address (unsigned short)................62

Read from the Reader / Puncher Interface ............ 128, 142

Read key..........................................................................44

Read Key Status ..............................................................49

Read Symbol and Comment in LADDER Program ........73

Read Symbol and Comment in LADDER Program

(16 characters symbol is available) .................................71

READ SYSTEM INFORMATION.................................70

Read the CNC Program......................................... 171, 196

Read the CNC Program List.................................. 178, 202

Read the CNC Program Memory Information ...... 174, 199

Read the Task Timer Value.............................................25

READER / PUNCHER INTERFACE ..........................123

Register the CNC Program....................................156, 182

RELATED DRAWING NUMBER...................................3

Restore the Character Screen ........................................100

Run the CNC Program (DNC running) .................161, 186

<S> Save the Character Screen...............................................98

Search the CNC Program ......................................165, 190

Search the CNC Program

(Supported 8 Digits Program Number) .................164, 189

Set a Display Attribute ....................................................88

Set a Display Position .....................................................87

Set a Graphic Color .......................................................114

Set a Graphic Line Type ...............................................113

Set Background Color of the Character Screen.............102

Set Palette for Character Screen....................................103

Set Palette for the Graphic Screen.................................122

Set the Event Flag ...........................................................31

Set the Event Flag (Pulse type) .......................................34

Set the Semaphore...........................................................37

Set the Task Timer Value................................................26

Shift...............................................................................119

Start DNC running of the CNC Program...............159, 185

Start Reading of the CNC Program.......................170, 195

Start Reading of the CNC Program

(Supported 8 Digits Program Number) .................169, 194

Start Reading of the CNC Program List ................177, 201

Start Reading of the CNC Program List


Start Reading of the CNC Program List


Start Registration of the CNC Program.................155, 181

SWITCH SCREEN .........................................................39

Switch to the CNC Screen...............................................41

Switch to the User Application Screen............................39

SYSTEM CALL..............................................................25

<W> Wait for Switching to the User Application Screen ........40

Wait for the Event Flag ...................................................32

Wait for the Semaphore...................................................38

Wait for the Timer Value ................................................27

Wait for Time..................................................................28

B-64183EN/01 INDEX

i-3

Write to the Extended Nonvolatile Memory ...................77

Write to the PMC Address (bit) ......................................57

Write to the PMC Address (char)....................................64

Write to the PMC Address (long)....................................66

Write to the PMC Address (short)...................................65

Write to the PMC Address (unsigned char).....................67

Write to the PMC Address (unsigned long) ....................69

Write to the PMC Address (unsigned short) ...................68

Write to the Reader / Puncher Interface ................ 129, 143

Rev

isio

n R

ecor

d

FAN

UC

Srie

s 30i/3

00i/3

00is

-MO

DE

L A

, Ser

ies

31i/3

10i/3

10is

-MO

DE

L A

5, S

erie

s 31i/3

10i/3

10is

-MO

DE

L A

, S

erie

s 32i/3

20i/3

20is

-MO

DE

L A

C L

angu

age

Exe

cuto

r Lib

rary

(For

Con

vers

ion

from

PM

C C

Lan

guag

e Fu

nctio

n)

PR

OG

RA

MM

ING

MA

NU

AL

(B-6

4183

EN

)

01

Ju

l., 2

004

Edi

tion

Dat

e C

onte

nts

Edi

tion

Dat

e C

onte

nts

Date post:	23-Mar-2018
Category:	Documents
Upload:	buinhi
View:	261 times
Download:	8 times

C Language Executor Library (For Conversion from … MANUAL B-64183EN/01 C Language Executor Library...

Documents