The write() method from SoftwareSerial (which is inherited from the abstract Print class) does not support printing PROGMEM-based binary buffers. The print() method does have some PROGMEM support, but it is limited to printing NUL-terminated character strings, and is meant to be used with the F() macro. You could coerce this method into printing your data, but this would require you to add a null byte at the end of each inner array, and the trick would break if you ever have to send a null byte.

Also, the pgm_read_stuff() macros cannot read an array at a time. You could do achieve this with memcpy_P(), but that would require allocating an array in RAM. I think the simplest solution here is to get the bytes from the flash one by one with pgm_read_byte():

const byte *message = messages_for_measurement[0];
size_t size = sizeof messages_for_measurement[0];
for (size_t i = 0; i < size; i++) {
    swSerial.write(pgm_read_byte(&message[i]));
}

Note that the first line does not attempt to access the array data: it only copies into message the address of the first byte: this is the decay-to-pointer semantics.

Answer from Edgar Bonet on Stack Exchange
🌐
Nongnu
nongnu.org › avr-libc › user-manual › group__avr__pgmspace.html
avr-libc: <avr/pgmspace.h>: Program Space Utilities
The address is a byte address. The address is in the program space. Read a double word from the program space with a 16-bit (near) address.
🌐
Debian Manpages
manpages.debian.org › testing › avr-libc › pgm_read_byte_near.3avr.en.html
pgm_read_byte_near(3avr) — avr-libc — Debian testing — Debian Manpages
Read a word from the program space with a 16-bit (near) byte-address. Attribute to use in order to declare an object being located in flash ROM. Attribute to use in order to declare an object being located in far flash ROM. This is similar to PROGMEM, except that it puts the static storage ...
🌐
FC2
garretlab.web.fc2.com › top › arduino › internal structure of arduino software › avr-gcc › pgmspace.h › pgm_read_byte_near()
pgm_read_byte_near() - garretlab - FC2
July 31, 2025 - The pgm_read_byte_near() is a macro that reads a byte of data stored in a specified address(PROGMEM area).
🌐
Carta
carta.tech › man-pages › man3 › pgm_read_byte_near.3avr.html
pgm_read_byte_near: Avr/pgmspace.h: program space utilities -
pgm_read_byte_near: Avr/pgmspace.h: program space utilities - #include <avr/io.h> #include <avr/pgmspace.h> The functions in this module provide interfaces for a program to access data stored in program space (flash memory) of the device. In order to use these functions, the target device must ...
🌐
GitHub
github.com › h1romas4 › arduino-vgmplayer › blob › master › YM2151.cpp
arduino-vgmplayer/YM2151.cpp at master · h1romas4/arduino-vgmplayer
uint8_t dt1_mul =pgm_read_byte_near(taddr++); write(0x40+ch+i,dt1_mul); } for(int i=0;i<4;i++){ RegTL[ch][i] =pgm_read_byte_near(taddr++); } for(int i=0;i<32;i+=8){ uint8_t ks_ar =pgm_read_byte_near(taddr++); write(0x80+ch+i,ks_ar); } for(int i=0;i<32;i+=8){ uint8_t ame_d1r =pgm_read_byte_near(taddr++); write(0xa0+ch+i,ame_d1r); } for(int i=0;i<32;i+=8){ uint8_t dt2_d2r =pgm_read_byte_near(taddr++); write(0xc0+ch+i,dt2_d2r); } for(int i=0;i<32;i+=8){ uint8_t d1l_rr =pgm_read_byte_near(taddr++); write(0xe0+ch+i,d1l_rr); } } ·
Author   h1romas4
🌐
Phipps Electronics
phippselectronics.com › home › blog › using the flash program memory of arduino to pre-store data
Using the Flash Program Memory of Arduino to Pre-store Data - Phipps Electronics
November 29, 2023 - To access this byte stored in the program memory space, use the pgm_read_byte_near() function. Note that this function requires an address as a parameter.
🌐
GitHub
github.com › Digilent › digilent-core › blob › master › pic32 › cores › pic32 › avr › pgmspace.h
digilent-core/pic32/cores/pic32/avr/pgmspace.h at master · Digilent/digilent-core
#ifdef pgm_read_byte_near · #undef pgm_read_byte_near · #endif · #define pgm_read_byte_near(x) (*((char *)x)) · #ifdef pgm_read_byte_far · #undef pgm_read_byte_far · #endif · #define pgm_read_byte_far(x) (*((char *)x)) · #ifdef pgm_read_word ·
Author   Digilent
Find elsewhere
🌐
Microchip
onlinedocs.microchip.com › oxy › GUID-BD1C16C8-7FA3-4D73-A4BE-241EE05EF592-en-US-7 › GUID-CFAD6CEC-CC4A-4133-8DAC-DEC6D81A80E6.html
8.5.4 pgm_read_byte_near Macro - Microchip Online Docs
Read a byte from the program space with a 16-bit (near) address. ... #include <avr/pgmspace.h> const unsigned char PROGMEM romObj = 0x55; int main(void) { unsigned char val; val = pgm_read_byte_near(&romObj); }
🌐
Ubuntu Manpages
manpages.ubuntu.com › manpages › trusty › man3 › avr_pgmspace.3.html
Ubuntu Manpage: <avr/pgmspace.h>: Program Space Utilities -
#define PGM_P const char * Used to declare a variable that is a pointer to a string in program space. #define pgm_read_byte(address_short) pgm_read_byte_near(address_short) Read a byte from the program space with a 16-bit (near) address. Note: The address is a byte address.
🌐
Code-reference
code-reference.com › arduino › constants › progmem
arduino constants progmem Programming | Library | Reference - Code-Reference.com
CREATED BY THE UNITED STATES DEPART"}; unsigned int displayInt; int k; // counter variable char myChar; // read back a 2-byte int displayInt = pgm_read_word_near(charSet + k) // read back a char myChar = pgm_read_byte_near(signMessage + k);
Top answer
1 of 4
7

