步驟1：您需要的條件

硬件

螺旋槳。您可以了解更多信息，并在Parallax網站上查看示例電路

編程棒。 USB到串行轉換器，Prop Plug或從具有內置USB

計算機的Parallax中獲取Protoboard。 PC，Mac或Linux（對不起，Amiga！）

用于示例程序的面包板，電阻器和LED，以及電源（可以使用2倍AA）。我使用了3mm綠色LED和270歐姆電阻。

軟件/下載

螺旋槳工具（PC，MAC，Linux）

Propeller手冊（pdf）

可以使用多種語言（C，Spin，PropBasic，Assembly等）對Propeller進行編程。我認為大多數人都使用Spin，這是我最喜歡的語言，所以本教程將介紹該語言。

步驟2：硬件設置

在開始編程之前，讓我們看一下將要使用的測試電路；

原理圖

（完整大小）

我正在使用3mm綠色LED和270歐姆電阻。

面包板

（原尺寸）

第3步：旋轉基礎

《” div》

“想象一下，如果BASIC和PASCAL在酒吧時間掛了，而9個月后出現了一種新語言-那么這就是您的SPIN。” - Ben Heck

Spin是Prop最常用的高級語言，可能是因為它很容易（1）和（2）存在旋轉

YOURFIRSTPROGRAM

為您的第一個程序準備好了嗎？我想說一下Spin，因為它是我最了解的語言。在這里是：

將上面的程序放入Propeller工具中，然后按F10。它將快速編譯并加載到螺旋槳中。代碼將每隔一秒鐘（1/2赫茲）使連接到P0的LED永遠閃爍一次。讓我們分解每一行以了解它的作用；

PUB主功能

旋轉被分為多個塊；

PUB和PRI

這2個塊包含實際代碼。如果您熟悉php或BASIC或C，則它們的功能很像函數。它們具有名稱（此塊的名稱為“ main”），您可以向其傳遞值（函數（passedval））。

對于有效程序，其余塊不是必需的；

CON

CON保存程序常數。如果您在整個程序中使用了一個常量，則CON塊允許您更改一次，并且每次使用時都會反映出來。這是使用CON塊的閃爍程序的示例；

VAR

VAR塊保存程序變量。在閃爍燈程序中，我沒有使用任何系統變量，但這是使用變量的閃爍燈的版本。

還有2個塊，即DAT和OBJ，但我們將暫時跳過這些內容-OBJ在合并其他人的代碼時很有用，而DAT是另一個保存變量的地方，它也是您放置匯編代碼的地方（如果要使用它）。

無論如何-回到我們的原始程序。下一行是：

dira ［0］：= 1

螺旋槳上的每個引腳都可以設置為輸入或輸出。道具啟動時，每個引腳都被設置為輸入，因此我們需要將P0設置為輸出。

要將P0設置為輸出，我們將dira ［0］的值更改為1。：=是spin中的賦值運算符。您能猜出如何將P10設置為輸出嗎？ dira ［10］：= 1.您還可以通過一個命令更改引腳范圍。要更改P0，P1，P2和P3，只需使用dira ［0..3］：=1。

repeat

repeat告訴Propeller多次運行一個代碼塊。您可以指定重復條件（將i從1重復到100），也可以通過不指定其他任何內容來永久重復。此重復塊將永遠重復。

要重復的代碼由標簽界定。注意重復塊下面的淺灰色線條嗎？螺旋槳工具在此處放了灰線，以顯示重復循環中的代碼。

outa ［0］：= 1

outa告訴螺旋槳將引腳接地或連接到V +。 outa的工作方式與dira一樣，您可以設置單個引腳（outa ［10］：= 1）或一組引腳（outa ［0..3］：= 1）的輸出。請注意，僅當將引腳切換到具有dira的輸出時，outa才有意義。

此外，螺旋槳使用三態邏輯。每個引腳可以接地，V +或設置為高阻抗狀態。

高阻抗狀態使該引腳可以感測到它是接地還是V +，而無需改變信號。它使多個引腳共享同一數據通道，并執行諸如charlieplexing之類的操作。

使用以下方法將引腳接地：

dira ［pin］：= 1

outa ［pin］：= 0

引腳連接到V +，其中：

dira ［pin］：= 1 outa ［pin］：= 1

如果該引腳連接到低或高信號（高阻抗狀態），則表示：

dira ［pin］：= 0（默認為啟動狀態）

pinstatus：= ina ［pin］ ina的工作方式與outa和dira相同，只是它是只讀的。如果將引腳設置為輸入，ina將保留當前輸入值。

步驟4：旋轉基礎，續

讓我們繼續執行閃爍燈程序。下一行是：

waitcnt（clkfreq + cnt）

在分解此指令之前，讓我先解釋一下clkfreq和cnt;

clkfreq

Prop可以在多個時鐘頻率下運行，從20kHz一直到80MHz。 clkfreq是一個系統變量，等于1秒內有多少個時鐘周期（滴答聲）。如果Prop以80MHz運行，則clkfreq = 80，000，000。如果Prop以20kHz運行，則它將等于20，000。

cnt

cnt是系統時鐘。在啟動時，cnt = 0，并且在每個刻度上一直遞增至232，然后再滾動到0。cnt是只讀值，您不能更改系統時鐘，只需讀取它的值即可。

