Help Topics

Topic Details for Soft Logic

Help - Soft Logic Addresses

Overview:

Data for the "Ck" soft logic library is stored in a data table which is divided into distinct types. The sizes and limits on the data table and constants are defined below.

Data Types:

Type	Size (bytes)	Min Value	Max Value
Signed integer	2	-32768	32767
Signed double integer	4	-2147483648	2147483647
Floating point	Undefined	-1.5e+308¹	1.5e+308¹
Unsigned integer (hex)	2	0	65535
Single character	1	N/A	N/A
Text string	Undefined	N/A	N/A

¹THe maximum constant that can be entered is +/- 1.9e307.

Data Table Addresses:

All data is stored in data table addresses. These addresses are either "bit" (boolean) or "register" (word) addresses. Each data table begins at "1" (not "0"), and extends to the maximum address listed below.

Prefix	Description	Max	Type	Example
X	Inputs	2000	Boolean	X9
Y	Outputs	2000	Boolean	Y1023
C	Control relays	2000	Boolean	C58
T	Timer status	500	Boolean	T421
CT	Counter status	250	Boolean	CT6
SC	System control	1000	Boolean	SC21
DS	Data register	10000	Integer	DS6432
DD	Data register	2000	Double integer	DD4
DH	Data register	2000	Unsigned integer	DH100
DF	Data register	2000	Floating point	DF57
XD	Input register	125	Unsigned integer	XD1
YD	Output register	125	Unsigned integer	YD99
XS	Input register	125	Signed integer	XS1
YS	Output register	125	Signed integer	YS99
TD	Timer current value	500	Integer ¹	TD45
CTD	Counter current value	250	Double integer ¹	CTD3
SD	System data	1000	Integer	SD9
TXT	Text data	10000	ASCII	TXT7420

¹ Only positive numbers (0 to max) are allowed for these addresses.

Pointers or Indirect Addressing

Pointer (indirect) addressing is provided by the COPY instruction. See the documentation on that instruction for details.

Differences from the Koyo "Click"

The maximum address permitted by the Ck soft logic library is in some cases larger than that permitted by the Koyo "Click".

The Ck library implements the X, Y, XD, and YD addresses slightly differently from the Koyo "Click". This is because the I/O hardware is different, which means that an exact correspondence would make little sense.

The differences are as follows:

X & Y - All addresses from 1 up to the maximum are permitted as legal addresses. The mapping of physical I/O to "X" & "Y" addresses is configuration dependent.
XD & YD - These registers are not related to the "X" or "Y" bit addresses. That is, the states of "X" or "Y" addresses are not reflected by the values in the "XD" or "YD" registers. Instead, these registers are intended for analogue and other word I/O. The mapping of physical I/O to "XD" & "YD" addreses is configuration dependent.
XD & YD register addresses begin at "1" in order to be consistent with the numbering system used for other registers.
XS & YS register addresses are an additional register type. They differ from the XD and YD addresses in that they are signed rather than unsigned integers. These may be more convenient when dealing with signed integer data.
Any data type may be used for interfacing with external I/O. For example, it is possible to transfer data directly between external I/O and C or DS addresses. X, Y, XD, YD, XS, and YS addresses however are recommended for this purpose.

Representation

Data table addresses must be represented exactly as defined. Case is significant, so while X1 is a valid address, x1 is not. Leading zeros are not permitted. X1 is a valid address, X01 is not.

Constants:

Many instructions which accept registers addresses as inputs will also accept constants. The type of constant must be compatible with the parameter expected by the instruction.

	Type	Example
KInt	Signed integer	125
KDInt	Signed double integer	-50000
KF	Floating point	123.456 or 1.23456E+2
KHex	Unsigned integer (hex)	f73h
KTxtChar	Single character	"A"
KTxtStr	Text string	"abc123"

Hexadecimal constants must have an "h" suffix to be valid. The "h" must be lower case.
Text constants must be enclosed in double quotes (").
Integers and double integers are distinguished by the magnitude of the value. An integer constant is assumed to be a normal (single) integer unless it exceeds the maximum permitted value, in which case it is automatically promoted to a double integer. Any instruction which expects a double integer will also accept a regular integer.
Floating point numbers may be represented in decimal or exponential notation.
Leading zeros are permitted, and are not significant.

System Control Relays:

System control relays are used to provide convenience functions, or to signal error conditions.

Error relays are set immediately by the instruction which encountered the error, and remain in effect until they are reset by another instruction which uses that relay, or until the system is restarted.
Free running clock relays are updated at the start of each scan.
The "always on" relay is set at the start of scan.

Address	Description
SC1	Always ON
SC2	ON for the first program scan
SC3	Turns on and off on alternate scans
SC4	Free running clock with a 10ms period
SC5	Free running clock with a 100ms period
SC6	Free running clock with a 500ms period
SC7	Free running clock with a 1sec period
SC8	Free running clock with a 1m period
SC9	Free running clock with a 1 hour period
SC19	ON if an error occurs
SC24	There is no PLC program, or the program is invalid.
SC25	The run time system is not compatible with the program version.
SC26	The watch dog timer timed out.¹
SC27	The data table contents were lost.
SC40	An attempt was made to divide by zero.
SC43	Data overflow, underflow, or data conversion error.
SC44	An invalid address was used
SC46	A math error occurred
SC50	Set run mode to stop.¹
SC51	Resets watchdog timer to zero.¹

Notes: 1 = Not implemented at this time. The SC relays are not writable by a user instruction.

System Control Registers:

System control registers are used to provide convenience functions, or to signal error conditions.

Address	Description
SD1	Current PLC error code¹
SD5	Low word of runtime version¹
SD6	High word of runtime version¹
SD9	Counts number of scans (rolls over at 32,767)
SD10	The current scan time
SD11	The minimum scan time since starting
SD12	The maximum scan time since starting
SD20	Real time clock year
SD21	Real time clock month
SD22	Real time clock day
SD23	Real time clock day of week (where Mon = 0) ²
SD24	Real time clock hour
SD25	Real time clock minute
SD26	Real time clock second

1 = Not implemented at this time.

2 = This is different than the Click hardware.

Subroutines:

Subroutines are referenced by names which may be from 1 to 24 characters long and which may contain the charcters a to z, A to Z and 1 to 9. No other characters are permitted, and no spaces are permitted within the name. Examples, "SubroutineName1", or "123ValidName". The following are invalid names "ThisNameIsMuchTooLongToBeAccepted", and "Bad&Characters*"

There is no limit to the number of subroutines permitted, but each subroutine name must be unique.