RSLogger PRO User manual

RSLogger
Users Manual
Ver. 1.30 © Electroware 2018 www.rslogger.com

www.rslogger.com
Introducing RSLogger: the ultimate RS232 recorder.
Main features:
512 MB fast internal FLAS ECC memory for data circular buffer
asynchronous RS232, two channel (RX & TX) recording up to 230400 bps baud rate
independent RS232 port settings (baud rate, etc) for each RX, TX channel
simultaneous recording of RX/TX channels to one common or two separated output TXT files
external USB Mass Storage support (FAT32) with intelligent automatic data backups
Ethernet connectivity (RJ45) with TTP control panel (WWW access)
Virtual COM port on USB (FTDI chip standard, multiple OS support and SDK)
Virtual COM Text Menu mode for settings and AT commands for data download & remote control.
RS232 ports forwarding/splitting mode to Virtual COM (USB) or Ethernet TCP output
Advanced Date&Time stamping (date as a file name, 1ms precision time stamps, rechargeable RTC
backup battery, built-in smart recharge circuit)
OLED 128x64 display for actual device status
Always up-to-date with secure firmware update feature and back to the factory defaults option
Micro USB connector for standard external 5VDC power adapters or USB port
Wide range of standard supply voltages (5 -12VDC), Industrial and Module versions with extended
supply voltage range (5-24VDC).
ESD safe and EMI enhanced, ultra compact, durable aluminum enclosure
programmable GPIO pins enabling additional features for industrial and module version
2 © Electroware 2018

www.rslogger.com
RSLogger front panel
USB-A: connect your USB Mass Storage here for on-demand data download, automatic backups or left unconnected.
Push Button: hidden button allows to switch display page (short) or back to factory firmware option.
Micro USB: main power supply port (5VDC) and USB Virtual COM mode communication via Micro USB cable.
RS232 DSub: RS232 channel A (RX) input (all 9 pins are 1:1 connected with channel B port at the rear panel)
RSLogger rear panel
RS232 DSub: RS232 channel B (TX) input (all 9 pins are 1:1 connected with channel A port at the front panel)
R -45: connect LAN/WAN cable to enable the Ethernet functions. Find the actual connection status on OLED display.
RSLogger Basic front panel
USB-A: connect your USB Mass Storage here for on-demand data download, automatic backups or left unconnected.
LED1: USB Mass Storage status indicator. Avoid disconnecting of the Mass Storage during read/write operation!
LED1 on when Mass storage connected, LED1 blinks while read/write, LED1 off when no drive detected.
RS232 DSub: RS232 channel A (RX) input (all 9 pins are 1:1 connected with channel B port at the rear panel)
3 © Electroware 2018
Push Button
OLED display control and
back to default function
Micro USB
5VDC power supply and
Virtual COMoperations
USB-A
USB Mass Storage
RS232 DSub 9-pin
input channel A
RS232 DSub 9-pin
input channel B
R -45
Ethernet LAN/WAN
USB-A
USB Mass Storage
RS232 DSub 9-pin
input channel A
LED 1
USB Mass Storage device
status and operations

www.rslogger.com
RSLogger Basic rear panel
Micro USB: main power supply port (5VDC) and USB Virtual COM mode communication via Micro USB cable.
RS232 DSub: RS232 channel B (TX) input (all 9 pins are 1:1 connected with channel A port at the front panel)
Push Button: hidden button enables the one-click back to factory firmware (when pressed at power up for 5s).
LED 2: system status indicator for devices without OLED display. LED2 is on as power-on indicator, LED2 blinks fast
while actual RS232 data recording to internal flash memory, LED2 blinks during back to default reset procedure.
RSLogger Industrial front panel
Detachable, 6-ways, 3.5mm pitch standard industrial terminal
connector for direct and secure wires connection:
A: RS232 link channel A (TX) input
B: RS232 link channel B (RX) input
Vcc: main power supply port (accepts 5 to 28V DC)
GND: RS232 ground and power ground (both GND pins are shorted)
AUX: auxiliary line/GPIO port for additional control (connected with push button feature)
LED 1: USB Mass Storage status indicator. Avoid disconnecting of the Mass Storage during read/write operation!
LED1 on when Mass storage connected, LED1 blinks while read/write, LED1 off when no drive detected.
LED 2: system status indicator for devices without OLED display. LED2 is on as power-on indicator, LED2 blinks fast
while actual RS232 data recording to internal flash memory, LED2 blinks during back to default reset procedure.
USB-A: connect your USB Mass Storage here for on-demand data download, automatic backups or left unconnected.
4 © Electroware 2018
Micro USB
5VDC power supply and
Virtual COMoperations
LED 2
system status indicator
Push Button
device control and
back to default function
RS232 DSub 9-pin
input channel B
LED 1 & 2
system status indicators
RS232: RX, TX, GND
GND, Vcc, Aux
USB-A
USB Mass Storage

