Microcontrollers

In addition, it is better to use pointers in case of passing structures to functions, or returning structures from functions,
In case no to use pointer, the process to copy the whole structure is needed and the code size increases.

To refer and modify PSR value,
PSR value is referred and modified after it is stored to stack memory by using int instruction, and then it is returned by using reti instruction.

Some models have implemented PSR accessing instructions.
Please refer to each technical manuals.

Example: PSR example

Even though syntax error occurs, assembly source file ".o" is output.
When this "-S" option is used, the object file cannot be generated due to GNU17 specification. Then, compile is failed at linker path.
In GNU17, it is general method to refer assembly result by objdump command with ".elf" file, instead of using command-line option "-S".

Basic character code on GCC is UTF-8. Please follow this process to support Shift-JIS.

Add -finput-charset=CP932 on the target project [Properties] dialog > C/C++ Build>Settings > [Tool Settings] > [Cross GCC Compiler] > [Dialect] > [Other dialect flags]
“-finput-charset” is an option to specify character code, Shift-JIS is CP932.

As example, data 0x00-0x0F will be located to the address 0xB000-0xB00F by writing source code and linker script as follows.

[Source code]
const unsigned char __attribute__ ((section (".updatable"))) checkerLineBit[16] = {
0x00, 0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08,0x09,0x0A,0x0B,0x0C,0x0D,0x0E,0x0F
};

[Linker Script]
.updatable (0xB000) :
{
*(.updatable);
. = ALIGN(0x800);
} > irom = 0xffff

Please refer to the following document.

Please refer to the following document.

Please refer to the following document.

Please refer to the following document.

Please refer to the following document.

The "crt0.c" file that is included in GNU17 Ver.3.x.x defines the vector table,and the basic sample software provides the following macros, so you can easily use them.
You can redefine the vector table. The "crt0.c" file is made into an object file by default, but the source code is stored in "\EPSON\GNU17V3\utility\lib_src\crt0".

1)Vector definition(crt0.c)
void _vector25_handler(void) __attribute__((weak, alias("_crt0_vector_handler")));
* From "_vector01_handler" to "_vector3x_handler", they are defined as well.

2)Macro definition(crt0.h)
#define C17_INTERRUPT_HANDLER(vh, ih)
void ih(void) __attribute__ ((interrupt_handler));
void vh(void) __attribute__ ((unused,alias(#ih)))

3)Macro usage example (user description content)
C17_INTERRUPT_HANDLER(_vector25_handler, c17intAd12);
(Refer to the S5U1C17001C manual page 3-5, 5-3)

Please refer to the following documents.

Please refer to the following documents.

By describing as follows, it is possible to read the value from the specified address to "value" or write the value of "value" to the specified address.
1) When the address is peripheral circuit register 0x4000 (2 byte)
unsigned int value;
value = *(volatile unsigned int *)(0x4000); // read from the address 0x4000
*(volatile unsigned int *)(0x4000) = value; //　write to the address 0x4000

2) When the address is RAM 0x0200 (1 byte)
unsigned char value;
value = *(volatile unsigned char *)(0x0200); // read from the address 0x0200
*(volatile unsigned char *)(0x0200) = value; // write to the address 0x0200

The default of stack pointer is set to 0x7c0 in linker script. In map file, it is always set to 0x7c0 without specifying linker script file.
Even if it has a different value, there is no impact to actual operation.

Please refer to the following documents.

Please refer to the following documents.

In this case, it can be avoided by setting the optimization off.
Refer the S5U1C17001C manual "C compiler" about setting of optimization.

The debug circuit built into the S1C17Family can set up to 4 hard breakpoints. However, in this debugger, the point that should be stopped immediately after startup (the beginning of the main function) is also set as a hard breakpoint, so the number of hard breakpoints that can be set in advance at the time of initial startup is 3 points or less.

2) Output the variable you want to monitor on the source code
For example, use functions such as "puts ()" and "putchar ()" to display variable values on the screen. There is sample software below, so it will be easier to understand

C:\EPSON\GNU17V3\sample\sample_gcc6

Please refer to the following document.

The optimization option is -O1 by default, so the local variables you want to display may be optimized. It can be displayed by adding a volatile declaration to the variable to prevent optimization.

When manipulating bits in C language, it is actually OR operation. That is, the target register information is read in byte units, specific bits are changed, and the target register information is written back in byte units. At this time, if another interrupt flag in a specific bit is 1, 1 is written back, and as a result, the flag is cleared. In such a case, it can be solved by performing a byte operation and specifying the value.

S5U1C17001H1/2(ICDminiV1/2) Flash writer mode is not supported on GNU17Ver3.
Please contact an Epson sales representative how to correspond it.

It is possible by using objdump command on GNU17.
Please start with following command.

　objdump -D -m c17 --stop-address=end-address XXXX.psa > XXXX.s

Note) Please be careful that this also converts the data which is defined with const, interrupt vector to instruction code.

Please refer to the following document.

In Windows10, the following screen is displayed when downloading the package from the MCU user site.

There is no problem running it.

Please check the length of wiring between ICDmini and target system. The writing data may be affected by noise with longer wiring.

Sample software to use MultiProgrammer.dll is prepared. Please contact an Epson sales representative in your region.

When using ICDmini Ver.3, first use the external power supply supplied to the TARGET_VCC_IN terminal. Try to connect to the target, and if this connection fails, switch to the internal power supply (3.3V) and try to reconnect. So you don't have to worry about it. Multi-programmers also use model-specific information files. Please check our website to make sure that this file is always up to date.

For models with a small target Flash memory, execution is complete before disconnecting the ICDmini from the target board.

The timing may be different from what you think because it is visually displayed on the main screen for users to see.

Please refer the gang programmer User Manual.
When you contact an Epson sales representative, please share following information in order to solve issues.
・The photo of LCD panel (display) at the timing of problem.
・gplog.txt file