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
Curiosity PIC32 MZ EF development board is a fully integrated 32-bit development platform featuring the high-performance PIC32MZ EF Series (PIC32MZ2048EFM) that has a 2MB Flash, 512KB RAM, integrated FPU, Crypto accelerator, and excellent connectivity options. It includes an integrated programmer and debugger, requiring no additional hardware. Users can expand
functionality through MIKROE mikroBUS™ Click™ adapter boards, add Ethernet connectivity with the Microchip PHY daughter board, add WiFi connectivity capability using the Microchip expansions boards, and add audio input and output capability with Microchip audio daughter boards. These boards are fully integrated into PIC32’s powerful software framework, MPLAB Harmony,
which provides a flexible and modular interface to application development a rich set of inter-operable software stacks (TCP-IP, USB), and easy-to-use features. The Curiosity PIC32 MZ EF development board offers expansion capabilities making it an excellent choice for a rapid prototyping board in Connectivity, IOT, and general-purpose applications.
Microcontroller Overview
MCU Card / MCU

Architecture
PIC32
MCU Memory (KB)
2048
Silicon Vendor
Microchip
Pin count
100
RAM (Bytes)
524288
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
1. Application Output - In Debug mode, the 'Application Output' window enables real-time data monitoring, offering direct insight into execution results. Ensure proper data display by configuring the environment correctly using the provided tutorial.

2. UART Terminal - Use the UART Terminal to monitor data transmission via a USB to UART converter, allowing direct communication between the Click board™ and your development system. Configure the baud rate and other serial settings according to your project's requirements to ensure proper functionality. For step-by-step setup instructions, refer to the provided tutorial.

3. Plot Output - The Plot feature offers a powerful way to visualize real-time sensor data, enabling trend analysis, debugging, and comparison of multiple data points. To set it up correctly, follow the provided tutorial, which includes a step-by-step example of using the Plot feature to display Click board™ readings. To use the Plot feature in your code, use the function: plot(*insert_graph_name*, variable_name);. This is a general format, and it is up to the user to replace 'insert_graph_name' with the actual graph name and 'variable_name' with the parameter to be displayed.

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