www.rslogger.com
RSLogger Module
Micro USB: for 5VDC power (from USB port or charger) and USB VirtualCOM port modes
USB-A: USB Mass Storage port
Vcc – main supply voltage input (5-24VDC accepted for Industrial version, 5VDC only for Eco version)
GND, GND – main ground and RS232 ground terminals (notice the both ground pins are internally shorted)
B - RS232 link channel B (RX) input
A - RS232 link channel A (TX) input
GPIO1,2 – general purpose input/output ports (to be adapted to the target implementation if more features or control
are needed, please contact us in case of any requirements). The default GPIO1 and GPIO2 functionality for RSLogger
module is the “back to factory default” function described in the “Back to factory default firmware & settings” chapter.
RED LED indicator: USB Mass Storage status indicator. Avoid disconnecting of the Mass Storage during read/write
operation! LED ON: when Mass storage connected, LED blinks while read/write. LED OFF when no drive detected.
GREEN LED indicator: system status indicator for devices without OLED display. LED ON as a power-on indicator,
LED blinks fast while actual RS232 data recording to internal flash memory, LED blinks slow during back to factory
default reset procedure.
Mouting flange – use this flange and M2 screws to fix your RSLogger module on target position, if not needed it’s
possible to breake-out the flange as it’s v-scored.
5 © Electroware 2018

www.rslogger.com
1-2-3 Quick Start & Configuration
1. Power it on.
Connect the DC power supply to the MicroUSB port or dedicated terminal. External 5VDC
adapter or USB port is fine (up to 24VDC for industrial or module version). Device is ready to be
configured. For OLED featured version the display will show the welcome screen and some basic
information. Models without OLED display will show actual status using system LEDs.
2. Set it up.
By CONFIG.INI text configuration file
Via Virtual COM Text Menu (USB)
With Ethernet LAN connection
Please refer to “Configuration” chapter for detailed configuration information.
3. Record!
Once the device is already set up to meet your installation requirements it’s ready to record
RS232 data. Connect the RS232 cable (or cables) and power it on! RSLogger may act as an
end-point device to record the RX stream from one RS232 device only or can be installed in
between RS232 transmitter and receiver devices to record both side communications (RX, TX).
Please refer to “Extracting the data” chapter for available data download options explained.
4. Customization ideas?
Please contact our Team to discuss any firmware and hardware customization request. The
RSLogger project is designed as a flexible platform capable to be modified or extended at low
customization cost. Make your own, dedicated, stand-alone solution or integral part of a larger
system capable to fit your project without changing it’s entire architecture.
6 © Electroware 2018

