aboutsummaryrefslogtreecommitdiff
path: root/README
blob: 4863a7fe2769e035e7bc197a8ee786c15d2754e1 (plain)
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
59
60
61
62
63
Chopstx - Threads and only Threads
							 Version 1.5
							  2017-10-10
							Niibe Yutaka
					     Flying Stone Technology

What's Chopstx?
===============

Chopstx is an RT thread library for STM32F103 (ARM Cortex-M3),
STM32F030 (ARM Cortex-M0), MKL27Z (ARM Cortex-M0plus), and
emulation on GNU/Linux.

While most RTOSes come with many features, drivers, and protocol
stacks, Chopstx just offers a simple RT thread library.

With Chopstx, interrupt handling is also done by a thread.  This
enables coherent code for ease of maintenance.

This library is _not_ related to the hand game:

    https://en.wikipedia.org/wiki/Chopsticks_(hand_game)

Thanks to Yao Wei and Enrico Zini for giving me the opportunity
visiting the wiki page.


License
=======

It is distributed under GNU General Public Licence version 3 or later
(GPLv3+), with additional permission.  Please see COPYING and
EXCEPTION.


Example code
============

We have some examples in this distribution; Useful ones are LED
blinker and USB CDC-ACM device.  For STM32F103, you can build it USB
CDC-ACM demo by:

   $ cd example-cdc
   $ ln -sf ../board/board-olimex-stm32-h103.h board.h
   $ make

For a specific board named FSM-55, an example of LED matrix dynamic
driver is provided.  See the directory: example-fsm-55.

For STM32 Primer2, see the directory: example-primer2.


Future Works
============

Convenience function to determine the bottom of thread stack,
configuration of thread size by compiler's output would be next things
to be done.

Experimental SMP port for Cortex-A7 is under development.  For SMP,
more careful considerations for shared access to objects of struct
chx_pq is needed.  So, modifications required will not be small.
--