I am afraid there is no good solution to this problem. One option I do like is to use the __flash qualifier instead of PROGMEM:

const uint8_t ram_array[] = { 1, 2, 3, 4 };
__flash const uint8_t flash_array[] = { 5, 6, 7, 8 };

void function_reading_ram(const uint8_t *array)
{
    uint8_t secondElement = array[1];
    // ...
}

void function_reading_flash(__flash const uint8_t *array)
{
    uint8_t secondElement = array[1];
    // ...
}

int main(void)
{
    function_reading_ram(ram_array);      // OK
    function_reading_flash(flash_array);  // OK
    function_reading_ram(flash_array);    // Warning
    function_reading_flash(ram_array);    // Warning
}

Note that, with __flash, you don't need pgm_read_byte_near() or anything similar. You just use the array like you would use any regular array, and the compiler is smart enough to generate the code required to access the Flash memory.

The warnings generated by gcc are:

warning: conversion from address space ‘__flash’ to address space ‘generic’ [-Waddr-space-convert]
     function_reading_ram(flash_array);
     ^
warning: conversion from address space ‘generic’ to address space ‘__flash’ [-Waddr-space-convert]
     function_reading_flash(ram_array);
     ^

Given how nice this solution is, you may wonder why I wrote “there is no good solution”. Well, this comes with two caveats, one small and one huge. The small caveat is that you need to explicitly pass the option -Waddr-space-convert to the compiler if you want it to generate the warnings. It is not implied even with -Wall -Wextra. The huge caveat is that this only works in plain C. If you try to use this trick in C++ you get:

error: ‘__flash’ does not name a type