www.rslogger.com
Settings & configuration options
Settin s with USB Mass Stora e
Simply connect the FAT32 formatted (default allocation unit size) USB Mass
Storage to the USB port located on the RSLogger device. By default the
password protection is disabled so all USB Mass Storage devices would be
accepted. You can protect the access by setting your own password latter.
Connect the USB mass storage to the USB port located on the RSLogger device. The logger’s folder would be
created on your USB Mass Storage according the device’s uinque serial number like: _L120004 (where _L header is
constant for all devices, allowing easy folders sorting. eader is followed by 6 bytes long serial number in EX format
like: 120004). From now on, it’s the logger’s main operating folder. It’s the home for iall data, settings and system
configuration files. Unique folder name for every single RSLogger allows to use one Mass Storage drive to handle
several different RSLoggers. Each device has it’s own directory named by it’s unique serial number.
RSLogger main folder on single device and multi-device shared USB Mass Storage.
In above example the device’s serial number is 120004. Current configuration would be stored into the _L120004
folder as a CONFIG.BAK text file. Current device’s internal memory map file would be stored in MEMORY.MAP
system file.
You can edit the CONFIG.BAK configuration file with any text editor (like Windows Notepad).
7 © Electroware 2018

www.rslogger.com
MEMORY.MAP is non editable binary file and should not be modified nor deleted. Please refer to the “MEMORY.MAP
explained” chapter for detailed information.
Device’s main folder containing data and configuration files ans the CONFIG.BAK file content.
Changes would be applied after renaming the CONFIG.BAK file to CONFIG.INI and connecting the USB mass
storage back to the RSLogger device to read and apply the changes. CONFIG.INI file would be read and applied, then
file name would be changed to CONFIG.BAK accordingly.
Please refer to “Advanced configuration options with CONFIG.INI file” table located at the end of this Manual
explaining all configuration parameters, values and syntax accepted by CONFIG.INI file.
If password parameter has been changed during CONFIG.INI configuration, the PASSWORD.TXT text file would be
created in devices folder after new setting applying. Please keep the password file on the USB mass storage (inside
the device folder) as long as you want to get access to your protected device with this particular Mass Storage device
(it’s containing the password string).
USB mass storage devices without actual PASSWORD.TXT file located in the device folder, would not be allowed by
RSLogger for data and settings access. It would be not allowed for changing settings as well. An ERROR.TXT file with
actual status log like “Incorrect password” would be created in the device’s folder.
PASSWORD.TXT file created on USB Mass Storage is keeping the device’s access password.
If you want to disable the password please left it blank in CONFIG.INI and the PASSWORD.TXT file would be
automatically deleted after password change applying during next USB mass storage connection to RSLogger (or
power up). All USB mas storage drives would be accepted from now on.
8 © Electroware 2018

www.rslogger.com
Settin s by Virtual COM port (USB) menu
In the Virtual COM mode it’s possible to use any serial port terminal application
to configure the device with intuitive and self-explanatory text based menu.
Connect the Micro USB cable to the RSLogger and your PC. Please refer to
the “FTDI chip installation guide” chapter if FTDI virtual COM drivers are not
yet installed/configured in your system.
Use your own or any third party COM port terminal application to access text menu of the RSLogger device and
download the data directly to terminal.
Termite (by CompuPhase) and Terminal (by Br@y++) applications with RSLogger’s text menu.
Please refer to the “Virtual COM terminal text menu mode” chapter for more details about using the text menu.
Via Ethernet
On Ethernet enabled devices it’s possible to download data from WWW
interface. Any Internet browser can be used (PC or mobile device connected to
the same LAN). Enter the “http://rslogger/” as a domain or it’s IP number
directly if known (method recommended on Apple Safari and mobile browsers).
WWW page would be displayed with simple menu, allowing you to configure the device, view and download the data
kept in the internal buffer (ASCII representation). It’s all available directly from the Internet browser level with use of an
intuitive menu.
RSLogger’s WWW welcome page on Microsoft Edge browser and the login window.
9 © Electroware 2018

www.rslogger.com
By default the WWW interface password is disabled. You can set your own user and password in the Network Settings
menu but we recommend to use your Mass Storage password as both user and password to not to mismatch the
device’s passwords. All device’s settings may be managed by two menu optios: Logger Settings and Network
Settings.
Network Settings menu: IP address settings, DHCP enable, WWW Password, TCP Virtual COM ports settings.
Logger Settings menu: time set, timestamp, log file mode, RS232 log port A & B settings (baud, parity, etc.)
10 © Electroware 2018