Local Map Viewer Demo - Independent ESP32 Example Projects

espressif_esp32_p4_function_ev_board

esp32_p4_function_ev_board

Project Structure

map_tiles_projects/
├── shared_components/
│ └── simple_map/ # Shared SimpleMap component
│ ├── simple_map.hpp
│ ├── simple_map.cpp
│ └── CMakeLists.txt
├── espressif_esp32_p4_function_ev_board/ # Demo for espressif_esp32_p4_function_ev_board
│ ├── main/
│ │ ├── main.cpp
│ │ └── CMakeLists.txt
│ └── CMakeLists.txt
├── waveshare_esp32_s3_touch_amoled_1_75/ # Demo for waveshare_esp32_s3_touch_amoled_1_75
│ ├── main/
│ │ ├── main.cpp
│ │ └── CMakeLists.txt
│ └── CMakeLists.txt
├── waveshare_esp32_p4_wifi6_touch_lcd_xc/ # Demo for waveshare_esp32_p4_wifi6_touch_lcd_xc
│ ├── main/
│ │ ├── main.cpp
│ │ └── CMakeLists.txt
│ └── CMakeLists.txt
├── components/ # Device-specific components
└── CMakeLists.txt # Shared components only

Features

Hardware Requirements

Dependencies

Map Tiles Format

/sdcard/
├── tiles1/
│ ├── 15/
│ │ ├── 10485/
│ │ │ ├── 12733.bin
│ │ │ ├── 12734.bin
│ │ │ └── ...
│ │ └── ...
│ ├── 16/
│ └── ...

Usage

Basic Operation

Map Controls

Key Features

Real-time GPS Updates

// GPS coordinates update automatically as you scroll
void SimpleMap::update_current_gps_from_map_center();

Smooth Tile Loading

Touch-optimized Interface

Code Structure

Shared Components

Main Task Stack Size

How to set it

Key Functions

// Initialize the map system
bool SimpleMap::init(lv_obj_t* parent_screen);
// Display map at specific location
void SimpleMap::show_location(double lat, double lon, int zoom);
// Handle user interactions
void SimpleMap::map_scroll_event_cb(lv_event_t *e);
void SimpleMap::update_button_event_cb(lv_event_t *e);
// GPS coordinate management
void SimpleMap::update_current_gps_from_map_center();
void SimpleMap::get_current_location(double* lat, double* lon);

Configuration

map_tiles_config_t config = {
 .base_path = "/sdcard", // SD card mount point
 .tile_folders = {"tiles1"}, // Tile directory names
 .tile_type_count = 1, // Number of tile types
 .grid_cols = 5, // Tile grid width
 .grid_rows = 5, // Tile grid height
 .default_zoom = 18, // Initial zoom level
 .use_spiram = true, // Use PSRAM for tiles
 .default_tile_type = 0 // Default tile type
};

Performance Optimization

Memory Management

Rendering Optimization

Touch Response

API Reference

Public Methods

class SimpleMap {
public:
 // Core functionality
 static bool init(lv_obj_t* parent_screen);
 static void show_location(double lat, double lon, int zoom = 18);
 static void update_location(double lat, double lon);
 static void cleanup();
 
 // Tile management
 static bool set_tile_type(int tile_type);
 static int get_tile_type();
 static int get_tile_type_count();
 
 // Coordinate access
 static void get_current_location(double* lat, double* lon);
 static int get_current_zoom();
 
 // Map positioning
 static void center_map_on_gps();
};

Configuration Options

Troubleshooting

Common Issues

Debug Output

// Key debug messages
"SimpleMap: Initialized with grid size %dx%d"
"SimpleMap: Loading %dx%d grid at position (%d,%d)"
"SimpleMap: Updated GPS from map center: %.6f, %.6f"
"SimpleMap: Zoom changed from %d to %d"

Example Integration

Device A Implementation (Interactive)

#include "simple_map.hpp"
extern "C" void app_main(void) {
 // Standard ESP32 initialization...
 
 // Initialize interactive map
 if (!SimpleMap::init(lv_screen_active())) {
 ESP_LOGE(TAG, "Failed to initialize map");
 return;
 }
 // Show initial location with full controls
 SimpleMap::show_location(37.77490, -122.41942, 16);
 SimpleMap::center_map_on_gps();
}

Device B Implementation (GPS Tracking)

#include "simple_map.hpp"
// Predefined locations for demo
static const struct {
 double lat, lon;
 const char* name;
} demo_locations[] = {
 {40.7128, -74.0060, "New York City"},
 {51.5074, -0.1278, "London"},
 {35.6762, 139.6503, "Tokyo"}
};
void location_cycle_task(void *pvParameters) {
 while (1) {
 vTaskDelay(pdMS_TO_TICKS(10000)); // 10 second intervals
 
 // Cycle through locations
 current_location_index = (current_location_index + 1) % 3;
 SimpleMap::show_location(
 demo_locations[current_location_index].lat,
 demo_locations[current_location_index].lon,
 15
 );
 }
}
extern "C" void app_main(void) {
 // Standard ESP32 initialization...
 
 // Initialize map for tracking mode
 SimpleMap::init(lv_screen_active());
 SimpleMap::show_location(demo_locations[0].lat, demo_locations[0].lon, 15);
 
 // Start location cycling task
 xTaskCreate(location_cycle_task, "location_cycle", 4096, NULL, 5, NULL);
}

Shared Component Usage

// Change tile type (e.g., satellite view)
SimpleMap::set_tile_type(1);
// Get current position
double lat, lon;
SimpleMap::get_current_location(&lat, &lon);
// Update to new location
SimpleMap::update_location(40.7128, -74.0060);

Creating Custom Device Projects

Step 1: Create New Project Directory

mkdir device_custom_project
cd device_custom_project

Step 2: Create CMakeLists.txt

# Device Custom - Your Demo
cmake_minimum_required(VERSION 3.5)
# Add shared components from parent directory
set(EXTRA_COMPONENT_DIRS "../shared_components")
include($ENV{IDF_PATH}/tools/cmake/project.cmake)
project(simple_map_device_custom)

Step 3: Create main/ directory and files

mkdir main

idf_component_register(SRCS "main.cpp"
 INCLUDE_DIRS "."
 REQUIRES simple_map)

#include "simple_map.hpp"
extern "C" void app_main(void) {
 // Your device-specific initialization
 
 // Initialize shared map component
 if (!SimpleMap::init(lv_screen_active())) {
 return;
 }
 
 // Your custom map configuration
 SimpleMap::show_location(your_lat, your_lon, your_zoom);
}

Step 4: Build and Test

idf.py build flash monitor

Contributing

Acknowledgments

Support

License