IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

int iniPutString(char *sectionName, char *itemName, char *text)
{
union REGS inregs;
union REGS outregs;
struct SREGS sregs;
inregs.h.ah = 0x23;
inregs.x.bx = FP_SEG(sectionName);
inregs.x.si = FP_OFF(sectionName);
sregs.es = FP_SEG(itemName);
inregs.x.di = FP_OFF(itemName);
sregs.ds = FP_SEG(text);
inregs.x.dx = FP_OFF(text);
int86x(0xA0,&inregs,&outregs,&sregs);
return outregs.x.ax;
}
//Call of this function:
iniPutString("MY_SECTION", "MY_ITEM", "VALUE_TEXT");
//and produces the following chip.ini entry
[MY_SECTION]
MY_ITEM=VALUE_TEXT
Developer Notes
Keep in mind that this function writes to the chip.ini file. This generates flash write cycles and these cycles are limited.
Top of list
Index page
Interrupt 0xA0 service 0x24: Find an entry in chip.ini
Parameters
AH
CX
BX:SI
ES:DI
Finds an entry in chip.ini configuration file.
Must be 0x24.
Maximum length of target string (without '\0').
Pointer to section string
Pointer to item name
DS:DX
Pointer to target
Return Value
Comments
AX= 0 : Entry not found
AX= -1: Could not open chip.ini
else Success: pointer at DS:DX contains the found string AX contains length of the found string
Important: API functions 0x23 and 0x24 are not reentrant.
Don't use in different tasks or in combination with @CHIP-RTOS commands,
which are writing to chip.ini, e.g. DHCP. Avoid race conditions with
any other API call, which writes or read also to/from chip.ini
e.g. 0xA0 0x02 Set IP address
Page 91 / 400