{"action":"created","comment":{"url":"https://api.github.com/repos/linuxkit/linuxkit/pulls/comments/149334954","pull_request_review_id":74710053,"id":149334954,"diff_hunk":"@@ -0,0 +1,63 @@\n+# LinuxKit on a Raspberry Pi 3b\n+\n+LinuxKit supports building and booting images on a Raspberry Pi 3b\n+using the mainline arm64 bit kernels. The LinuxKit arm64 kernel has\n+support for some of the devices on the Raspberry Pi 3b, but notably it\n+does *not* support:\n+\n+- WLAN\n+- Bluetooth\n+- Graphics (though text console should work)\n+\n+It is unlikely, that we going to add support for these in the main\n+LinuxKit kernels in the near future. The LinuxKit kernel is more\n+targeted at VMs and baremetal servers where support for these type of\n+devices is typically not needed. However, it should be possible to\n+easily extend the LinuxKit kernel build process add the required\n+kernel options, in a similar fashion to how `-dbg` kernels are\n+build. See the [`kernel`](./kernels.md) documentation for details.\n+\n+\n+## Boot\n+\n+We use the mainline Linux kernels for the Raspberry Pi and it is\n+booted via [`uboot`](https://www.denx.de/wiki/U-Boot). The `moby`\n+tool, via `moby build -format rpi3 <YAML>`, currently produces a `tar`\n+archive which can be extracted onto a FAT32 formatted SD card to boot\n+your Raspberry Pi.\n+\n+Currently, the root filesystem is provided as a RAM disk via the\n+`initrd`.\n+\n+\n+## Console\n+\n+The LinuxKit images support console access via HDMI and USB keyboard\n+as well as via serial. For serial console, you need a suitable cable\n+to connect to the GPIO pins as described\n+[here](https://elinux.org/RPi_Serial_Connection).\n+\n+\n+## Disks\n+\n+There currently is no support for persistent disks for the Raspberry\n+Pi. It may be possible to partition the SD card, format a second\n+partition as `ext4` (or similar), and use it for persistent storage.\n+\n+**TODO:** Experiment with and document this set up.\n+\n+\n+## Networking\n+\n+The onboard, USB connected network interface is supported by the\n+LinuxKit kernel, but for some unknown reason the driver is not cold\n+plugged by `mdev`. To use the network interface, the driver needs to\n+be `modeprobe`d before the network interface can be used. The easiest\n+way is to add the following section to the `onboot` section in your\n+LinuxKit YAML file:\n+\n+```\n+  - name: netdev\n+    image: linuxkit/modprobe:<hash>\n+    command: [\"modprobe\", \"smsc95xx\"]\n+```","path":"docs/platform-rpi3.md","position":63,"original_position":63,"commit_id":"95c99b25ffadccab5715aac74182628df3233044","original_commit_id":"95c99b25ffadccab5715aac74182628df3233044","user":{"login":"justincormack","id":482364,"avatar_url":"https://avatars0.githubusercontent.com/u/482364?v=4","gravatar_id":"","url":"https://api.github.com/users/justincormack","html_url":"https://github.com/justincormack","followers_url":"https://api.github.com/users/justincormack/followers","following_url":"https://api.github.com/users/justincormack/following{/other_user}","gists_url":"https://api.github.com/users/justincormack/gists{/gist_id}","starred_url":"https://api.github.com/users/justincormack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/justincormack/subscriptions","organizations_url":"https://api.github.com/users/justincormack/orgs","repos_url":"https://api.github.com/users/justincormack/repos","events_url":"https://api.github.com/users/justincormack/events{/privacy}","received_events_url":"https://api.github.com/users/justincormack/received_events","type":"User","site_admin":false},"body":"worth adding a `TODO` here to fix this...","created_at":"2017-11-07T11:04:19Z","updated_at":"2017-11-07T11:04:19Z","html_url":"https://github.com/linuxkit/linuxkit/pull/2692#discussion_r149334954","pull_request_url":"https://api.github.com/repos/linuxkit/linuxkit/pulls/2692","author_association":"COLLABORATOR","_links":{"self":{"href":"https://api.github.com/repos/linuxkit/linuxkit/pulls/comments/149334954"},"html":{"href":"https://github.com/linuxkit/linuxkit/pull/2692#discussion_r149334954"},"pull_request":{"href":"https://api.github.com/repos/linuxkit/linuxkit/pulls/2692"}}},"pull_request":{"url":"https://api.github.com/repos/linuxkit/linuxkit/pulls/2692","id":151000604,"html_url":"https://github.com/linuxkit/linuxkit/pull/2692","diff_url":"https://github.com/linuxkit/linuxkit/pull/2692.diff","patch_url":"https://github.com/linuxkit/linuxkit/pull/2692.patch","issue_url":"https://api.github.com/repos/linuxkit/linuxkit/issues/2692","number":2692,"state":"open","locked":false,"title":"docs: Add documentation for the Raspberry Pi 3b","user":{"login":"rn","id":3338098,"avatar_url":"https://avatars0.githubusercontent.com/u/3338098?v=4","gravatar_id":"","url":"https://api.github.com/users/rn","html_url":"https://github.com/rn","followers_url":"https://api.github.com/users/rn/followers","following_url":"https://api.github.com/users/rn/following{/other_user}","gists_url":"https://api.github.com/users/rn/gists{/gist_id}","starred_url":"https://api.github.com/users/rn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rn/subscriptions","organizations_url":"https://api.github.com/users/rn/orgs","repos_url":"https://api.github.com/users/rn/repos","events_url":"https://api.github.com/users/rn/events{/privacy}","received_events_url":"https://api.github.com/users/rn/received_events","type":"User","site_admin":false},"body":"closes #2574\r\n\r\nSigned-off-by: Rolf Neugebauer <rolf.neugebauer@docker.com>\r\n\r\n![chamelon](https://user-images.githubusercontent.com/3338098/32471875-76e5c12e-c357-11e7-8686-8a8917b55184.png)\r\n","created_at":"2017-11-07T01:03:43Z","updated_at":"2017-11-07T11:04:19Z","closed_at":null,"merged_at":null,"merge_commit_sha":"53d9ccf1a14fb58a66f6aefa017788802284e08b","assignee":null,"assignees":[],"requested_reviewers":[],"milestone":null,"commits_url":"https://api.github.com/repos/linuxkit/linuxkit/pulls/2692/commits","review_comments_url":"https://api.github.com/repos/linuxkit/linuxkit/pulls/2692/comments","review_comment_url":"https://api.github.com/repos/linuxkit/linuxkit/pulls/comments{/number}","comments_url":"https://api.github.com/repos/linuxkit/linuxkit/issues/2692/comments","statuses_url":"https://api.github.com/repos/linuxkit/linuxkit/statuses/95c99b25ffadccab5715aac74182628df3233044","head":{"label":"rn:rpi3-doc","ref":"rpi3-doc","sha":"95c99b25ffadccab5715aac74182628df3233044","user":{"login":"rn","id":3338098,"avatar_url":"https://avatars0.githubusercontent.com/u/3338098?v=4","gravatar_id":"","url":"https://api.github.com/users/rn","html_url":"https://github.com/rn","followers_url":"https://api.github.com/users/rn/followers","following_url":"https://api.github.com/users/rn/following{/other_user}","gists_url":"https://api.github.com/users/rn/gists{/gist_id}","starred_url":"https://api.github.com/users/rn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rn/subscriptions","organizations_url":"https://api.github.com/users/rn/orgs","repos_url":"https://api.github.com/users/rn/repos","events_url":"https://api.github.com/users/rn/events{/privacy}","received_events_url":"https://api.github.com/users/rn/received_events","type":"User","site_admin":false},"repo":{"id":88780717,"name":"linuxkit","full_name":"rn/linuxkit","owner":{"login":"rn","id":3338098,"avatar_url":"https://avatars0.githubusercontent.com/u/3338098?v=4","gravatar_id":"","url":"https://api.github.com/users/rn","html_url":"https://github.com/rn","followers_url":"https://api.github.com/users/rn/followers","following_url":"https://api.github.com/users/rn/following{/other_user}","gists_url":"https://api.github.com/users/rn/gists{/gist_id}","starred_url":"https://api.github.com/users/rn/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rn/subscriptions","organizations_url":"https://api.github.com/users/rn/orgs","repos_url":"https://api.github.com/users/rn/repos","events_url":"https://api.github.com/users/rn/events{/privacy}","received_events_url":"https://api.github.com/users/rn/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/rn/linuxkit","description":"A toolkit for building secure, portable and lean operating systems for containers","fork":true,"url":"https://api.github.com/repos/rn/linuxkit","forks_url":"https://api.github.com/repos/rn/linuxkit/forks","keys_url":"https://api.github.com/repos/rn/linuxkit/keys{/key_id}","collaborators_url":"https://api.github.com/repos/rn/linuxkit/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/rn/linuxkit/teams","hooks_url":"https://api.github.com/repos/rn/linuxkit/hooks","issue_events_url":"https://api.github.com/repos/rn/linuxkit/issues/events{/number}","events_url":"https://api.github.com/repos/rn/linuxkit/events","assignees_url":"https://api.github.com/repos/rn/linuxkit/assignees{/user}","branches_url":"https://api.github.com/repos/rn/linuxkit/branches{/branch}","tags_url":"https://api.github.com/repos/rn/linuxkit/tags","blobs_url":"https://api.github.com/repos/rn/linuxkit/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/rn/linuxkit/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/rn/linuxkit/git/refs{/sha}","trees_url":"https://api.github.com/repos/rn/linuxkit/git/trees{/sha}","statuses_url":"https://api.github.com/repos/rn/linuxkit/statuses/{sha}","languages_url":"https://api.github.com/repos/rn/linuxkit/languages","stargazers_url":"https://api.github.com/repos/rn/linuxkit/stargazers","contributors_url":"https://api.github.com/repos/rn/linuxkit/contributors","subscribers_url":"https://api.github.com/repos/rn/linuxkit/subscribers","subscription_url":"https://api.github.com/repos/rn/linuxkit/subscription","commits_url":"https://api.github.com/repos/rn/linuxkit/commits{/sha}","git_commits_url":"https://api.github.com/repos/rn/linuxkit/git/commits{/sha}","comments_url":"https://api.github.com/repos/rn/linuxkit/comments{/number}","issue_comment_url":"https://api.github.com/repos/rn/linuxkit/issues/comments{/number}","contents_url":"https://api.github.com/repos/rn/linuxkit/contents/{+path}","compare_url":"https://api.github.com/repos/rn/linuxkit/compare/{base}...{head}","merges_url":"https://api.github.com/repos/rn/linuxkit/merges","archive_url":"https://api.github.com/repos/rn/linuxkit/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/rn/linuxkit/downloads","issues_url":"https://api.github.com/repos/rn/linuxkit/issues{/number}","pulls_url":"https://api.github.com/repos/rn/linuxkit/pulls{/number}","milestones_url":"https://api.github.com/repos/rn/linuxkit/milestones{/number}","notifications_url":"https://api.github.com/repos/rn/linuxkit/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/rn/linuxkit/labels{/name}","releases_url":"https://api.github.com/repos/rn/linuxkit/releases{/id}","deployments_url":"https://api.github.com/repos/rn/linuxkit/deployments","created_at":"2017-04-19T19:02:23Z","updated_at":"2017-05-27T08:03:15Z","pushed_at":"2017-11-07T00:16:57Z","git_url":"git://github.com/rn/linuxkit.git","ssh_url":"git@github.com:rn/linuxkit.git","clone_url":"https://github.com/rn/linuxkit.git","svn_url":"https://github.com/rn/linuxkit","homepage":"","size":23731,"stargazers_count":0,"watchers_count":0,"language":"Logos","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"linuxkit:master","ref":"master","sha":"626adf5375f3c922ee5d409df686e1bf264ef4b1","user":{"login":"linuxkit","id":27256246,"avatar_url":"https://avatars2.githubusercontent.com/u/27256246?v=4","gravatar_id":"","url":"https://api.github.com/users/linuxkit","html_url":"https://github.com/linuxkit","followers_url":"https://api.github.com/users/linuxkit/followers","following_url":"https://api.github.com/users/linuxkit/following{/other_user}","gists_url":"https://api.github.com/users/linuxkit/gists{/gist_id}","starred_url":"https://api.github.com/users/linuxkit/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/linuxkit/subscriptions","organizations_url":"https://api.github.com/users/linuxkit/orgs","repos_url":"https://api.github.com/users/linuxkit/repos","events_url":"https://api.github.com/users/linuxkit/events{/privacy}","received_events_url":"https://api.github.com/users/linuxkit/received_events","type":"Organization","site_admin":false},"repo":{"id":46932243,"name":"linuxkit","full_name":"linuxkit/linuxkit","owner":{"login":"linuxkit","id":27256246,"avatar_url":"https://avatars2.githubusercontent.com/u/27256246?v=4","gravatar_id":"","url":"https://api.github.com/users/linuxkit","html_url":"https://github.com/linuxkit","followers_url":"https://api.github.com/users/linuxkit/followers","following_url":"https://api.github.com/users/linuxkit/following{/other_user}","gists_url":"https://api.github.com/users/linuxkit/gists{/gist_id}","starred_url":"https://api.github.com/users/linuxkit/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/linuxkit/subscriptions","organizations_url":"https://api.github.com/users/linuxkit/orgs","repos_url":"https://api.github.com/users/linuxkit/repos","events_url":"https://api.github.com/users/linuxkit/events{/privacy}","received_events_url":"https://api.github.com/users/linuxkit/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/linuxkit/linuxkit","description":"A toolkit for building secure, portable and lean operating systems for containers","fork":false,"url":"https://api.github.com/repos/linuxkit/linuxkit","forks_url":"https://api.github.com/repos/linuxkit/linuxkit/forks","keys_url":"https://api.github.com/repos/linuxkit/linuxkit/keys{/key_id}","collaborators_url":"https://api.github.com/repos/linuxkit/linuxkit/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/linuxkit/linuxkit/teams","hooks_url":"https://api.github.com/repos/linuxkit/linuxkit/hooks","issue_events_url":"https://api.github.com/repos/linuxkit/linuxkit/issues/events{/number}","events_url":"https://api.github.com/repos/linuxkit/linuxkit/events","assignees_url":"https://api.github.com/repos/linuxkit/linuxkit/assignees{/user}","branches_url":"https://api.github.com/repos/linuxkit/linuxkit/branches{/branch}","tags_url":"https://api.github.com/repos/linuxkit/linuxkit/tags","blobs_url":"https://api.github.com/repos/linuxkit/linuxkit/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/linuxkit/linuxkit/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/linuxkit/linuxkit/git/refs{/sha}","trees_url":"https://api.github.com/repos/linuxkit/linuxkit/git/trees{/sha}","statuses_url":"https://api.github.com/repos/linuxkit/linuxkit/statuses/{sha}","languages_url":"https://api.github.com/repos/linuxkit/linuxkit/languages","stargazers_url":"https://api.github.com/repos/linuxkit/linuxkit/stargazers","contributors_url":"https://api.github.com/repos/linuxkit/linuxkit/contributors","subscribers_url":"https://api.github.com/repos/linuxkit/linuxkit/subscribers","subscription_url":"https://api.github.com/repos/linuxkit/linuxkit/subscription","commits_url":"https://api.github.com/repos/linuxkit/linuxkit/commits{/sha}","git_commits_url":"https://api.github.com/repos/linuxkit/linuxkit/git/commits{/sha}","comments_url":"https://api.github.com/repos/linuxkit/linuxkit/comments{/number}","issue_comment_url":"https://api.github.com/repos/linuxkit/linuxkit/issues/comments{/number}","contents_url":"https://api.github.com/repos/linuxkit/linuxkit/contents/{+path}","compare_url":"https://api.github.com/repos/linuxkit/linuxkit/compare/{base}...{head}","merges_url":"https://api.github.com/repos/linuxkit/linuxkit/merges","archive_url":"https://api.github.com/repos/linuxkit/linuxkit/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/linuxkit/linuxkit/downloads","issues_url":"https://api.github.com/repos/linuxkit/linuxkit/issues{/number}","pulls_url":"https://api.github.com/repos/linuxkit/linuxkit/pulls{/number}","milestones_url":"https://api.github.com/repos/linuxkit/linuxkit/milestones{/number}","notifications_url":"https://api.github.com/repos/linuxkit/linuxkit/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/linuxkit/linuxkit/labels{/name}","releases_url":"https://api.github.com/repos/linuxkit/linuxkit/releases{/id}","deployments_url":"https://api.github.com/repos/linuxkit/linuxkit/deployments","created_at":"2015-11-26T14:48:52Z","updated_at":"2017-11-07T04:27:58Z","pushed_at":"2017-11-07T10:17:49Z","git_url":"git://github.com/linuxkit/linuxkit.git","ssh_url":"git@github.com:linuxkit/linuxkit.git","clone_url":"https://github.com/linuxkit/linuxkit.git","svn_url":"https://github.com/linuxkit/linuxkit","homepage":"","size":23558,"stargazers_count":3462,"watchers_count":3462,"language":"Logos","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":407,"mirror_url":null,"archived":false,"open_issues_count":180,"forks":407,"open_issues":180,"watchers":3462,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/linuxkit/linuxkit/pulls/2692"},"html":{"href":"https://github.com/linuxkit/linuxkit/pull/2692"},"issue":{"href":"https://api.github.com/repos/linuxkit/linuxkit/issues/2692"},"comments":{"href":"https://api.github.com/repos/linuxkit/linuxkit/issues/2692/comments"},"review_comments":{"href":"https://api.github.com/repos/linuxkit/linuxkit/pulls/2692/comments"},"review_comment":{"href":"https://api.github.com/repos/linuxkit/linuxkit/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/linuxkit/linuxkit/pulls/2692/commits"},"statuses":{"href":"https://api.github.com/repos/linuxkit/linuxkit/statuses/95c99b25ffadccab5715aac74182628df3233044"}},"author_association":"MEMBER"}}
{"actor":{"display_login":"justincormack"}}