This is an implementation of the “named address spaces” extension to the standard C. Since nothing like this is standardized in C++, the authors of gcc assumed it would not be useful to users of C++. :-( You can mix C and C++ sources in Arduino, but you can't call class methods from C.

2 of 4
5

I will expand on KIIV's comment here.

This is a known issue to the people who wrote the Arduino framework. Essentially, the pointers to PROGMEM and RAM are both data pointers (think of a pointer like an array index, but for the entire RAM/Flash itself rather than one chunk of it that you manage) of the same size and type. They cannot be told apart since pointer types are only determined by the size of the data, not where the data is.

So, they used a clever solution: Make the pointer into a different pointer that isn't compatible with the regular RAM pointer. This is done by casting to the __FlashStringHelper class (and then casting back when it must be read). The FSH class doesn't actually have any methods or do anything; it's simply used to define a custom pointer type that is different from the normal const *.

You can directly go read one of the better guides I've seen on it here (Note that it's for the ESP8266, but this part works the same), or I can try to explain it. I suggest reading it anyway, since it has a lot of other info that's useful but not relevant to this question. Do note that they have a few examples near the end which don't de-allocate memory when they are done using it, though, so copying them directly could cause a memory leak (see my string processing example to see the proper method).

First, you need to cast the array to the FSH class:

const byte MyProgmemArray[] PROGMEM = {4,4,4,4,4,4,4,4}; //Fixes issue #82 (add randomness); see https://xkcd.com/221/ for details :D
__FlashStringHelper * MyArray = (__FlashStringHelper *) MyProgmemArray;

I am unaware if there is any method (and I did look) to declare these in-place, i.e. to make the original array declaration into a __FlashStringHelper * directly. So you still need, as the programmer/user, to know which strings are in flash when you add them, and add the conversion line. This means that what you wanted (fully automatic RAM/Flash detection) isn't quite possible, but this is as close as I think it gets. A further warning is that the original array still exists, meaning that it could accidentally be used instead (will still cause the original mismatch issue) and the new definition takes up slightly more memory for the additional pointer (if the compiler does not optimize it out?).

Oddly, it works fine if your want to store a string:

__FlashStringHelper * MyString = PSTR("yaddayaddayadda...");

Strings can be inlined, but I think it's because of both the PSTR macro and because string definitions might be treated differently than an array of values (even though they are physically the same thing). Perhaps you could experiment with however PSTR works (it's actually a macro that does something, and isn't just a keyword) and see if you can implement this in your own code after all.


Now, you still need to get the data OUT of the array in that function you mentioned. To do that, we actually use two versions of that function. This is called overloading (and I think it's C++ only, but this is Arduino, which is by definition C++, so it's safe).

The RAM function you declare as normal:

void MyFunction(const uint8_t *MY_ARRAY){
  byte index_two = MY_ARRAY[1];
  ...
}

The PROGMEM function you declare as follows (assuming that pgm_read_byte_near IS the right function. Also note that it gets more complicated if you need multi-byte values, like int or something...):

void MyFunction(__FlashStringHelper *MY_PROGMEM_ARRAY){
  const byte *MY_ARRAY = (const byte *)MY_PROGMEM_ARRAY; //convert back to normal
  byte index_two = pgm_read_byte_near(MY_ARRAY+1); //still have to read it as flash, of course
  ...
}

As a bonus bit of info that is unrelated to the question as asked, but that may interest you/be relevant later:

