Efficient solution for incorporating RS-232 communication capabilities into various electronic projects and applications, including serial data exchange and modem communication
A
A
Hardware Overview
How does it work?
RS232 Click is based on the MAX3232, a low-power, true RS-232 transceiver from Analog Devices. Several protection features improve the reliability of this device. It has up to ±15kV ESD protection, ensuring no electrical discharge damages the circuit on the input side. The MAX3232 has two receivers and two transmitter channels, and it is used to bridge the physical differences between the CMOS/TTL signal levels and RS-232 bus levels. While CMOS/TTL signal levels vary from 0V to 5V typically, RS-232 uses signal levels that range from ±5V up to ±15 V. Furthermore, the RS-232 equipment is required to withstand short circuits for any voltage, up to ±25V, during an indefinite time interval. MAX3232 IC uses two internal charge pumps to obtain required driving levels of ±5V on its transceiver sections.
This Click board™ offers two inputs and two outputs, which feature the CMOS/TTL logic levels. These lines can be used to either drive the RS-232 bus or receive the incoming data from the bus. Receivers convert the RS-232 signals to MCU-acceptable UART-type signals, while transmitters convert the MCU UART signal to RS-232 levels. Therefore, one input/output pair is routed to the UART pins of the mikroBUS™, allowing simplified operation by the host MCU, while another pair of input/output signals is routed via the J2 and J3 SMD jumpers and is used as the UART RTS and CTS. These pins are typically used for the UART communication with the hardware flow control. The jumpers are unpopulated by default. The MAX3232 device can maintain a 120kbps data rate with the worst-case scenario - load of 3kΩ in parallel with
1000pF, while the typical communication speed goes up to 232 kbps. The RS232 Click comes equipped with the SUB D connector, typically found on many devices that use the RS-232 interface, and can be used for connection directly to the RS-232 bus. RS232 uses a standard 2-Wire UART interface to communicate with the host MCU. If using it with soldered J2 and J3 jumpers, then you can use the UART RTS and CTS hardware flow control pins. This Click board™ can operate with either 3.3V or 5V logic voltage levels selected via the PWR SEL jumper. This way, both 3.3V and 5V capable MCUs can use the communication lines properly. Also, this Click board™ comes equipped with a library containing easy-to-use functions and an example code that can be used as a reference for further development.
Features overview
Development board
EasyAVR v7 is the seventh generation of AVR development boards specially designed for the needs of rapid development of embedded applications. It supports a wide range of 16-bit AVR microcontrollers from Microchip and has a broad set of unique functions, such as a powerful onboard mikroProg programmer and In-Circuit debugger over USB. The development board is well organized and designed so that the end-user has all the necessary elements in one place, such as switches, buttons, indicators, connectors, and others. With four different connectors for each port, EasyAVR v7 allows you to connect accessory boards, sensors, and custom electronics more
efficiently than ever. Each part of the EasyAVR v7 development board contains the components necessary for the most efficient operation of the same board. An integrated mikroProg, a fast USB 2.0 programmer with mikroICD hardware In-Circuit Debugger, offers many valuable programming/debugging options and seamless integration with the Mikroe software environment. Besides it also includes a clean and regulated power supply block for the development board. It can use a wide range of external power sources, including an external 12V power supply, 7-12V AC or 9-15V DC via DC connector/screw terminals, and a power source via the USB Type-B (USB-B)
connector. Communication options such as USB-UART and RS-232 are also included, alongside the well-established mikroBUS™ standard, three display options (7-segment, graphical, and character-based LCD), and several different DIP sockets which cover a wide range of 16-bit AVR MCUs. EasyAVR v7 is an integral part of the Mikroe ecosystem for rapid development. Natively supported by Mikroe software tools, it covers many aspects of prototyping and development thanks to a considerable number of different Click boards™ (over a thousand boards), the number of which is growing every day.
Microcontroller Overview
MCU Card / MCU
Architecture
AVR
MCU Memory (KB)
32
Silicon Vendor
Microchip
Pin count
40
RAM (Bytes)
2048
You complete me!
Accessories
DB9 Cable Female-to-Female (2m) cable is essential for establishing dependable serial data connections between devices. With its DB9 female connectors on both ends, this cable enables a seamless link between various equipment, such as computers, routers, switches, and other serial devices. Measuring 2 meters in length, it offers flexibility in arranging your setup without compromising data transmission quality. Crafted with precision, this cable ensures consistent and reliable data exchange, making it suitable for industrial applications, office environments, and home setups. Whether configuring networking equipment, accessing console ports, or utilizing serial peripherals, this cable's durable construction and robust connectors guarantee a stable connection. Simplify your data communication needs with the 2m DB9 female-to-female cable, an efficient solution designed to meet your serial connectivity requirements easily and efficiently.
Used MCU Pins
mikroBUS™ mapper
Take a closer look
Click board™ Schematic
Step by step
Project assembly
Track your results in real time
Application Output via UART Mode
1. Once the code example is loaded, pressing the "FLASH" button initiates the build process, and programs it on the created setup.
2. After the programming is completed, click on the Tools icon in the upper-right panel, and select the UART Terminal.
3. After opening the UART Terminal tab, first check the baud rate setting in the Options menu (default is 115200). If this parameter is correct, activate the terminal by clicking the "CONNECT" button.
4. Now terminal status changes from Disconnected to Connected in green, and the data is displayed in the Received data field.
Software Support
Library Description
This library contains API for RS232 Click driver.
Key functions:
rs232_generic_write
- Generic write function.rs232_generic_read
- Generic read function.
Open Source
Code example
The complete application code and a ready-to-use project are available through the NECTO Studio Package Manager for direct installation in the NECTO Studio. The application code can also be found on the MIKROE GitHub account.
/*!
* \file
* \brief Rs232 Click example
*
* # Description
* This example reads and processes data from RS232 clicks.
*
* The demo application is composed of two sections :
*
* ## Application Init
* Initializes driver.
*
* ## Application Task
* Depending on the selected mode (receiver/transmitter) this function reads/sends an appropriate message.
* All data is displayed on USB UART.
*
* \author MikroE Team
*
*/
// ------------------------------------------------------------------- INCLUDES
#include "board.h"
#include "log.h"
#include "rs232.h"
#include "string.h"
#define PROCESS_RX_BUFFER_SIZE 500
#define RS232_TRANSMITTER
// #define RS232_RECEIVER
// ------------------------------------------------------------------ VARIABLES
static rs232_t rs232;
static log_t logger;
static int32_t rsp_size;
static char uart_rx_buffer[ PROCESS_RX_BUFFER_SIZE ] = { 0 };
static char message[ ] = "MikroE";
// ------------------------------------------------------ APPLICATION FUNCTIONS
void application_init ( void )
{
log_cfg_t log_cfg;
rs232_cfg_t cfg;
/**
* Logger initialization.
* Default baud rate: 115200
* Default log level: LOG_LEVEL_DEBUG
* @note If USB_UART_RX and USB_UART_TX
* are defined as HAL_PIN_NC, you will
* need to define them manually for log to work.
* See @b LOG_MAP_USB_UART macro definition for detailed explanation.
*/
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, "---- Application Init ----" );
// Click initialization.
rs232_cfg_setup( &cfg );
RS232_MAP_MIKROBUS( cfg, MIKROBUS_1 );
rs232_init( &rs232, &cfg );
Delay_ms( 100 );
#ifdef RS232_RECEIVER
log_printf( &logger, " ** RS232 Receiver **\r\n" );
#endif
#ifdef RS232_TRANSMITTER
log_printf( &logger, " ** RS232 Transmitter **\r\n" );
#endif
}
void application_task ( void )
{
#ifdef RS232_RECEIVER
rsp_size = rs232_generic_read( &rs232, uart_rx_buffer, PROCESS_RX_BUFFER_SIZE );
if ( rsp_size == strlen( message ) )
{
log_printf( &logger, "Message received: %s", uart_rx_buffer );
log_printf( &logger, "\r\n-------------------------\r\n" );
memset( uart_rx_buffer, 0, rsp_size );
}
Delay_ms( 100 );
#endif
#ifdef RS232_TRANSMITTER
rs232_generic_write( &rs232, message, strlen( message ) );
log_printf( &logger, "Message sent: %s", message );
log_printf( &logger, "\r\n-------------------------\r\n" );
Delay_ms( 1000 );
#endif
}
void main ( void )
{
application_init( );
for ( ; ; )
{
application_task( );
}
}
// ------------------------------------------------------------------------ END