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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
## What is CROPS (CROssPlatformS)?
CROPS is an open source, cross-platform development framework that leverages Docker containers to provide an easily managed, extensible environment which allows developers to build binaries for a variety of architectures of Windows, Linux and Mac OS X hosts.
### CROPS components
* **CEED** - runs on the development host and exposes an API to Integrated
Development Environments (IDEs) or CLI callers
* **TURFF** - runs in a container and services requests from CODI
* **CODI** - COntainer DIspatcher runs in a container and keeps track of all available TURFF instances
in its internal table. CODI also redirects CEED requests to the corresponding TURFF instance
## USING CROPS FOR [ZEPHYR OS](https://www.zephyrproject.org/) DEVELOPMENT
Please refer to the [GitHub Wiki](https://github.com/todorez/crops/wiki)
## USING CROPS WITH YOUR OWN TOOLCHAIN
1. **Install [Docker (Linux)](https://docs.docker.com/linux/step_one/) or [Docker Toolbox (Windows/Mac)](https://www.docker.com/products/docker-toolbox)**
2. **Build CODI dependencies container**
Execute the following command from within the dockerfiles directory:
```
docker build -t crops/codi:deps -f Dockerfile.codi.deps .
```
3. **Build CODI container**
Execute the following command from within the dockerfiles directory:
```
docker build -t crops/codi:version -f Dockerfile.codi ../
```
4. **Build toolchain dependencies container**
Execute the following command from within the dockerfiles directory:
```
docker build -t crops/toolchain:deps -f Dockerfile.toolchain.deps .
```
5. **Open the Dockerfile.toolchain file and provide the URL to your toolchain**
Example:
```
ENV TOOLCHAIN_NAME poky-glibc-x86_64-core-image-sato-i586-toolchain-2.0.sh
ENV TOOLCHAIN_PATH http://downloads.yoctoproject.org/releases/yocto/yocto-2.0/toolchain/x86_64/
```
6. **Build your toolchain container**
```
docker build -t crops/toolchain:my_toolchain -f Dockerfile.toolchain ../
```
7. **Start CODI container**
```
docker run -d --name codi-test -v /var/run/docker.sock:/var/run/docker.sock --net=host crops/codi:version
```
8. **Start toolchain container**
```
mkdir -p $HOME/crops-workspace && docker run -d --name crops-toolchain-my_toolchain -v $HOME/crops-workspace/:/crops/ --env TURFFID=crops-toolchain-my_toolchain --net=host crops/toolchain:my_toolchain
```
9. **Run the Zephyr installer and answer "Yes" when prompted to install CEED. Answer "No" to all other questions**
```
curl -kOs https://raw.githubusercontent.com/todorez/crops/master/installers/zephyr-installer.sh && source ./zephyr-installer.sh
```
10. **Place your project in the shared workspace**
Example:
```
$HOME/crops-workspace/my_project/
```
11. **Build your project**
Example:
```
$HOME/.crops/ceed/ceed -d crops-toolchain-my_toolchain -g "make -C /crops/my_project/"
```
12. **Share your toolchain with other developers by pushing it to Docker Hub**
Example:
```
$docker push crops/toolchain:my_toolchain"
```
## CONTRIBUTING TO CROPS
#### COMPILE CEED, TURFF AND CODI ON LINUX
**Required Prerequisites**
* **libsqlite3-dev** - "SQLite is a C library that implements an SQL database engine."
* **libcurl4-openssl-dev (7.40 or later)** - "libcurl is an easy-to-use client-side URL transfer library, supporting DICT, FILE, FTP, FTPS, GOPHER, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMTP, SMTPS, TELNET and TFTP."
* **libjansson-dev** - "Jansson is a C library for encoding, decoding and manipulating JSON data."
1. **Install Prerequisites On Debian / Ubuntu**
```
apt-get install libsqlite3-dev libcurl4-openssl-dev libjansson-dev
```
2. **Compile**
* GCC
```
CC=gcc make all
```
* CLANG
```
CC=clang make all
```
3. **Debug Compile**
* GCC
```
CC=gcc make debug
```
* CLANG
```
CC=clang make debug
```
#### RUNNING A CLANG STATIC ANALYSYS
1. **Run the static analyzer**
```
scan-build -V make
```
2. **Point your browser at the following URL to view the static analysis results**
```
http://127.0.0.1:8181
```
|
