summaryrefslogtreecommitdiff
path: root/nuttx/configs/vsn/src/README.txt
blob: 732ede5e62f91ce582b85befcd398982385432a0 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
VSN Board Support Package, for the NuttX, Uros Platise <uros.platise@isotel.eu>
===============================================================================
http://www.netClamps.com

The directory contains start-up and board level functions. 
Execution starts in the following order:

 - sysclock, immediately after reset stm32_rcc calls external
   clock configuration when
     CONFIG_ARCH_BOARD_STM32_CUSTOM_CLOCKCONFIG=y
   is set. It must be set for the VSN board.
   
 - boot, performs initial chip and board initialization
 - sched/os_bringup.c then calls user entry defined in the .config file.


Naming throughout the code
==========================

 - _init(): used to be called once only, after powerup, to perform board
   initialization
 - _start() or called via FS _open(): starts peripheral power, puts it 
   into operation
 - _stop() or called via FS _close(): opposite to _start()
 

System notifications (a sort of run-levels)
===========================================

On the VSN, NSH represents the core application as it supports scripts
easily adaptable for any custom application configuration. NSH is 
invoked as follows (argument runs a script from the /etc/init.d directory):

 - nsh init: on system powerup called by the NuttX APP_START

TODOs: 
 
 - nsh xpowerup: run on external power used to:
   - try to setup an USB serial connection
   - configure SLIP mode, internet
   - start other internet services, such as telnetd, ftpd, httpd
   
 - nsh xpowerdown: run whenever USB recevied suspend signal or
   external power has been removed.
   - used to stop internet services
   
 - nsh batdown: whenever battery is completely discharged

   
Compile notes
===============================

To link-in the sif_main() utility do, in this folder:
 - make context TOPDIR=<path to nuttx top dir>
 
This will result in registering the application into the builtin application
registry.