README

nxgipd v1.1.1
=============

nxgipd is a monitoring daemon for UTC Interlogix/GE Security/Caddx NetworX
series alarm systems that use the NetworX NX-584 protocol.

Daemon process requires very minimal memory and CPU resource making it suitable
to be run in on almost any hardware that runs Linux (or feel free to port
this to your favorite OS :-)
nxgipd daemon process is meant to continuously monitor the alarm panel and
log any activity into local log file and/or to syslog.
Daemon process can run designated script as response to different events
(such as alarm, zone tripped, etc.), making it easy to perform custom
actions or monitor the alarm yourself.

Command line tools nxstat and nxcmd allow real-time polling of the alarm
status and interact with the alarm.

NOTE! Before you can use this program you typically need to first install
NX-584E (home automation) module or enable built-in serial port (NX-8E panel).
If you don't know the program code (PIN) for your panel, you may need to get
your alarm provider to do this for you.

This program does not interfere with alarm monitoring services, so it can be
used on systems monitored by a third-party (as additional means of monitoring
the alarm system).
Alternatively, this program could be used to build "DIY" monitoring solution
withouth requiring a third party monitoring provider.



SUPPORTED ALARM PANEL MODELS

	NX-4 (V2)
	NX-6 (V2)
	NX-8 (V2)
	NX-8E
	CS575 (Aritech)

	Other panels that use same "NetworX NX-584 RS-232 Gateway
	Interface Protocol" should work fine as well (NX-10, CS275,
        CS375, CS875, ...)


REQUIREMENTS
	Mini-XML library (libmxml) v3.0 or later version


TESTED PLATFORMS
	Linux (Debian)
	OpenBSD


INSTALLATION
	Installation should be very straightforward, just unpack the
	tar file, run configure,  make necessary changes to the Makefile,
	and then compile the program. You may want do something like this:

		tar xzvf nxgipd-1.1.1.tar.gz
		cd nxgipd-1.1.1
		./configure
		make
		make strip
		make install

	Then copy included nxgipd.conf template to /etc/nxgipd.conf and update
        it to match your setup.


SERIAL INTERFACE CONFIGURATION

       For this program to work, the NX-584 interface module (or the built-in
       serial port in NX-8E) must be configured first. For detailed
       instructions on how to do that, see the corresponding installation manuals.

       Recommended configuration settings:

       - Protocol: ASCII

       - Speed: 9600 Baud

       - Enabled Transision Messages:
       	 	 * Interface Configuration Message
		 * Zone Status Message
		 * Partition Status Message
		 * System Status Message
		 * Log Event Message
		 * Keypad Message Received (OPTIONAL)
		 * X-10 Message Received (OPTIONAL)

       - Enabled Commands:
       	 	 * Interface Configuration Request
		 * Zone Name Request
		 * Zone Status Request
		 * Zones Snapshot Request
		 * Partition Status Request
		 * Partitions Snapshot Request
		 * Send X-10 Message (OPTIONAL)
		 * Log Event Request
		 * Send Keypad Text Message (OPTIONAL)
		 * System Status Request
		 * Program Data Request (OPTIONAL)
		 * Program Data Command (OPTIONAL)
		 * Set Clock / Calendar Command
		 * Primary Keypad Function with PIN (OPTIONAL)
		 * Secondary Keypad Function (OPTIONAL)
		 * Zone Bypass Toggle (OPTIONAL)



HISTORY
	v1.1.1
	        - support for non-standard serial modes (other than "8N1")
		- added serial port locking (on Linux)
	        - updated to work with Mini-XML v3.x
		- new -r option to nxstat command
		- fix to binary protocol support
		- minor bug fixes
        v1.1.0  - new configuration setting 'savestatus' to specify status file
                  saving interval
		- SIGUSR1 signal can now be used to tell daemon to save status
		- setclock command added to nxcmd
		- added option -t to nxstat to sort zones by last change time
		- added support for programming panel using nxcmd
		- nxcmd now displays command status/result
		- support for NX-4, NX-6, and CS575 added
		- autodetection of panel features/model
		- fix bug in IPC message sizing (nxcmd didn't work correctly
		  on non x86_64 architectures)
		- new config settings to set IPC memory segment and
                  message queue user/group
		- new config setting 'maxprocesses' to prevent too many
		  trigger scripts running simultaneously
		- add --csv option to nxstat command
		- minor fixes
	v1.0.1  - add support for systems withouth zone names (no NX-148E)
		- fix to PIN number ordering in nxmcd (thanks to Dogora)
		- minor tweaks to allow compiling on OSX (and other BSDs)...
	v1.0.0  - support for running a script/command as response
		  to events (alarm, zone tripped, etc..)
		- support for sending X-10 commands via nxcmd
		- support for sending Zone Bypass command via nxcmd
		- support for display custom messages on NX-148 keypads
		  using nxcmd
		- added zone status saving/restore
		- new command nxcmd to send (keypad) commands to alarm panel
		  (based on initial implmementation by Brian Whaley)
		- new option -i for nxstat to display interface status
		- lot of minor fixes
	v0.9.0	- first public release



LATEST VERSION

	Latest version is always available from:
		http://www.iki.fi/tjko/projects.html

	Sources (GIT)
		https://github.com/tjko/nxgipd


Timo <tjko@iki.fi>
15-Apr-2023