background preloader

Firmware/soft

Facebook Twitter

DASH7 Webinar: Working With Open Tag For Mode 2. Opentag:capi - Indigresso Wiki. The C API is just callable C functions, each of which is a simplified wrapper for a sequence lower-level OTlib functions. The C API can be used to build requests, create events, and do some other sandboxed features that are part of OpenTag's standard OTlib functionality (in other words, if you are an OpenTag kung-fu master, you can just call the OTlib low-level functions directly to get the same effect). That said, the C API functions are cleaner and simpler to use, and just as good if you don't need the deepest level of functionality. Relevant Files To use the C API, you need to include OTAPI.h in your code. Using Low Level Functions Experts might want to bypass the C API entirely, in favor of using the low level OpenTag functions themselves.

Extensibility New OTAPI C functions can be added very easily, if new functionality is desired. General Form The general form of a C API function is: ot_u16 otapi_function_name(ot_u8* status, void* tmpl) Special Form Some Examples C API Function Manifest. Doxygen. Generate documentation from source code Doxygen is the de facto standard tool for generating documentation from annotated C++ sources, but it also supports other popular programming languages such as C, Objective-C, C#, PHP, Java, Python, IDL (Corba, Microsoft, and UNO/OpenOffice flavors), Fortran, VHDL, Tcl, and to some extent D.

Doxygen can help you in three ways: It can generate an on-line documentation browser (in HTML) and/or an off-line reference manual (in ) from a set of documented source files. There is also support for generating output in RTF (MS-Word), PostScript, hyperlinked PDF, compressed HTML, and Unix man pages. The documentation is extracted directly from the sources, which makes it much easier to keep the documentation consistent with the source code. Doxygen is developed under Mac OS X and Linux, but is set-up to be highly portable. Doxygen license Copyright © 1997-2016 by Dimitri van Heesch. Sponsored links(not related to doxygen) Opentag:coding_style_guidelines - Indigresso Wiki. OpenTag coding guidelines include the Base Guidelines, the Style Guidelines, and the Performance Guidelines.

The Style Guidelines (here) are pretty loose: they are enforced just to promote uniformity, readability, and maintainability. With OpenTag, performance always comes before style. General Themes Never, ever use C++. Descriptive comments shall be put into Doxygen markup. C99 supports inline comments. // This is a normal inline comment in C // Use these inside .c files to describe implementation notes that you don't want Doxygen to see. /// This is a doxygen inline comment, for C. /// Doxygen will parse these comments when you run the code through doxygen /// Use these inside .c files to describe how a function is architected C has supported block comments for as long as it has been around. Doxygen Block Comments are like C block comments except they have some additional requirements.

Syntax Manipulation Most Important Requirements Use Unix line breaks and UTF-8 text formatting. Opentag:api:quickstart - Indigresso Wiki. This is a “quickstart” users' guide for working with the client-server OpenTag API. The main focus is to give developers the information they need to control an OpenTag device (server) from another device (client). As such, it deals primarily with the Messaging (ALP) API as used over MPipe, but it does also describe the C API (OTAPI) to a limited degree. Note: Developers may also find it valuable to look at the DASH7 Registry Guide. It contains information about how values in the registry files affect the way DASH7 devices behave. 1. 1A. The OpenTag codebase can be downloaded as an archived download, or the latest code can be downloaded directly from the git repository. 1B. This quickstart will refer to the Opmode Demo Application, which is stored inside OT_ROOT/Apps/Demo_Opmode.

Verifying your board Demo_Opmode is available for most officially supported boards. 1C. If you are using RIDE, there isn't much to do. Platform Configuration RIDE Setup CCS Setup 2. 2A. 2A. OT/NDEF mode Raw Mode 2B. Jpnorair/OpenTag.