DigiRail NXprog

This repository

This repository contains support files to use NOVUS DigiRail NXprog devices such as NXprog RAMIX 2EA / 2SA / 4ED / 3SD ETH and NXprog RAMIX 2EA / 2SA / 4ED / 2RL ETH with the Arduino IDE.

DigiRail NXprog is an Arduino-compatible device that allows the use of high-level C/C++ programming language, which enables to implement complex algorithms, like recursion logic, state machines, statistical analysis, and mathematic equations. Therefore, this is a big advantage against the complex and old-style of the IEC mid-level programming found in most worldwide PLCs.

The user guide is a short version in English, which only shows the functions that can be used and a summary on how to use DigiRail NXprog.

Installation

Driver Installation

Windows

1. The NOVUS NXprog requires NXperience version 2.0.6.00 or above.
2. Download the latestes version of NXperience from NOVUS download page and install it.
3. Plugin the NXprog.
4. Windows will detect the board.

Linux

1. No driver installation is needed.

Installing NOVUS NXprog Core support in Arduino IDE

1. The NOVUS NXprog Core requires Arduino IDE 1.8.6 or above.
2. If not installed, download Arduino Desktop IDE
3. Follow the download and installation guidelines as described in Install the Arduino Desktop IDE
4. After installation, click File->Preferences in the Arduino IDE. A window will appear like the one shown below:

1. Click the button next to Additional Boards Manager URLs.
2. Add the reference to NOVUS platform definition

   https://www.novusautomation.com/en/package_NOVUS_NXprog_index.json

3. Save preferences, then open the Boards Manager.

1. Search for 'NXprog' in Boards Manager

1. Install the NXprog package.
2. Close Boards Manager, then click Tools->Board and select your NXproduct under 'NXprog Arduino Boards".
3. Plugin the NXprog.
4. Click Tools->Port and choose the COM port.
5. You can now upload your sketch.

Language reference

The NXprog Arduino programming language is an extension of the standard Arduino Language and it was designed to be highly compatible with existing Arduino code.

Arduino Standard Functions

Although most standard functions have the same functionality, there are small differences as listed in the following items.

Digital I/O functions

• digitalRead()
• digitalWrite()
• pinMode()
• turnOffPWM()

(see complete document at Standard Digital I/O)

Analog I/O functions

• analogRead()
• analogWrite()
• analogReference()

(see complete document at Standard Analog I/O)

Advanced I/O

• tone()
• noTone()

(see complete document at Advanced I/O)

For all other functions, please refer to Arduino functions reference.

NXprog Extended Functions

The NXprog extensions to Arduino standard language provide the required functionality to support underlying hardware.

Novus Expert Analog Input

• setMode()
• setModeLinear()
• setUnit()
• enFilter()
• setSamplingRate()
• setState()
• setSafeValue()

Novus Expert Analog Output

• setMode()
• setState()
• setPowerOnValue()
• setPowerOnState()
• setSafeValue()

Novus Expert Digital Input

• setMode()
• setFunctionMode()
• setState()
• setConnectionType()
• setDebounce()
• readCounter()
• readTimer()
• setPreset()
• applyPreset()

Novus Expert Digital Output

• setMode()
• setState()
• setSafeState()
• setPowerOnState()
• setActuationMode()
• enInstant()

Configuration Values

• Analog Configuration
• Digital Configuration

Configuration Functions

• getAInConfig()
• getAOutConfig()
• getDInConfig()
• getDOutConfig()
• getDigiRailFWVersion()

Special Features

• NXprog Modbus library - Device as Master (Client) / Slave (Server)
• Modbus registers - For use with device in Slave (Server) mode
• Watchdog timer
• Real Time Clock
• EEPROM