現在，waitcnt：它將暫停程序執行，直到系統時鐘達到括號中的值為止。括號中的值是什么？當前系統時鐘（cnt）加上一秒內的滴答數。 waitcnt（clkfreq + cnt）告訴道具在進行下一條指令之前要保持1秒鐘。

如果我們要等待半秒鐘怎么辦？ waitcnt（clkfreq/2 + cnt）。 5秒左右如何？ waitcnt（clkfreq * 5 + cnt）

因此，在我們的程序中，我們將引腳0翻轉到輸出，將其連接到V +（將其驅動為高電平）以打開LED，并等待一秒鐘。這是下一條指令；

outa ［0］：= 0

該指令將引腳0從連接到V +變為接地。它關閉LED。請注意，引腳0仍是輸出，但已接地。

waitcnt（clkfreq + cnt）

就像上次一樣，它暫停程序執行，直到系統時鐘等于括號中的值。在這種情況下，它將暫停執行一秒鐘。

將其打包

我們的重復循環中的最后一條指令已完成。因為我們的重復循環沒有結束條件，所以它將在第一行再次開始（outa ［0］：= 1），并無限期地運行。

步驟5：清理代碼

讓我們用幾個運算符清理代碼。請注意，這些運算符將不會更改您的代碼，它們只是使您更易于閱讀的快捷方式。

這里是代碼的清理版本

在許多語言中，您可以使用“ ++”來增加變量（i ++會增加變量i）。還有更多運算符供您使用，以下是我在清理代碼中使用過的一些運算符；

~~（雙波浪號）

雙波浪號將設置前面的變量為TRUE。因此，代替dira ［0］：= 1，我們可以使用dira ［0］ ~~

?（單波浪號）將前面的變量設置為FALSE。

！ （感嘆號）

感嘆號翻轉后繼變量的值。如果將其設置為TRUE，它將被翻轉為FALSE。通常，它被稱為“切換”，因為它就是這樣做的。

在Spin，++，-，比較，最大和最小值等中可以使用很多運算符-請查看《螺旋槳手冊》從第42頁開始查看所有內容。

第6步：基本視頻

螺旋槳具有在視頻硬件中，制作視頻非常簡單：

首先，我們需要稍微改變一下電路；

（原尺寸）

我們添加了2件事；在引腳30和31上有一個5MHz的晶體。推進器需要一定的速度和精度才能生成視頻數據，Prop會采用該5MHz的輸入晶體并將其乘以16，以達到80MHz的時鐘速度。

A RCA（復合）視頻插孔

您將連接3個引腳以生成視頻，

P12通過270歐姆電阻連接到插孔

P13通過560歐姆電阻連接到插孔

P14通過一個1.1k歐姆的電阻器到插孔

現在已經設置了視頻插孔和晶體，這是程序；

Runni ng該程序將使該圖像顯示在電視上：

我將簡要介紹該程序，以使您了解正在發生的事情，但我將保存詳細的分析為了將來的指導。讓我們從CON塊開始；

CON

CON保持程序常量。這里有2個特殊常量；

_clkmode

該常量告訴Propeller應該以什么時鐘速度運行。如果您未指定任何內容，則道具將使用內部振蕩器在20MHz附近運行。此設置（xtal1 + pll16x）告訴Prop獲取晶體頻率并將其乘以16。請查看《 Propeller手冊》以了解其他有效的時鐘設置。

_xinfreq

如果您使用的時鐘速度為使用水晶時，您需要告訴Prop水晶有多快！將_xinfreq設置為5_000_000可以告訴道具，晶體頻率為5MHz。注意：在Spin中，下劃線（_）被忽略，因此人們經常使用它們來簡化大數字的讀取。

OBJ

obj塊告訴編譯器：“如果我在另一個文件中引用方法（PUB或PRI），則應在此處進行”。我將完整討論如何將Objects用于另一個可指導的對象，但是現在，僅將Objects視為包含其他代碼的一種方式即可。

我們此處使用的代碼是Propeller工具隨附的。 tv_text是啟動電視并在其上顯示簡單文本信息的代碼。 Parallax的對象交換中也有大量其他對象。

PUB main

這是主要的代碼塊。 text.start指文本對象中的PUB啟動方法。它啟動電視并為屏幕保留內存。

text.str指文本對象中的str方法，它使用Propellers內置字體顯示文本字符串。我們使用spin的string（）函數聲明要顯示的文本字符串。

就是這樣！還有其他電視顯示對象。圖形演示（下載Propeller工具時隨附）包括顯示文本，顏色和圖形的方法，下面是屏幕截圖。您還可以在Object Exchange上下載圖形演示。

步驟7：后續步驟

我們在Spin中瀏覽了一個閃爍的燈光程序，我為您提供了生成視頻的快速概述，但Propeller可以做的還很多！

多任務處理-我們的閃爍燈程序僅使用了1個核心，但您還擁有其他7個核心

面向對象編程-Spin是一種“ OOP精簡”語言，并且代碼重用非常簡單。已經建立了對象來控制和讀取傳感器，伺服器，電動機和許多其他設備。

高級圖形和音頻-MIDI和wav文件播放，圖形和游戲。

后續步驟

還有一些其他資源可幫助您入門：

螺旋槳手冊，教學工具包，數據表和應用筆記（此處）

螺旋槳論壇

Nuts and Volts雜志上喬恩·威廉姆斯的旋轉區專欄

道具的替代編程語言：

12個模塊

PropBasic

Imagecraft C

螺旋槳對象交換