There are a few more notes if you use this for string data (or pretend it's a string for this part, which works if your data contains no zeros and ends in one). By the latter, I refer to the fact that strings in C (NOT the C++ std::string or Arduino String, though, so keep this in mind) are basically char arrays with a 0 tacked on the end. All string-processing functions run an infinite loop until they read a 0 at their current index, which allows them to work with strings of any length but still know when they are done. As a result, when reading it, you can treat your data like a string, with three caveats:

  1. It can never contain a 0, except for the very last item, which won't be read.
  2. When defining it, you'd need to still use {} instead of "" since most values don't have printable ASCII characters. (And even so, you'd have to write " " for 32, for instance.)
  3. You can't actually print the alleged string, since the data won't actually contain printable characters. You'll get any mix of numbers, letters, punctuation, and fun things like backspace and newline all jumbled together. You would need to read each character and convert it (via, say, String num = <your value here>; or itoa() etc).

If you want to print it using an existing Arduino function, like Serial.print, and it is actually a string (and not data pretending to be a string), it will natively support __FlashStringHelper *, so you don't need the conversion step (this lets you do Serial.print(F("No static RAM used here!")); and similar).

There are two ways to read the data if it is for your own string-processing function, however. The first, the simple one, is not memory efficient and creates a full copy of the data or string in RAM while it's being used. As a result, it is not capable of processing strings that are too large for RAM and may have issues if it's called while a lot of RAM is already in use or it is called deep down a set of nested functions. It is very convenient, however:

//convert from __FlashStringHelper * as above, but let's assume it's a char* here
int size = strlen_P(MY_ARRAY);
if (size!=0){
  char * data = new char[size];
  if (data!=NULL){
    strcpy_P(data,MY_ARRAY);
    //do stuff with the string
    delete data;
  }
}

The second method is more annoying to actually do, and requires more control over how the data is processed, but you can also read out the data byte-by-byte as shown in my first decoding example above using pgm_read_byte_near. This lets you work with data that is too large to fit in RAM and keeps a constant stack size too. The downside is that it requires that you are actually able to stream the data byte-by-byte in all places that it's then used (or that you re-read it when it needs to be accessed out-of-order).

🌐
Microchip
onlinedocs.microchip.com › oxy › GUID-317042D4-BCCE-4065-BB05-AC4312DBC2C4-en-US-2 › GUID-6DC2BA6A-C24F-40BF-99A9-1EAC448B718C.html
2.1.5 pgm_read_byte_near - Microchip Online Docs
pgm_read_byte_near(address_short) Read a byte from the program space with a 16-bit (near) address. Note: The address is a byte address. The address is in the program space. The online versions of the documents are provided as a courtesy.
🌐
FC2
garretlab.web.fc2.com › top › arduino › internal structure of arduino software › avr-gcc › pgmspace.h › pgm_read_byte()
pgm_read_byte() - garretlab - FC2
July 31, 2025 - The pgm_read_byte() is a macro that read a word of data stored in a specified address(PROGMEM area).
🌐
GitHub
github.com › espressif › arduino-esp32 › blob › master › cores › esp32 › pgmspace.h
arduino-esp32/cores/esp32/pgmspace.h at master · espressif/arduino-esp32
#define pgm_read_byte_near(addr) pgm_read_byte(addr) #define pgm_read_word_near(addr) pgm_read_word(addr) #define pgm_read_dword_near(addr) pgm_read_dword(addr) #define pgm_read_float_near(addr) pgm_read_float(addr) #define pgm_read_ptr_near(addr) pgm_read_ptr(addr) #define pgm_read_byte_far(addr) pgm_read_byte(addr) #define pgm_read_word_far(addr) pgm_read_word(addr) #define pgm_read_dword_far(addr) pgm_read_dword(addr) #define pgm_read_float_far(addr) pgm_read_float(addr) #define pgm_read_ptr_far(addr) pgm_read_ptr(addr) ·
Author   espressif
🌐
AVR Freaks
avrfreaks.net › forum › pgmreadbyte-vs-pgmreadbytenear
pgm_read_byte vs pgm_read_byte_near | AVR Freaks
July 2, 2017 - The end user does not pick near or far, the header does depending on which AVR it is. Just use pgm_read_*() and you get the right one. Nope. The default is near on every AVR (no matter how big).
🌐
Microchip
onlinedocs.microchip.com › oxy › GUID-317042D4-BCCE-4065-BB05-AC4312DBC2C4-en-US-2 › GUID-6DC2BA6A-C24F-40BF-99A9-1EAC448B718C_2.html
4.153.5 pgm_read_byte_near
pgm_read_byte_near(address_short) Read a byte from the program space with a 16-bit (near) address. Note: The address is a byte address. The address is in the program space. The online versions of the documents are provided as a courtesy.
🌐
Stanford CCRMA
ccrma.stanford.edu › courses › 250a-fall-2005 › docs › avr-libc-user-manual-1.2.5 › group__avr__pgmspace.html
avr-libc: Program Space String Utilities
If possible, put your constant tables in the lower 64K and use pgm_read_byte_near() or pgm_read_word_near() instead of pgm_read_byte_far() or pgm_read_word_far() since it is more efficient that way, and you can still use the upper 64K for executable code.