You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
			
				
					45 lines
				
				1.9 KiB
			
		
		
			
		
	
	
					45 lines
				
				1.9 KiB
			| 
								 
											2 years ago
										 
									 | 
							
								# openpilot releases
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								## terms
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								- `channel` - a named version of openpilot (git branch, casync caidx) which receives updates
							 | 
						||
| 
								 | 
							
								- `build` - a release which is already built for the comma 3/3x and contains only required files for running openpilot and identifying the release
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								- `build_style` - type of build, either `debug` or `release`
							 | 
						||
| 
								 | 
							
								  - `debug` - build with `ALLOW_DEBUG=true`, can test experimental features like longitudinal on alpha cars
							 | 
						||
| 
								 | 
							
								  - `release` - build with `ALLOW_DEBUG=false`, experimental features disabled
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								## openpilot channels
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								| channel      | build_style | description                                                       |
							 | 
						||
| 
								 | 
							
								| -----------  | ----------- | ----------                                                        |
							 | 
						||
| 
								 | 
							
								| release      | `release`   | stable release of openpilot                                       |
							 | 
						||
| 
								 | 
							
								| staging      | `release`   | release candidate of openpilot for final verification             |
							 | 
						||
| 
								 | 
							
								| nightly      | `release`   | generated nightly from last commit passing CI tests               |
							 | 
						||
| 
								 | 
							
								| master       | `debug`     | current master commit with experimental features enabled          |
							 | 
						||
| 
								 | 
							
								| git branches | `debug`     | installed manually, experimental features enabled, build required |
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								## creating casync build
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								`create_casync_build.sh` - creates a casync openpilot build, ready to upload to `openpilot-releases`
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								```bash
							 | 
						||
| 
								 | 
							
								# run on a tici, within the directory you want to create the build from.
							 | 
						||
| 
								 | 
							
								# creates a prebuilt version of openpilot into BUILD_DIR and outputs the caidx
							 | 
						||
| 
								 | 
							
								# and other casync files into CASYNC_DIR for uploading to openpilot-releases.
							 | 
						||
| 
								 | 
							
								BUILD_DIR=/data/openpilot_build    \
							 | 
						||
| 
								 | 
							
								CASYNC_DIR=/data/casync            \
							 | 
						||
| 
								 | 
							
								OPENPILOT_CHANNEL=nightly          \
							 | 
						||
| 
								 | 
							
								release/create_casync_build.sh
							 | 
						||
| 
								 | 
							
								```
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								`upload_casync_release.sh` - helper for uploading a casync build to `openpilot-releases`
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								## release builds
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								to create a release build, set `RELEASE=1` environment variable when running the build script
							 |