7.6. SERVICES
7.6.1. SDK
RACOM routers are shipping with a Software Development Kit (SDK) which offers a simple and fast
way to implement customer-specific functions and applications. It consists of:
1. An SDK host which defines the runtime environment (a so-called sandbox), that is, controlling access
to system resources (such as memory, storage and CPU) and, by doing so, catering for the right
scalability.
2. An interpreter language called arena, a light-weight scripting language optimized for embedded
systems, which uses a syntax similar to ANSI-C but adds support for exceptions, automatic memory
management and runtime polymorphism on top of that.
3. A RACOM-specific Application Programming Interface (API), which ships with a comprehensive
set of functions for accessing hardware interfaces (e.g. digital IO ports, GPS, external storage media,
serial ports) but also for retrieving system status parameters, sending E-Mail or SMS messages or
simply just to configure the router.
Anyone, reasonably experienced in the C language, will find an environment that is easy to dig in.
However, feel free to contact us via
and we will happily support you in finding
a programming solution to your specific problem.
The Language
The arena scripting language offers a broad range of POSIX functions (like printf or open) and provides,
together with tailor-made API functions, a simple platform for implementing any sort of applications to
interconnect your favourite device or service with the router.
Here comes a short example:
/* This script prints short status and if the SMS section is setted properly, the status ►
will be send even to your mobile phone :-)
*/
printf("------------------------------");
printf("\n\n");
printf(nb_status_summary(all));
printf("\n\n");
printf("------------------------------");
/* Please change the following number to your mobile phone number
*/
nb_sms_send("+420123456789", nb_status_summary(all));
A set of example scripts can be downloaded directly from the router, you can find a list of them in the
appendix. The manual at
menu SERVICES-Administration-Troubleshooting-SDK API
gives a detailed
introduction of the language, including a description of all available functions.
SDK API Functions
The current range of API functions can be used to implement the following features:
M!DGE2 GPRS/UMTS/HSPA+/LTE router – © RACOM s.r.o.
102
Web Configuration
Summary of Contents for M!DGE2
Page 2: ......
Page 188: ...188 ...
